summaryrefslogtreecommitdiffstats
path: root/docs/testing/user/userguide/sriov.rst
diff options
context:
space:
mode:
authorahothan <ahothan@cisco.com>2018-11-27 17:50:54 -0800
committerahothan <ahothan@cisco.com>2018-11-27 18:02:33 -0800
commit5cc38f190fdd8bb61a1dd9a53a814460ae41b0e7 (patch)
tree34ab3f283c6153192374f6cb52438788e5cfa5ce /docs/testing/user/userguide/sriov.rst
parent4a80fac56ca122a34de5d03c0876e424cc7c6c56 (diff)
NFVBENCH-114 SRIOV run fails while creating VM
Change-Id: I1010a722805d0b101f93f0c93c1d26672e469be7 Signed-off-by: ahothan <ahothan@cisco.com>
Diffstat (limited to 'docs/testing/user/userguide/sriov.rst')
-rw-r--r--docs/testing/user/userguide/sriov.rst66
1 files changed, 62 insertions, 4 deletions
diff --git a/docs/testing/user/userguide/sriov.rst b/docs/testing/user/userguide/sriov.rst
index 4898e85..7702d3c 100644
--- a/docs/testing/user/userguide/sriov.rst
+++ b/docs/testing/user/userguide/sriov.rst
@@ -26,6 +26,7 @@ This example instructs NFVbench to create the left and right networks of a PVP p
.. code-block:: bash
+ sriov: true
internal_networks:
left:
segmentation_id: 2000
@@ -38,26 +39,83 @@ The segmentation ID fields must be different.
In the case of PVVP, the middle network also needs to be provisioned properly.
The same physical network can also be shared by the virtual networks but with different segmentation IDs.
+NFVbench cores with SR-IOV
+--------------------------
+The default core count for NFVbench/TRex may not be sufficient for higher throughput line cards (greater than 10Gbps).
+This will result in warning messages such as:
+
+.. code-block:: bash
+
+ INFO WARNING: There is a significant difference between requested TX rate (119047618) and actual TX rate (38897379).
+ The traffic generator may not have sufficient CPU to achieve the requested TX rate.
+
+In that case it is recommended to try allocating more cores to TRex using the cores property in the configuration
+file, for example to set to 8 cores:
+
+.. code-block:: bash
+
+ cores: 8
+
+It is also advisable to increase the number of vcpus in the VMs:
+
+
+VM Flavor for SR-IOV and NIC NUMA socket placement
+--------------------------------------------------
+
+Because SR-IOV throughput uses a lot of CPU in the VM, it is recommended to increase the
+vcpu count, for example to 4 vcpus:
+
+.. code-block:: bash
+
+ flavor:
+ # Number of vCPUs for the flavor
+ vcpus: 4
+ # Memory for the flavor in MB
+ ram: 8192
+ # Size of local disk in GB
+ disk: 0
+ extra_specs:
+ "hw:cpu_policy": dedicated
-NIC NUMA socket placement and flavors
--------------------------------------
If the 2 selected ports reside on NICs that are on different NUMA sockets, you will need to explicitly tell Nova to use 2 numa nodes in the flavor used for the VMs in order to satisfy the filters, for example:
.. code-block:: bash
flavor:
# Number of vCPUs for the flavor
- vcpus: 2
+ vcpus: 4
# Memory for the flavor in MB
ram: 8192
# Size of local disk in GB
disk: 0
extra_specs:
"hw:cpu_policy": dedicated
- "hw:mem_page_size": large
"hw:numa_nodes": 2
Failure to do so might cause the VM creation to fail with the Nova error
"Instance creation error: Insufficient compute resources:
Requested instance NUMA topology together with requested PCI devices cannot fit the given host NUMA topology."
+Example of configuration file (summary)
+---------------------------------------
+
+.. code-block:: bash
+
+ flavor:
+ # Number of vCPUs for the flavor
+ vcpus: 4
+ # Memory for the flavor in MB
+ ram: 8192
+ # Size of local disk in GB
+ disk: 0
+ extra_specs:
+ "hw:cpu_policy": dedicated
+ cores: 8
+ sriov: true
+ internal_networks:
+ left:
+ segmentation_id: 3830
+ physical_network: phys_sriov0
+ right:
+ segmentation_id: 3831
+ physical_network: phys_sriov1