Merge pull request #95008 from johnwilkins/HCIDOCS-699-4.18

HCIDOCS-699-4.18: Cherry pick of 92567

Author: ShaunaDiaz

_topic_maps/_topic_map.yml

@@ -445,11 +445,11 @@ Topics:
     Topics:
     - Name: Installing a user-provisioned cluster on bare metal
       File: installing-bare-metal
-    - Name: Installing a user-provisioned bare metal cluster with network customizations
+    - Name: Installing a user-provisioned bare-metal cluster with network customizations
       File: installing-bare-metal-network-customizations
-    - Name: Installing a user-provisioned bare metal cluster on a disconnected environment
+    - Name: Installing a user-provisioned bare-metal cluster on a disconnected environment
       File: installing-restricted-networks-bare-metal
-    - Name: Scaling a user-provisioned installation with the bare metal operator
+    - Name: Scaling a user-provisioned installation with the Bare Metal Operator
       File: scaling-a-user-provisioned-cluster-with-the-bare-metal-operator
     - Name: Installation configuration parameters for bare metal
       File: installation-config-parameters-bare-metal
@@ -467,10 +467,10 @@ Topics:
       File: ipi-install-installing-a-cluster
     - Name: Troubleshooting the installation
       File: ipi-install-troubleshooting
-    - Name: Postinstallation configuration
-      File: ipi-install-post-installation-configuration
-    - Name: Expanding the cluster
-      File: ipi-install-expanding-the-cluster
+  - Name: Installer-provisioned postinstallation configuration
+    File: bare-metal-postinstallation-configuration
+  - Name: Expanding the cluster
+    File: bare-metal-expanding-the-cluster
 - Name: Installing IBM Cloud Bare Metal (Classic)
   Dir: installing_ibm_cloud_classic
   Distros: openshift-origin,openshift-enterprise
@@ -3384,7 +3384,7 @@ Topics:
     File: optimizing-networking
   - Name: Optimizing CPU usage
     File: optimizing-cpu-usage
-- Name: Managing bare metal hosts
+- Name: Managing bare-metal hosts
   File: managing-bare-metal-hosts
   Distros: openshift-origin,openshift-enterprise
 - Name: What huge pages do and how they are consumed by apps

backup_and_restore/control_plane_backup_and_restore/disaster_recovery/quorum-restoration.adoc

@@ -16,4 +16,4 @@ include::modules/dr-restoring-etcd-quorum-ha.adoc[leveloffset=+1]
 == Additional resources
 
 * xref:../../../installing/installing_bare_metal/upi/installing-bare-metal.adoc#installing-bare-metal[Installing a user-provisioned cluster on bare metal]
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc#replacing-a-bare-metal-control-plane-node_ipi-install-expanding-the-cluster[Replacing a bare-metal control plane node]
+* xref:../../../installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc#replacing-a-bare-metal-control-plane-node_bare-metal-expanding-the-cluster[Replacing a bare-metal control plane node]

backup_and_restore/control_plane_backup_and_restore/disaster_recovery/scenario-2-restoring-cluster-state.adoc

@@ -30,6 +30,6 @@ include::modules/manually-restoring-cluster-etcd-backup.adoc[leveloffset=+1]
 
 * xref:../../../networking/accessing-hosts.adoc#accessing-hosts[Creating a bastion host to access {product-title} instances and the control plane nodes with SSH]
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc#replacing-a-bare-metal-control-plane-node_ipi-install-expanding-the-cluster[Replacing a bare-metal control plane node]
+* xref:../../../installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc#replacing-a-bare-metal-control-plane-node_bare-metal-expanding-the-cluster[Replacing a bare-metal control plane node]
 
 include::modules/dr-scenario-cluster-state-issues.adoc[leveloffset=+1]

edge_computing/image_base_install/ibi_deploying_sno_clusters/ibi-edge-image-based-install.adoc

