summaryrefslogtreecommitdiffstats
path: root/docs/to-be-reorganized/installation.rst
blob: 90de7a0a273aa9ef942c8e3bdbc8a032129115a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
Installing vswitchperf
======================

The test suite requires Python 3.3 and relies on a number of other
packages. These need to be installed for the test suite to function. To
install Python 3.3 in CentOS 7, an additional repository, Software
Collections (see
https://www.softwarecollections.org/en/scls/rhscl/python33) should be
enabled.

Install the requirements as specified below.

Enable Software Collections (SCL)
---------------------------------

  .. code-block:: console

   yum -y install scl-utils
   yum -y install https://www.softwarecollections.org/en/scls/rhscl/python33/epel-7-x86_64/download/rhscl-python33-epel-7-x86_64.noarch.rpm

(Optional) Enable Repoforge (for stress)
----------------------------------------
Allows optional installation of stress tool, which is required by load tests.

  .. code-block:: console

   yum -y install http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.3-1.el7.rf.x86_64.rpm

System packages
-----------------
There are a number of packages that must be installed using `yum`. These can be installed like so:

  .. code-block:: console

   yum -y --exclude=python33-mod_wsgi* install python33-* pciutils

Optional installation of stress tool

  .. code-block:: console

   yum -y install stress

Python 3 Packages
-----------------

To avoid file permission errors and Python version issues, use
virtualenv to create an isolated environment with Python3. The required
Python 3 packages can be found in the ``requirements.txt`` file in the
root of the test suite. They can be installed in your virtual
environment like so:

  .. code-block:: bash

    scl enable python33 bash
    # Create virtual environment
    virtualenv vsperfenv
    cd vsperfenv
    source bin/activate
    pip install -r requirements.txt

You need to activate the virtual environment every time you start a new
shell session. To activate, simple run:

.. code:: bash

    scl enable python33 bash
    cd vsperfenv
    source bin/activate

--------------

Working Behind a Proxy
======================

If you're behind a proxy, you'll likely want to configure this before
running any of the above. For example:

  .. code:: bash

    export http_proxy=proxy.mycompany.com:123
    export https_proxy=proxy.mycompany.com:123