From a481bc50312bca310dae224dd334b69992fb3d19 Mon Sep 17 00:00:00 2001 From: Maryam Tahhan Date: Wed, 24 Feb 2016 21:11:18 +0000 Subject: Altering the heading levels to fit into the composite docs user guide. Is required or it leaves the context of the document segment in the userguide. Change-Id: Idb476b7926ba0fce11ed3be54eaa6837e34bff66 Signed-off-by: ChristopherPrice --- docs/userguide/quickstart.rst | 57 +++++++++++++++++++++++++++---------------- 1 file changed, 36 insertions(+), 21 deletions(-) diff --git a/docs/userguide/quickstart.rst b/docs/userguide/quickstart.rst index a72a3ebd..f06bfc20 100755 --- a/docs/userguide/quickstart.rst +++ b/docs/userguide/quickstart.rst @@ -2,12 +2,11 @@ .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV, Intel Corporation, AT&T and others. -============================= -Getting Started with 'vsperf' -============================= +vSwitchPerf test suites userguide +--------------------------------- General -------- +^^^^^^^ VSPERF requires a traffic generators to run tests, automated traffic gen support in VSPERF includes: @@ -23,20 +22,22 @@ option as shown in `Traffic generator instructions `__ VSPERF Installation --------------------- +^^^^^^^^^^^^^^^^^^^ + To see the supported Operating Systems, vSwitches and system requirements, please follow the `installation instructions `__ to install. Traffic Generator Setup ------------------------ +^^^^^^^^^^^^^^^^^^^^^^^ + Follow the `Traffic generator instructions `__ to install and configure a suitable traffic generator. Cloning and building src dependencies -------------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In order to run VSPERF, you will need to download DPDK and OVS. You can do this manually and build them in a preferred location, OR you could @@ -70,7 +71,8 @@ use: $ make clobber 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 @@ -82,7 +84,7 @@ contents. Any configuration item mentioned in any .conf file in the custom configuration value. Using a custom settings file ----------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 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 @@ -102,7 +104,8 @@ described like so (1 = max priority): 3. Configuration file(s) vloop_vnf ---------- +^^^^^^^^^ + vsperf uses a VM called vloop_vnf for looping traffic in the PVP and PVVP deployment scenarios. The image can be downloaded from ``__. @@ -119,13 +122,14 @@ vloop_vnf forwards traffic through a VM using one of: Alternatively you can use your own QEMU image. l2fwd Kernel Module -------------------- +^^^^^^^^^^^^^^^^^^^ + A Kernel Module that provides OSI Layer 2 Ipv4 termination or forwarding with support for Destination Network Address Translation (DNAT) for both the MAC and IP addresses. l2fwd can be found in /src/l2fwd Executing tests ---------------- +^^^^^^^^^^^^^^^ Before running any tests make sure you have root permissions by adding the following line to /etc/sudoers: @@ -179,7 +183,7 @@ For all available options, check out the help dialog: $ ./vsperf --help Executing Vanilla OVS tests ----------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^ 1. If needed, recompile src for all OVS variants @@ -216,7 +220,8 @@ set the ports. Executing PVP and PVVP tests ----------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + To run tests using vhost-user as guest access method: 1. Set VHOST_METHOD and VNF of your settings file to: @@ -264,7 +269,8 @@ To run tests using vhost-cuse as guest access method: $ ./vsperf --conf-file=/10_custom.conf Executing PVP tests using Vanilla OVS -------------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + To run tests using Vanilla OVS: 1. Set the following variables: @@ -284,9 +290,9 @@ To run tests using Vanilla OVS: or use --test-param - ./vsperf --conf-file=/10_custom.conf - --test-param "vanilla_tgen_tx_ip=n.n.n.n; - vanilla_tgen_tx_mac=nn:nn:nn:nn:nn:nn" + $ ./vsperf --conf-file=/10_custom.conf + --test-param "vanilla_tgen_tx_ip=n.n.n.n; + vanilla_tgen_tx_mac=nn:nn:nn:nn:nn:nn" 2. If needed, recompile src for all OVS variants @@ -304,7 +310,8 @@ To run tests using Vanilla OVS: $ ./vsperf --conf-file/10_custom.conf Selection of loopback application for PVP and PVVP tests --------------------------------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + To select loopback application, which will perform traffic forwarding inside VM, following configuration parameter should be configured: @@ -334,7 +341,8 @@ will not be forwarded by VM and testcases with PVP and PVVP deployments will fail. Guest loopback application is set to 'testpmd' by default. Code change verification by pylint ----------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + Every developer participating in VSPERF project should run pylint before his python code is submitted for review. Project specific configuration for pylint is available at 'pylint.rc'. @@ -346,10 +354,11 @@ Example of manual pylint invocation: $ pylint --rcfile ./pylintrc ./vsperf GOTCHAs: --------- +^^^^^^^^ OVS with DPDK and QEMU ~~~~~~~~~~~~~~~~~~~~~~~ + If you encounter the following error: "before (last 100 chars): '-path=/dev/hugepages,share=on: unable to map backing store for hugepages: Cannot allocate memory\r\n\r\n" with the PVP or PVVP @@ -368,3 +377,9 @@ an appropriate amount of memory: VSWITCHD_DPDK_ARGS = ['-c', '0x4', '-n', '4', '--socket-mem 1024,0'] +More information +^^^^^^^^^^^^^^^^ + +For more information and details refer to the vSwitchPerf user guide at: +http://artifacts.opnfv.org/vswitchperf/brahmaputra/userguide/index.html + -- cgit 1.2.3-korg