README.md

Redis based Tomcat Session Manager

Implements non-sticky session management backed by Redis.
Supports Tomcat 6.x, 7.x, 8.x

Advantages

Current implementation differs from any other Tomcat Session Manager in terms of efficient storage and optimized writes. Each session attribute is written into Redis during each HttpSession.setAttribute invocation. While other solutions serialize whole session each time.

Usage

  1. Add RedissonSessionManager into context.xml

    <Manager className="org.redisson.tomcat.RedissonSessionManager"
             configPath="${catalina.base}/redisson.conf" />

    configPath - path to Redisson JSON or YAML config. See configuration wiki page for more details.

  2. Copy two jars into TOMCAT_BASE/lib directory:

    1. For JDK 1.8+
      redisson-all-3.2.2.jar

      for Tomcat 6.x
      redisson-tomcat-6-3.2.2.jar
      for Tomcat 7.x
      redisson-tomcat-7-3.2.2.jar
      for Tomcat 8.x
      redisson-tomcat-8-3.2.2.jar

    2. For JDK 1.6+
      redisson-all-2.7.2.jar

      for Tomcat 6.x
      redisson-tomcat-6-2.7.2.jar
      for Tomcat 7.x
      redisson-tomcat-7-2.7.2.jar
      for Tomcat 8.x
      redisson-tomcat-8-2.7.2.jar