Jump to: navigation, search

Difference between revisions of "Rally/installation"

(Automated installation)
(Rally setup)
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.
[https://rally.readthedocs.org/en/latest/install.html Rally Installation Guide]
Please Note: '''Running Rally on OSX is not advised as some pip dependencies will fail to install.'''
== Automated installation ==
'''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.'''
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:'''
'''Or install in a virtual environment:'''
  ./rally/install_rally.sh -v
'''Now you are able to [[Rally/HowTo | use Rally!]]'''
''Note instruction for full manual installation can be found [[Rally/installation/manual | here]]''
== 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:
'''<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'

Revision as of 00:20, 27 February 2015

Rally Installation Guide