LATEST VERSION: 8.2.7 - CHANGELOG
Pivotal GemFire® v8.2

HTTP Session Management Quick Start

HTTP Session Management Quick Start

In this section you download, install, and set up the HTTP Session Management modules.

Quick Start Instructions

  1. Download and install one of the application servers supported by Pivotal GemFire.
    Note: This table lists all application server versions that have been tested with the GemFire HTTP Session Management modules. However, the generic HTTP Session Management Module for AppServers is implemented as a servlet filter and should work on any application server platform that supports the Java Servlet 2.4 specification.
  2. The HTTP Session Management Modules installation .zip files are located in the tools/Modules directory of the GemFire product download. Locate the .zip file for the HTTP Session Management Module that you wish to install. Unzip the appropriate HTTP Session Management Module into the specified directory for your application server:
    Supported Application Server Version Module Target Location for Module
    tc Server 2.5 HTTP Session Management Module for Pivotal tc Server <tc Server root dir>/templates
    tc Server 2.6 HTTP Session Management Module for Pivotal tc Server <tc Server root dir>/templates
    tc Server 2.7 HTTP Session Management Module for Pivotal tc Server <tc Server root dir>/templates
    tc Server 2.8 HTTP Session Management Module for Pivotal tc Server <tc Server root dir>/templates
    tc Server 2.9 HTTP Session Management Module for Pivotal tc Server <tc Server root dir>/templates
    tc Server 3.0, 3.1, and 3.2 HTTP Session Management Module for Pivotal tc Server 3.0 <tc Server root dir>/templates
    Tomcat 6.0 HTTP Session Management Module for Tomcat $CATALINA_HOME
    Tomcat 7.0 HTTP Session Management Module for Tomcat $CATALINA_HOME
    WebLogic 11g (10.3.x) HTTP Session Management Module for AppServers any directory
    WebSphere 7, 8 HTTP Session Management Module for AppServers any directory
    JBoss 5, 6, 7 HTTP Session Management Module for AppServers any directory
  3. Complete the appropriate set up instructions for your application server described in the following sections:

Additional Quick Start Instructions for tc Server Module

These steps provide a basic starting point for using the tc Server module. For more configuration options, see HTTP Session Management Module for Pivotal tc Server.
  1. Navigate to the root directory of tc Server.
  2. Create a GemFire instance using one of the provided templates and start the instance. For example:
    prompt$ ./tcruntime-instance.sh create my_instance_name --template gemfire-p2p
    prompt$ ./tcruntime-ctl.sh my_instance_name start

    This will create and run a GemFire instance using the peer-to-peer topology and default configuration values. Another GemFire instance on another system can be created and started in the same way.

    If you need to pin your tc Server instance to a specific tc Server runtime version, use the --version parameter when creating the instance. See Pinning a tc Server Runtime Instance to a Specific Version for details.

Additional Quick Start Instructions for Tomcat Module

These steps provide a basic starting point for using the Tomcat module. For more configuration options, see HTTP Session Management Module for Tomcat.
  1. Modify Tomcat's server.xml and context.xml files. Configuration is slightly different depending on the topology you are setting up and the version of Tomcat you are using.
    For example, in a peer-to-peer configuration using Tomcat 7, you would add the following entry within the <server> element of server.xml:
    <Listener className="com.gemstone.gemfire.modules.session.catalina.
                             PeerToPeerCacheLifecycleListener"/>
    and the following entry within the <context> tag in the context.xml file:
    <Manager className="com.gemstone.gemfire.modules.session.catalina.
                             Tomcat7DeltaSessionManager"/> 
    See Setting Up the HTTP Module for Tomcat for additional instructions.
  2. Restart the application server.

Additional Instructions for AppServers Module

These steps provide a basic starting point for using the AppServers module with WebLogic, WebSphere or JBoss. For more configuration options, see HTTP Session Management Module for AppServers.
Note:
  • The modify_war script, described below, relies on files within the distribution tree and should not be run outside of a complete distribution.
  • The modify_war script is a bash script and does not run on Windows.
To set up the AppServers module, perform the following steps:
  1. Run the modify_war script against an existing .war or .ear file to integrate the necessary components. The example below will create a configuration suitable for a peer-to-peer GemFire system, placing the necessary libraries into WEB-INF/lib for wars and lib for ears and modifying any web.xml files:
    prompt$ bin/modify_war -w my-app.war -x
  2. A new war file will be created called session-my-app.war. This file can now be deployed to the server.