8.2.2. Configure HttpSession Passivation in Your Application
HttpSession passivation is configured in your application's
Example 8.3. Example
<!DOCTYPE jboss-web PUBLIC "-//JBoss//DTD Web Application 5.0//EN" "http://www.jboss.org/j2ee/dtd/jboss-web_5_0.dtd"> <jboss-web version="6.0" xmlns="http://www.jboss.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.jboss.com/xml/ns/javaee http://www.jboss.org/j2ee/schema/jboss-web_6_0.xsd"> <max-active-sessions>20</max-active-sessions> <passivation-config> <use-session-passivation>true</use-session-passivation> <passivation-min-idle-time>60</passivation-min-idle-time> <passivation-max-idle-time>600</passivation-max-idle-time> </passivation-config> </jboss-web>
Passivation Configuration Elements
- The maximum number of active sessions allowed. If the number of sessions managed by the session manager exceeds this value and passivation is enabled, the excess will be passivated based on the configured
<passivation-min-idle-time>. Then, if the number of active sessions still exceeds this limit, attempts to create new sessions will fail. The default value of
-1sets no limit on the maximum number of active sessions.
- This element holds the rest of the passivation configuration parameters, as child elements.
<passivation-config> Child Elements
- Whether or not to use session passivation. The default value is
- The minimum time, in seconds, that a session must be inactive before the container will consider passivating it in order to reduce the active session count to conform to value defined by max-active-sessions. The default value of
-1disables passivating sessions before
<passivation-max-idle-time>has elapsed. Neither a value of -1 nor a high value are recommended if
- The maximum time, in seconds, that a session can be inactive before the container attempts to passivate it to save memory. Passivation of such sessions takes place regardless of whether the active session count exceeds
<max-active-sessions>. This value should be less than the
<session-timeout>setting in the
web.xml. The default value of
-1disables passivation based on maximum inactivity.
<max-active-sessions>. The number of sessions replicated from other nodes also depends on whether
DISTcache mode is enabled. In
REPLcache mode, each session is replicated to each node. In
DISTcache mode, each session is replicated only to the number of nodes specified by the
ownerparameter. Refer to Section 8.1.2, “About the Web Session Cache” and Section 8.1.3, “Configure the Web Session Cache” for information on configuring session cache modes.
REPLcache mode, each node would store 800 sessions in memory. With
DISTcache mode enabled, and the default
2, each node stores 200 sessions in memory.