Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

 

Info

Released on November 21, 2014

Info

For all existing installations of 2.0.X and 2.1.X, important upgrade instructions exist in the previous 2.12.2, 2.3, 2.4, 2.5.1 and 2.5.2  Release notes. 

  • To upgrade from 2.0.X follow the upgrade instructions for 2.12.22.3, 2.4, 2.5.1 and 2.5.2 Release Notes before deploying the 2.5.2 code
  • To upgrade from 2.1.X follow the upgrade instructions for the 2.22.3, 2.4, 2.5.1 and 2.5.2 Release Notes before deploying the 2.5.2 code
  • To upgrade from 2.2.X follow the upgrade instructions for the  2.3, 2.4, 2.5.1 and 2.5.2 Release Notes before deploying the 2.5.2 code
  • To upgrade from 2.3.X follow the 2.4, 2.5.1 and 2.5.2 Release Notes before deploying the 2.5.2 code
  • To upgrade from 2.4.X following the 2.5.1 and 2.5.2 Release Notes before deploying the 2.5.2 code
  • New installations of 2.6.0 are not required to make any additional change

If you are running a SSP version prior to 1.1.1, you are strongly encouraged to upgrade or otherwise apply the reporting subsystem security patches described by SSP-701.

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.

Also please take a few minutes to review additional security-related announcements detailed at the top of the SSP space here in Confluence.

...

  • Maven 3.0.3 or later
    • Download Loation: http://maven.apache.org
    • Environment Variable: MAVEN_HOME

      Tip
      titleMaven Environment Variables
      MAVEN_HOME= /path/to/your/maven (ie: /usr/local/maven or C:\tools\maven)
      M2_HOME= /path/to/your/maven (ie: /usr/local/maven or C:\tools\maven)

      (optional)
      PATH= append the bin subdirectory to the path statement
  • Ant 1.8.2 (use this exact version)
    • Download Location: http://ant.apache.org

    • Environment Variable: ANT_HOME

      Tip
      titleAnt Environment Variable
      ANT_HOME= /path/to/your/ant (ie: /usr/local/ant or C:\tools\ant)

      (optional)
      PATH= append the bin subdirectory to the path statement
  • Sencha SDK
  • RDBMS (support for PostgreSQL and Microsoft SQL Server)
    • PostgreSQL 9.1 or later
      • Download Location: http://www.postgresql.org
        • On Unix:
        • On Mac:
          • PostgreSQL is available via the homebrew package manager or as a download on the postgresql.org site.
        • On Windows:
          • PostgreSQL is available as a download on the postgresql.org site.
      • Configure PostgreSQL
        • Server Connection
          • Launch the PG Admin application
          • In the Object Browser, navigate to and right click on Server Groups -> Servers -> PostgreSQL 9.1 (localhost:5432)
          • Click Connect and the enter the administrator password
        • Login Roles
          • In the Object Browser, right click on Login Roles and click New Login Role
            • In the Properties tab, enter a Role name of "sspadmin" without the quotes

            • In the Definition tab, enter a Password of "sspadmin" without the quotes

          • In the Object Browser, right click on Login Roles and click New Login Role


            • In the Properties tab, enter a Role name of "ssp" without the quotes

            • In the Definition tab, enter a Password of "ssp" without the quotes

          • Confirm the new Login Roles exist in the Object Browser
        • Database
          • In the Object Browser, right click on Databases and click New Database
            • Enter "ssp" without the quotes as the database name
            • Enter "sspadmin" without the quotes as the database owner
          • Confirm the new database exists in the Object Browser
    • Microsoft SQL Server 2008 R2 and 2012
      • Server Connection
        • Launch the SQL Server Management Studio application
        • Enter your database connection info including administrator account credentials, and click Connect
      • Login Roles
        • Navigate to Security->Logins, and right click on New Login
          • Login name of "sspadmin" without the quotes
          • Select SQL Server authentication and enter a Password of "sspadmin" without the quote
          • Uncheck Enforce password policy
        • Right click on Logins again, and New Login Role
          • Login name of "ssp" without the quotes
          • Select SQL Server authentication and enter a Password of "ssp" without the quote
          • Uncheck Enforce password policy
        • Confirm the new users exist
      • Database
        • Navigate to and right click on Databases and click New Database
          • Enter "ssp" without the quotes as the database name
        • Confirm the new database exists
        • Run the following SQL to assign user permissions and configure the required database settings

...

Zip Download
The source files can be downloaded in a zip file

Download Location: SSP-Platform-2-6.0.zip    ("SSP Platform" is a portal application which acts container for SSP itself. The two applications are versioned independently. By default, version 2.6.0 of SSP Platform will include version 2.6.0 of SSP.)

  • Unzip the file into a suitable path (e.g. on Windows C:\ssp\platform-src or on Unix/Linux/Mac /usr/local/ssp/platform-src)

