OSDOCS-9469: Documented the configure-ovs alternative

dfitzmau · dfitzmau · commit 32a85983e3d0 · 2024-07-22T12:12:26.000+01:00
diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml
@@ -582,7 +582,7 @@ Topics:
   Distros: openshift-enterprise,openshift-origin
   File: configuring-private-cluster
 - Name: Bare metal configuration
-  File: bare-metal-configuration
+  File: post-install-bare-metal-configuration
 - Name: Configuring multi-architecture compute machines on an OpenShift cluster
   Dir: configuring-multi-arch-compute-machines
   Distros: openshift-enterprise
diff --git a/installing/cluster-capabilities.adoc b/installing/cluster-capabilities.adoc
@@ -35,7 +35,7 @@ include::modules/cluster-bare-metal-operator.adoc[leveloffset=+2]
 .Additional resources
 * xref:../installing/installing_bare_metal_ipi/ipi-install-overview.adoc#ipi-install-overview[Deploying installer-provisioned clusters on bare metal]
 * xref:../installing/installing_bare_metal/preparing-to-install-on-bare-metal.adoc#preparing-to-install-on-bare-metal[Preparing for bare metal cluster installation]
-* xref:../post_installation_configuration/bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
+* xref:../post_installation_configuration/post-install-bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
 
 // Build capability
 include::modules/build-config-capability.adoc[leveloffset=+2]
diff --git a/installing/index.adoc b/installing/index.adoc
@@ -23,7 +23,7 @@ include::modules/ipi-verifying-nodes-after-installation.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../post_installation_configuration/bare-metal-configuration.adoc#getting-the-baremetalhost-resource_post-install-bare-metal-configuration[Getting the BareMetalHost resource]
+* xref:../post_installation_configuration/post-install-bare-metal-configuration.adoc#getting-the-baremetalhost-resource_post-install-bare-metal-configuration[Getting the BareMetalHost resource]
 
 * xref:../installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc#ipi-install-troubleshooting-following-the-installation_ipi-install-installation-workflow[Following the installation]
 
diff --git a/installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc b/installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
@@ -52,6 +52,7 @@ include::modules/csr-management.adoc[leveloffset=+2]
 * See xref:../../installing/installing_bare_metal/installing-bare-metal.adoc#installation-three-node-cluster_installing-bare-metal[Configuring a three-node cluster] for details about deploying three-node clusters in bare metal environments.
 * See xref:../../installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc#installation-approve-csrs_installing-bare-metal-network-customizations[Approving the certificate signing requests for your machines] for more information about approving cluster certificate signing requests after installation.
 
+// Networking requirements for user-provisioned infrastructure
 include::modules/installation-network-user-infra.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
@@ -65,6 +66,12 @@ include::modules/installation-dns-user-infra.adoc[leveloffset=+2]
 
 include::modules/installation-load-balancing-user-infra.adoc[leveloffset=+2]
 
+// Creating a manifest object that includes a customized `br-ex` bridge
+include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset=+1]
+
+// Scale each machine set to compute nodes
+include::modules/creating-scaling-machine-sets-compute-nodes-networking.adoc[leveloffset=+2]
+
 include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
diff --git a/installing/installing_bare_metal/installing-bare-metal.adoc b/installing/installing_bare_metal/installing-bare-metal.adoc
@@ -70,6 +70,7 @@ Ensure you enable the `disk.EnableUUID` parameter on all virtual machines in you
 
 * See xref:../../installing/installing_vsphere/upi/installing-vsphere.adoc#installation-vsphere-machines_installing-vsphere[Installing RHCOS and starting the OpenShift Container Platform bootstrap process] for details on setting the `disk.EnableUUID` parameter's value to `TRUE` on VMware vSphere for user-provisioned infrastructure.
 
+// Networking requirements for user-provisioned infrastructure
 include::modules/installation-network-user-infra.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
@@ -86,6 +87,12 @@ include::modules/installation-dns-user-infra.adoc[leveloffset=+2]
 
 include::modules/installation-load-balancing-user-infra.adoc[leveloffset=+2]
 
+// Creating a manifest object that includes a customized `br-ex` bridge
+include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset=+1]
+
+// Scale each machine set to compute nodes
+include::modules/creating-scaling-machine-sets-compute-nodes-networking.adoc[leveloffset=+2]
+
 include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
