From 0f21a0025a21b601fde7de90d806e9ca4a99fb81 Mon Sep 17 00:00:00 2001 From: Christian Trautman Date: Wed, 7 Dec 2016 14:35:54 -0500 Subject: rhel73_install: Provide installer script for RHEL 7.3 Adds installer scripts for RHEL 7.3 OS. Modified dpdk makefile to allow upstream dpdk to build. Prevents upstream OVS from building due to kernel incompatibilities. Provides instructions on setting up RHEL 7.3 for usage with binary OVS packages when testing with OVS Vanilla. Tested under RHEL 7.3 JIRA: VSPerf-322 Change-Id: If294d465f28f60a1c514a7b661ce4696ac3b5b73 Signed-off-by: Christian Trautman --- docs/configguide/installation.rst | 29 +++++++++++++++++------------ docs/design/vswitchperf_design.rst | 4 ++++ 2 files changed, 21 insertions(+), 12 deletions(-) (limited to 'docs') diff --git a/docs/configguide/installation.rst b/docs/configguide/installation.rst index 7ba64bba..51aa469d 100755 --- a/docs/configguide/installation.rst +++ b/docs/configguide/installation.rst @@ -13,7 +13,8 @@ Supported Operating Systems * Fedora 20 * Fedora 21 * Fedora 22 -* RedHat 7.2 Enterprise +* RedHat 7.2 Enterprise Linux +* RedHat 7.3 Enterprise Linux * Ubuntu 14.04 Supported vSwitches @@ -26,15 +27,15 @@ The vSwitch must support Open Flow 1.3 or greater. Supported Hypervisors --------------------- -* Qemu version 2.3. +* Qemu version 2.3 or greater. Available VNFs -------------- A simple VNF that forwards traffic through a VM, using: * DPDK testpmd -* Linux Brigde -* custom l2fwd module +* Linux Bridge +* Custom l2fwd module The official VM image is called vloop-vnf and it is available for free download at OPNFV website. @@ -89,18 +90,22 @@ automatically. 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`_). In case of RedHat 7 it will -install Python 3.4 as an alternate installation in /usr/local/bin. 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. +In case of CentOS 7 or RHEL 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. + +**Please Note**: For RHEL 7.3 Enterprise OVS Vanilla is not built from upstream +source due to kernel incompatibilities. Please see the instructions in the +vswitchperf_design document for details on configuring OVS Vanilla for binary +package usage. You will need to activate the virtual environment every time you start a new shell session. Its activation is specific to your OS: -CentOS 7 and RedHat -=================== +CentOS 7 and RHEL +================= .. code:: bash diff --git a/docs/design/vswitchperf_design.rst b/docs/design/vswitchperf_design.rst index 88b6ba88..4f33a99f 100755 --- a/docs/design/vswitchperf_design.rst +++ b/docs/design/vswitchperf_design.rst @@ -257,6 +257,10 @@ that DPDK sources are not available, then vsperf will continue with test executi but testpmd can't be used as a guest loopback. This is useful in case, that other guest loopback applications (e.g. buildin or l2fwd) are used. +Note: In case of RHEL 7.3 OS usage, binary package configuration is required +for Vanilla OVS tests. With the installation of a supported rpm for OVS there is +a section in the ``conf\10_custom.conf`` file that can be used. + .. _VSPERF installation scripts: http://artifacts.opnfv.org/vswitchperf/docs/configguide/installation.html#other-requirements Configuration of GUEST options -- cgit 1.2.3-korg