@@ -54,7 +54,7 @@ include::modules/ibi-extra-manifests-configmap.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc#bmo-about-the-baremetalhost-resource_ipi-install-post-installation-configuration[About the BareMetalHost resource]
+* xref:../../../installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc#bmo-about-the-baremetalhost-resource_bare-metal-postinstallation-configuration[About the BareMetalHost resource]
 
 * xref:../../../openshift_images/managing_images/using-image-pull-secrets.adoc[Using image pull secrets]
 

installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc

@@ -0,0 +1,41 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="bare-metal-expanding-the-cluster"]
+= Expanding the cluster
+include::_attributes/common-attributes.adoc[]
+:context: bare-metal-expanding-the-cluster
+
+toc::[]
+
+After deploying an installer-provisioned {product-title} cluster, you can use the following procedures to expand the number of worker nodes. Ensure that each prospective worker node meets the prerequisites.
+
+[NOTE]
+====
+Expanding the cluster using RedFish Virtual Media involves meeting minimum firmware requirements. See *Firmware requirements for installing with virtual media* in the *Prerequisites* section for additional details when expanding the cluster using RedFish Virtual Media.
+====
+
+include::modules/ipi-install-preparing-the-bare-metal-node.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* See xref:../../installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc#configuring-host-network-interfaces-in-the-install-config-yaml-file_ipi-install-installation-workflow[Optional: Configuring host network interfaces in the install-config.yaml file] for details on configuring the NMState syntax.
+* See xref:../../scalability_and_performance/managing-bare-metal-hosts.adoc#automatically-scaling-machines-to-available-bare-metal-hosts_managing-bare-metal-hosts[Automatically scaling machines to the number of available bare-metal hosts] for details on automatically scaling machines.
+
+include::modules/ipi-install-replacing-a-bare-metal-control-plane-node.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../backup_and_restore/control_plane_backup_and_restore/replacing-unhealthy-etcd-member.adoc#replacing-the-unhealthy-etcd-member[Replacing an unhealthy etcd member]
+
+* xref:../../backup_and_restore/control_plane_backup_and_restore/backing-up-etcd.adoc#backing-up-etcd-data_backup-etcd[Backing up etcd]
+
+* xref:../../installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc#bmo-config-using-bare-metal-operator_bare-metal-postinstallation-configuration[Configuration using the Bare Metal Operator]
+
+* xref:../../installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc#bmc-addressing_ipi-install-installation-workflow[BMC addressing]
+
+include::modules/ipi-install-preparing-to-deploy-with-virtual-media-on-the-baremetal-network.adoc[leveloffset=+1]
+
+include::modules/ipi-install-diagnosing-duplicate-mac-address.adoc[leveloffset=+1]
+
+include::modules/ipi-install-provisioning-the-bare-metal-node.adoc[leveloffset=+1]

installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc renamed to installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc

@@ -1,8 +1,8 @@
 :_mod-docs-content-type: ASSEMBLY
-[id="ipi-install-post-installation-configuration"]
+[id="bare-metal-postinstallation-configuration"]
 = Installer-provisioned postinstallation configuration
 include::_attributes/common-attributes.adoc[]
-:context: ipi-install-post-installation-configuration
+:context: bare-metal-postinstallation-configuration
 
 toc::[]
 
@@ -20,9 +20,9 @@ include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../../networking/ovn_kubernetes_network_provider/converting-to-dual-stack.adoc#nw-dual-stack-convert_converting-to-dual-stack[Converting to a dual-stack cluster network]
+* xref:../../networking/ovn_kubernetes_network_provider/converting-to-dual-stack.adoc#nw-dual-stack-convert_converting-to-dual-stack[Converting to a dual-stack cluster network]
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc#ipi-install-expanding-the-cluster[Expanding the cluster]
+* xref:../../installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc#bare-metal-expanding-the-cluster[Expanding the cluster]
 
 // Services for a user-managed load balancer
 include::modules/nw-osp-services-external-load-balancer.adoc[leveloffset=+1]

installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc

