Merge pull request #46137 from tmulquee/BZ1851483

BZ1851483: Preparing to reinstall a cluster on bare-metal

Author: jab-rh

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

@@ -17,6 +17,7 @@ include::modules/ipi-install-extracting-the-openshift-installer.adoc[leveloffset
 include::modules/ipi-install-creating-an-rhcos-images-cache.adoc[leveloffset=+1]
 
 [id="ipi-install-configuration-files"]
+[id="additional-resources_config"]
 == Configuring the install-config.yaml file
 
 include::modules/ipi-install-configuring-the-install-config-file.adoc[leveloffset=+2]
@@ -42,6 +43,7 @@ include::modules/ipi-install-modifying-install-config-for-dual-stack-network.ado
 include::modules/ipi-install-configuring-host-network-interfaces-in-the-install-config.yaml-file.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
+[id="additional-resources_relnotes"]
 .Additional resources
 
 * xref:../../release_notes/ocp-4-11-release-notes.adoc#ocp-4-11-known-issues[OpenShift Container Platform 4.11 release notes]
@@ -62,13 +64,15 @@ include::modules/ipi-install-deploying-routers-on-worker-nodes.adoc[leveloffset=
 include::modules/ipi-install-configuring-the-bios.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
+[id="additional-resources_bare_metal_config"]
 .Additional resources
 
 * xref:../../post_installation_configuration/bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
 
 include::modules/ipi-install-configuring-the-raid.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
+[id="additional-resources_raid_config"]
 .Additional resources
 
 * xref:../../post_installation_configuration/bare-metal-configuration.adoc#post-install-bare-metal-configuration[Bare metal configuration]
@@ -95,7 +99,10 @@ include::modules/ipi-install-following-the-installation.adoc[leveloffset=+1]
 
 include::modules/ipi-install-verifying-static-ip-address-configuration.adoc[leveloffset=+1]
 
+include::modules/ipi-preparing-reinstall-cluster-bare-metal.adoc[leveloffset=+1]
+
 [role="_additional-resources"]
+[id="additional-resources_creating_manifest_ignition"]
 == Additional resources
-
+* xref:../..//installing/installing_bare_metal/installing-bare-metal.html#installation-user-infra-generate-k8s-manifest-ignition_installing-bare-metal.adoc#installation-user-infra-generate-k8s-manifest-ignition_installing-bare-metal[{product-title} Creating the Kubernetes manifest and Ignition config files]
 * xref:../../updating/understanding-upgrade-channels-release.adoc#understanding-upgrade-channels_understanding-upgrade-channels-releases[{product-title} upgrade channels and releases]

modules/ipi-preparing-reinstall-cluster-bare-metal.adoc

@@ -0,0 +1,19 @@
+// Module included in the following assemblies:
+// //installing/installing_bare_metal_ipi/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc
+
+[id="ipi-preparing-reinstall-cluster-bare-metal_{context}"]
+
+= Preparing to reinstall a cluster on bare metal
+Before you reinstall a cluster on bare metal, you must perform cleanup operations.
+
+.Procedure
+. Remove or reformat the disks for the bootstrap, control plane node, and worker nodes. If you are working in a hypervisor environment, you must add any disks you removed.
+. Delete the artifacts that the previous installation generated:
++
+[source,terminal]
+----
+$ cd ; /bin/rm -rf auth/ bootstrap.ign master.ign worker.ign metadata.json \
+.openshift_install.log .openshift_install_state.json
+----
+. Generate new manifests and Ignition config files. See “Creating the Kubernetes manifest and Ignition config files" for more information.
+. Upload the new bootstrap, control plane, and compute node Ignition config files that the installation program created to your HTTP server. This will overwrite the previous Ignition files.