1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3 .. (c) <optionally add copywriters name>
5 This document provides scenario level details for Euphrates 1.0 of
6 deployment with no SDN controller and DPDK enabled Open vSwitch.
15 NFV and virtualized high performance applications, such as video processing,
16 require Open vSwitch to be accelerated with a fast data plane solution that
17 provides both carrier grade forwarding performance, scalability and open
20 A key component of any NFV solution is the virtual forwarder, which should
21 consist of soft switch that includes an accelerated data plane component. For
22 this, any virtual switch should make use of hardware accelerators and optimized
23 cache operation to be run in user space.
25 Scenario components and composition
26 ===================================
28 This scenario enables high performance data plan acceleration by utilizing
29 DPDK enabled Open vSwitch (OVS). This allows packet switching to be isolated
30 to particular hardware resources (CPUs, huge page memory allocation) without
31 kernel interrupt or context switching on the data plane CPU.
33 Tenant networking leverages Open vSwitch accelerated with a fast user space
34 data path such. OVS with the Linux kernel module data path is used for all
35 other connectivity, such as connectivity to the external network (i.e. br-ex)
36 is performed via non-accelerated OVS.
38 Scenario Configuration
39 ======================
41 Due to the performance optimization done by this scenario, it is recommended to
42 set some performance settings in the deploy settings in order to ensure maximum
43 performance. This is not necessary unless doing a baremetal deployment. Note,
44 this scenario requires taking the NIC mapped to the tenant network on the
45 compute node and binding it to DPDK. This means it will no longer be
46 accessible via the kernel. Ensure the NIC that is mapped to the Compute
47 Tenant network supports DPDK.
49 Make a copy of the deploy settings file, os-nosdn-ovs_dpdk-ha.yaml. Under the
50 kernel options for Compute, edit as follows:
51 - hugepagesz: the size of hugepages as an integer, followed by unit M
52 (megabyte) or G (gigabyte).
53 - hugepages: number of hugepages of hugepagesz size. Huge page memory will be
54 used for OVS as well as each nova instance spawned. It is a good idea to
55 allocate the maximum number possible, while still leaving some non-huge page
56 memory available to other processes (nova-compute, etc).
57 - isolcpus: comma-separated list of CPUs to isolate from the kernel. Isolated
58 CPUs will be used for pinning OVS and libvirtd to.
60 Under the performance->Compute->ovs section, edit as follows:
61 - socket_memory: the amount of huge page memory in MB to allocate to allocate
62 per socket to OVS as a comma-separated list. It is best to allocate the
63 memory to the socket which is closest to the PCI-Express bus of the NIC
64 to be used with OVS DPDK for tenant traffic.
65 - pmd_cores: comma-separated list of cores to pin to the poll-mode driver in
66 OVS. OVS DPDK will spawn TX/RX PMD threads to handle forwarding packets.
67 This setting identifies which cores to pin these threads to. For best
68 performance, dedicate at least 2 isolated cores on the same NUMA node where
69 socket_memory was assigned.
70 - dpdk_cores: comma-separated list of cores to pin OVS lcore threads to.
71 These threads do validation and control handling and it may not have any
72 impact on performance to include this setting.
74 Under the performance->Compute section. Add a nova subsection and include
75 the following setting:
76 - libvirtpin: comma-separated list of CPUs to pin libvirt (nova) instances to.
77 For best results, set this to be one or more CPUs that are located on the
78 same NUMA node where OVS socket memory was dedicated.
80 Now deploy with the modified deploy settings file.
82 Limitations, Issues and Workarounds
83 ===================================
85 * _APEX-415 br-phy dpdk interfaces are not brought up by os-net-config
90 For more information on the OPNFV Euphrates release, please visit
91 http://www.opnfv.org/euphrates