Ce contenu n'est pas disponible dans la langue sélectionnée.

Chapter 15. Externalizing HTTP sessions from Red Hat JBoss Web Server to Red Hat Data Grid


Achieve high availability by externalizing HTTP session data from JBoss Web Server deployments to Data Grid Server clusters through the org.apache.catalina.Manager interface.

15.1. Installing the Tomcat session client

Install the Tomcat session client to externalize HTTP sessions from Red Hat JBoss Web Server applications to Red Hat Data Grid.

Procedure

  1. Download the redhat-datagrid-8.1.1-tomcat<$version>-session-client.zip archive from the Data Grid Software Downloads.
  2. Extract the archive to your filesystem.
  3. Copy the contents of the lib/ directory from the extracted archive into $CATALINA_HOME/lib.

15.2. Configuring the session manager

Configure the HotRodManager class for the session manager to define how the Tomcat session client connects to Red Hat Data Grid Server and stores data in remote caches.

Prerequisites

  • Install the Tomcat session client.
  • Install at least one Data Grid Server instance.
  • Create a cache on Data Grid Server to use as a template for storing HTTP session data.

Procedure

  1. Open either $CATALINA_HOME/conf/context.xml or /WEB-INF/context.xml for editing.
  2. Specify org.wildfly.clustering.tomcat.hotrod.HotRodManager as the value for the className property.
  3. Specify the name of the cache to use as a template with the configurationName property.
  4. Define any other configuration properties for the HotRodManager class as appropriate.
  5. Set Hot Rod client configuration properties without the infinispan.client.hotrod. prefix.

    1. Specify the list of Data Grid Server nodes with the server_list property.
    2. Specify Data Grid credentials with the auth_username and auth_password properties.
  6. Specify common attributes for the Tomcat session manager as required.
  7. Save and close context.xml.

Configuration example

<Manager className="org.wildfly.clustering.tomcat.hotrod.HotRodManager"
         configurationName="mycache"
         persistenceStrategy="FINE"
         maxActiveSessions="100"
         server_list="192.0.2.0:11222;192.0.2.0:11223;192.0.2.0:11224"
         protocol_version="2.9"
         auth_username="admin"
         auth_password="changeme"
         auth_realm="default"
         sasl_mechanism="DIGEST-MD5"
         auth_server_name="infinispan"/>
Copy to Clipboard Toggle word wrap

Verification

To verify that the Tomcat session client stores data in remote caches, do the following:

  1. Open the Data Grid Console in any browser.

    By default the console is available at http://127.0.0.1:11222/console/.

  2. Check that the Tomcat session client has created caches for each deployed application.

15.2.1. Hot Rod manager configuration properties

The following table lists and describes configuration properties for the HotRodManager class:

Expand
PropertyDescription

className

Specifies org.wildfly.clustering.tomcat.hotrod.HotRodManager as the session manager.

configurationName

Specifies a remote cache on Data Grid Server to use as a template for storing HTTP session data.

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).

Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat