summaryrefslogtreecommitdiffstats
path: root/docs/release/scenarios
diff options
context:
space:
mode:
authorTim Rozet <trozet@redhat.com>2017-10-17 15:25:16 -0400
committerTim Rozet <trozet@redhat.com>2017-10-18 13:51:26 +0000
commite675928d02d66928f291b83ef805b56a5fc41010 (patch)
tree5190e00f6c77df8a68ecd1422c811d586cd20853 /docs/release/scenarios
parent6960788c4d5124a2ee4b31aa36408a050618d95c (diff)
Updates docs and scenarios for Euphrates
Change-Id: I2da89d7a6ab4b0549edded908acc760b949231e1 Signed-off-by: Tim Rozet <trozet@redhat.com> (cherry picked from commit 94787144f6d92476854ca6f8ab65427beafea7a4)
Diffstat (limited to 'docs/release/scenarios')
-rw-r--r--docs/release/scenarios/os-nosdn-ovs_dpdk-ha/index.rst16
-rw-r--r--docs/release/scenarios/os-nosdn-ovs_dpdk-ha/os-nosdn-ovs_dpdk-ha.rst91
-rw-r--r--docs/release/scenarios/os-nosdn-ovs_dpdk-noha/index.rst16
-rw-r--r--docs/release/scenarios/os-nosdn-ovs_dpdk-noha/os-nosdn-ovs_dpdk-noha.rst91
4 files changed, 214 insertions, 0 deletions
diff --git a/docs/release/scenarios/os-nosdn-ovs_dpdk-ha/index.rst b/docs/release/scenarios/os-nosdn-ovs_dpdk-ha/index.rst
new file mode 100644
index 00000000..febf16c1
--- /dev/null
+++ b/docs/release/scenarios/os-nosdn-ovs_dpdk-ha/index.rst
@@ -0,0 +1,16 @@
+.. _os-nosdn-ovs_dpdk-ha:
+
+.. OPNFV - Open Platform for Network Function Virtualization
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+
+**********************************************************************************
+User Space Accelerated OVS scenario: os-nosdn-ovs_dpdk-ha Overview and Description
+**********************************************************************************
+
+.. toctree::
+ :numbered:
+ :maxdepth: 4
+
+ os-nosdn-ovs_dpdk-ha.rst
diff --git a/docs/release/scenarios/os-nosdn-ovs_dpdk-ha/os-nosdn-ovs_dpdk-ha.rst b/docs/release/scenarios/os-nosdn-ovs_dpdk-ha/os-nosdn-ovs_dpdk-ha.rst
new file mode 100644
index 00000000..cc5fee3b
--- /dev/null
+++ b/docs/release/scenarios/os-nosdn-ovs_dpdk-ha/os-nosdn-ovs_dpdk-ha.rst
@@ -0,0 +1,91 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
+This document provides scenario level details for Euphrates 1.0 of
+deployment with no SDN controller and DPDK enabled Open vSwitch.
+
+.. contents::
+ :depth: 3
+ :local:
+
+Introduction
+============
+
+NFV and virtualized high performance applications, such as video processing,
+require Open vSwitch to be accelerated with a fast data plane solution that
+provides both carrier grade forwarding performance, scalability and open
+extensibility.
+
+A key component of any NFV solution is the virtual forwarder, which should
+consist of soft switch that includes an accelerated data plane component. For
+this, any virtual switch should make use of hardware accelerators and optimized
+cache operation to be run in user space.
+
+Scenario components and composition
+===================================
+
+This scenario enables high performance data plan acceleration by utilizing
+DPDK enabled Open vSwitch (OVS). This allows packet switching to be isolated
+to particular hardware resources (CPUs, huge page memory allocation) without
+kernel interrupt or context switching on the data plane CPU.
+
+Tenant networking leverages Open vSwitch accelerated with a fast user space
+data path such. OVS with the Linux kernel module data path is used for all
+other connectivity, such as connectivity to the external network (i.e. br-ex)
+is performed via non-accelerated OVS.
+
+Scenario Configuration
+======================
+
+Due to the performance optimization done by this scenario, it is recommended to
+set some performance settings in the deploy settings in order to ensure maximum
+performance. This is not necessary unless doing a baremetal deployment. Note,
+this scenario requires taking the NIC mapped to the tenant network on the
+compute node and binding it to DPDK. This means it will no longer be
+accessible via the kernel. Ensure the NIC that is mapped to the Compute
+Tenant network supports DPDK.
+
+Make a copy of the deploy settings file, os-nosdn-ovs_dpdk-ha.yaml. Under the
+kernel options for Compute, edit as follows:
+ - hugepagesz: the size of hugepages as an integer, followed by unit M
+ (megabyte) or G (gigabyte).
+ - hugepages: number of hugepages of hugepagesz size. Huge page memory will be
+ used for OVS as well as each nova instance spawned. It is a good idea to
+ allocate the maximum number possible, while still leaving some non-huge page
+ memory available to other processes (nova-compute, etc).
+ - isolcpus: comma-separated list of CPUs to isolate from the kernel. Isolated
+ CPUs will be used for pinning OVS and libvirtd to.
+
+Under the performance->Compute->ovs section, edit as follows:
+ - socket_memory: the amount of huge page memory in MB to allocate to allocate
+ per socket to OVS as a comma-separated list. It is best to allocate the
+ memory to the socket which is closest to the PCI-Express bus of the NIC
+ to be used with OVS DPDK for tenant traffic.
+ - pmd_cores: comma-separated list of cores to pin to the poll-mode driver in
+ OVS. OVS DPDK will spawn TX/RX PMD threads to handle forwarding packets.
+ This setting identifies which cores to pin these threads to. For best
+ performance, dedicate at least 2 isolated cores on the same NUMA node where
+ socket_memory was assigned.
+ - dpdk_cores: comma-separated list of cores to pin OVS lcore threads to.
+ These threads do validation and control handling and it may not have any
+ impact on performance to include this setting.
+
+Under the performance->Compute section. Add a nova subsection and include
+the following setting:
+ - libvirtpin: comma-separated list of CPUs to pin libvirt (nova) instances to.
+ For best results, set this to be one or more CPUs that are located on the
+ same NUMA node where OVS socket memory was dedicated.
+
+Now deploy with the modified deploy settings file.
+
+Limitations, Issues and Workarounds
+===================================
+
+* _APEX-415 br-phy dpdk interfaces are not brought up by os-net-config
+
+References
+==========
+
+For more information on the OPNFV Euphrates release, please visit
+http://www.opnfv.org/euphrates
diff --git a/docs/release/scenarios/os-nosdn-ovs_dpdk-noha/index.rst b/docs/release/scenarios/os-nosdn-ovs_dpdk-noha/index.rst
new file mode 100644
index 00000000..699f3915
--- /dev/null
+++ b/docs/release/scenarios/os-nosdn-ovs_dpdk-noha/index.rst
@@ -0,0 +1,16 @@
+.. _os-nosdn-ovs_dpdk-noha:
+
+.. OPNFV - Open Platform for Network Function Virtualization
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+
+************************************************************************************
+User Space Accelerated OVS scenario: os-nosdn-ovs_dpdk-noha Overview and Description
+************************************************************************************
+
+.. toctree::
+ :numbered:
+ :maxdepth: 4
+
+ os-nosdn-ovs_dpdk-noha.rst
diff --git a/docs/release/scenarios/os-nosdn-ovs_dpdk-noha/os-nosdn-ovs_dpdk-noha.rst b/docs/release/scenarios/os-nosdn-ovs_dpdk-noha/os-nosdn-ovs_dpdk-noha.rst
new file mode 100644
index 00000000..b85f6e2b
--- /dev/null
+++ b/docs/release/scenarios/os-nosdn-ovs_dpdk-noha/os-nosdn-ovs_dpdk-noha.rst
@@ -0,0 +1,91 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
+This document provides scenario level details for Euphrates 1.0 of
+deployment with no SDN controller and DPDK enabled Open vSwitch.
+
+.. contents::
+ :depth: 3
+ :local:
+
+Introduction
+============
+
+NFV and virtualized high performance applications, such as video processing,
+require Open vSwitch to be accelerated with a fast data plane solution that
+provides both carrier grade forwarding performance, scalability and open
+extensibility.
+
+A key component of any NFV solution is the virtual forwarder, which should
+consist of soft switch that includes an accelerated data plane component. For
+this, any virtual switch should make use of hardware accelerators and optimized
+cache operation to be run in user space.
+
+Scenario components and composition
+===================================
+
+This scenario enables high performance data plan acceleration by utilizing
+DPDK enabled Open vSwitch (OVS). This allows packet switching to be isolated
+to particular hardware resources (CPUs, huge page memory allocation) without
+kernel interrupt or context switching on the data plane CPU.
+
+Tenant networking leverages Open vSwitch accelerated with a fast user space
+data path such. OVS with the Linux kernel module data path is used for all
+other connectivity, such as connectivity to the external network (i.e. br-ex)
+is performed via non-accelerated OVS.
+
+Scenario Configuration
+======================
+
+Due to the performance optimization done by this scenario, it is recommended to
+set some performance settings in the deploy settings in order to ensure maximum
+performance. This is not necessary unless doing a baremetal deployment. Note,
+this scenario requires taking the NIC mapped to the tenant network on the
+compute node and binding it to DPDK. This means it will no longer be
+accessible via the kernel. Ensure the NIC that is mapped to the Compute
+Tenant network supports DPDK.
+
+Make a copy of the deploy settings file, os-nosdn-ovs_dpdk-noha.yaml. Under
+the kernel options for Compute, edit as follows:
+ - hugepagesz: the size of hugepages as an integer, followed by unit M
+ (megabyte) or G (gigabyte).
+ - hugepages: number of hugepages of hugepagesz size. Huge page memory will be
+ used for OVS as well as each nova instance spawned. It is a good idea to
+ allocate the maximum number possible, while still leaving some non-huge page
+ memory available to other processes (nova-compute, etc).
+ - isolcpus: comma-separated list of CPUs to isolate from the kernel. Isolated
+ CPUs will be used for pinning OVS and libvirtd to.
+
+Under the performance->Compute->ovs section, edit as follows:
+ - socket_memory: the amount of huge page memory in MB to allocate to allocate
+ per socket to OVS as a comma-separated list. It is best to allocate the
+ memory to the socket which is closest to the PCI-Express bus of the NIC
+ to be used with OVS DPDK for tenant traffic.
+ - pmd_cores: comma-separated list of cores to pin to the poll-mode driver in
+ OVS. OVS DPDK will spawn TX/RX PMD threads to handle forwarding packets.
+ This setting identifies which cores to pin these threads to. For best
+ performance, dedicate at least 2 isolated cores on the same NUMA node where
+ socket_memory was assigned.
+ - dpdk_cores: comma-separated list of cores to pin OVS lcore threads to.
+ These threads do validation and control handling and it may not have any
+ impact on performance to include this setting.
+
+Under the performance->Compute section. Add a nova subsection and include
+the following setting:
+ - libvirtpin: comma-separated list of CPUs to pin libvirt (nova) instances to.
+ For best results, set this to be one or more CPUs that are located on the
+ same NUMA node where OVS socket memory was dedicated.
+
+Now deploy with the modified deploy settings file.
+
+Limitations, Issues and Workarounds
+===================================
+
+* _APEX-415 br-phy dpdk interfaces are not brought up by os-net-config
+
+References
+==========
+
+For more information on the OPNFV Euphrates release, please visit
+http://www.opnfv.org/euphrates