Reference Library

SSPR Environment

ApplicationPath

The application path setting is required. Configure the application path to use a directory on the local filesystem. SSPR will store it's operating files in this directory. Specifically, the following contents will be stored in the application path:

• Configuration
• LocalDB database
• Log files
• Backup data

The path value is given as an absolute directory path on the local file system. The SSPR application must have full permissions to create, modify and delete folders in this directory. The directory must already be exist when SSPR is started, it will not be automatically created.

Older versions of SSPR did not require the application path to be set and would automatically use the exploded war directory's WEB-INF directory as the application path. This is no longer done automatically, and having the application path be within the exploded war or anywhere in the application server's directory structure is not recommended.

Setting the Application Path

The following configuration methods are evaluated by the application in this order until a value is found:

1.     Servlet web.xml

2.     Java System Property

3.     Environment Variable

Servlet web.xml

Modify the servlet WEB-INF/web.xml file. You must modify the application war file to accomplish this method. This method accommodates multiple applications on a single application server. File paths must be absolute.

Linux Example

<context-param>
   <description>...</description>
   <param-name>applicationPath</param-name>
   <param-value>/home/user/sspr-data</param-value>
</context-param>

Windows Example

<context-param>
   <description>...</description>
   <param-name>applicationPath</param-name>
   <param-value>c:\sspr-data</param-value>
</context-param>

Java System Property

The application will read the java system property sspr.applicationPath variable to determine the location of the application path. Relative paths are not permitted. These example parameters would be added to the java command line that starts the application server (tomcat) and java process.

Linux Example

-Dsspr.applicationPath='/home/user/sspr-data'

Windows Example

-Dsspr.applicationPath="c:\sspr-data"

Environment Variable

The application will read the SSPR_APPLICATIONPATH variable to determine the location of the application path. Relative paths are not permitted.

Linux Example

export SSPR_APPLICATIONPATH='/home/user/sspr-data'

This environment variable would typically be set as part of an init or other script file that starts your application server.

Windows Example

set "SSPR_APPLICATIONPATH=c:\sspr-data"

This environment variable is typically set as part of a .bat file that starts your application server, or possibly as a system-wide environment variable via the windows control panel.

ApplicationFlags

Application flags can be set to enable or disable behaviors in SSPR. By default, no flags are set. Setting flags is optional. Flags are specified as a comma seperated list of values. Values are case sensitive. In most cases, you will not need to set an application flag.

Linux Example

export SSPR_APPLICATIONFLAGS='ManageHttps,NoFileLock'

Environment Variable Names and Servlet Context

The environment variables listed above, such as SSPR_APPLICATIONPATH and sspr.applicationPathassume the default context name of /sspr/ is used. The context path will default to the war file name on most systems.

For non-default context names, or when there are multiple SSPR applications deployed on the same server, the environment variable must include the context. For example: