From af429faced8fdff12ffa9a908a716007d7323456 Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Wed, 23 Apr 2025 13:36:13 -0700 Subject: [PATCH 1/3] ContentX re-org of postinstallation and expanding assemblies. Signed-off-by: John Wilkins --- _topic_maps/_topic_map.yml | 8 ++++---- ....adoc => bare-metal-expanding-the-cluster.adoc} | 6 +++--- ...bare-metal-postinstallation-configuration.adoc} | 8 ++++---- ...-replacing-a-bare-metal-control-plane-node.adoc | 14 +++++++------- ...-a-provisioning-network-after-installation.adoc | 4 ++-- 5 files changed, 20 insertions(+), 20 deletions(-) rename installing/installing_bare_metal/{ipi/ipi-install-expanding-the-cluster.adoc => bare-metal-expanding-the-cluster.adoc} (89%) rename installing/installing_bare_metal/{ipi/ipi-install-post-installation-configuration.adoc => bare-metal-postinstallation-configuration.adoc} (92%) diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 7cb8c85ef87c..90ea05c976c7 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -465,10 +465,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: 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 diff --git a/installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc b/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc similarity index 89% rename from installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc rename to installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc index 0ffb131a8a24..3cf71e5169fd 100644 --- a/installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc +++ b/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc @@ -1,12 +1,12 @@ :_mod-docs-content-type: ASSEMBLY -[id="ipi-install-expanding-the-cluster"] +[id="bare-metal-expanding-the-cluster"] = Expanding the cluster include::_attributes/common-attributes.adoc[] -:context: ipi-install-expanding +:context: bare-metal-expanding 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. +After deploying a bare metal cluster, you can use the following procedures to expand the number of worker nodes. Ensure that each prospective worker node meets the prerequisites. [NOTE] ==== diff --git a/installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc b/installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc similarity index 92% rename from installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc rename to installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc index 9f10a9f34ab2..37660a5f0b6f 100644 --- a/installing/installing_bare_metal/ipi/ipi-install-post-installation-configuration.adoc +++ b/installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc @@ -1,12 +1,12 @@ :_mod-docs-content-type: ASSEMBLY -[id="ipi-install-post-installation-configuration"] -= Installer-provisioned postinstallation configuration +[id="bare-metal-post-installation-configuration"] += Postinstallation configuration include::_attributes/common-attributes.adoc[] -:context: ipi-install-post-installation-configuration +:context: bare-metal-post-installation-configuration toc::[] -After successfully deploying an installer-provisioned cluster, consider the following postinstallation procedures. +After successfully deploying a bare metal cluster, consider the following postinstallation procedures. // Configuring NTP for disconnected clusters include::modules/ipi-install-configuring-ntp-for-disconnected-clusters.adoc[leveloffset=+1] diff --git a/modules/ipi-install-replacing-a-bare-metal-control-plane-node.adoc b/modules/ipi-install-replacing-a-bare-metal-control-plane-node.adoc index 1824345978cb..40f9c109b83a 100644 --- a/modules/ipi-install-replacing-a-bare-metal-control-plane-node.adoc +++ b/modules/ipi-install-replacing-a-bare-metal-control-plane-node.adoc @@ -1,18 +1,18 @@ // This is included in the following assemblies: // -// installing/installing_bare_metal/ipi/ipi-install-expanding-the-cluster.adoc +// installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc :_mod-docs-content-type: PROCEDURE [id="replacing-a-bare-metal-control-plane-node_{context}"] = Replacing a bare-metal control plane node -Use the following procedure to replace an installer-provisioned {product-title} control plane node. +Use the following procedure to replace a {product-title} control plane node. [IMPORTANT] ==== If you reuse the `BareMetalHost` object definition from an existing control plane host, do not leave the `externallyProvisioned` field set to `true`. -Existing control plane `BareMetalHost` objects may have the `externallyProvisioned` flag set to `true` if they were provisioned by the {product-title} installation program. +Existing control plane `BareMetalHost` objects might have the `externallyProvisioned` flag set to `true` if they were provisioned by the {product-title} installation program. ==== .Prerequisites @@ -85,11 +85,11 @@ spec: online: true EOF ---- -<1> Replace `` for the control plane number of the bare metal node in the `name` fields and the `credentialsName` field. +<1> Replace `` for the control plane number of the bare-metal node in the `name` fields and the `credentialsName` field. <2> Replace `` with the `base64` string of the user name. <3> Replace `` with the `base64` string of the password. -<4> Replace `` with the BMC protocol, such as `redfish`, `redfish-virtualmedia`, `idrac-virtualmedia`, or others. Replace `` with the IP address of the bare metal node's baseboard management controller. For additional BMC configuration options, see "BMC addressing" in the _Additional resources_ section. -<5> Replace `` with the MAC address of the bare metal node's first NIC. +<4> Replace `` with the BMC protocol, such as `redfish`, `redfish-virtualmedia`, `idrac-virtualmedia`, or others. Replace `` with the IP address of the bare-metal node's baseboard management controller. For additional BMC configuration options, see "BMC addressing" in the _Additional resources_ section. +<5> Replace `` with the MAC address of the bare-metal node's first NIC. + After the inspection is complete, the `BareMetalHost` object is created and available to be provisioned. @@ -147,7 +147,7 @@ spec: name: master-user-data-managed EOF ---- -<1> Replace `` for the control plane number of the bare metal node in the `name`, `labels` and `annotations` fields. +<1> Replace `` for the control plane number of the bare-metal node in the `name`, `labels` and `annotations` fields. + . To view the `BareMetalHost` objects, run the following command: + diff --git a/modules/nw-enabling-a-provisioning-network-after-installation.adoc b/modules/nw-enabling-a-provisioning-network-after-installation.adoc index 7f0b1c799c39..650c1f1f8c54 100644 --- a/modules/nw-enabling-a-provisioning-network-after-installation.adoc +++ b/modules/nw-enabling-a-provisioning-network-after-installation.adoc @@ -1,13 +1,13 @@ // This is included in the following assemblies: // -// ipi-install-post-installation-configuration.adoc +// bare-metal-postinstallation-configuration.adoc :_mod-docs-content-type: PROCEDURE [id="enabling-a-provisioning-network-after-installation_{context}"] = Enabling a provisioning network after installation -The assisted installer and installer-provisioned installation for bare metal clusters provide the ability to deploy a cluster without a `provisioning` network. This capability is for scenarios such as proof-of-concept clusters or deploying exclusively with Redfish virtual media when each node's baseboard management controller is routable via the `baremetal` network. +The {ai-full} and installer-provisioned installation for bare-metal clusters provide the ability to deploy a cluster without a `provisioning` network. This capability is for scenarios such as proof-of-concept clusters or deploying exclusively with Redfish virtual media when each node's baseboard management controller is routable via the `baremetal` network. You can enable a `provisioning` network after installation using the Cluster Baremetal Operator (CBO). From 67e48969e4d74541e22c433ea869e3343bc52d6e Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Thu, 24 Apr 2025 13:58:06 -0700 Subject: [PATCH 2/3] Fixed vale suggestions. Signed-off-by: John Wilkins --- .../installing_bare_metal/bare-metal-expanding-the-cluster.adoc | 2 +- .../bare-metal-postinstallation-configuration.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc b/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc index 3cf71e5169fd..182dff155de1 100644 --- a/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc +++ b/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc @@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] -After deploying a bare metal cluster, you can use the following procedures to expand the number of worker nodes. Ensure that each prospective worker node meets the prerequisites. +After deploying a bare-metal cluster, you can use the following procedures to expand the number of worker nodes. Ensure that each prospective worker node meets the prerequisites. [NOTE] ==== diff --git a/installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc b/installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc index 37660a5f0b6f..a37019190060 100644 --- a/installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc +++ b/installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc @@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] -After successfully deploying a bare metal cluster, consider the following postinstallation procedures. +After successfully deploying a bare-metal cluster, consider the following postinstallation procedures. // Configuring NTP for disconnected clusters include::modules/ipi-install-configuring-ntp-for-disconnected-clusters.adoc[leveloffset=+1] From 2698d56c2014038b3590f54c01c8bde7c0eaf799 Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Thu, 24 Apr 2025 14:34:58 -0700 Subject: [PATCH 3/3] Fixed cross-references. Signed-off-by: John Wilkins --- .../bare-metal-expanding-the-cluster.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc b/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc index 182dff155de1..0bec5b1c439c 100644 --- a/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc +++ b/installing/installing_bare_metal/bare-metal-expanding-the-cluster.adoc @@ -18,21 +18,21 @@ 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. +* 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/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:../../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/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-post-installation-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] +* 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]