rearranging workflow order

skopacz1 · skopacz1 · commit 5290554d1797 · 2025-05-29T14:13:08.000-04:00
diff --git a/modules/installing-ove-booting.adoc b/modules/installing-ove-booting.adoc
diff --git a/modules/installing-ove-console-final.adoc b/modules/installing-ove-console-final.adoc
@@ -0,0 +1,65 @@
+// Module included in the following assemblies:
+//
+// * virt/install/installing-booting.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-installing-ove-console-final_{context}"]
+= Completing cluster configuration and initiating the installation
+
+Before you can finally initiate the cluster installation, you must verify host details, configure cluster networking details, and download the default cluster credentials.
+
+.Prerequisites
+
+* You have booted all of the hosts that will comprise your cluster and configured them with the correct rendezvous node IP address.
++
+[IMPORTANT]
+====
+You can add as many hosts as you want to your cluster.
+However, at this stage, you must at least have enough available hosts to match the value you specified in the *Number of control plane nodes* field of the installation console's *Cluster details* page.
+====
+
+.Procedure
+
+. On the installation console hosted by the rendezvous node, configure the hosts in the *Host discovery* page:
+
+.. Verify that every machine you booted from the ISO image appears in the *Host Inventory* section and has a *Status* value of *Ready*.
+
+.. For each host, click the expand icon and verify that all of the specification fields are correct.
+
+.. Optional: For each host, configure the role by selecting an option from the dropdown menu of the *Role* column.
+The default value for every host except the rendezvous node is `Auto-assign`.
+
+.. Click *Next* to continue.
+
+. On the *Storage* page, click the expand icon for each host and verify that all of the specification fields are correct.
+
+. Click *Next* to continue.
+
+. Configure the cluster networking on the *Networking* page:
+
+.. Optional: Select a machine network from the dropdown menu of the *Machine network* field.
+Otherwise, a default value is selected.
+
+.. Enter an IP address in the *API IP* field.
+An API IP provides an endpoint for all users to interact with and configure the platform.
+
+.. Enter an IP address in the *Ingress IP* field.
+An ingress IP provides an endpoint for application traffic flowing from outside the cluster.
+
+.. Optional: Select the *Use advanced networking* checkbox and configure other parameters such as the *Cluster network CIDR*, the *Cluster network host prefix*, or *the Service network CIDR*.
+
+.. Optional: Enter a key in the *Host SSH Public Key for troubleshooting after installation* field, which you can use to connect to hosts using a public SSH key for troubleshooting after installation.
+
+.. Click *Next* to continue.
+
+. On the *Download credentials* page, select the checkbox to acknowledge that you must download credential files prior to cluster installation.
+
+. Click *Download credentials* and save the cluster credentials file in a secure location.
++
+[IMPORTANT]
+====
+You must download the credentials at this stage.
+Once you initiate the cluster installation, the rendezvous node reboots and you can no longer retrieve the credentials.
+====
+
+. On the *Review and create* page, review all of the cluster details and click *Install cluster* to initiate the cluster installation.
diff --git a/modules/installing-ove-console-initial.adoc b/modules/installing-ove-console-initial.adoc
@@ -0,0 +1,61 @@
+// Module included in the following assemblies:
+//
+// * virt/install/installing-booting.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-installing-ove-console-initial_{context}"]
+= Configuring cluster details and choosing Operators to install
+
+Once the rendezvous node has been booted from the ISO image, configure details about your cluster and choose Virtualization Operators to install from the web console.
+
+.Prerequisites
+
+* You have the URL of the installation web console that was provided by the rendezvous node.
+
+.Procedure
+
+. In a web browser, go to the URL provided by the rendezvous node.
+
+. Configure your cluster in the *Cluster details* page:
+
+.. Enter a name for the cluster in the *Cluster name* field.
+
+.. Enter a base domain for the cluster in the *Base domain* field.
+All subdomains for the cluster will use this base domain.
++
+[NOTE]
+====
+The base domain must be a valid DNS name.
+You must not have a wildcard domain set up for the base domain.
+====
+
+.. Enter your pull secret in the *Pull secret* field.
+You can obtain a copy of your pull secret link:https://console.redhat.com/openshift/install/pull-secret[here].
+
+.. Optional: In the *Number of control plane nodes* field, select the number of control plane nodes for your installation from the dropdown menu.
+The default value is `3`.
+
+.. Optional: Select the *include custom manifests* checkbox if you want to upload custom manifests to further configure your cluster.
+This option adds an additional page for custom manifests that you use later in the configuration process.
++
+[IMPORTANT]
+====
+If you have already added custom manifests, clearing the *Include custom manifests* checkbox automatically deletes them all.
+You must confirm the deletion.
+====
+
+.. Click *Next* to continue.
+Once you proceed to the next page, you cannot go back to change any of these cluster details.
+
+. Choose additional Operators to install in the *Operators* page:
+
+.. If you want to install all of the Operators recommended for running Virtualization on your cluster, select *Virtualization* in the *Bundles* section.
+
+.. If you want to install only some Operators, select the individual Operators from the Single Operators section.
++
+[NOTE]
+====
+Some of the listed Operators are available only as part of the Virtualization Operator bundle.
+====
+
+.. Click *Next* to continue.
diff --git a/modules/installing-ove-console.adoc b/modules/installing-ove-console.adoc
diff --git a/modules/installing-ove-hosts.adoc b/modules/installing-ove-hosts.adoc
@@ -0,0 +1,34 @@
+// Module included in the following assemblies:
+//
+// * virt/install/installing-booting.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-installing-ove-hosts_{context}"]
+= Booting the remaining cluster hosts
+
+After you have configured initial cluster details in the installation web console and have a defined cluster topology, you must boot the remaining machines that will make up your cluster from the ISO image.
+
+[NOTE]
+====
+You can boot non-rendezvous node machines earlier in the installation process, even before you designate a machine as the rendezvous node. However, you must know the valid IP address that you will select for the rendezvous node.
+
+When you boot your non-rendezvous node machines, the machines will perform a check to see if an Assisted Service is running at the specified rendezvous IP address.
+If the service is not yet running, a warning appears to confirm whether you would still like to proceed booting the machine from the ISO image.
+====
+
+.Prerequisites
+
+* You have downloaded the installation ISO.
+
+.Procedure
+
+. Attach the ISO image to a machine and boot the machine from this image.
+You can also boot from a USB drive containing the ISO image.
+
+. Wait for a machine to boot from the image and display the *Rendezvous node setup* menu.
+
+. Enter the rendezvous node IP address in the *Rendezvous node setup* menu and select *Save rendezvous IP*.
+
+. Select *Save and Continue*.
+
+. Repeat this process for each remaining machine that will comprise the hosts in your cluster.
diff --git a/modules/installing-ove-rendezvous.adoc b/modules/installing-ove-rendezvous.adoc
@@ -0,0 +1,34 @@
+// Module included in the following assemblies:
+//
+// * virt/install/installing-booting.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-installing-ove-booting_{context}"]
+= Mounting the ISO and booting the rendezvous node
+
+To initiate the cluster installation, attach the downloaded ISO to the machine that will serve as your rendezvous host and boot the machine from the ISO.
+The rendezvous node runs as the bootstrap host during the installation, which hosts the configuration web console and runs an Assisted Service that facilitates the cluster deployment.
+
+.Prerequisites
+
+* You have downloaded the installation ISO.
+
+.Procedure
+
+. On the machine that you have designated to be the rendezvous node, attach the ISO image to the machine and boot the machine from this image.
+You can also boot from a USB drive containing the ISO image.
+
+. Wait for the machine to boot from the image and display the *Rendezvous node setup* menu.
+
+. Select *This is the rendezvous node* in the *Rendezvous node setup* menu.
++
+[IMPORTANT]
+====
+You must select only one machine to act as the rendezvous node.
+Selecting two or more machines as a rendezvous node is not supported.
+====
+
+. In the *Rendezvous node IP selection* menu, select an IP address from the list to use as the rendezvous node IP address and select *Continue*.
+Make note of this address for later use.
+
+. Wait for the rendezvous node to provide a URL for finishing the installation and save the URL for later use.
diff --git a/virt/install/installing-ove.adoc b/virt/install/installing-ove.adoc
@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-The following procedures describe a method to install a {ove-first} cluster that uses a simplified user interface, and does not require you to set up an external image registry in disconnected environments, which is a requirement for all other disconnected installation methods.
+The following procedures describe a method to install a {ove-first} cluster that uses a simplified user interface. This method does not require you to set up an external image registry in disconnected environments, which is a requirement for all other disconnected installation methods.
 
 :FeatureName: Installing an {ove} cluster using this method
 include::snippets/technology-preview.adoc[]
