https://github.com/magro/memcached-session-manager

A tomcat session manager that backups sessions in memcached and pulls them from there if asked for unknown sessions
https://github.com/magro/memcached-session-manager

Last synced: 10 months ago
JSON representation

A tomcat session manager that backups sessions in memcached and pulls them from there if asked for unknown sessions

• Host: GitHub
• URL: https://github.com/magro/memcached-session-manager
• Owner: magro
• License: apache-2.0
• Created: 2009-03-17T14:35:13.000Z (about 17 years ago)
• Default Branch: master
• Last Pushed: 2023-12-17T15:47:24.000Z (about 2 years ago)
• Last Synced: 2025-04-22T02:07:19.324Z (11 months ago)
• Language: Java
• Homepage:
• Size: 5.54 MB
• Stars: 757
• Watchers: 91
• Forks: 349
• Open Issues: 111
• Metadata Files:
  • Readme: README.markdown

Awesome Lists containing this project

• awesome-java - Memcached Session Manager

README

          
# memcached session manager

[![Join the chat at https://gitter.im/memcached-session-manager/Lobby](https://badges.gitter.im/memcached-session-manager/Lobby.svg)](https://gitter.im/memcached-session-manager/Lobby)

[![Build Status](https://travis-ci.org/magro/memcached-session-manager.svg?branch=master)](https://travis-ci.org/magro/memcached-session-manager)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/de.javakaffee.msm/memcached-session-manager/badge.svg)](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22de.javakaffee.msm%22)

memcached-session-manager is a tomcat session manager that keeps sessions in memcached or Redis, for highly available, scalable and fault tolerant web applications.

It supports both sticky and non-sticky configurations, and is currently working with tomcat 6.x, 7.x, 8.x and 9.x. For sticky sessions session failover (tomcat crash)

is supported, for non-sticky sessions this is the default (a session is served by default by different tomcats for different requests).

Also memcached failover (memcached crash) is supported via migration of sessions. There shall also be no single point of failure, so when a memcached fails

the session will not be lost (but either be available in tomcat or in another memcached).

## Installation and Configuration

Basically you must put the spymemcached jar and the memcached-session-manager jars into tomcat's lib folder.

If you want to use Redis instead of memcached, you need the jar of the Redis client "jedis" instead.

Additionally you must set the Manager class and add some configuration attributes. This is described in detail in the

[SetupAndConfiguration wiki page](https://github.com/magro/memcached-session-manager/wiki/SetupAndConfiguration).

## Where to get help

Checkout the [wiki](https://github.com/magro/memcached-session-manager/wiki) for documentation, contact the

[mailing list](http://groups.google.com/group/memcached-session-manager) or [submit an issue](https://github.com/magro/memcached-session-manager/issues).

## How to contribute

If you want to contribute to this project you can fork this project, make your changes and submit a [pull request](https://help.github.com/articles/using-pull-requests/).

Or you start on the [mailing list](http://groups.google.com/group/memcached-session-manager) and we'll see how we can work together.

## Samples

There's [sample webapp](https://github.com/magro/memcached-session-manager/tree/master/samples) that allows to run tomcat+msm in different configurations,

both sticky and non-sticky etc, just checkout the [README](https://github.com/magro/memcached-session-manager/tree/master/samples).

## License

The license is Apache 2.0, see LICENSE.txt.