Chapter 6. Appendix


Additional information for Data Grid 8.0.

Externalize HTTP sessions from JBoss Web Server (JWS) to Data Grid via the Apache Tomcat org.apache.catalina.Manager interface.

6.1.1. Installing the Session Client

  1. Download the redhat-datagrid-8.0.0.Final-tomcat<$version>-session-client.zip archive from the Data Grid Software Downloads on the Red Hat customer portal.
  2. Copy the contents of the lib/ directory in the archive into $CATALINA_HOME.

6.1.2. Configuring the Session Manager

  1. Open either $CATALINA_HOME/conf/context.xml or /WEB-INF/context.xml for editing.
  2. Specify the HotRodManager class for the Session Manager and define configuration as appropriate.
  3. Save and close context.xml.

Example Configuration

<Manager className="org.wildfly.clustering.tomcat.hotrod.HotRodManager"
         configurationName="mycache"
         persistenceStrategy="FINE"
         maxActiveSessions="100"
         server_list="127.0.0.1:11222;127.0.0.1:11223;127.0.0.1:11224"/>
Copy to Clipboard Toggle word wrap

6.1.3. HotRodManager Configuration Properties

Expand
PropertyDescription

configurationName

Specifies a cache instance or template defined in $RHDG_HOME/server/conf/infinispan.xml. Your application then creates a cache instance that uses the configuration from the named cache.

persistenceStrategy

Defines how sessions map to entries in the cache.

COARSE stores all attributes of a session in a single cache entry. This is the default.

FINE stores session attributes in separate cache entries.

maxActiveSessions

Defines the maximum number of sessions to store in the cache. The default is no maximum (limitless).

To configure Hot Rod clients, specify properties without the infinispan.client.hotrod. prefix. For more information, see the Hot Rod Client Configuration API.

You can also specify common attributes for the Session Manager. Refer to the appropriate version of the Apache Tomcat documentation as follows:

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat