ran-jit/tomcat-cluster-redis-session-manager
Tomcat clustering redis session manager java client. https://github.com/ran-jit/tomcat-cluster-redis-session-manager/wiki
Download
Step 1. Add the JitPack repository to your build file
Add it in your root settings.gradle at the end of repositories:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
}Add it in your settings.gradle.kts at the end of repositories:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url = uri("https://jitpack.io") }
}
}Add to pom.xml
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>Add it in your build.sbt at the end of resolvers:
resolvers += "jitpack" at "https://jitpack.io"
Add it in your project.clj at the end of repositories:
:repositories [["jitpack" "https://jitpack.io"]]
Step 2. Add the dependency
dependencies {
implementation 'com.github.ran-jit:TomcatClusterRedisSessionManager:4.0'
} dependencies {
implementation("com.github.ran-jit:TomcatClusterRedisSessionManager:4.0")
} <dependency>
<groupId>com.github.ran-jit</groupId>
<artifactId>TomcatClusterRedisSessionManager</artifactId>
<version>4.0</version>
</dependency>
libraryDependencies += "com.github.ran-jit" % "TomcatClusterRedisSessionManager" % "4.0"
:dependencies [[com.github.ran-jit/TomcatClusterRedisSessionManager "4.0"]]
Readme
Tomcat Clustering Redis Session Manager
The Redis session manager is pluggable one. It stores session into Redis for easy distribution of HTTP Requests across a cluster of Tomcat servers.
Here the Sessions are implemented as non-sticky (means, each request can able to go to any server in the cluster, unlike the Apache provided Tomcat clustering setup.)
Request Sessions will be stored into Redis immediately (Session attributes must be Serializable), for the use of other servers. When tomcat receives a request from the client, Sessions are loaded directly from Redis.
Supports Redis default, sentinel and cluster mode, based on the configuration.
Going forward, we no need to enable sticky session (JSESSIONID) in Load Balancer.
Supports:
- Apache Tomcat 7
- Apache Tomcat 8
- Apache Tomcat 9
- Apache Tomcat 10
Downloads: 
<p align="center">
<a href="https://www.buymeacoffee.com/ranmanic" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-red.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
</p>
Maven configuration
<repository>
<id>repsy</id>
<name>tomcat-cluster-redis-session-manager-repo</name>
<url>https://repo.repsy.io/mvn/ranmanic/tomcat-session-manager</url>
</repository>
<dependency>
<groupId>tomcat-session-manager</groupId>
<artifactId>redis</artifactId>
<version>4.0</version>
</dependency>
Pre-requisite:
- jedis.jar
- commons-pool2.jar
- commons-logging.jar
more details.. https://github.com/ran-jit/tomcat-cluster-redis-session-manager/wiki
Steps to be done,
- Copy the downloaded jars to your tomcat/lib directory.
tomcat/lib/
- Add tomcat system property "catalina.base".
catalina.base="TOMCAT_LOCATION"
example: env "catalina.base=/opt/tomcat" bash
- Copy the redis-data-cache.properties file to your tomcat/conf directory and update your Redis server details.
tomcat/conf/redis-data-cache.properties
- Add the below two lines in your tomcat/conf/context.xml file.
<Valve className="tomcat.request.session.redis.SessionHandlerValve" />
<Manager className="tomcat.request.session.redis.SessionManager" />
- Verify the session expiration time in tomcat/conf/web.xml file.
<session-config>
<session-timeout>60</session-timeout>
</session-config>
Note:
- All your session attribute values must implement java.io.Serializable.