After installing and configuring the in-memory data grid, you can perform the following steps to use the ScaleOut StateServer in-memory data grid as a Session Provider for Java web servers following the Java Servlet 2.5 and 3.0 specification.
- Copy the java_api/session_provider/soss-sessionprovider-5.7.jar JAR and the java_api/soss-jnc-5.7.jar JAR into the application’s WEB-INF/lib directory.
- Copy all the JARs from java_api/lib (JavaApi on Windows) into the application’s WEB-INF/lib directory.
- Set the following configuration parameters in the application’s WEB-INF/web.xml configuration file (this will set the name of the NamedCache instance):
... <filter> <filter-name>SossHttpFilter</filter-name> <filter-class>com.scaleoutsoftware.soss.http.websession.SossHttpFilter</filter-class> </filter> <filter-mapping> <filter-name>SossHttpFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <context-param> <param-name>SossAppName</param-name> <param-value>YourApplicationName</param-value> </context-param> ...
![]() |
Note |
---|---|
The SossAppName parameter should be unique across applications which store sessions in the ScaleOut StateServer in-memory data grid. |
Optionally, you can enable/disable session locking by using the following parameter (by default, session locking is enabled):
<context-param> <param-name>SossSessionLocking</param-name> <param-value>false</param-value> </context-param>