Page Comparison

Info
Release Date: TBDJanuary 20, 2017

Warning
SSP 2.8 requires Java JDK 1.8 and Tomcat 8.0.X or 8.5.X. No other versions of Java or Tomcat (including 8.5.X) will work. Both Java and Tomcat must be updated prior to installing SSP 2.8.

...

JDK 1.8 is required starting with SSP v2.8.0. JAVA SE jdk 1.7 and earlier will no longer work. The SSP development team has also observed somewhat better GC performance with the Sun/Oracle JDK vs OpenJDK)
- Environment Variable: JAVA_HOME
  Tip
  title Java Environment Variable
  JAVA_HOME=/path/to/your/java (ie: /usr/local/java or C:\java\jdk)
  
  (optional)
  PATH= append the bin subdirectory to the path statement

Tomcat 8.0.X (Tomcat 6 is not supported as of the 2.8 release)

Instructions for installing and configuring Tomcat for the SSP-Platform (uPortal 4.0). Last known good link to download Tomcat is here: Tomcat 6.

Warning

title	Tomcat Configuration

It is important to complete sections: Shared Libraries, Shared Sessions, Context and Java Heap.

1. Minimally, the catalina.properties file must contain:

shared.loader=${catalina.base}/shared/lib/*.jar

2. And your active connector/s in <tomcat>/conf/server.xml must have the emptySessionPath flag set:

<Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000" redirectPort="8443" emptySessionPath="true"/>

3. (new in Tomcat 8) The context must be updated with two changes. The context.xml should be modified with an updated Context tag and new lines for Resources. The following excerpt can replace the existing section.

<Context crossContext="true" sessionCookiePath="/">

    <!-- Default set of monitored resources. If one of these changes, the    -->
    <!-- web application will be reloaded.                                   -->
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
    <WatchedResource>${catalina.base}/conf/web.xml</WatchedResource>
    <Resources cachingAllowed="true" cacheMaxSize="100000" />

    <!-- Uncomment this to disable session persistence across Tomcat restarts -->
    <!--
    <Manager pathname="" />
    -->
</Context>

4. Increase the heap in <tomcat>/bin/setenv.sh (*nix) or <tomcat>/bin/setenv.bat (Windows). Smaller sizing is probably feasible, but the examples below match what our SSP CI envs run with. For production systems, start with a max heap of roughly half available physical memory and increase from there if necessary.

The uPortal instructions above recommend using JAVA_OPTS for heap sizing. This can lead to problems on memory constrained systems because JAVA_OPTS will be used when trying to stop Tomcat with its own scripts. You don't typically need a large heap at all for that operation. So CATALINA_OPTS is a better choice for sizing the heap in setenv scripts, because that var will only be used for Tomcat's http-serving runtime.

setenv.sh:

CATALINA_OPTS=-Xms2G -Xmx2G -XX:PermSize=256m -XX:MaxPermSize=256m

setenv.bat (uPortal instructions linked to above are missing the 'set'):

set CATALINA_OPTS=-Xms2G -Xmx2G -XX:PermSize=256m -XX:MaxPermSize=256m

Additionally, a performance improvement has been experienced by enabling compression in Tomcat

Tip

Add compression="force" to the server.xml in the connector like the following:

<Connector port="8080" protocol="HTTP/1.1

connectionTimeout="20000"

redirectPort="8443"

emptySessionPath="true"

compression="force" />

...

Zip Download

The source files can be downloaded in a zip file.

Download Location: SSP-Platformplatform-2-8.0.zip ("SSP Platform" is a portal application which acts container for SSP itself. The two applications are versioned independently. By default, version 2.78.0 of SSP Platform will include version 2.78.0 of SSP.) Note: If you wish to make customizations to SSP, you'll want to download SSP separately see: Developer Install Instructions

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)

...

Versions Compared

Old Version 5

New Version Current

Key