From 081ace7342b175f8e06d8aa9848e2aa4557f65c8 Mon Sep 17 00:00:00 2001 From: Aric Gardner Date: Fri, 11 Sep 2015 15:45:39 -0400 Subject: Move documentation to new sphinx build TODO: Reorganize documentation into properly named subfolders TODO: Add logos to documentation (see index.rst for example) Note you can see the results of this change via a link in the gerrit comments below NOTE: The merge job for your project has not been enabled, this code will not go to the artifacts page upon a merge. you can merge it and work on it in your own time, please contact me to enable the merge (the merge job will make this documentation avaliable to the public on artifacts.opnfv.org) JIRA:RELENG-15 Change-Id: I3f3d8c9d7fceae90e0ed824b66bdaf7a8ea66328 Signed-off-by: Aric Gardner --- docs/quickstart.rst | 233 ---------------------------------------------------- 1 file changed, 233 deletions(-) delete mode 100644 docs/quickstart.rst (limited to 'docs/quickstart.rst') diff --git a/docs/quickstart.rst b/docs/quickstart.rst deleted file mode 100644 index e5b433fa..00000000 --- a/docs/quickstart.rst +++ /dev/null @@ -1,233 +0,0 @@ -Getting Started with 'vsperf' -============================= - -Hardware Requirements ---------------------- - -VSPERF requires the following hardware to run tests: IXIA traffic -generator (IxNetwork), a machine that runs the IXIA client software and -a CentOS Linux release 7.1.1503 (Core) host. - -vSwitch Requirements --------------------- - -The vSwitch must support Open Flow 1.3 or greater. - -Installation ------------- - -Follow the `installation instructions `__ to install. - -IXIA Setup ----------- - -On the CentOS 7 system -~~~~~~~~~~~~~~~~~~~~~~ - -You need to install IxNetworkTclClient$(VER\_NUM)Linux.bin.tgz. - -On the IXIA client software system -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Find the IxNetwork TCL server app (start -> All Programs -> IXIA -> -IxNetwork -> IxNetwork\_$(VER\_NUM) -> IxNetwork TCL Server) - -Right click on IxNetwork TCL Server, select properties - Under shortcut tab in -the Target dialogue box make sure there is the argument "-tclport xxxx" -where xxxx is your port number (take note of this port number you will -need it for the 10\_custom.conf file). - -|Alt text| - -Hit Ok and start the TCL server application - -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 -use vswitchperf/src. The vswitchperf/src directory contains makefiles -that will allow you to clone and build the libraries that VSPERF depends -on, such as DPDK and OVS. To clone and build simply: - - .. code-block:: console - - cd src - make - -VSPERF can be used with OVS without DPDK support. In this case you have -to specify path to the kernel sources by WITH\_LINUX parameter: - - .. code-block:: console - - cd src - make WITH_LINUX=/lib/modules/`uname -r`/build - -To build DPDK and OVS for PVP testing with vhost_user as the guest access -method, use: - - .. code-block:: console - - make VHOST_USER=y - -To delete a src subdirectory and its contents to allow you to re-clone simply -use: - - .. code-block:: console - - make clobber - -Configure the ``./conf/10_custom.conf`` file --------------------------------------------- - -The supplied ``10_custom.conf`` file must be modified, as it contains -configuration items for which there are no reasonable default values. - -The configuration items that can be added is not limited to the initial -contents. Any configuration item mentioned in any .conf file in -``./conf`` directory can be added and that item will be overridden by -the custom configuration value. - -Using a custom settings file ----------------------------- - -Alternatively a custom settings file can be passed to ``vsperf`` via the -``--conf-file`` argument. - - .. code-block:: console - - ./vsperf --conf-file ... - -Note that configuration passed in via the environment (``--load-env``) -or via another command line argument will override both the default and -your custom configuration files. This "priority hierarchy" can be -described like so (1 = max priority): - -1. Command line arguments -2. Environment variables -3. Configuration file(s) - --------------- - -Executing tests ---------------- - -Before running any tests make sure you have root permissions by adding -the following line to /etc/sudoers: - - .. code-block:: console - - username ALL=(ALL) NOPASSWD: ALL - -username in the example above should be replaced with a real username. - -To list the available tests: - - .. code-block:: console - - ./vsperf --list-tests - -To run a group of tests, for example all tests with a name containing -'RFC2544': - - .. code-block:: console - - ./vsperf --conf-file=user_settings.py --tests="RFC2544" - -To run all tests: - - .. code-block:: console - - ./vsperf --conf-file=user_settings.py - -Some tests allow for configurable parameters, including test duration -(in seconds) as well as packet sizes (in bytes). - -.. code:: bash - - ./vsperf --conf-file user_settings.py - --tests RFC2544Tput - --test-param "rfc2544_duration=10;packet_sizes=128" - -For all available options, check out the help dialog: - - .. code-block:: console - - ./vsperf --help - -Executing PVP tests -------------------- -To run tests using vhost-user as guest access method: - -1. Set VHOST_METHOD and VNF of your settings file to: - - .. code-block:: console - - VHOST_METHOD='user' - VNF = 'QemuDpdkVhost' - -2. Recompile src for VHOST USER testing - - .. code-block:: console - - cd src - make cleanse - make VHOST_USER=y - -3. Run test: - - .. code-block:: console - - ./vsperf --conf-file - -To run tests using vhost-cuse as guest access method: - -1. Set VHOST_METHOD and VNF of your settings file to: - - .. code-block:: console - - VHOST_METHOD='cuse' - VNF = 'QemuDpdkVhostCuse' - -2. Recompile src for VHOST USER testing - - .. code-block:: console - - cd src - make cleanse - make VHOST_USER=n - -3. Run test: - - .. code-block:: console - - ./vsperf --conf-file - - - -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 deployment -scenario, check the amount of hugepages on your system: - -.. code:: bash - - cat /proc/meminfo | grep HugePages - - -By default the vswitchd is launched with 1Gb of memory, to change -this, modify --socket-mem parameter in conf/02_vswitch.conf to allocate -an appropriate amount of memory: - -.. code:: bash - - VSWITCHD_DPDK_ARGS = ['-c', '0x4', '-n', '4', '--socket-mem 1024,0'] - --------------- - -.. |Alt text| image:: images/TCLServerProperties.png -- cgit 1.2.3-korg