1 Star 0 Fork 0

刘程/tomcat-cluster-redis-session-manager

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

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

Downloads:

Pre-requisite:

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

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"
      • edit the tomcat/bin/catalina.sh add JAVA_OPTS for example:
      JAVA_OPTS='-Dcatalina.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

    • 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:

PropertyDescription
redis.hostsRedis server running instance IP address and port number
- ex: 127.0.0.1:6379, 127.0.0.2:6379, 127.0.0.2:6380, ..
- default: 127.0.0.1:6379
redis.passwordRedis protected password
redis.databaseRedis database selection. (Numeric value)
- default: 0
redis.timeoutRedis connection timeout
- default: 2000 ms
redis.cluster.enabledTo enable redis cluster mode
- default: false
- supported values: true/false
redis.sentinel.enabledTo enable redis sentinel mode
- default: false
- supported values: true/false
redis.sentinel.masterRedis sentinel master name
- default: mymaster
lb.sticky-session.enabledTo enable redis and standard session mode

If enabled,
  1. Must be enabled sticky session in your load balancer configuration. Else this manager may not return the updated session values
  2. Session values are stored in local jvm and redis
  3. If redis is down/not responding, requests uses jvm stored session values to process user requests. Redis comes back the values will be synced
- default: false

空文件

简介

取消

发行版

暂无发行版

贡献者

全部

近期动态

不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/chan_lewis/tomcat-cluster-redis-session-manager.git
git@gitee.com:chan_lewis/tomcat-cluster-redis-session-manager.git
chan_lewis
tomcat-cluster-redis-session-manager
tomcat-cluster-redis-session-manager
master

搜索帮助