aboutsummaryrefslogtreecommitdiffstats
path: root/docs/userguides
diff options
context:
space:
mode:
authorMartin Klozik <martinx.klozik@intel.com>2016-01-19 14:17:05 +0000
committerMaryam Tahhan <maryam.tahhan@intel.com>2016-01-21 09:42:29 +0000
commit2a2baf3f5f348539b50194a456b49b4ccb32b775 (patch)
tree5ee84aa556d51c80ec2e056bf9bcb4ae11e26c3a /docs/userguides
parenta64311b5ba40d31e438732979eb97cc8e94e7a6e (diff)
docs: installation guide update
Installation guide should be OS agnostic. Change-Id: Idba63925a27fd204c6542ca886381a56c0415dab JIRA: VSPERF-150 Signed-off-by: Martin Klozik <martinx.klozik@intel.com> Reviewed-by: Maryam Tahhan <maryam.tahhan@intel.com>
Diffstat (limited to 'docs/userguides')
-rwxr-xr-xdocs/userguides/installation.rst45
1 files changed, 33 insertions, 12 deletions
diff --git a/docs/userguides/installation.rst b/docs/userguides/installation.rst
index bd47519a..abd09cb4 100755
--- a/docs/userguides/installation.rst
+++ b/docs/userguides/installation.rst
@@ -3,13 +3,13 @@ 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 (`a link`_) should be enabled.
+packages. These need to be installed for the test suite to function.
+
+Installation of required packages, preparation of Python 3 virtual
+environment and compilation of OVS, DPDK and QEMU is performed by
+script **systems/build_base_machine.sh**. It should be executed under
+user account, which will be used for vsperf execution.
-Installation of required packages and preparation of Python 3 virtual
-environment is performed by systems/build_base_machine.sh. It should be
-executed under user account, which will be used for vsperf execution.
Please Note: Password-less sudo access must be configured for given
user account before script is executed.
@@ -21,16 +21,29 @@ Execution of installation script:
$ ./build_base_machine.sh
Please note: you don't need to go into any of the systems subdirectories,
-simply run the top level build_base_machine.sh, your OS will be detected
+simply run the top level **build_base_machine.sh**, your OS will be detected
automatically.
-build_base_machine.sh will install all the vsperf dependencies in terms of
-system packages and Python modules, it will also use `virtualenv`_ to create a
-vsperf virtual environment that's isolated from the default Python env. This
-environment will reside in a directory called vsperfenv in $HOME.
+Currently supported operating systems are:
+
+ - CentOS 7
+ - Fedora 20
+ - Fedora 21
+ - Fedora 22
+ - Ubuntu 14.04
+
+Script **build_base_machine.sh** will install all the vsperf dependencies
+in terms of system packages, Python 3.x and required Python modules.
+In case of CentOS 7 it will install Python 3.3 from an additional repository
+provided by Software Collections (`a link`_). Installation script will also
+use `virtualenv`_ to create a vsperf virtual environment, which is isolated
+from the default Python environment. This environment will reside
+in a directory called **vsperfenv** in $HOME.
You will need to activate the virtual environment every time you start a
-new shell session. To activate, simple run:
+new shell session. Its activation is specific to your OS:
+
+CentOS 7:
.. code:: bash
@@ -38,6 +51,14 @@ new shell session. To activate, simple run:
$ cd $HOME/vsperfenv
$ source bin/activate
+Fedora and Ubuntu:
+
+.. code:: bash
+
+ $ cd $HOME/vsperfenv
+ $ source bin/activate
+
+
--------------
Working Behind a Proxy