diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index a049ae4367..bf6696df1a 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -477,6 +477,8 @@ Topics: Topics: - Name: vSphere installation requirements File: ipi-vsphere-installation-reqs + - Name: Preparing to install a cluster + File: ipi-vsphere-preparing-to-install - Name: Installing a cluster File: installing-vsphere-installer-provisioned - Name: Installing a cluster with customizations diff --git a/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc b/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc index eb1482ead1..54e5e45274 100644 --- a/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc +++ b/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc @@ -13,6 +13,7 @@ include::snippets/vcenter-support.adoc[] [id="prerequisites_installing-restricted-networks-installer-provisioned-vsphere"] == Prerequisites +* You have completed the tasks in xref:../../../installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc#ipi-vsphere-preparing-to-install[Preparing to install a cluster using installer-provisioned infrastructure]. * You reviewed your VMware platform licenses. Red{nbsp}Hat does not place any restrictions on your VMware licenses, but some VMware infrastructure components require licensing. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. @@ -36,10 +37,6 @@ include::modules/installation-about-restricted-network.adoc[leveloffset=+1] include::modules/cluster-entitlements.adoc[leveloffset=+1] -include::modules/ssh-agent-using.adoc[leveloffset=+1] - -include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1] - include::modules/installation-creating-image-restricted.adoc[leveloffset=+1] include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1] @@ -69,8 +66,6 @@ include::modules/configuring-vsphere-regions-zones.adoc[leveloffset=+2] include::modules/installation-launching-installer.adoc[leveloffset=+1] -include::modules/cli-installing-cli.adoc[leveloffset=+1] - include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] include::modules/olm-restricted-networks-configuring-operatorhub.adoc[leveloffset=+1] diff --git a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-customizations.adoc b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-customizations.adoc index 135286cf58..aca58831bc 100644 --- a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-customizations.adoc +++ b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-customizations.adoc @@ -14,6 +14,7 @@ include::snippets/vcenter-support.adoc[] == Prerequisites +* You have completed the tasks in xref:../../../installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc#ipi-vsphere-preparing-to-install[Preparing to install a cluster using installer-provisioned infrastructure]. * You reviewed your VMware platform licenses. Red{nbsp}Hat does not place any restrictions on your VMware licenses, but some VMware infrastructure components require licensing. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. @@ -29,12 +30,6 @@ Be sure to also review this site list if you are configuring a proxy. include::modules/cluster-entitlements.adoc[leveloffset=+1] -include::modules/ssh-agent-using.adoc[leveloffset=+1] - -include::modules/installation-obtaining-installer.adoc[leveloffset=+1] - -include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1] - include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1] [role="_additional-resources"] @@ -62,8 +57,6 @@ include::modules/configuring-vsphere-regions-zones.adoc[leveloffset=+2] include::modules/installation-launching-installer.adoc[leveloffset=+1] -include::modules/cli-installing-cli.adoc[leveloffset=+1] - include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] [id="installing-vsphere-installer-provisioned-customizations-registry"] diff --git a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc index 4232469177..1b791775a0 100644 --- a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc +++ b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned-network-customizations.adoc @@ -15,6 +15,7 @@ include::snippets/vcenter-support.adoc[] == Prerequisites +* You have completed the tasks in xref:../../../installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc#ipi-vsphere-preparing-to-install[Preparing to install a cluster using installer-provisioned infrastructure]. * You reviewed your VMware platform licenses. Red{nbsp}Hat does not place any restrictions on your VMware licenses, but some VMware infrastructure components require licensing. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. @@ -31,12 +32,6 @@ Be sure to also review this site list if you are configuring a proxy. include::modules/cluster-entitlements.adoc[leveloffset=+1] -include::modules/ssh-agent-using.adoc[leveloffset=+1] - -include::modules/installation-obtaining-installer.adoc[leveloffset=+1] - -include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1] - include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1] [role="_additional-resources"] @@ -72,8 +67,6 @@ include::modules/nw-operator-cr.adoc[leveloffset=+1] include::modules/installation-launching-installer.adoc[leveloffset=+1] -include::modules/cli-installing-cli.adoc[leveloffset=+1] - include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] [id="installing-vsphere-installer-provisioned-network-customizations-registry"] diff --git a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned.adoc b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned.adoc index 5fb1102d1f..0beb7ef1c6 100644 --- a/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned.adoc +++ b/installing/installing_vsphere/ipi/installing-vsphere-installer-provisioned.adoc @@ -13,6 +13,7 @@ include::snippets/vcenter-support.adoc[] == Prerequisites +* You have completed the tasks in xref:../../../installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc#ipi-vsphere-preparing-to-install[Preparing to install a cluster using installer-provisioned infrastructure]. * You reviewed your VMware platform licenses. Red{nbsp}Hat does not place any restrictions on your VMware licenses, but some VMware infrastructure components require licensing. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. @@ -29,16 +30,8 @@ Be sure to also review this site list if you are configuring a proxy. include::modules/cluster-entitlements.adoc[leveloffset=+1] -include::modules/ssh-agent-using.adoc[leveloffset=+1] - -include::modules/installation-obtaining-installer.adoc[leveloffset=+1] - -include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1] - include::modules/installation-launching-installer.adoc[leveloffset=+1] -include::modules/cli-installing-cli.adoc[leveloffset=+1] - include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] [id="installing-vsphere-installer-provisioned-registry"] diff --git a/installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc b/installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc new file mode 100644 index 0000000000..6adf0f1c0d --- /dev/null +++ b/installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc @@ -0,0 +1,32 @@ +:_mod-docs-content-type: ASSEMBLY +[id="ipi-vsphere-preparing-to-install"] += Preparing to install a cluster using installer-provisioned infrastructure +include::_attributes/common-attributes.adoc[] +:context: ipi-vsphere-preparing-to-install + +toc::[] + +You prepare to install an {product-title} cluster on vSphere by completing the following steps: + +* Downloading the installation program. ++ +[NOTE] +==== +If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. +==== +* Installing the {oc-first}. ++ +[NOTE] +==== +If you are installing in a disconnected environment, install `oc` to the mirror host. +==== +* Generating an SSH key pair. You can use this key pair to authenticate into the {product-title} cluster's nodes after it is deployed. +* Adding your vCenter’s trusted root CA certificates to your system trust. + +include::modules/installation-obtaining-installer.adoc[leveloffset=+1] + +include::modules/cli-installing-cli.adoc[leveloffset=+1] + +include::modules/ssh-agent-using.adoc[leveloffset=+1] + +include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1] diff --git a/modules/cli-installing-cli.adoc b/modules/cli-installing-cli.adoc index 56b59809ce..006d47f3ed 100644 --- a/modules/cli-installing-cli.adoc +++ b/modules/cli-installing-cli.adoc @@ -35,10 +35,6 @@ // * installing/installing_ibm_cloud_public/installing-ibm-cloud-private.adoc // * installing/install_config/installing-restricted-networks-preparations.adoc // * installing/installing_vsphere/installing-vsphere.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc -// * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc // * installing/installing_ibm_z/installing-ibm-z.adoc // * openshift_images/samples-operator-alt-registry.adoc // * updating/updating-restricted-network-cluster/mirroring-image-repository.adoc @@ -51,6 +47,7 @@ // * installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc // * installing/installing-restricted-networks-azure-installer-provisioned.adoc // * installing/installing_azure/installing-restricted-networks-azure-user-provisioned.adoc +// * installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc // AMQ docs link to this; do not change anchor ifeval::["{context}" == "mirroring-ocp-image-repository"] diff --git a/modules/installation-adding-vcenter-root-certificates.adoc b/modules/installation-adding-vcenter-root-certificates.adoc index 2c39e6ff2a..ab02590473 100644 --- a/modules/installation-adding-vcenter-root-certificates.adoc +++ b/modules/installation-adding-vcenter-root-certificates.adoc @@ -1,9 +1,5 @@ // Module included in the following assemblies: -// -// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc -// * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc +// * installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc :_mod-docs-content-type: PROCEDURE [id="installation-adding-vcenter-root-certificates_{context}"] diff --git a/modules/installation-obtaining-installer.adoc b/modules/installation-obtaining-installer.adoc index 1de3fa6eaa..efdebf8ad1 100644 --- a/modules/installation-obtaining-installer.adoc +++ b/modules/installation-obtaining-installer.adoc @@ -35,13 +35,11 @@ // * installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc // * installing/installing_vsphere/installing-vsphere.adoc // * installing/installing_vsphere/installing-vsphere-network-customizations.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc // * installing/installing_ibm_z/installing-ibm-z.adoc // * installing/installing_ibm_z/installing-ibm-z-kvm.adoc // * installing/installing_nutanix/installing-nutanix-installer-provisioned.adoc // * installing/installing_azure/installing-restricted-networks-azure-user-provisioned.adoc +// * installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc ifeval::["{context}" == "installing-ibm-z"] @@ -62,13 +60,7 @@ endif::[] ifeval::["{context}" == "installing-ibm-cloud-private"] :private: endif::[] -ifeval::["{context}" == "installing-vsphere-installer-provisioned"] -:vsphere: -endif::[] -ifeval::["{context}" == "installing-vsphere-installer-provisioned-customizations"] -:vsphere: -endif::[] -ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"] +ifeval::["{context}" == "ipi-vsphere-preparing-to-install"] :vsphere: endif::[] @@ -170,12 +162,6 @@ endif::[] ifeval::["{context}" == "installing-ibm-cloud-private"] :!private: endif::[] -ifeval::["{context}" == "installing-vsphere-installer-provisioned"] -:!vsphere: -endif::[] -ifeval::["{context}" == "installing-vsphere-installer-provisioned-customizations"] -:!vsphere: -endif::[] -ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-customizations"] +ifeval::["{context}" == "ipi-vsphere-preparing-to-install"] :!vsphere: endif::[] diff --git a/modules/ssh-agent-using.adoc b/modules/ssh-agent-using.adoc index a224194ec7..722a7c7da8 100644 --- a/modules/ssh-agent-using.adoc +++ b/modules/ssh-agent-using.adoc @@ -43,10 +43,6 @@ // * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc // * installing/installing_vsphere/installing-vsphere.adoc // * installing/installing_vsphere/installing-vsphere-network-customizations.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc -// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc -// * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc // * installing/installing_ibm_z/installing-ibm-z.adoc // * installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc // * installing/installing_ibm_z/installing-ibm-z-kvm.adoc @@ -56,6 +52,7 @@ // * installing/installing-restricted-networks-nutanix-installer-provisioned.adoc // * installing/installing_azure/installing-restricted-networks-azure-installer-provisioned.adoc // * installing/installing_azure/installing-restricted-networks-azure-user-provisioned.adoc +// * installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc ifeval::["{context}" == "installing-restricted-networks-vsphere"]