@@ -33,7 +33,7 @@ include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset
 
 * xref:../../../networking/ovn_kubernetes_network_provider/converting-to-dual-stack.adoc#nw-dual-stack-convert_converting-to-dual-stack[Converting to a dual-stack cluster network]
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc#ipi-install-expanding-the-cluster[Expanding the cluster]
+* xref:../../../installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc#bare-metal-expanding-the-cluster[Expanding the cluster]
 
 // Scale each machine set to compute nodes
 include::modules/creating-scaling-machine-sets-compute-nodes-networking.adoc[leveloffset=+2]
@@ -80,7 +80,7 @@ include::modules/ipi-install-bmc-addressing.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc#bmo-editing-a-baremetalhost-resource_ipi-install-post-installation-configuration[Editing a BareMetalHost resource]
+* xref:../../../installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc#bmo-editing-a-baremetalhost-resource_bare-metal-postinstallation-configuration[Editing a BareMetalHost resource]
 
 // Verifying support for the Redfish API
 include::modules/ipi-install-verifying-support-for-redfish-apis.adoc[leveloffset=+2]
@@ -154,7 +154,7 @@ include::modules/ipi-install-configuring-the-bios.adoc[leveloffset=+2]
 [id="additional-resources_bare_metal_config"]
 .Additional resources
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc#bmo-config-using-bare-metal-operator_ipi-install-post-installation-configuration[Configuration using the Bare Metal Operator]
+* xref:../../../installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc#bmo-config-using-bare-metal-operator_bare-metal-postinstallation-configuration[Configuration using the Bare Metal Operator]
 
 // Optional: Configuring the RAID
 include::modules/ipi-install-configuring-the-raid.adoc[leveloffset=+2]
@@ -166,7 +166,7 @@ include::modules/ipi-install-configuring-storage-on-nodes.adoc[leveloffset=+2]
 [id="additional-resources_raid_config"]
 .Additional resources
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc#bmo-config-using-bare-metal-operator_ipi-install-post-installation-configuration[Configuration using the Bare Metal Operator]
+* xref:../../../installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc#bmo-config-using-bare-metal-operator_bare-metal-postinstallation-configuration[Configuration using the Bare Metal Operator]
 
 * 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]
 

installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="installing-bare-metal-network-customizations"]
-= Installing a user-provisioned bare metal cluster with network customizations
+= Installing a user-provisioned bare-metal cluster with network customizations
 include::_attributes/common-attributes.adoc[]
 :context: installing-bare-metal-network-customizations
 
@@ -26,7 +26,7 @@ include::modules/cluster-entitlements.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* See xref:../../../installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[Installing a user-provisioned bare metal cluster on a restricted network] for more information about performing a restricted network installation on bare metal infrastructure that you provision.
+* See xref:../../../installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[Installing a user-provisioned bare-metal cluster on a restricted network] for more information about performing a restricted network installation on bare-metal infrastructure that you provision.
 
 [id="installation-requirements-user-infra_{context}"]
 == Requirements for a cluster with user-provisioned infrastructure
@@ -49,7 +49,7 @@ include::modules/csr-management.adoc[leveloffset=+2]
 [role="_additional-resources"]
 .Additional resources
 
-* See xref:../../../installing/installing_bare_metal/upi/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/upi/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/upi/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
@@ -74,7 +74,7 @@ include::modules/creating-manifest-file-customized-br-ex-bridge.adoc[leveloffset
 
 * xref:../../../networking/ovn_kubernetes_network_provider/converting-to-dual-stack.adoc#nw-dual-stack-convert_converting-to-dual-stack[Converting to a dual-stack cluster network]
 
-* xref:../../../installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc#ipi-install-expanding-the-cluster[Expanding the cluster]
+* xref:../../../installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc#bare-metal-expanding-the-cluster[Expanding the cluster]
 
 // Scale each machine set to compute nodes
 include::modules/creating-scaling-machine-sets-compute-nodes-networking.adoc[leveloffset=+2]