Chapter 38. Externalize Sessions

Procedure 38.1. Externalize HTTP Sessions

1. Ensure the remote cache containers are defined in EAP's infinispan subsystem; in the example below the cache attribute in the remote-store element defines the cache name on the remote JBoss Data Grid server:

   <subsystem xmlns="urn:jboss:domain:infinispan:4.0">
     [...]
     <cache-container name="web" default-cache="dist" module="org.jboss.as.clustering.web.infinispan" statistics-enabled="true">
       <transport lock-timeout="60000"/>
       <invalidation-cache name="jdg" mode="SYNC">
         <locking isolation="REPEATABLE_READ"/>
         <transaction mode="BATCH"/>
         <remote-store remote-servers="remote-jdg-server1 remote-jdg-server2" 
                       cache="default" socket-timeout="60000" 
                       preload="true" passivation="false" purge="false" shared="true"/>
       </replicated-cache>
     </cache-container>
   </subsystem>

   Copy to Clipboard Toggle word wrap
2. Define the location of the remote Red Hat JBoss Data Grid server by adding the networking information to the socket-binding-group:

   <socket-binding-group ...>
     <outbound-socket-binding name="remote-jdg-server1">
       <remote-destination host="JDGHostName1" port="11222"/>
     </outbound-socket-binding>
     <outbound-socket-binding name="remote-jdg-server2">
       <remote-destination host="JDGHostName2" port="11222"/>
     </outbound-socket-binding>
   </socket-binding-group>

   Copy to Clipboard Toggle word wrap
3. Repeat the above steps for each cache-container and each Red Hat JBoss Data Grid server. Each server defined must have a separate <outbound-socket-binding> element defined.
4. Add passivation and cache information into the application's jboss-web.xml. In the following example web is the name of the cache container, and jdg is the name of the default cache located in this container. An example file is shown below:

   <?xml version="1.0" encoding="UTF-8"?>
   <jboss-web 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_10_0.xsd"
              version="10.0">
    
       <replication-config>
           <replication-granularity>SESSION</replication-granularity>
           <cache-name>web.jdg</cache-name>
       </replication-config>
       
   </jboss-web>

   Copy to Clipboard Toggle word wrap

   Note

   The passivation timeouts above are provided assuming that a typical session is abandoned within 15 minutes and uses the default HTTP session timeout in JBoss EAP of 30 minutes. These values may need to be adjusted based on each application's workload.