diff --git a/installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc b/installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
@@ -64,6 +64,7 @@ include::modules/csr-management.adoc[leveloffset=+2]
 * See xref:../../installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc#installation-three-node-cluster_installing-restricted-networks-bare-metal[Configuring a three-node cluster] for details about deploying three-node clusters in bare metal environments.
 * See xref:../../installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc#installation-approve-csrs_installing-restricted-networks-bare-metal[Approving the certificate signing requests for your machines] for more information about approving cluster certificate signing requests after installation.
 
+// Networking requirements for user-provisioned infrastructure
 include::modules/installation-network-user-infra.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
@@ -80,6 +81,12 @@ include::modules/installation-dns-user-infra.adoc[leveloffset=+2]
 
 include::modules/installation-load-balancing-user-infra.adoc[leveloffset=+2]
 
+// Creating a manifest object that includes a customized `br-ex` bridge
+include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset=+1]
+
+// Scale each machine set to compute nodes
+include::modules/creating-scaling-machine-sets-compute-nodes-networking.adoc[leveloffset=+2]
+
 include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
diff --git a/installing/installing_bare_metal_ipi/ipi-install-expanding-the-cluster.adoc b/installing/installing_bare_metal_ipi/ipi-install-expanding-the-cluster.adoc
@@ -30,7 +30,7 @@ include::modules/ipi-install-replacing-a-bare-metal-control-plane-node.adoc[leve
 
 * xref:../../backup_and_restore/control_plane_backup_and_restore/backing-up-etcd.adoc#backing-up-etcd-data_backup-etcd[Backing up etcd]
 
-* xref:../../post_installation_configuration/bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
+* xref:../../post_installation_configuration/post-install-bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
 
 * xref:../../installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc#bmc-addressing_ipi-install-installation-workflow[BMC addressing]
 
diff --git a/installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc b/installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc
@@ -25,6 +25,12 @@ include::modules/ipi-install-checking-ntp-sync.adoc[leveloffset=+1]
 // Configuring networking
 include::modules/ipi-install-configuring-networking.adoc[leveloffset=+1]
 
+// Creating a manifest object that includes a customized `br-ex` bridge
+include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset=+1]
+
+// Scale each machine set to compute nodes
+include::modules/creating-scaling-machine-sets-compute-nodes-networking.adoc[leveloffset=+2]
+
 // Establishing communication between subnets
 include::modules/ipi-install-establishing-communication-between-subnets.adoc[leveloffset=+1]
 
@@ -62,7 +68,7 @@ include::modules/ipi-install-bmc-addressing.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../post_installation_configuration/bare-metal-configuration.adoc#editing-a-baremetalhost-resource_post-install-bare-metal-configuration[Editing a BareMetalHost resource]
+* xref:../../post_installation_configuration/post-install-bare-metal-configuration.adoc#editing-a-baremetalhost-resource_post-install-bare-metal-configuration[Editing a BareMetalHost resource]
 
 // Verifying support for the Redfish API
 include::modules/ipi-install-verifying-support-for-redfish-apis.adoc[leveloffset=+2]
@@ -133,7 +139,7 @@ include::modules/ipi-install-configuring-the-bios.adoc[leveloffset=+2]
 [id="additional-resources_bare_metal_config"]
 .Additional resources
 
-* xref:../../post_installation_configuration/bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
+* xref:../../post_installation_configuration/post-install-bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
 
 // Optional: Configuring the RAID
 include::modules/ipi-install-configuring-the-raid.adoc[leveloffset=+2]
@@ -145,7 +151,7 @@ include::modules/ipi-install-configuring-storage-on-nodes.adoc[leveloffset=+2]
 [id="additional-resources_raid_config"]
 .Additional resources
 
-* xref:../../post_installation_configuration/bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
+* xref:../../post_installation_configuration/post-install-bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
 
 * link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/managing_storage_devices/index#partition-naming-scheme_disk-partitions[Partition naming scheme]
 
diff --git a/installing/installing_bare_metal_ipi/ipi-install-post-installation-configuration.adoc b/installing/installing_bare_metal_ipi/ipi-install-post-installation-configuration.adoc
@@ -12,3 +12,6 @@ include::modules/ipi-install-configuring-ntp-for-disconnected-clusters.adoc[leve
 
 include::modules/nw-enabling-a-provisioning-network-after-installation.adoc[leveloffset=+1]
 
+// Creating a manifest object that includes a customized `br-ex` bridge
+include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset=+1]
+
diff --git a/modules/bmo-about-the-bare-metal-operator.adoc b/modules/bmo-about-the-bare-metal-operator.adoc
@@ -1,25 +1,25 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_module-type: CONCEPT
 [id="bmo-about-the-bare-metal-operator_{context}"]
 = About the Bare Metal Operator
 
