starlingx/docs
Code Issues Proposed changes

Add additional config info for vswitch

Browse Source 
Fix procedural issue in docs by adding additional configurations
for vswitch memory for numa node and huge pages (Simplex/Duplex)

Patch set 2: Apply same change to Controller Storage/Dedicated Storage

Closes-bug: 1858390

Change-Id: I5a2b11dc7a041812b89f9616e168b9aa0b326156
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
This commit is contained in:
Kristal Dale 2020-01-07 14:35:52 -08:00
parent 003a15e184
commit ae1b78e124
2 changed files with 66 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/source/deploy_install_guides/r3_release/bare_metal/aio_simplex_install_kubernetes.rst
View File

@ -268,7 +268,9 @@ OpenStack-specific host configuration
manifest.
* Shares the core(s) assigned to the platform.
If you require better performance, OVS-DPDK should be used:
If you require better performance, OVS-DPDK (OVS with the Data Plane
Development Kit, which is supported only on bare metal hardware) should be
used:
* Runs directly on the host (it is not containerized).
* Requires that at least 1 core be assigned/dedicated to the vSwitch function.
@ -282,8 +284,7 @@ OpenStack-specific host configuration
Do not run any vSwitch directly on the host, instead, use the containerized
OVS defined in the helm charts of stx-openstack manifest.
To deploy OVS-DPDK (OVS with the Data Plane Development Kit, which is
supported only on bare metal hardware), run the following command:
To deploy OVS-DPDK, run the following command:
::
@ -294,8 +295,33 @@ OpenStack-specific host configuration
default to automatically assigning 1 vSwitch core for AIO controllers and 2
vSwitch cores for computes.
When using OVS-DPDK, virtual machines must be configured to use a flavor with
property: hw:mem_page_size=large
When using OVS-DPDK, configure vSwitch memory per NUMA node with the following
command:
::
system host-memory-modify -f <function> -1G <1G hugepages number> <hostname or id> <processor>
For example:
::
system host-memory-modify -f vswitch -1G 1 compute-0 0
VMs created in an OVS-DPDK environment must be configured to use huge pages
to enable networking and must use a flavor with property: hw:mem_page_size=large
Configure the huge pages for VMs in an OVS-DPDK environment with the command:
::
system host-memory-modify -1G <1G hugepages number> <hostname or id> <processor>
For example:
::
system host-memory-modify compute-0 0 -1G 10
.. note::

38
doc/source/deploy_install_guides/r3_release/bare_metal/controller_storage_install_kubernetes.rst
View File

@ -217,7 +217,9 @@ OpenStack-specific host configuration
manifest.
* Shares the core(s) assigned to the platform.
If you require better performance, OVS-DPDK should be used:
If you require better performance, OVS-DPDK (OVS with the Data Plane
Development Kit, which is supported only on bare metal hardware) should be
used:
* Runs directly on the host (it is not containerized).
* Requires that at least 1 core be assigned/dedicated to the vSwitch function.
@ -231,8 +233,7 @@ OpenStack-specific host configuration
Do not run any vSwitch directly on the host, instead, use the containerized
OVS defined in the helm charts of stx-openstack manifest.
To deploy OVS-DPDK (OVS with the Data Plane Development Kit, which is
supported only on bare metal hardware), run the following command:
To deploy OVS-DPDK, run the following command:
::
@ -243,13 +244,38 @@ OpenStack-specific host configuration
default to automatically assigning 1 vSwitch core for AIO controllers and 2
vSwitch cores for computes.
When using OVS-DPDK, Virtual Machines must be configured to use a flavor with
property: hw:mem_page_size=large.
When using OVS-DPDK, configure vSwitch memory per NUMA node with the following
command:
::
system host-memory-modify -f <function> -1G <1G hugepages number> <hostname or id> <processor>
For example:
::
system host-memory-modify -f vswitch -1G 1 compute-0 0
VMs created in an OVS-DPDK environment must be configured to use huge pages
to enable networking and must use a flavor with property: hw:mem_page_size=large
Configure the huge pages for VMs in an OVS-DPDK environment with the command:
::
system host-memory-modify -1G <1G hugepages number> <hostname or id> <processor>
For example:
::
system host-memory-modify compute-0 0 -1G 10
.. note::
After controller-0 is unlocked, changing vswitch_type requires
locking and unlocking all computes (and/or AIO controllers) to
locking and unlocking all computes (and/or AIO Controllers) to
apply the change.
.. incl-config-controller-0-storage-end: