From 8a4b99730c23f00b5359c58abb9dc5c3014d074f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Elisamara=20Aoki=20Gon=C3=A7alves?= Date: Fri, 24 Oct 2025 20:56:55 +0000 Subject: [PATCH] Openstack Installation Guide Updates - Open VSwitch (OVS and OVS+DPDK MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Install Guide update and enhancements. Change-Id: I2ed989bc405d6dbcb6f169afef0eaf7170f34dbd Signed-off-by: Elisamara Aoki Gonçalves --- .../bare_metal/controller_storage_install_kubernetes.rst | 7 ++++--- .../bare_metal/dedicated_storage_install_kubernetes.rst | 6 ++++-- .../bare_metal/rook_storage_install_kubernetes.rst | 9 +++++---- .../openstack/convert-worker-nodes-0007b1532308.rst | 4 ++-- .../virtual/controller_storage_install_kubernetes.rst | 5 +++-- .../virtual/dedicated_storage_install_kubernetes.txt | 5 +++-- .../release/virtual/rook_storage_install_kubernetes.rst | 7 ++++--- .../shared/_includes/aio_duplex_install_kubernetes.rest | 2 +- .../_includes/controller_storage_install_kubernetes.rest | 5 +++-- .../_includes/dedicated_storage_install_kubernetes.rest | 9 +++++---- .../_includes/inc-openstack-specific-host-config.rest | 4 ++-- .../_includes/r5_inc-openstack-specific-host-config.rest | 4 ++-- 12 files changed, 38 insertions(+), 29 deletions(-) diff --git a/doc/source/deploy_install_guides/release/bare_metal/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/release/bare_metal/controller_storage_install_kubernetes.rst index 2ffb24bf8..56e175f8a 100644 --- a/doc/source/deploy_install_guides/release/bare_metal/controller_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/release/bare_metal/controller_storage_install_kubernetes.rst @@ -676,12 +676,13 @@ Configure worker nodes #. **For OpenStack only:** Assign OpenStack host labels to the worker nodes in support of installing the |prefix|-openstack manifest/helm-charts later: - :: + .. parsed-literal:: for NODE in worker-0 worker-1; do - system host-label-assign $NODE openstack-compute-node=enabled + system host-label-assign $NODE openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule - system host-label-assign $NODE openvswitch=enabled + system host-label-assign $NODE |vswitch-label| + system host-label-assign $NODE dpdk=enabled done .. note:: diff --git a/doc/source/deploy_install_guides/release/bare_metal/dedicated_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/release/bare_metal/dedicated_storage_install_kubernetes.rst index 1c8c40690..444931d49 100644 --- a/doc/source/deploy_install_guides/release/bare_metal/dedicated_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/release/bare_metal/dedicated_storage_install_kubernetes.rst @@ -667,10 +667,12 @@ Configure worker nodes .. parsed-literal:: for NODE in worker-0 worker-1; do - system host-label-assign $NODE openstack-compute-node=enabled + system host-label-assign $NODE + openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule system host-label-assign $NODE |vswitch-label| - system host-label-assign $NODE sriov=enabled + system host-label-assign $NODE dpdk=enabled + system host-label-assign $NODE sriov=enabled done #. **For OpenStack only:** Set up a 'instances' filesystem, diff --git a/doc/source/deploy_install_guides/release/bare_metal/rook_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/release/bare_metal/rook_storage_install_kubernetes.rst index 957e1b4b8..9b9a8d029 100644 --- a/doc/source/deploy_install_guides/release/bare_metal/rook_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/release/bare_metal/rook_storage_install_kubernetes.rst @@ -297,8 +297,8 @@ OpenStack-specific host configuration 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: + Configure the huge pages for |VMs| in an |OVS|-|DPDK| environment on this + host, assuming 1G huge page, with the following command: :: @@ -609,10 +609,11 @@ OpenStack-specific host configuration .. parsed-literal:: for NODE in worker-0 worker-1; do - system host-label-assign $NODE openstack-compute-node=enabled + system host-label-assign $NODE openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule system host-label-assign $NODE |vswitch-label| - system host-label-assign $NODE sriov=enabled + system host-label-assign $NODE dpdk=enabled + system host-label-assign $NODE sriov=enabled done .. only:: partner diff --git a/doc/source/deploy_install_guides/release/openstack/convert-worker-nodes-0007b1532308.rst b/doc/source/deploy_install_guides/release/openstack/convert-worker-nodes-0007b1532308.rst index 50b66010a..ed507caf0 100644 --- a/doc/source/deploy_install_guides/release/openstack/convert-worker-nodes-0007b1532308.rst +++ b/doc/source/deploy_install_guides/release/openstack/convert-worker-nodes-0007b1532308.rst @@ -29,7 +29,7 @@ worker nodes to/from ``openstack-compute-nodes``. .. code-block:: none - system host-label-assign --overwrite openstack-compute-node=enabled avs=enabled sriov=enabled + system host-label-assign --overwrite openstack-compute-node=enabled openvswitch=enabled dpdk=enabled sriov=enabled #. Allocate vswitch huge pages: @@ -74,7 +74,7 @@ worker nodes to/from ``openstack-compute-nodes``. .. code-block:: none - system host-label-remove openstack-compute-node avs sriov + system host-label-remove openstack-compute-node openvswitch dpdk sriov .. note:: diff --git a/doc/source/deploy_install_guides/release/virtual/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/release/virtual/controller_storage_install_kubernetes.rst index cacc9e63a..aef1fc32d 100644 --- a/doc/source/deploy_install_guides/release/virtual/controller_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/release/virtual/controller_storage_install_kubernetes.rst @@ -509,9 +509,10 @@ OpenStack-specific host configuration :: for NODE in worker-0 worker-1; do - system host-label-assign $NODE openstack-compute-node=enabled + system host-label-assign $NODE openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule - system host-label-assign $NODE openvswitch=enabled + system host-label-assign $NODE openvswitch=enabled + system host-label-assign $NODE dpdk=enabled done .. note:: diff --git a/doc/source/deploy_install_guides/release/virtual/dedicated_storage_install_kubernetes.txt b/doc/source/deploy_install_guides/release/virtual/dedicated_storage_install_kubernetes.txt index e4807765a..08d1b0d6f 100644 --- a/doc/source/deploy_install_guides/release/virtual/dedicated_storage_install_kubernetes.txt +++ b/doc/source/deploy_install_guides/release/virtual/dedicated_storage_install_kubernetes.txt @@ -368,8 +368,9 @@ OpenStack-specific host configuration for NODE in worker-0 worker-1; do system host-label-assign $NODE openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule - system host-label-assign $NODE |vswitch-label| - system host-label-assign $NODE sriov=enabled + system host-label-assign $NODE |vswitch-label| + system host-label-assign $NODE dpdk=enabled + system host-label-assign $NODE sriov=enabled done #. **For OpenStack only:** Set up a 'instances' filesystem, diff --git a/doc/source/deploy_install_guides/release/virtual/rook_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/release/virtual/rook_storage_install_kubernetes.rst index 88cfe2c26..3c8b0b07e 100644 --- a/doc/source/deploy_install_guides/release/virtual/rook_storage_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/release/virtual/rook_storage_install_kubernetes.rst @@ -434,10 +434,11 @@ OpenStack-specific host configuration :: for NODE in worker-0 worker-1; do - system host-label-assign $NODE openstack-compute-node=enabled + system host-label-assign $NODE openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule - system host-label-assign $NODE openvswitch=enabled - system host-label-assign $NODE sriov=enabled + system host-label-assign $NODE openvswitch=enabled + system host-label-assign $NODE dpdk=enabled + system host-label-assign $NODE sriov=enabled done #. **For OpenStack only:** Set up a 'instances' filesystem, diff --git a/doc/source/shared/_includes/aio_duplex_install_kubernetes.rest b/doc/source/shared/_includes/aio_duplex_install_kubernetes.rest index 7e707d88f..9050e4962 100644 --- a/doc/source/shared/_includes/aio_duplex_install_kubernetes.rest +++ b/doc/source/shared/_includes/aio_duplex_install_kubernetes.rest @@ -221,7 +221,7 @@ memory on each |NUMA| node on the host. |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`` + ``hw:mem_page_size=large``. Configure the huge pages for |VMs| in an |OVS-DPDK| environment on this host, the following commands are an example that assumes that 1G diff --git a/doc/source/shared/_includes/controller_storage_install_kubernetes.rest b/doc/source/shared/_includes/controller_storage_install_kubernetes.rest index af0da3996..e5b78ed78 100644 --- a/doc/source/shared/_includes/controller_storage_install_kubernetes.rest +++ b/doc/source/shared/_includes/controller_storage_install_kubernetes.rest @@ -134,9 +134,10 @@ .. parsed-literal:: for NODE in worker-0 worker-1; do - system host-label-assign $NODE openstack-compute-node=enabled + system host-label-assign $NODE openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule - system host-label-assign $NODE |vswitch-label| + system host-label-assign $NODE |vswitch-label| + system host-label-assign $NODE dpdk=enabled done .. note:: diff --git a/doc/source/shared/_includes/dedicated_storage_install_kubernetes.rest b/doc/source/shared/_includes/dedicated_storage_install_kubernetes.rest index 8d3ad0fb3..98d7ed673 100644 --- a/doc/source/shared/_includes/dedicated_storage_install_kubernetes.rest +++ b/doc/source/shared/_includes/dedicated_storage_install_kubernetes.rest @@ -182,10 +182,11 @@ .. parsed-literal:: for NODE in worker-0 worker-1; do - system host-label-assign $NODE openstack-compute-node=enabled + system host-label-assign $NODE openstack-compute-node=enabled kubectl taint nodes $NODE openstack-compute-node:NoSchedule - system host-label-assign $NODE |vswitch-label| - system host-label-assign $NODE sriov=enabled + system host-label-assign $NODE |vswitch-label| + system host-label-assign $NODE dpdk=enabled + system host-label-assign $NODE sriov=enabled done #. **For OpenStack only:** Configure the host settings for the vSwitch. @@ -232,7 +233,7 @@ |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 + ``hw:mem_page_size=large`` Configure the huge pages for |VMs| in an |OVS-DPDK| environment on this host, the following commands are an example that assumes that 1G diff --git a/doc/source/shared/_includes/inc-openstack-specific-host-config.rest b/doc/source/shared/_includes/inc-openstack-specific-host-config.rest index e952e17ae..d3e70745c 100644 --- a/doc/source/shared/_includes/inc-openstack-specific-host-config.rest +++ b/doc/source/shared/_includes/inc-openstack-specific-host-config.rest @@ -76,8 +76,8 @@ 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: + Configure the huge pages for |VMs| in an |OVS-DPDK| environment on this + host, assuming 1G huge page, with the following commands: :: diff --git a/doc/source/shared/_includes/r5_inc-openstack-specific-host-config.rest b/doc/source/shared/_includes/r5_inc-openstack-specific-host-config.rest index 543161b33..25b65add6 100644 --- a/doc/source/shared/_includes/r5_inc-openstack-specific-host-config.rest +++ b/doc/source/shared/_includes/r5_inc-openstack-specific-host-config.rest @@ -73,8 +73,8 @@ 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: + Configure the huge pages for |VMs| in an |OVS-DPDK| environment on this + host, assuming 1G huge page, with the following command: ::