cassandra-sessions/README.markdown

cassandra-sessions
==================

This is a session backend for Django that stores sessions in Cassandra

The advantage to using this over other solutions is that your data is persistent
unlike memcached, and Cassandra is designed to store key-value data like
this, so performance is much closer to that of memcached than with a database.

Note: This work was initially based off of [tokyo-tyrant-sessions](http://github.com/ericflo/django-tokyo-sessions) by @ericflo.

Dependencies
------------
* [Lazyboy](http://github.com/ieure/lazyboy/) (Use Ian Eure's version as it supports 0.6.1 of Cassandra)

Installing cassandra-sessions
-----------------------------

1.  download the source and run 

       `python setup.py install`


2. Set 'cassandra-sessions' as your session engine, like so:

       `SESSION_ENGINE = 'cassandra-sessions'`


3. Add settings describing where to connect to Cassandra:

    `CASSANDRA_POOL = ('127.0.0.1:9160',)  
    CASSANDRA_SESSION_KEYSPACE = 'Testing'`


4. Create the Keyspace and Column Family in Cassandra:

    `<Keyspace Name="Testing">  
      <ColumnFamily Name="Sessions" CompareWith="UTF8Type"/>  
      <ReplicaPlacementStrategy>org.apache.cassandra.locator.RackUnawareStrategy</ReplicaPlacementStrategy>  
      <ReplicationFactor>1</ReplicationFactor>  
      <EndPointSnitch>org.apache.cassandra.locator.EndPointSnitch</EndPointSnitch>  
    </Keyspace>`