SSP v2.0.0 Release Notes
SSP v2.0.0 general release announcement
Jasig released 2.0.0 on September 1, 2013. This new version includes a set of major improvements and all patches included in v1.2.X and v1.1.X.
v2.0.0 Upgrade Information
If you are running SSP version 2.0.0 or 2.0.0-b3, you are strongly encouraged to upgrade to 2.0.1 or 2.1.0 or 2.2.0 or later or otherwise apply the Confidentiality Level-related patches for the Student Documents tool as described by SSP-1917 .
For implementers with any 2.0 beta version installed, upgrade steps are required.
2.0-b3 installations
- Create new permissions for OAUTH2 client management
- ant -Dmaven.test.skip=true -Ddir=uportal-war/src/main/data/ssp_entities/patches-SSP-2-0-0/SSP-1387 data-import
- The default local.properties now includes two new properties. If changes are made to the source distribution, the following lines need to be added.
environment.build.sso.requireSecure=true
environment.build.sso.ticketTimeToLiveMinutes=5
- The addition of the race reference table adds defaults that were manipulated to create the code column. After the release is deployed, review the Races reference table in SSP Administration to update the values.
{{ssp.log}} can now optionally include the request URI (e.g. {{/ssp/api/1/session/getAuthenticatedPerson}}) in each log message. To add the additional output
Add '%X\{req.requestURI}' to your {{<pattern>}} config in {{logback.xml}}.
Example:
<appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <pattern>${system_id}: %d{HH:mm:ss.SSS} [%thread] %X{req.requestURI} %-5level %logger{36} - %msg%n</pattern> </encoder> </appender>
Pre 2.0-b3 Installations
- SSP v2.0.0-b3 Release Notes
Upgrade Notes:
For implementers upgrading from a version prior to 2.0-b2, please pay attention to the following items.
- A new column named code has been added to the student_type table. The code column is not nullable and must be unique so SQL has been added to the liquibase to copy the student_type.name to student_type.code. The code column is limited to 10 characters and the name column is longer than 10. For any item with a name longer than 10 characters, the liquibase will fail. In order to allow the liquibase to complete, the name values must be temporarily reduced to 10 of fewer characters. Once the SSP application deploys, the name values can be restored. This must be done locally in the database.
- Removal of duplicate permissions for student documents
SQL to delete dup perms: delete from up_permission_activity where activity_name in ('PERSON_STUDENT_DOCUMENT_READ','PERSON_STUDENT_DOCUMENT_WRITE'); 2 results SQL to remove group to perm relationships: delete from up_permission where activity in ('PERSON_STUDENT_DOCUMENT_READ','PERSON_STUDENT_DOCUMENT_WRITE'); 6 results
- uPortal Database Update
uPortal Database: Updates the uPortal database to include SSO options contributed by St Petersburg College and Indian River State College ant -Dmaven.test.skip=true db-update Alternatively, the update can be done during the deployment with: ant -Dmaven.test.skip=true clean db-update deploy-ear
- uPortal Permissions and Groups to support SSP Roles
If you are upgrading through SSP v1.2.x, be sure to execute the uPortal data migrations for that version first. This can be done in a single command: ant -Dmaven.test.skip=true -Ddir=uportal-war/src/main/data/ssp_entities/patches-SSP-1-2-0/ data-import Then execute the 2.0.0 migrations: ant -Dmaven.test.skip=true -Ddir=uportal-war/src/main/data/ssp_entities/patches-SSP-2-0-0/ data-import Then update the list of child groups for the 'SSP Roles' group: ant -Dmaven.test.skip=true -Dfile=uportal-war/src/main/data/ssp_entities/group_membership/SSP_Roles/SSP_Roles.group-membership.xml data-import
All upgrades:
The Sencha SDK is now required for SSP builds
Install the Sencha SDK
Download Location: http://www.sencha.com/products/sdk-tools/download
Update your system or user PATH, appending the root of the Sencha SDK install
Additional information: SSP Sencha Build Tool Usage (see that page for additional installation steps on 64-bit OSs)
You should delete or change the passwords for the uPortal users created for demonstration purposes, especially in a production deployment. This can be done through the user interface: Manage Users
-> Find an Existing User
-> [Enter user ID from list below] -> [Click result] -> Delete
or Edit
, then change password. Demo users:
- advisor0
- ken
- student0
- student1
Non-private installs should also either change the admin
user's password or add some other user to the Portal Administrators group and delete the admin
user.
v2.0.0 JIRA Issues
See 2.0 Beta Release Notes
New Feature
- [SSP-173] - Add a tool for Displaced Workers data
- [SSP-510] - Provide a way to Re-open a closed Early Alert
- [SSP-531] - Display some sort of version/build number in UI
Improvement
- [SSP-400] - Add version and build info to footer
- [SSP-515] - Avoid lazy person record creation on external person lookup in caseload assignment UI
- [SSP-527] - Set externally-provided fields to read-only immediately after pressing "Retrieve from external" button (and successfully loading a person record as a result)
- [SSP-530] - Alert user to intractable person record conflict in Caseload Assignment tool prior to offering overwrite/reload options
- [SSP-774] - Create new field for Task and ChallengeReferral 'link' where urls can be stored
- [SSP-1062] - Add a new Student Intake/external data value for race
- [SSP-1068] - Add the race demographic field to MyGPS
- [SSP-1224] - Uniqueness constraints on external data tables
- [SSP-1387] - Add Oauth2 API authentication
- [SSP-1461] - Add requisite information to available course details
- [SSP-1490] - Coach and student type sync
- [SSP-1606] - Journal detail layout improvements
- [SSP-1630] - Don't lock student type and coach fields in Caseload Assignment
- [SSP-1647] - Switch Caseload Assignment form to 'edit' mode when 'Retrieve from external' button finds an existing internal person record
- [SSP-1658] - Add MDCInsertingServletFilter and corresponding output placeholder to default Logback config
- [SSP-1661] - Add index to external_student_transcript_course.formatted_course
- [SSP-1665] - Show/hide toggle for version info in portal footer
- [SSP-1671] - Allow all uP SSO params to be overridden via Maven filters
- [SSP-1686] - More visually consistent MAP plan-level notes button background
- [SSP-1700] - Loading mask should cover course panel while course validation happens 'on course drop'
- [SSP-1665] - Show/hide toggle for version info in portal footer
- [SSP-1671] - Allow all uP SSO params to be overridden via Maven filters
- [SSP-1672] - Document new SSO params in Maven filters files
- [SSP-1621] - Default values for student_type.code should be changed
- [SSP-1624] - Update integration specifications for external term no time component
- [SSP-1627] - Implementors will need to change default data in code column for race
- [SSP-1634] - Document OAuth2 Client API
- [SSP-1635] - Document process for adding OAuth2 Client management permission
- [SSP-1636] - Document OAuth2 Client interaction model for 3rd party apps
- [SSP-1637] - Document OAuth2 Client secret hashing key config
- [SSP-1659] - Document new request URI logging option
- [SSP-1672] - Document new SSO params in Maven filters files
Bug
- [SSP-504] - Caseload assignment always loads "oldest" appointment, creating the impression recent appointment edits were lost
- [SSP-521] - Use externally-provided username instead of UI-calculated username when creating new user with schoolID via the caseload assignment tool
- [SSP-703] - Caseload assignment form fails to save if no selectable special service groups exist
- [SSP-804] - Logout in Linux 1.2.0 CI env redirects to localhost
- [SSP-806] - Collapsing a Tool
- [SSP-807] - Unable to See Student Intake link in MyGPS's Task Panel
- [SSP-809] - n-many Early Alert Response count lookups in Early Alert tool
- [SSP-845] - All of the MyGPS API methods are GETs
- [SSP-874] - Accidental overwrite with null value when no match found in reference table
- [SSP-898] - Find root cause of non-participating reason dialog save failure
- [SSP-911] - Early Alert Tool Hangs
- [SSP-919] - Unable to See Student Intake Form in MyGPS
- [SSP-977] - Empty-string handling of external_person.coach_school_id different from null handling
- [SSP-990] - Can't delete Strengths
- [SSP-1011] - Early Alerts are being sent when cancelling request
- [SSP-1012] - No Email title
- [SSP-1174] - Can create an Action Plan with the Target date occurring in the past
- [SSP-1205] - Intake completion date disappears on cancel
- [SSP-1206] - Intake completion date not shown immediately on save
- [SSP-1210] - ODS Registration Date not shown immediately on save
- [SSP-1240] - General Student Report does not include date range nor term criteria in header
- [SSP-1243] - Scrollbar appears with many item within 'Recent SSP Activity for this Student'
- [SSP-1326] - Drop-Down auto-completes don't switch off of last thing entered.
- [SSP-1359] - Misleading pagination control state in Journal Track admin UI
- [SSP-1368] - Inefficient ID generation in external views
- [SSP-1376] - Term Dates compared using seconds.
- [SSP-1380] - AbstractBase#populateFromGenericObject() probably leads to unexpected behavior
- [SSP-1491] - Dead end when searching for deactivated EA routing person
- [SSP-1518] - Inactive filter on /api/1/journalStep/{id}/journalStepDetail always returns empty results
- [SSP-1565] - SSP Student Intake Highest Grade Doesn't Transfer
- [SSP-1566] - MyGPS Student Intake Shift not applicable error
- [SSP-1567] - MyGPS Student Intake EduGoal Planned Major
- [SSP-1568] - MyGPS Student Intake EduGoal Other Field
- [SSP-1569] - MyGPS Student Intake Funding Other Field
- [SSP-1570] - Student Search deleted students cause phantom issues
- [SSP-1572] - 404s when no current term
- [SSP-1579] - Store student document paths relative to currently configured base path
- [SSP-1580] - Student Intake Second Address Improper Display
- [SSP-1581] - Deleted Journal reference items appear then disappear
- [SSP-1582] - Do we need ./src/main/jasperreports/numberStudentsByStatusCourseForm.jasper
- [SSP-1583] - SSP Permissons Editing Not Visible in IE
- [SSP-1584] - Coaching History report missing dates
- [SSP-1587] - Action Plan report problems
- [SSP-1602] - Early Alert reason explanation for other doesn't display on early alert
- [SSP-1605] - Updating anticipated start year makes student disappear
- [SSP-1610] - Defaulting of student_type.code unlikely to work for upgrades
- [SSP-1611] - Person records unintentionally deleted as side-effect of Strengths save
- [SSP-1613] - Found Students incorrect in Reports (General Student Report etc.)
- [SSP-1616] - Early Alert Tool Halted By Error
- [SSP-1617] - 404 in Schedule tab from unresolvable v_external_student_transcript_course.faculty_school_id
- [SSP-1618] - Adding a course to a Template all courses disappear
- [SSP-1619] - MAP Plan Status data success is false
- [SSP-1620] - MAP 404 Error on Save Template or Plan derived from Template
- [SSP-1622] - CaseloadAssign Failure on Edit Student
- [SSP-1625] - Possible deleted/orphaned Suggestions or Reasons for EA in Coach History Report
- [SSP-1626] - Add CourseRequisites.js to aggr/min js file
- [SSP-1628] - Oath2 changeset 000065.xml failure
- [SSP-1629] - Authenticated user remains original login while impersonating
- [SSP-1638] - remove configs made vestigial by SSP-1630
- [SSP-1642] - Reports showing very limited results
- [SSP-1643] - Mail Exception Error for student intake
- [SSP-1649] - Canceling inline edit in Color admin UI leads to fatal JS error
- [SSP-1650] - Unresponsive Early Alert form when student record not already present in person table
- [SSP-1651] - Non-null constraint person_class discriminator column breaks demo data provisioning
- [SSP-1652] - Error from /api/1/session/getAuthenticatedPerson immediately after user's first-time login
- [SSP-1653] - SQL Server error msg for maximum row size
- [SSP-1654] - Adjustments for EA external data and duplicate row handling
- [SSP-1656] - Adjustments for Main Tool and MAP external data and duplicate row handling
- [SSP-1660] - Method undefined IE8
- [SSP-1664] - Student intake task link in MyGPS cut off
- [SSP-1673] - Invalid POST generated by as a side-effect of a PUT generated by the reference data inline editor
- [SSP-1675] - Fix NPE when constraint violation gets thrown by database in PersonServiceImpl#create
- [SSP-1679] - NPE for Counselor Case Management Report
- [SSP-1681] - Early Alert Response Hibernate formula results in invalid paginated SELECT on SQLServer
- [SSP-1683] - Rename Case Management Report form header to match naming in combo box and the report itself
- [SSP-1684] - Canceling inline edit in Elective admin throws Javascript exception
- [SSP-1685] - Documents upload failing on Win CI
- [SSP-1688] - Caseload Assignment errors out if looked-up person record has no coach
- [SSP-1689] - MYGPS Submission Error
- [SSP-1692] - Disable PersonController#getAll() for performance reasons
- [SSP-1693] - JDBC ERROR: target lists can have at most 1664 entries
- [SSP-1695] - Student type not persisted in Caseload Assignment if user had no student type previously
- [SSP-1696] - uPortal first time login error
- [SSP-1697] - Edugoal Other field text does not come over in Coach View - Student Intake
- [SSP-1706] - Printing Map from Main Details Tab - Error
- [SSP-1712] - Document fails to upload
- [SSP-1715] - MAP business rule violations clobber course descriptions in persistent map_plan_course records
- [SSP-1716] - Looking up current MAP plan status is a POST and requires ROLE_PERSON_MAP_WRITE
- [SSP-1583] - SSP Permissons Editing Not Visible in IE