Use these parameters to modify the ObjectGrid session manager.
The way that you define these parameters depends on
how you modify your application to use the ObjectGrid HTTP session manager.
For more information about modifying your application, see
Modifying
an application to use the ObjectGrid HTTP session manager.
- If you are splicing the application with the provided batch files and
Unix scripts, modify the splicer.properties properties file.
- If you are splicing the application by using an ANT task, modify these
properties in the build.xml file.
Parameters
- affinityManager
- Specifies the fully-qualified package and Java class name of a servlet
filter plug-in that is used to facilitate HTTP session routing affinity. Use
this parameter when you are configuring an application server that is not
running WebSphere Application Server. WebSphere Application Server uses built-in
affinity support.
Table 1. affinityManager parameter usage
Affinity mechanism |
Value |
Default |
com.ibm.ws.httpsession.NoAffinityManager, which
specifies that no affinity is used. |
Third-party affinity mechanism |
com.ibm.ws.httpsession.AssumeAffinityManager |
Construct an affinity manager for new servers |
Code to the com.ibm.wsspi.session.ISessionAffinityManager interface |
- persistenceMechanism
- Specifies a string value that defines how the session is stored in the
ObjectGrid.
Table 2. persistenceMechanism parameter values
Value |
Definition |
ObjectGridStore |
Each session attribute is stored in a different entry
in the ObjectGrid table. |
ObjectGridAtomicSessionStore |
The entire session is stored as a single entry in the
ObjectGrid table. |
- objectGridName
- Specifies a string value for the name of the ObjectGrid table that is
used for a particular Web application. If you do not define a value for this
property, the default name comes from the Web application name that is defined
with the ServletContext interface.
- objectGridClusterConfigFileName
- Specifies a string value that contains the absolute path to the ObjectGrid
configuration file. This configuration file must conform to the objectGridCluster.xsd schema
and contain configuration information, including topology, of the ObjectGrid
instance that is specified with the objectGridName parameter.
- replicationType
- Specifies a string value that defines how session updates are written
to the ObjectGrid. The valid values are asynchronous and synchronous.
Table 3. replicationType parameter values
Value |
Definition |
asynchronous |
The default value that can only be used if affinity
is enabled. |
synchronous |
Define this value if affinity is not enabled. |
- replicationInterval
- Specifies a string value that defines the time in seconds between writing
updated sessions to the ObjectGrid. This parameter is used only when the replicationType
parameter is set to asynchronous. The default value is 10 seconds.
- sessionTableSize
- Specifies an integer value that defines the number of sessions that are
stored in memory with the servlet filter. These sessions are also stored in
the ObjectGrid. The default is 1000 sessions.
- defaultSessionTimeout
- Specifies an integer value that defines the amount of time in minutes,
that a session can be inactive before the session is invalidated and removed
from the system. A session is inactive when it is not accessed from a servlet.
The default value is 30 minutes.
- sessionIDLength
- Specifies an integer value that defines the length of the string identifies
that are created for HTTP sessions. The default value is 23.
- shareSessionsAcrossWebApps
- Specifies a string value of true or false that indicates if HTTP Sessions
are shared across Web applications. By default, HTTP sessions cannot be shared.
You can use an extension to the servlet specification to allow HTTP sessions
to be shared.