Installation

Because OVN Scale Test is mostly a plugin of Rally, you should install Rally firstly, then install it on top of Rally.

Install Rally

Rally is dedicated to OpenStack now(this situation will be change soon, Rally developers are splitting Rally from OpenStack: Rally Brainstorm), OVN Scale Test makes some changes on Rally to skip OpenStack specific code, and these changes have not been pushed to Rally upstream. Hence you need to use a forked Rally from repo https://github.com/l8huang/rally.git, you can clone it and install it by running its installation script:

$ git clone https://github.com/l8huang/rally.git
$ cd rally
$ ./install_rally.sh

If you execute the script as regular user, Rally will create a new virtual environment in ~/rally/ and install in it, and will use sqlite as database backend. If you execute the script as root, Rally will be installed system wide. For more installation options, please refer to the Rally installation page.

Note: Rally requires Python version 2.7 or 3.4.

Install OVN Scale Test

After Rally is installed, you can install OVN Scale Test now. Get a copy of it from repo https://github.com/openvswitch/ovn-scale-test.git:

$ git clone https://github.com/openvswitch/ovn-scale-test.git
$ cd ovn-scale-test
$ ./install.sh

If installed successful, you can see:

======================================
Installation of OVN scale test is done!
=======================================

In order to work with Rally you have to enable the virtual environment
with the command:

    . /home/<user>/rally/bin/activate

You need to run the above command on every new shell you opened before
using Rally, but just once per session.

Information about your Rally installation:

  * Method: virtualenv
  * Virtual Environment at: /home/<user>/rally
  * Configuration file at: /home/<user>/rally/etc/rally
  * Samples at: /home/<user>/rally/samples

Run ./install.sh with option --help to have a list of all available options:

$ ./install.sh --help
Usage: install.sh [options]

This script will install OVN scale test tool in your system.

Options:
  -h, --help             Print this help text
  -v, --verbose          Verbose mode
  -s, --system           Install system-wide.
  -d, --target DIRECTORY Install Rally virtual environment into DIRECTORY.
                         (Default: /home/lhuang8/rally if not root).
  --url                  Git repository public URL to download Rally OVS from.
                         This is useful when you have only installation script and want to install Rally
                         from custom repository.
                         (Default: https://github.com/l8huang/rally-ovs.git).
                         (Ignored when you are already in git repository).
  --branch               Git branch name name or git tag (Rally OVS release) to install.
                         (Default: latest - master).
                         (Ignored when you are already in git repository).
  -y, --yes              Do not ask for confirmation: assume a 'yes' reply
                         to every question.
  -p, --python EXE       The python interpreter to use. Default: /home/lhuang8/rally/bin/python
  --develop              Install Rally with editable source code try.
                         (Default: false)
  --no-color             Disable output coloring.

Notes: --system option is not supported yet.