_OVS-DPDK Virtio Interfaces - Performance Tuning Recommendations

OVS-DPDK Virtio Interfaces - Performance Tuning Recommendations

Follow the open stack recommended performance settings for host and guest.
Refer to VNF Performance Tuning for details.
Make sure that physical network adapters, Poll Mode Driver (PMD) threads, and pinned CPUs for the instance are all on the same NUMA node. This is required for optimal performance.

PMD threads are the threads that do the heavy lifting for userspace switching. They perform tasks such as continuous polling of input ports for packets, classifying packets once received, and executing actions on the packets once they are classified.
Set the queue size for virtio interfaces to 1024 by updating the Director template.
1. NovaComputeExtraConfig: - nova::compute::libvirt::tx_queue_size: '"1024"'
2. NovaComputeExtraConfig: - nova::compute::libvirt::rx_queue_size: '"1024"'
Configure the following dpdk parameters in host ovs-dpdk:
1. Make sure two pairs of Rx/Tx queues are configured for host dpdk interfaces.
  
  To validate, issue the following command during ovs-dpdk bring-up:
  ovs-vsctl get Interface dpdk0 options
  For background details, refer to http://docs.openvswitch.org/en/latest/howto/dpdk/
2. Enable per-port memory to allow each port to use separate mem-pools when receiving packets instead of using a default shared mem-pool:
  ovs-vsctl set Open_vSwitch . other_config:per-port-memory=true
3. Configure 4096 MB hugepage memory on each socket:
  ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=4096,4096
4. Spawn the appropriate number of PMD threads so that each port/queue is serviced by a particular PMD thread.
  Ensure that PMD threads are:
  1. pinned to dedicated cores/hyper-threads,
  2. in the same NUMA as network adapter and guest,
  3. isolated from the kernel, and
  4. not be used by guest for any other purpose.
5. Set the pmd-cpu-mask, accordingly:
  ovs-vsctl set Open_vSwitch . other_config:pmd-cpu-mask=0x40001004000100
  
  The example above sets PMD threads to run on two physical cores:8,26,36,54. (cores:8-36 and 26-54 are sibling hyper-threads).
6. Restart ovs-vswitchd after the changes:
  systemctl status ovs-vswitchd
  systemctl restart ovs-vswitchd
The port and Rx queue assignment to PMD threads is crucial for optimal performance. Follow http://docs.openvswitch.org/en/latest/topics/dpdk/pmd/ for more details. The affinity is a csv list of <queue_id>:<core_id> which needs to be set for each ports.

ovs-vsctl set interface dpdk0 other_config:pmd-rxq-affinity="0:8,1:26" ovs-vsctl set interface vhub89b3d58-4f other_config:pmd-rxq-affinity="0:36"
ovs-vsctl set interface vhu6d3f050e-de other_config:pmd-rxq-affinity="1:54"

In the example above, the PMD thread on core 8 will read queue 0 and PMD thread on core 26 will read queue 1 of dpdk0 interface.

Alternatively, you can use the default assignment of port/Rx queues to PMD threads and enable auto-load-balance option so that ovs will put the threads on cores based on load.

ovs-vsctl set open_vswitch . other_config:pmd-auto-lb="true" ovs-appctl dpif-netdev/pmd-rxq-rebalance

Troubleshooting

To check the port/Rx queue distribution among PMD threads, enter the command:
ovs-appctl dpif-netdev/pmd-rxq-show
To check the PMD thread stats (actual CPU usage), enter the following command, and look for "processing cycles" and "idle cycles":
ovs-appctl dpif-netdev/pmd-stats-clear && sleep 10 && ovs-appctl dpif-netdev/pmd-stats-show
To check packet drops (rx_dropped / tx_dropped counters) on host dpdk interfaces, enter the command:
watch -n 1 'ovs-vsctl get interface dpdk0 statistics|sed -e "s/,/\n/g" -e "s/[\",\{,\}, ]//g" -e "s/=/ =\u21d2 /g"'