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

74 lines
4.4 KiB

# Tomcat Clustering Redis Session Manager
6 years ago
The Redis session manager is pluggable one. It stores session into Redis for easy distribution of HTTP Requests across a cluster of Tomcat servers.
6 years ago
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.)
6 years ago
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.
6 years ago
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:
5 years ago
- [latest version (3.0.4)](https://github.com/ran-jit/tomcat-cluster-redis-session-manager/releases/tag/3.0.4)
- [older versions](https://github.com/ran-jit/tomcat-cluster-redis-session-manager/wiki)
5 years ago
<p align="center">
5 years ago
<a href="https://paypal.me/ranmanic1" target="_blank"><img alt="Donate" height="30%" width="30%" src="https://github.com/ran-jit/tomcat-cluster-redis-session-manager/blob/master/src/main/resources/donate.png"></a>
5 years ago
</p>
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,
6 years ago
1. Copy the downloaded jars to your tomcat/lib directory.
- **tomcat/lib/**
6 years ago
2. Add tomcat system property "catalina.base".
- **catalina.base="TOMCAT_LOCATION"**
5 years ago
* example: env "catalina.base=/opt/tomcat" bash
6 years ago
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**
6 years ago
4. Add the below two lines in your tomcat/conf/context.xml file.
- **&#60;Valve className="tomcat.request.session.redis.SessionHandlerValve" &#47;&#62;**
- **&#60;Manager className="tomcat.request.session.redis.SessionManager" &#47;&#62;**
6 years ago
5. Verify the session expiration time in tomcat/conf/web.xml file.
- **&#60;session-config&#62;**
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; **&#60;session-timeout&#62;60&#60;&#47;session-timeout&#62;**
- **&#60;&#47;session-config&#62;**
### Note:
- **All your session attribute values must implement java.io.Serializable.**
### Configuration Properties:
<html>
<body>
<table border="1px" style="width: 80%;margin-left: 10%;margin-right: 10%;line-height: 1.5;">
<tr><th style="width: 30%;">Property</th><th style="width: 50%;">Description</th></tr>
<tr><td>redis.hosts</td><td>Redis server running instance IP address and port number<br/>- ex: 127.0.0.1:6379, 127.0.0.2:6379, 127.0.0.2:6380, ..<br/>- default: 127.0.0.1:6379</td></tr>
<tr><td>redis.password</td><td>Redis protected password</td></tr>
<tr><td>redis.database</td><td>Redis database selection. (Numeric value)<br/>- default: 0</td></tr>
<tr><td>redis.timeout</td><td>Redis connection timeout<br/>- default: 2000 ms</td></tr>
<tr><td>redis.cluster.enabled</td><td>To enable redis cluster mode<br/>- default: false<br>- supported values: true/false</td></tr>
<tr><td>redis.sentinel.enabled</td><td>To enable redis sentinel mode<br/>- default: false<br>- supported values: true/false</td></tr>
<tr><td>redis.sentinel.master</td><td>Redis sentinel master name<br/>- 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>- default: false</td></tr>
5 years ago
<tr><td>session.persistent.policies</td><td>session persistent policies.<br/><br/>- policies - DEFAULT, SAVE_ON_CHANGE, ALWAYS_SAVE_AFTER_REQUEST <br/><ol><li>SAVE_ON_CHANGE: every time session.setAttribute() or session.removeAttribute() is called the session will be saved.</li><li>ALWAYS_SAVE_AFTER_REQUEST: force saving after every request, regardless of whether or not the manager has detected changes to the session.</li></ol>- default: DEFAULT</td></tr>
</table>
</body>
</html>