...

    • ssp-platform-config.properties
      • The ssp-platform-config.properties file must be modifed for database connectivity and email settings
        • Original File Location: ./uportal-war/src/main/resources/properties/ssp-platform-config.default.properties
        • Edit the file and save in the SSP_CONFIGDIR
      • Run-Time File Location: <SSP_CONFIGDIR>/ssp-platform-config.properties
      • Configuration Values:

      ValueDescription
      environment.build.hibernate.connection.driver_class

      jdbc driver file

      For best results with SQL Server, the JTDS driver included with the Platform installation is recommended.

      environment.build.hibernate.connection.url

      jdbc connection syntax

      For best results with SQL Server, the JTDS driver included with the Platform installation is recommended.

      environment.build.hibernate.connection.usernamejdbc connection database username
      environment.build.hibernate.connection.passwordjdbc connection database password
      environment.build.hibernate.dialect

      jdbc connection dialect

      For best results with SQL Server, the JTDS driver included with the Platform installation is recommended.

      environment.build.uportal.serverHostname and port for your SSP deployment. (Default: localhost:8080)
      environment.build.uportal.protocolHTTP/S protocol at which end users access your SSP deployment. (Default: http)
      environment.build.uportal.email.fromAddressAddress from which Platform email will originate. Rarely used. (Default: ssp@university.edu)
      environment.build.sso.*Several properties which configure inbound LTI and legacy SSO. See documentation specific to those features: SSP LTI Provider and SSP Signed URL SSO. Note that to enable these features environment.build.sso.local.sharedSecret must be set to the same non-empty value as ssp_platform_sso_ticket_service_shared_secret in $SSP_CONFIGDIR/ssp-config.properties

...

    • (database specific attributes)(default values)
      environment.build.raweventsdb.connection.driver_class${environment.build.hibernate.connection.driver_class}
      environment.build.raweventsdb.connection.url${environment.build.hibernate.connection.url}
      environment.build.raweventsdb.connection.username${environment.build.hibernate.connection.username}
      environment.build.raweventsdb.connection.password${environment.build.hibernate.connection.password}
      environment.build.aggreventsdb.connection.driver_class${environment.build.hibernate.connection.driver_class}
      environment.build.aggreventsdb.connection.url${environment.build.hibernate.connection.url}
      environment.build.aggreventsdb.connection.username${environment.build.hibernate.connection.username}
      environment.build.aggreventsdb.connection.password${environment.build.hibernate.connection.password}
      environment.build.portaldb.initial.size1
      environment.build.portaldb.min.idle1
      environment.build.portaldb.max.active50
      environment.build.portaldb.max.idle50
      environment.build.portaldb.max.wait2000
      environment.build.portaldb.abandon.when.percentage.full70
      environment.build.portaldb.remove.abandonedTRUE
      environment.build.portaldb.remove.abandoned.timeout300
      environment.build.portaldb.jdbc.interceptorsConnectionState(useEquals=true);ResetAbandonedTimer
      environment.build.portaldb.test.while.idleTRUE
      environment.build.portaldb.test.on.borrowTRUE
      environment.build.raweventsdb.initial.size1
      environment.build.raweventsdb.min.idle1
      environment.build.raweventsdb.max.active50
      environment.build.raweventsdb.max.idle50
      environment.build.raweventsdb.max.wait2000
      environment.build.raweventsdb.abandon.when.percentage.full70
      environment.build.raweventsdb.remove.abandonedTRUE
      environment.build.raweventsdb.remove.abandoned.timeout300
      environment.build.raweventsdb.jdbc.interceptorsConnectionState(useEquals=true);ResetAbandonedTimer
      environment.build.raweventsdb.test.while.idleTRUE
      environment.build.raweventsdb.test.on.borrowTRUE
      environment.build.aggreventsdb.initial.size1
      environment.build.aggreventsdb.min.idle1
      environment.build.aggreventsdb.max.active50
      environment.build.aggreventsdb.max.idle50
      environment.build.aggreventsdb.max.wait2000
      environment.build.aggreventsdb.abandon.when.percentage.full70
      environment.build.aggreventsdb.remove.abandonedTRUE
      environment.build.aggreventsdb.remove.abandoned.timeout300
      environment.build.aggreventsdb.jdbc.interceptorsConnectionState(useEquals=true);ResetAbandonedTimer
      environment.build.aggreventsdb.test.while.idleTRUE
      environment.build.aggreventsdb.test.on.borrowTRUE

4. Build SSP-Platform

  • Use the following command to build, deploy, and initialize the SSP-Platform project:

...