summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorMaryam Tahhan <maryam.tahhan@intel.com>2015-11-08 11:50:48 +0000
committerMaryam Tahhan <maryam.tahhan@intel.com>2015-11-26 15:01:54 +0000
commit0606ef6290ac1e41468f57b0ef2ff1d0571aee3e (patch)
treed8669b9360b115213d8dff2facbd3a5d52a25502 /docs
parent27e73259399032657fef7c43c33d55715aa95ba0 (diff)
docs: update installation guide and gsg.
Update installation guide and gsg to include latest updates to vsperf build and installation. JIRA: VSPERF-127 Change-Id: I773ea240eb90e191f4f53ed977651056817413f1 Signed-off-by: Maryam Tahhan <maryam.tahhan@intel.com> Reviewed-by: Billy O'Mahony <billy.o.mahony@intel.com> Reviewed-by: Martin Klozik <martinx.klozik@intel.com>
Diffstat (limited to 'docs')
-rwxr-xr-xdocs/guides/installation.rst14
-rwxr-xr-xdocs/guides/quickstart.rst70
2 files changed, 73 insertions, 11 deletions
diff --git a/docs/guides/installation.rst b/docs/guides/installation.rst
index 272993ef..5047dce4 100755
--- a/docs/guides/installation.rst
+++ b/docs/guides/installation.rst
@@ -11,8 +11,8 @@ enabled.
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.
-Password less sudo access must be configured for given user account
-before script is executed.
+Please Note: Password-less sudo access must be configured for given
+user account before script is executed.
Execution of installation script:
@@ -21,13 +21,17 @@ Execution of installation script:
cd systems
./build_base_machine.sh
-You need to activate the virtual environment every time you start a new
-shell session. To activate, simple run:
+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
+automatically.
+
+You will 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
+ cd $HOME/vsperfenv
source bin/activate
--------------
diff --git a/docs/guides/quickstart.rst b/docs/guides/quickstart.rst
index 630da7da..7af068d2 100755
--- a/docs/guides/quickstart.rst
+++ b/docs/guides/quickstart.rst
@@ -123,6 +123,16 @@ access method, use:
make VHOST_USER=y
+To build everything: Vanilla OVS, OVS with vhost_user as the guest access
+method and OVS with vhost_cuse access simply:
+ .. code-block:: console
+
+ make
+
+The vhost_user build will reside in src/ovs/
+The vhost_cuse build will reside in vswitchperf/src_cuse
+The Vanilla OVS build will reside in vswitchperf/src_vanilla
+
To delete a src subdirectory and its contents to allow you to re-clone simply
use:
@@ -132,7 +142,8 @@ use:
Configure the ``./conf/10_custom.conf`` file
--------------------------------------------
-
+The ``10_custom.conf`` file is the configuration file that overrides
+default configurations in all the other configuration files in ``./conf``
The supplied ``10_custom.conf`` file must be modified, as it contains
configuration items for which there are no reasonable default values.
@@ -144,8 +155,9 @@ the custom configuration value.
Using a custom settings file
----------------------------
-Alternatively a custom settings file can be passed to ``vsperf`` via the
-``--conf-file`` argument.
+If your ``10_custom.conf`` doesn't reside in the ``./conf`` directory
+of if you want to use an alternative configuration file, the file can
+be passed to ``vsperf`` via the ``--conf-file`` argument.
.. code-block:: console
@@ -178,7 +190,15 @@ To list the available tests:
.. code-block:: console
- ./vsperf --list-tests
+ ./vsperf --list
+
+To run a single test:
+
+ .. code-block:: console
+
+ ./vsperf $TESTNAME
+
+Where $TESTNAME is the name of the vsperf test you would like to run.
To run a group of tests, for example all tests with a name containing
'RFC2544':
@@ -200,7 +220,7 @@ Some tests allow for configurable parameters, including test duration
./vsperf --conf-file user_settings.py
--tests RFC2544Tput
- --test-param "rfc2544_duration=10;packet_sizes=128"
+ --test-param "duration=10;pkt_sizes=128"
For all available options, check out the help dialog:
@@ -208,7 +228,45 @@ For all available options, check out the help dialog:
./vsperf --help
-Executing PVP and PVVP tests
+Executing Vanilla OVS tests
+----------------------------
+If you have compiled all the variants of OVS in ''src/'' please skip
+step 1.
+
+1. Recompile src for Vanilla OVS testing
+
+ .. code-block:: console
+
+ cd src
+ make cleanse
+ make WITH_LINUX=/lib/modules/`uname -r`/build
+
+2. Update your ''10_custom.conf'' file to use the appropriate variables
+for Vanilla OVS:
+ .. code-block:: console
+
+ VSWITCH = 'OvsVanilla'
+ VSWITCH_VANILLA_PHY_PORT_NAMES = ['$PORT1', '$PORT1']
+
+Where $PORT1 and $PORT2 are the Linux interfaces you'd like to bind
+to the vswitch.
+
+3. Run test:
+
+ .. code-block:: console
+
+ ./vsperf --conf-file <path_to_settings_py>
+
+Please note if you don't want to configure Vanilla OVS through the
+configuration file, you can pass it as a CLI argument; BUT you must
+set the ports.
+
+ .. code-block:: console
+
+ ./vsperf --vswitch OvsVanilla
+
+
+ Executing PVP and PVVP tests
----------------------------
To run tests using vhost-user as guest access method: