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

Update README.md

Browse Source
session-42
Ranjith Manickam 6 years ago committed by GitHub
parent 11e7525e32
commit 02004d5bd0
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File

21
README.md
Unescape View File

@ -1,12 +1,14 @@
# Tomcat Clustering Redis Session Manager # 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 Redis session manager is pluggable one. It stores session into Redis for easy distribution of HTTP Requests across a cluster of Tomcat servers.
The HTTP Requests session setAttribute(name, value) method stores the session into Redis (session attribute values 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. 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.)
Supports redis default, sentinel and cluster mode, based on the configuration. 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.
Going forward, we no need to enable sticky session (JSESSIONID) in Load balancer. 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: ## Supports:
- Apache Tomcat 7 - Apache Tomcat 7
@ -26,28 +28,27 @@ more details.. https://github.com/ran-jit/tomcat-cluster-redis-session-manager/w
#### Steps to be done, #### Steps to be done,
1. Move the downloaded jars to tomcat/lib directory 1. Copy the downloaded jars to your tomcat/lib directory.
- **tomcat/lib/** - **tomcat/lib/**
2. Add tomcat system property "catalina.base" 2. Add tomcat system property "catalina.base".
- **catalina.base="TOMCAT_LOCATION"** - **catalina.base="TOMCAT_LOCATION"**
* example: export catalina.base=/opt/tomcat * example: export catalina.base=/opt/tomcat
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 3. Copy the redis-data-cache.properties file to your tomcat/conf directory and update your Redis server details.
- **tomcat/conf/redis-data-cache.properties** - **tomcat/conf/redis-data-cache.properties**
4. Add the below two lines in tomcat/conf/context.xml 4. Add the below two lines in your tomcat/conf/context.xml file.
- **<Valve className="tomcat.request.session.redis.SessionHandlerValve" />** - **<Valve className="tomcat.request.session.redis.SessionHandlerValve" />**
- **<Manager className="tomcat.request.session.redis.SessionManager" />** - **<Manager className="tomcat.request.session.redis.SessionManager" />**
5. Verify the session expiration time in tomcat/conf/web.xml 5. Verify the session expiration time in tomcat/conf/web.xml file.
- **<session-config>** - **<session-config>**
-         **<session-timeout>60</session-timeout>** -         **<session-timeout>60</session-timeout>**
- **</session-config>** - **</session-config>**
### Note: ### Note:
- **All your session attribute values must implement java.io.Serializable.** - **All your session attribute values must implement java.io.Serializable.**
- Supports redis default, sentinel and cluster mode, based on the redis-data-cache.properties configuration.
### Configuration Properties: ### Configuration Properties:
<html> <html>

Write Preview
Loading…
Cancel
Save