-Use the Bare Metal Operator (BMO) to provision, manage, and inspect bare-metal hosts in your cluster. 
- 
-The BMO uses the following resources to complete these tasks: 
+Use the Bare Metal Operator (BMO) to provision, manage, and inspect bare-metal hosts in your cluster.
+
+The BMO uses the following resources to complete these tasks:
 
 * `BareMetalHost`
 * `HostFirmwareSettings`
 * `FirmwareSchema`
 * `HostFirmwareComponents`
 
-The BMO maintains an inventory of the physical hosts in the cluster by mapping each bare-metal host to an instance of the `BareMetalHost` custom resource definition. Each `BareMetalHost` resource features hardware, software, and firmware details. The BMO continually inspects the bare-metal hosts in the cluster to ensure each `BareMetalHost` resource accurately details the components of the corresponding host. 
+The BMO maintains an inventory of the physical hosts in the cluster by mapping each bare-metal host to an instance of the `BareMetalHost` custom resource definition. Each `BareMetalHost` resource features hardware, software, and firmware details. The BMO continually inspects the bare-metal hosts in the cluster to ensure each `BareMetalHost` resource accurately details the components of the corresponding host.
 
-The BMO also uses the `HostFirmwareSettings` resource, the `FirmwareSchema` resource, and the `HostFirmwareComponents` resource to detail firmware specifications and upgrade or downgrade firmware for the bare-metal host. 
+The BMO also uses the `HostFirmwareSettings` resource, the `FirmwareSchema` resource, and the `HostFirmwareComponents` resource to detail firmware specifications and upgrade or downgrade firmware for the bare-metal host.
 
-The BMO interfaces with bare-metal hosts in the cluster by using the Ironic API service. The Ironic service uses the Baseboard Management Controller (BMC) on the host to interface with the machine. 
+The BMO interfaces with bare-metal hosts in the cluster by using the Ironic API service. The Ironic service uses the Baseboard Management Controller (BMC) on the host to interface with the machine.
 
 Some common tasks you can complete by using the BMO include the following:
 
diff --git a/modules/bmo-about-the-baremetalhost-resource.adoc b/modules/bmo-about-the-baremetalhost-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: REFERENCE
 [id="about-the-baremetalhost-resource_{context}"]
@@ -96,7 +96,7 @@ a|  (Optional) Contains the information about the RAID configuration for bare me
 ====
 {product-title} {product-version} supports hardware RAID for BMCs, including:
 
-* Fujitsu iRMC with support for RAID levels 0, 1, 5, 6, and 10 
+* Fujitsu iRMC with support for RAID levels 0, 1, 5, 6, and 10
 * Dell iDRAC using the Redfish API with firmware version 6.10.30.20 or later and RAID levels 0, 1, and 5
 
 {product-title} {product-version} does not support software RAID.
diff --git a/modules/bmo-about-the-firmwareschema-resource.adoc b/modules/bmo-about-the-firmwareschema-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: REFERENCE
 [id="about-the-firmwareschema-resource_{context}"]
diff --git a/modules/bmo-about-the-hostfirmwarecomponents-resource.adoc b/modules/bmo-about-the-hostfirmwarecomponents-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: REFERENCE
 [id="about-the-hostfirmwarecomponents-resource_{context}"]
diff --git a/modules/bmo-about-the-hostfirmwaresettings-resource.adoc b/modules/bmo-about-the-hostfirmwaresettings-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: REFERENCE
 [id="about-the-hostfirmwaresettings-resource_{context}"]
diff --git a/modules/bmo-attaching-a-non-bootable-iso-to-a-bare-metal-node.adoc b/modules/bmo-attaching-a-non-bootable-iso-to-a-bare-metal-node.adoc
@@ -1,6 +1,6 @@
-// This module is included in the following assemblies: 
+// This module is included in the following assemblies:
 //
-// * post_installation_configuration/bare-metal-configuration.adoc
+// * post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="attaching-a-non-bootable-iso-to-a-bare-metal-node_{context}"]
@@ -46,7 +46,7 @@ $ oc apply -f <node_name>-dataimage.yaml -n <node_namespace> <1>
 ----
 <1> Replace `<node_namespace>` so that the namespace matches the namespace for the `BareMetalHost` resource. For example, `openshift-machine-api`.
 
