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.
tomcat-cluster-redis-sessio.../README.md

68 lines
4.0 KiB

# 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 (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.
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
7 years ago
## Downloads:
- [latest version (3.0)](https://github.com/ran-jit/tomcat-cluster-redis-session-manager/releases/tag/3.0)
- [older versions](https://github.com/ran-jit/tomcat-cluster-redis-session-manager/wiki)
7 years ago
#### Pre-requisite:
1. jedis.jar
2. commons-pool2.jar
3. commons-logging.jar
7 years ago
more details.. https://github.com/ran-jit/tomcat-cluster-redis-session-manager/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"**
* example: export catalina.base=/opt/tomcat
7 years ago
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:
- **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:
<html>
<body>
<table border="1px" style="width: 80%;margin-left: 10%;margin-right: 10%;line-height: 1.5;">
<tr><th style="width: 20%;">Property</th><th style="width: 40%;">Description</th><th style="width: 30%;">Value</th></tr>
<tr><td>redis.hosts</td><td>Redis server running instance IP address and port number</td><td>default: 127.0.0.1:6379<br>ex: 127.0.0.1:6379, 127.0.0.2:6379, 127.0.0.2:6380, ....</td></tr>
<tr><td>redis.password</td><td>Redis protected password</td><td></td></tr>
<tr><td>redis.database</td><td>Redis database selection. (Numeric value)</td><td>default: 0</td></tr>
<tr><td>redis.timeout</td><td>Redis connection timeout</td><td>default: 2000</td></tr>
<tr><td>redis.cluster.enabled</td><td>To enable redis cluster mode</td><td>default: false<br>supported values: true/false</td></tr>
<tr><td>redis.sentinel.enabled</td><td>To enable redis sentinel mode</td><td>default: false<br>supported values: true/false</td></tr>
<tr><td>redis.sentinel.master</td><td>Redis sentinel master name</td><td>default: mymaster</td></tr>
<tr><td>lb.sticky-session.enabled</td><td>To enable redis and standard session mode<br><br>If enabled,<ol><li>Must be enabled sticky session in your load balancer configuration. Else this manager may not return the updated session values</li><li>Session values are stored in local jvm and redis</li><li>If redis is down/not responding, requests uses jvm stored session values to process user requests. Redis comes back the values will be synced</li></ol></td><td>default: false</td></tr>
</table>
</body>
</html>