jinql
/
tomcat-cluster-redis-session-manager
mirror of https://github.com/ran-jit/tomcat-cluster-redis-session-manager
1
0
Fork 0
Code Issues Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
29 Commits
4 Branches
17 Tags
493 KiB
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'dcd3dbdf9b'
${ noResults }
Go to file
Ranjith Manickam dcd3dbdf9b
Update README.md 		7 years ago
src Tomcat clustering with Redis data-cache implementation version-2 changes initial commit.. 7 years ago
.classpath Tomcat clustering with Redis data-cache implementation version-2 changes initial commit.. 7 years ago
.gitattributes 🎪 Added .gitattributes & .gitignore files 9 years ago
.gitignore Tomcat clustering with Redis data-cache implementation version-2 changes initial commit.. 7 years ago
.project Tomcat clustering with Redis data-cache implementation version-2 changes initial commit.. 7 years ago
README.md Update README.md 7 years ago
pom.xml Tomcat clustering with Redis data-cache implementation version-2 changes initial commit.. 7 years ago

README.md

Tomcat Clustering Redis Session Manager

Redis session manager is pluggable one. It uses to store sessions into Redis for easy distribution of HTTP Requests across a cluster of Tomcat servers. Sessions are implemented as as non-sticky i.e, each request is forwarded to any server in round-robin manner.

The HTTP Requests session setAttribute(name, value) method stores the session into Redis (must be Serializable) immediately and the session getAttribute(name) method request directly from Redis. Also, the inactive sessions has been removed based on the session time-out configuration.

It supports, both single redis master and redis cluster based on the RedisDataCache.properties configuration.

Going forward, we no need to enable sticky session (JSESSIONID) in Load balancer.

Supports:

  • Apache Tomcat 7
  • Apache Tomcat 8
  • Apache Tomcat 9 (working on it..)

Downloads:

Pre-requisite:

  1. jedis.jar
  2. commons-pool2.jar
  3. commons-logging.jar

more details.. https://github.com/ran-jit/TomcatClusterRedisSessionManager/wiki

Steps to be done,

  1. Move the downloaded jars to tomcat/lib directory

    • tomcat/lib/

  2. Add tomcat system property "catalina.base"

    • catalina.base="TOMCAT_LOCATION"

  3. Extract downloaded package (tomcat-cluster-redis-session-manager.zip) to configure Redis credentials in redis-data-cache.properties file and move the file to tomcat/conf directory

    • tomcat/conf/redis-data-cache.properties

  4. Add the below two lines in tomcat/conf/context.xml

    • <Valve className="tomcat.request.session.redis.SessionHandlerValve" />
    • <Manager className="tomcat.request.session.redis.SessionManager" />

  5. Verify the session expiration time in tomcat/conf/web.xml

    • <session-config>
    • <session-timeout>60</session-timeout>
    • </session-config>

Note:

  • This supports, both redis stand-alone and multiple node cluster based on the redis-data-cache.properties configuration.