Jump to: navigation, search

Difference between revisions of "Rally/installation"

(Rally setup: Add the 'Automated installation' section.)
 
(24 intermediate revisions by 7 users not shown)
Line 1: Line 1:
= Rally setup =
 
  
The simplest way to start using Rally is to install it together with OpenStack using 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.
+
<big>'''Rally wiki documentation is obsolete.'''</big>
  
== Automated installation ==
+
''Everything moved to https://rally.readthedocs.org''
  
NOTE: Please ensure that you have installed either the Python 2.6 or the Python 2.7 version in the system that you are planning to install Rally.
+
Here is [https://rally.readthedocs.org/en/latest/install.html Rally Installation Guide]
 
 
The installation script of Rally supports 2 installation methods:
 
* system-wide (default)
 
* in a virtual environment using the virtualenv tool
 
 
 
 
 
On the target system, get the source code of Rally:
 
 
 
  git clone https://git.openstack.org/stackforge/rally
 
 
 
As root, or as a normal user using sudo, execute the installation script. If you define the -v switch, Rally will be installed in a virtual environment, otherwise, it will be installed system-wide.
 
 
 
  # install system-wide
 
  ./rally/tools/install_rally.sh
 
 
 
  # install in a virtual environment
 
  ./rally/tools/install_rally.sh -v
 
 
 
== Rally with DevStack all in one installation ==
 
To install Rally with DevStack, you should first clone the corresponding repositories and copy the files necessary to integrate Rally with DevStack:
 
 
 
  git clone https://github.com/openstack-dev/devstack
 
  git clone https://github.com/stackforge/rally
 
 
 
To configure DevStack to run Rally:
 
  cp rally/contrib/devstack/lib/rally devstack/lib/
 
  cp rally/contrib/devstack/extras.d/70-rally.sh devstack/extras.d/
 
  cd devstack
 
  echo "enable_service rally" >> localrc
 
 
 
Finally, run DevStack as usually:
 
 
 
  ./stack.sh
 
 
 
'''<big>And finally you are able to [[Rally/HowTo | use Rally!]]</big>'''
 
 
 
 
 
== 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 libffi-dev
 
  sudo pip install pbr
 
 
 
'''CentOS'''
 
  sudo yum install gcc git-core postgresql-libs python-devel libevent-devel openssl-devel libffi-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 [https://github.com/stackforge/rally/blob/c8508134c05bbffde9f9422029d48adb1a0f38ea/etc/rally/rally.conf.sample#L145 ''"connection"'' parameter],
 
  # e.g. to ''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
 
 
 
'''<big>And finally you are able to [[Rally/HowTo | use Rally!]]</big>'''
 
 
 
== 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
 

Latest revision as of 00:46, 27 February 2015

Rally wiki documentation is obsolete.

Everything moved to https://rally.readthedocs.org

Here is Rally Installation Guide