Rally/installation/manual

Manual installation

Prerequisites

Start with installing some requirements that Rally needs to be set up correctly. The specific requirements depend on the environment you are going to install Rally in:

Ubuntu

 sudo apt-get update
 sudo apt-get install libpq-dev git-core python-dev libevent-dev libssl-dev libffi-dev libsqlite3-dev
 curl -o /tmp/get-pip.py https://raw.github.com/pypa/pip/master/contrib/get-pip.py
 sudo python /tmp/get-pip.py
 sudo pip install pbr

CentOS

 sudo yum install gcc git-core postgresql-libs python-devel libevent-devel openssl-devel libffi-devel sqlite
 #install pip on centos:
 curl -o /tmp/get-pip.py https://raw.github.com/pypa/pip/master/contrib/get-pip.py
 sudo python /tmp/get-pip.py
 sudo pip install pbr

VirtualEnv

Another option is to install Rally in virtualenv; you should then install this package, create a virtualenv and activate it:

 sudo pip install -U virtualenv
 virtualenv .venv
 . .venv/bin/activate  # NOTE: Make sure that your current shell is either bash or zsh (otherwise it will fail)
 sudo pip install pbr

Installing Rally

The next step is to clone & install rally:

 git clone https://github.com/stackforge/rally.git && cd rally
 sudo python setup.py install

Now you are ready to configure Rally (in oder for it to be able to use the database):

 sudo mkdir /etc/rally 
 sudo cp etc/rally/rally.conf.sample /etc/rally/rally.conf
 sudo vim /etc/rally/rally.conf
 # Change the "connection" parameter, For example to this: 
 connection="sqlite://///home/<your_username>/.venv/rally-db/$sqlite_db" #(or any other place)

After the installation step has been completed, you need to create the Rally database:

 rally-manage db recreate

And finally you are able to use Rally!