initial commit

README.markdown

@@ -0,0 +1,38 @@
+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.
+
+Installing cassandra-sessions
+-----------------------------
+
+1. Either download the tarball and run 'python setup.py install', or simply
+   use easy install or pip like so 'easy_install cassandra-sessions'.
+
+
+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>
+
+That's it.  Hopefully this backend gives you all the better performance while
+still not sacrificing persistence.