Difference between revisions of "Rally/installation"
m (→Rally setup) |
m (→Rally setup) |
||
Line 65: | Line 65: | ||
sudo cp etc/rally/rally.conf.sample /etc/rally/rally.conf | sudo cp etc/rally/rally.conf.sample /etc/rally/rally.conf | ||
sudo vim /etc/rally/rally.conf | sudo vim /etc/rally/rally.conf | ||
− | # Change the ''"connection"'' parameter in line 145, e.g. to ''connection="~/.rally/"'' (or any other place) | + | # Change the ''"connection"'' parameter in line 145, |
+ | # e.g. to ''connection="~/.rally/"'' (or any other place) | ||
After the installation step has been completed, you need to create the Rally database: | After the installation step has been completed, you need to create the Rally database: |
Revision as of 17:48, 15 February 2014
Contents
Rally setup
The simplest way to start using Rally is to install it as a part of DevStack. If you already have an existing OpenStack installation and/or don't want to install DevStack, then the preferable way to set up Rally would be to install it manually. Both types of installation are described below in full detail.
Rally with DevStack all in one installation
The contrib/devstack/ directory of the Rally repository contains the files necessary to integrate Rally with DevStack. These files are used below while configuring DevStack.
To install:
DEVSTACK_DIR=.../path/to/devstack cp lib/rally ${DEVSTACK_DIR}/lib cp extras.d/70-rally.sh ${DEVSTACK_DIR}/extras.d
To configure DevStack to run Rally:
cd ${DEVSTACK_DIR} echo "enable_service rally" >> localrc
Finally, run DevStack as usually:
./stack.sh
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 python-pip sudo pip install pbr
CentOS
sudo yum install gcc git-core postgresql-libs python-devel libevent-devel openssl-devel #install pip on centos: curl -o /tmp/ez_setup.py https://sources.rhodecode.com/setuptools/raw/bootstrap/ez_setup.py sudo /usr/bin/python /tmp/ez_setup.py sudo /usr/bin/easy_install pip sudo rm setuptools-*.tar.gz sudo pip install -i https://pypi.rhodecode.com/ --upgrade pip 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 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 in line 145, # e.g. to connection="~/.rally/" (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 it
Running Rally's Unit Tests
Rally should be tested with tox, but is not compatible with the current version of tox, so install tox 1.6.1 then run it.
pip install 'tox<=1.6.1' tox