@@ -29,14 +29,20 @@ Included Operator bundle:: You can install the Virtualization bundle, which incl
 // Downloading the installation ISO
 include::modules/installing-ove-iso.adoc[leveloffset=+1]
 
-// Mounting the ISO and booting the machines
-include::modules/installing-ove-booting.adoc[leveloffset=+1]
+// Mounting the ISO and booting the rendezvous node
+include::modules/installing-ove-rendezvous.adoc[leveloffset=+1]
 
-// Configuring the cluster installation from the web console
-include::modules/installing-ove-console.adoc[leveloffset=+1]
+// Configuring cluster details and choosing Operators to install
+include::modules/installing-ove-console-initial.adoc[leveloffset=+1]
+
+// Booting the remaining cluster hosts
+include::modules/installing-ove-hosts.adoc[leveloffset=+1]
+
+// Completing cluster configuration and initiating the installation
+include::modules/installing-ove-console-final.adoc[leveloffset=+1]
 
 During the installation process, the rendezvous node reboots and the console you used to configure the installation is no longer accessible.
-At that point, the URL of the cluster web console is provided, however this console is not accessible until the cluster installation is completed.
+At that point, the URL of the deployed cluster's web console is provided, although this console is not accessible until the cluster installation is completed.
 
 Once the cluster is installed, you can visit this URL and sign in to the web console with your downloaded credentials.
 