-. Reboot the node. 
+. Reboot the node.
 +
 [NOTE]
 ====
diff --git a/modules/bmo-editing-a-baremetalhost-resource.adoc b/modules/bmo-editing-a-baremetalhost-resource.adoc
@@ -1,6 +1,6 @@
-// This module is included in the following assemblies: 
+// This module is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="editing-a-baremetalhost-resource_{context}"]
diff --git a/modules/bmo-editing-the-hostfirmwarecomponents-resource.adoc b/modules/bmo-editing-the-hostfirmwarecomponents-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 [id="editing-the-hostfirmwarecomponents-resource_{context}"]
 = Editing the HostFirmwareComponents resource
diff --git a/modules/bmo-editing-the-hostfirmwaresettings-resource.adoc b/modules/bmo-editing-the-hostfirmwaresettings-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="editing-the-hostfirmwaresettings-resource_{context}"]
diff --git a/modules/bmo-getting-the-baremetalhost-resource.adoc b/modules/bmo-getting-the-baremetalhost-resource.adoc
@@ -1,6 +1,7 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
+
 :_mod-docs-content-type: PROCEDURE
 [id="getting-the-baremetalhost-resource_{context}"]
 = Getting the BareMetalHost resource
diff --git a/modules/bmo-getting-the-firmwareschema-resource.adoc b/modules/bmo-getting-the-firmwareschema-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="getting-the-firmwareschema-resource_{context}"]
diff --git a/modules/bmo-getting-the-hostfirmwarecomponents-resource.adoc b/modules/bmo-getting-the-hostfirmwarecomponents-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 [id="getting-the-hostfirmwarecomponents-resource_{context}"]
 = Getting the HostFirmwareComponents resource
@@ -76,5 +76,5 @@ status:
     status: "False"
     type: ChangeDetected
   lastUpdated: "2024-04-25T20:32:06Z"
-  updates: [] 
+  updates: []
 ----
diff --git a/modules/bmo-getting-the-hostfirmwaresettings-resource.adoc b/modules/bmo-getting-the-hostfirmwaresettings-resource.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 [id="getting-the-hostfirmwaresettings-resource_{context}"]
 = Getting the HostFirmwareSettings resource
diff --git a/modules/bmo-verifying-the-hostfirmware-settings-resource-is-valid.adoc b/modules/bmo-verifying-the-hostfirmware-settings-resource-is-valid.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="verifying-the-hostfirmware-settings-resource-is-valid_{context}"]
diff --git a/modules/con_bmo-bare-metal-operator-architecture.adoc b/modules/con_bmo-bare-metal-operator-architecture.adoc
@@ -1,6 +1,6 @@
 // This is included in the following assemblies:
 //
-// post_installation_configuration/bare-metal-configuration.adoc
+// post_installation_configuration/post-install-bare-metal-configuration.adoc
 :_mod-docs-content-type: CONCEPT
 [id="bmo-bare-metal-operator-architecture_{context}"]
 = Bare Metal Operator architecture
diff --git a/modules/creating-manifest-file-customized-br-ex-bridge.adoc b/modules/creating-manifest-file-customized-br-ex-bridge.adoc
diff --git a/modules/creating-scaling-machine-sets-compute-nodes-networking.adoc b/modules/creating-scaling-machine-sets-compute-nodes-networking.adoc
diff --git a/modules/nw-modifying-operator-install-config.adoc b/modules/nw-modifying-operator-install-config.adoc
diff --git a/modules/nw-ovn-kubernetes-migration.adoc b/modules/nw-ovn-kubernetes-migration.adoc
diff --git a/modules/virt-example-nmstate-IP-management.adoc b/modules/virt-example-nmstate-IP-management.adoc
diff --git a/networking/k8s_nmstate/k8s-nmstate-about-the-k8s-nmstate-operator.adoc b/networking/k8s_nmstate/k8s-nmstate-about-the-k8s-nmstate-operator.adoc
diff --git a/networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc b/networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc
diff --git a/post_installation_configuration/index.adoc b/post_installation_configuration/index.adoc
diff --git a/post_installation_configuration/post-install-bare-metal-configuration.adoc b/post_installation_configuration/post-install-bare-metal-configuration.adoc
