From a20d38c26f2954358ce724d03785d84949004364 Mon Sep 17 00:00:00 2001 From: tedaveryredhat Date: Thu, 23 Jul 2026 14:29:22 -0400 Subject: [PATCH] OSDOCS-17044-1:[CQA] MACH-3: (UPI) Attachment2 --- .../adding-bare-metal-compute-user-infra.adoc | 32 +++++-------------- ...bare-metal-compute-user-infra-prereqs.adoc | 20 ++++++++++++ .../creating-rhcos-machines-bare-metal.adoc | 12 +++++++ 3 files changed, 40 insertions(+), 24 deletions(-) create mode 100644 modules/adding-bare-metal-compute-user-infra-prereqs.adoc create mode 100644 modules/creating-rhcos-machines-bare-metal.adoc diff --git a/machine_management/user_infra/adding-bare-metal-compute-user-infra.adoc b/machine_management/user_infra/adding-bare-metal-compute-user-infra.adoc index cfff7d2baea4..c91c54f3e33a 100644 --- a/machine_management/user_infra/adding-bare-metal-compute-user-infra.adoc +++ b/machine_management/user_infra/adding-bare-metal-compute-user-infra.adoc @@ -7,30 +7,13 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -You can add more compute machines to your {product-title} cluster on bare metal or platform agnostic cluster. +To scale your {product-title} cluster on bare-metal or platform-agnostic infrastructure, you can add more compute machines. Create {op-system} machines, then approve their certificate signing requests. -== Prerequisites +//Creating RHCOS bare metal machines +include::modules/creating-rhcos-machines-bare-metal.adoc[leveloffset=+2] -* You xref:../../installing/installing_bare_metal/upi/installing-bare-metal.adoc#installing-bare-metal[installed a cluster on bare metal]. -* You xref:../../installing/installing_platform_agnostic/installing-platform-agnostic.adoc#installing-platform-agnostic[installed a cluster on any platform]. -* You have installation media and {op-system-first} images that you used to create your cluster. If you do not have these files, you must obtain them by following the instructions in the xref:../../installing/installing_bare_metal/upi/installing-bare-metal.adoc#installing-bare-metal[installation procedure]. -* If a DHCP server is available for your user-provisioned infrastructure, you have added the details for the additional compute machines to your DHCP server configuration. This includes a persistent IP address, DNS server information, and a hostname for each machine. -* You have updated your DNS configuration to include the record name and IP address of each compute machine that you are adding. You have validated that DNS lookup and reverse DNS lookup resolve correctly. - -[IMPORTANT] -==== -If you do not have access to the {op-system-first} images that were used to create your cluster, you can add more compute machines to your {product-title} cluster with newer versions of {op-system-first} images. For instructions, see link:https://access.redhat.com/solutions/5514051[Adding new nodes to UPI cluster fails after upgrading to OpenShift 4.6+]. -==== - -[id="creating-rhcos-machines-bare-metal"] -== Creating {op-system-first} machines - -Before you add more compute machines to a cluster that you installed on bare metal infrastructure, you must create {op-system} machines for it to use. You can either use an ISO image or network PXE booting to create the machines. - -[NOTE] -==== -You must use the same ISO image that you used to install a cluster to deploy all new nodes in a cluster. It is recommended to use the same Ignition config file. The nodes automatically upgrade themselves on the first boot before running the workloads. You can add the nodes before or after the upgrade. -==== +//Prerequisites +include::modules/adding-bare-metal-compute-user-infra-prereqs.adoc[leveloffset=+2] //Creating {op-system} machines using an ISO image include::modules/machine-user-infra-machines-iso.adoc[leveloffset=+2] @@ -38,6 +21,9 @@ include::modules/machine-user-infra-machines-iso.adoc[leveloffset=+2] //Creating {op-system} machines by PXE or iPXE booting include::modules/machine-user-infra-machines-pxe.adoc[leveloffset=+2] +// Approving the certificate signing requests for your machines +include::modules/installation-approve-csrs.adoc[leveloffset=+2] + [role="_additional-resources"] .Additional resources @@ -45,5 +31,3 @@ include::modules/machine-user-infra-machines-pxe.adoc[leveloffset=+2] * link:https://ipxe.org/buildcfg/image_gzip[`IMAGE_GZIP` option in iPXE (iPXE documentation)] -// Approving the certificate signing requests for your machines -include::modules/installation-approve-csrs.adoc[leveloffset=+1] \ No newline at end of file diff --git a/modules/adding-bare-metal-compute-user-infra-prereqs.adoc b/modules/adding-bare-metal-compute-user-infra-prereqs.adoc new file mode 100644 index 000000000000..b3bd689551c3 --- /dev/null +++ b/modules/adding-bare-metal-compute-user-infra-prereqs.adoc @@ -0,0 +1,20 @@ +:_mod-docs-content-type: REFERENCE +[id="adding-bare-metal-compute-user-infra-prereqs_{context}"] += Prerequisites +:context: adding-bare-metal-compute-user-infra + +[role="_abstract"] +There are several prerequisites that must be completed before you add compute machines to your cluster. + +The following prerequisites must be met: + +* You xref:../../installing/installing_bare_metal/upi/installing-bare-metal.adoc#installing-bare-metal[installed a cluster on bare metal]. +* You xref:../../installing/installing_platform_agnostic/installing-platform-agnostic.adoc#installing-platform-agnostic[installed a cluster on any platform]. +* You have installation media and {op-system-first} images that you used to create your cluster. If you do not have these files, you must obtain them by following the instructions in the xref:../../installing/installing_bare_metal/upi/installing-bare-metal.adoc#installing-bare-metal[installation procedure]. +* If a DHCP server is available for your user-provisioned infrastructure, you have added the details for the additional compute machines to your DHCP server configuration. This includes a persistent IP address, DNS server information, and a hostname for each machine. +* You have updated your DNS configuration to include the record name and IP address of each compute machine that you are adding. You have validated that DNS lookup and reverse DNS lookup resolve correctly. + +[IMPORTANT] +==== +If you do not have access to the {op-system-first} images that were used to create your cluster, you can add more compute machines to your {product-title} cluster with newer versions of {op-system-first} images. For instructions, see link:https://access.redhat.com/solutions/5514051[Adding new nodes to UPI cluster fails after upgrading to OpenShift 4.6+]. +==== \ No newline at end of file diff --git a/modules/creating-rhcos-machines-bare-metal.adoc b/modules/creating-rhcos-machines-bare-metal.adoc new file mode 100644 index 000000000000..1f2e02d9756f --- /dev/null +++ b/modules/creating-rhcos-machines-bare-metal.adoc @@ -0,0 +1,12 @@ +:_mod-docs-content-type: REFERENCE +[id="creating-rhcos-machines-bare-metal__{context}"] += Creating {op-system-first} machines +:context: adding-bare-metal-compute-user-infra + +[role="_abstract"] +Before you add more compute machines to a cluster that you installed on bare metal infrastructure, you must create {op-system} machines for it to use. You can either use an ISO image or network PXE booting to create the machines. + +[NOTE] +==== +You must use the same ISO image that you used to install a cluster to deploy all new nodes in a cluster. It is recommended to use the same Ignition config file. The nodes automatically upgrade themselves on the first boot before running the workloads. You can add the nodes before or after the upgrade. +==== \ No newline at end of file