Tutorial

This tutorial covers getting started with split on a Rails 3.0 app.

Installation

First lets create our rails app:

$ gem install rails
$ rails new split-example
$ cd split-example

We'll also need redis (2.0 or greater) installed on for split to store its data.

If you are on a mac, you can install redis using homebrew:

$ brew install redis

And then follow the instructions.

If you are on ubuntu or debian you can install redis using apt-get:

$ sudo apt-get install redis-server

Otherwise you can compile it from source using he instructions on the redis.io website: http://redis.io/download

Note: redis is not officially supported on windows

Then we need to add split as a dependency, so we add the following to our Gemfile:

gem 'split'

If you are using Ruby 1.8.x then you will likely want to also use the SystemTimer gem if you want to make sure the Redis client will not hang.

Put the following in your gemfile as well:

gem 'SystemTimer'

Then update your bundle with:

$ bundle install