aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorVolodymyr Mytnyk <volodymyrx.mytnyk@intel.com>2019-04-26 16:06:38 +0000
committerGerrit Code Review <gerrit@opnfv.org>2019-04-26 16:06:38 +0000
commita53c2e9b4e3d4c536873255331d34449f855296a (patch)
tree82bc57d5f411a245d6e71da91e96452746e8e6e5 /docs
parentc059db1151296830467c10e89a2ca62655b9afe9 (diff)
parent4b8ef49f0b374cd662acde686d38fc931aaf9d88 (diff)
Merge "[docs] Document SRIOV configuration options"
Diffstat (limited to 'docs')
-rw-r--r--docs/testing/user/userguide/13-nsb-installation.rst150
1 files changed, 97 insertions, 53 deletions
diff --git a/docs/testing/user/userguide/13-nsb-installation.rst b/docs/testing/user/userguide/13-nsb-installation.rst
index 74f76c9c9..35f67b92f 100644
--- a/docs/testing/user/userguide/13-nsb-installation.rst
+++ b/docs/testing/user/userguide/13-nsb-installation.rst
@@ -489,6 +489,15 @@ topology and update all the required fields.::
Standalone Virtualization
-------------------------
+VM can be deployed manually or by Yardstick. If parameter *vm_deploy* is set
+to `True` VM will be deployed by Yardstick. Otherwise VM should be deployed
+manually. Test case example, context section::
+
+ contexts:
+ ...
+ vm_deploy: True
+
+
SR-IOV
^^^^^^
@@ -716,6 +725,93 @@ Update contexts section
gateway_ip: '152.16.100.20'
+SRIOV configuration options
++++++++++++++++++++++++++++
+
+The only configuration option available for SRIOV is *vpci*. It is used as base
+address for VFs that are created during SRIOV test case execution.
+
+ .. code-block:: yaml+jinja
+
+ networks:
+ uplink_0:
+ phy_port: "0000:05:00.0"
+ vpci: "0000:00:07.0"
+ cidr: '152.16.100.10/24'
+ gateway_ip: '152.16.100.20'
+ downlink_0:
+ phy_port: "0000:05:00.1"
+ vpci: "0000:00:08.0"
+ cidr: '152.16.40.10/24'
+ gateway_ip: '152.16.100.20'
+
+.. _`VM image properties label`:
+
+VM image properties
+'''''''''''''''''''
+
+VM image properties example under *flavor* section:
+
+ .. code-block:: console
+
+ flavor:
+ images: <path>
+ ram: 8192
+ extra_specs:
+ machine_type: 'pc-i440fx-xenial'
+ hw:cpu_sockets: 1
+ hw:cpu_cores: 6
+ hw:cpu_threads: 2
+ hw_socket: 0
+ cputune: |
+ <cputune>
+ <vcpupin vcpu="0" cpuset="7"/>
+ <vcpupin vcpu="1" cpuset="8"/>
+ ...
+ <vcpupin vcpu="11" cpuset="18"/>
+ <emulatorpin cpuset="11"/>
+ </cputune>
+ user: ""
+ password: ""
+
+VM image properties description:
+
+ +-------------------------+-------------------------------------------------+
+ | Parameters | Detail |
+ +=========================+=================================================+
+ | images || Path to the VM image generated by |
+ | | ``nsb_setup.sh`` |
+ | || Default path is ``/var/lib/libvirt/images/`` |
+ | || Default file name ``yardstick-nsb-image.img`` |
+ | | or ``yardstick-image.img`` |
+ +-------------------------+-------------------------------------------------+
+ | ram || Amount of RAM to be used for VM |
+ | || Default is 4096 MB |
+ +-------------------------+-------------------------------------------------+
+ | hw:cpu_sockets || Number of sockets provided to the guest VM |
+ | || Default is 1 |
+ +-------------------------+-------------------------------------------------+
+ | hw:cpu_cores || Number of cores provided to the guest VM |
+ | || Default is 2 |
+ +-------------------------+-------------------------------------------------+
+ | hw:cpu_threads || Number of threads provided to the guest VM |
+ | || Default is 2 |
+ +-------------------------+-------------------------------------------------+
+ | hw_socket || Generate vcpu cpuset from given HW socket |
+ | || Default is 0 |
+ +-------------------------+-------------------------------------------------+
+ | cputune || Maps virtual cpu with logical cpu |
+ +-------------------------+-------------------------------------------------+
+ | machine_type || Machine type to be emulated in VM |
+ | || Default is 'pc-i440fx-xenial' |
+ +-------------------------+-------------------------------------------------+
+ | user || User name to access the VM |
+ | || Default value is 'root' |
+ +-------------------------+-------------------------------------------------+
+ | password || Password to access the VM |
+ +-------------------------+-------------------------------------------------+
+
+
OVS-DPDK
^^^^^^^^
@@ -1047,59 +1143,7 @@ OVS-DPDK properties description:
VM image properties
'''''''''''''''''''
-VM image properties example under *flavor* section:
-
- .. code-block:: console
-
- flavor:
- images: <path>
- ram: 8192
- extra_specs:
- machine_type: 'pc-i440fx-xenial'
- hw:cpu_sockets: 1
- hw:cpu_cores: 6
- hw:cpu_threads: 2
- hw_socket: 0
- cputune: |
- <cputune>
- <vcpupin vcpu="0" cpuset="7"/>
- <vcpupin vcpu="1" cpuset="8"/>
- ...
- <vcpupin vcpu="11" cpuset="18"/>
- <emulatorpin cpuset="11"/>
- </cputune>
-
-VM image properties description:
-
- +-------------------------+-------------------------------------------------+
- | Parameters | Detail |
- +=========================+=================================================+
- | images || Path to the VM image generated by |
- | | ``nsb_setup.sh`` |
- | || Default path is ``/var/lib/libvirt/images/`` |
- | || Default file name ``yardstick-nsb-image.img`` |
- | | or ``yardstick-image.img`` |
- +-------------------------+-------------------------------------------------+
- | ram || Amount of RAM to be used for VM |
- | || Default is 4096 MB |
- +-------------------------+-------------------------------------------------+
- | hw:cpu_sockets || Number of sockets provided to the guest VM |
- | || Default is 1 |
- +-------------------------+-------------------------------------------------+
- | hw:cpu_cores || Number of cores provided to the guest VM |
- | || Default is 2 |
- +-------------------------+-------------------------------------------------+
- | hw:cpu_threads || Number of threads provided to the guest VM |
- | || Default is 2 |
- +-------------------------+-------------------------------------------------+
- | hw_socket || Generate vcpu cpuset from given HW socket |
- | || Default is 0 |
- +-------------------------+-------------------------------------------------+
- | cputune || Maps virtual cpu with logical cpu |
- +-------------------------+-------------------------------------------------+
- | machine_type || Machine type to be emulated in VM |
- | || Default is 'pc-i440fx-xenial' |
- +-------------------------+-------------------------------------------------+
+VM image properties are same as for SRIOV :ref:`VM image properties label`.
OpenStack with SR-IOV support