From 5a4ae01293d0791e15ba394d876b0263153de592 Mon Sep 17 00:00:00 2001 From: Silke Niemann Date: Mon, 3 Aug 2026 09:41:21 +0200 Subject: [PATCH] IBM Power VS CQA2 xrefs prereqs --- .../creating-ibm-power-vs-workspace.adoc | 9 ++-- ...lation-config-parameters-ibm-power-vs.adoc | 3 +- ...installing-ibm-cloud-account-power-vs.adoc | 7 +-- ...nstalling-ibm-power-vs-customizations.adoc | 31 ++++++------- ...stalling-ibm-power-vs-private-cluster.adoc | 31 ++++++------- .../installing-ibm-powervs-vpc.adoc | 28 +++++------ ...ling-restricted-networks-ibm-power-vs.adoc | 46 ++++++++----------- .../preparing-to-install-on-ibm-power-vs.adoc | 27 +++++++---- .../uninstalling-cluster-ibm-power-vs.adoc | 1 + ...ting-ibm-power-vs-workspace-procedure.adoc | 1 + .../prereqs-ibm-power-vs-disconnected.adoc | 25 ++++++++++ modules/prereqs-ibm-power-vs.adoc | 18 ++++++++ 12 files changed, 137 insertions(+), 90 deletions(-) create mode 100644 modules/prereqs-ibm-power-vs-disconnected.adoc create mode 100644 modules/prereqs-ibm-power-vs.adoc diff --git a/installing/installing_ibm_powervs/creating-ibm-power-vs-workspace.adoc b/installing/installing_ibm_powervs/creating-ibm-power-vs-workspace.adoc index fda2d50eb6a4..3acf6078be33 100644 --- a/installing/installing_ibm_powervs/creating-ibm-power-vs-workspace.adoc +++ b/installing/installing_ibm_powervs/creating-ibm-power-vs-workspace.adoc @@ -4,9 +4,12 @@ include::_attributes/common-attributes.adoc[] = Creating an {ibm-power-server-title} workspace :context: creating-ibm-power-vs-workspace -include::modules/creating-ibm-power-vs-workspace-procedure.adoc[leveloffset=+1] +[role="_abstract"] +You can create an {ibm-power-server-name} workspace to host your {product-title} cluster. +include::modules/creating-ibm-power-vs-workspace-procedure.adoc[leveloffset=+1] -[id="next-steps_creating-ibm-power-vs-workspace"] -== Next steps +[role="_additional-resources"] +[id="additional-resources_{context}"] +== Additional resources * xref:../../installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc#installing-ibm-power-vs-customizations[Installing a cluster on {ibm-power-server-name} with customizations] diff --git a/installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc b/installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc index 30d70a062df1..a558efbfdaa7 100644 --- a/installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc +++ b/installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc @@ -7,6 +7,7 @@ include::_attributes/common-attributes.adoc[] toc::[] -Before you deploy an {product-title} on {ibm-power-server-name}, you provide parameters to customize your cluster and the platform that hosts it. When you create the `install-config.yaml` file, you provide values for the required parameters through the command line. You can then modify the `install-config.yaml` file to customize your cluster further. +[role="_abstract"] +Before you deploy an {product-title} cluster on {ibm-power-server-name}, you provide parameters to customize your cluster and the platform that hosts it. include::modules/installation-configuration-parameters.adoc[leveloffset=+1] diff --git a/installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc b/installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc index c44017a3c7b0..22ecb40d98ef 100644 --- a/installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc +++ b/installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc @@ -6,9 +6,9 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] Before you can install {product-title}, you must configure an {ibm-cloud-name} account. -[id="prerequisites_installing-ibm-cloud-account-power-vs"] == Prerequisites * You have an {ibm-cloud-name} account with a subscription. You cannot install {product-title} on a free or on a trial {ibm-cloud-name} account. @@ -31,6 +31,7 @@ include::modules/installation-ibm-cloud-creating-api-key.adoc[leveloffset=+2] include::modules/installation-ibm-cloud-regions.adoc[leveloffset=+1] -[id="next-steps_installing-ibm-cloud-account-power-vs"] -== Next steps +[role="_additional-resources"] +[id="additional-resources_{context}"] +== Additional resources * xref:../../installing/installing_ibm_powervs/creating-ibm-power-vs-workspace.adoc#creating-ibm-power-vs-workspace[Creating an {ibm-power-server-name} workspace] diff --git a/installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc b/installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc index d056efec10d1..f60ea104d9ad 100644 --- a/installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc +++ b/installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc @@ -6,16 +6,18 @@ include::_attributes/common-attributes.adoc[] toc::[] -In {product-title} version {product-version}, you can install a customized cluster on infrastructure that the installation program provisions on {ibm-power-server-title}. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster. +[role="_abstract"] +In {product-title} version {product-version}, you can install a customized cluster on {ibm-power-server-title} infrastructure that the installation program provisions. -[id="prerequisites_installing-ibm-powervs-customizations"] -== Prerequisites +include::modules/prereqs-ibm-power-vs.adoc[leveloffset=+1] -* 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/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[configured an {ibm-cloud-name} account] to host the cluster. -* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. -* You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility]. +[role="_additional-resources"] +.Additional resources +* xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[Configuring an {ibm-cloud-name} account] +* xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] +* xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility] include::modules/cluster-entitlements.adoc[leveloffset=+1] @@ -29,7 +31,7 @@ include::modules/installation-initializing.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] +* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] include::modules/installation-ibm-power-vs-config-yaml.adoc[leveloffset=+2] @@ -58,12 +60,9 @@ include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -[id="additional-resources_installing-ibm-power-vs-customizations-telemetry"] -.Additional resources -* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] +[id="additional-resources_{context}"] +== Additional resources -[id="next-steps_installing-ibm-power-vs-customizations"] -== Next steps +* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] * xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] -* If necessary, you can -xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] +* xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] diff --git a/installing/installing_ibm_powervs/installing-ibm-power-vs-private-cluster.adoc b/installing/installing_ibm_powervs/installing-ibm-power-vs-private-cluster.adoc index 8d3da3cfa995..3d7287f3c813 100644 --- a/installing/installing_ibm_powervs/installing-ibm-power-vs-private-cluster.adoc +++ b/installing/installing_ibm_powervs/installing-ibm-power-vs-private-cluster.adoc @@ -6,16 +6,18 @@ include::_attributes/common-attributes.adoc[] toc::[] -In {product-title} version {product-version}, you can install a private cluster into an existing VPC and {ibm-power-server-name} Workspace. The installation program provisions the rest of the required infrastructure, which you can further customize. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster. +[role="_abstract"] +In {product-title} version {product-version}, you can install a private cluster into an existing VPC and {ibm-power-server-name} workspace. -[id="prerequisites_installing-ibm-power-vs-private-cluster"] -== Prerequisites +include::modules/prereqs-ibm-power-vs.adoc[leveloffset=+1] -* 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/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[configured an {ibm-cloud-name} account] to host the cluster. -* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. -* You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility]. +[role="_additional-resources"] +.Additional resources +* xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[Configuring an {ibm-cloud-name} account] +* xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] +* xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility] include::modules/private-clusters-default.adoc[leveloffset=+1] @@ -35,7 +37,7 @@ include::modules/installation-initializing-manual.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] +* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2] @@ -71,12 +73,9 @@ include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -[id="additional-resources_installing-ibm-power-vs-private-telemetry"] -.Additional resources -* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] - +[id="additional-resources_{context}"] +== Additional resources -[id="next-steps_installing-ibm-power-vs-private-cluster"] -== Next steps +* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] * xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] -* Optional: xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] +* xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] diff --git a/installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc b/installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc index 9e8f03d8711b..2484f4d655a7 100644 --- a/installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc +++ b/installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc @@ -6,16 +6,18 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] In {product-title} version {product-version}, you can install a cluster into an existing Virtual Private Cloud (VPC) on {ibm-cloud-name}. The installation program provisions the rest of the required infrastructure, which you can then further customize. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster. -[id="prerequisites_installing-ibm-powervs-vpc"] -== Prerequisites +include::modules/prereqs-ibm-power-vs.adoc[leveloffset=+1] -* 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/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[configured an {ibm-cloud-name} account] to host the cluster. -* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. -* You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility]. +[role="_additional-resources"] +.Additional resources +* xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[Configuring an {ibm-cloud-name} account] +* xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] +* xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility] include::modules/installation-custom-ibm-power-vs.adoc[leveloffset=+1] @@ -31,7 +33,7 @@ include::modules/installation-initializing.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] +* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2] @@ -67,11 +69,9 @@ include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -[id="additional-resources_installing-ibm-powervs-vpc-telemetry"] -.Additional resources -* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] +[id="additional-resources_{context}"] +== Additional resources -[id="next-steps_installing-ibm-powervs-vpc"] -== Next steps +* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] * xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] -* Optional: xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] +* xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] diff --git a/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc b/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc index 452d57539905..6a867aab9caa 100644 --- a/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc +++ b/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc @@ -6,25 +6,19 @@ include::_attributes/common-attributes.adoc[] toc::[] -In {product-title} {product-version}, you can install a cluster on {ibm-cloud-name} in a restricted network by creating an internal mirror of the installation release content on an existing Virtual Private Cloud (VPC) on {ibm-cloud-name}. - -[id="prerequisites_installing-ibm-power-vs-restricted"] -== Prerequisites - -* 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/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[configured an {ibm-cloud-name} account] to host the cluster. -* You xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. -+ -[IMPORTANT] -==== -Because the installation media is on the mirror host, you can use that computer to complete all installation steps. -==== -* You have an existing VPC in {ibm-cloud-name}. When installing a cluster in a restricted network, you cannot use the installer-provisioned VPC. You must use a user-provisioned VPC that satisfies one of the following requirements: -** Contains the mirror registry -** Has firewall rules or a peering connection to access the mirror registry hosted elsewhere -* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. -* You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility]. +[role="_abstract"] +In {product-title} {product-version}, you can install a cluster on {ibm-cloud-name} in a restricted network by using an internal mirror of the installation release content. + +include::modules/prereqs-ibm-power-vs-disconnected.adoc[leveloffset=+1] + +[role="_additional-resources"] +.Additional resources +* xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[Configuring an {ibm-cloud-name} account] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] +* xref:../../installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc#cco-ccoctl-configuring_preparing-to-install-on-ibm-power-vs[Configuring the Cloud Credential Operator utility] include::modules/installation-about-restricted-network.adoc[leveloffset=+1] @@ -40,7 +34,7 @@ include::modules/installation-initializing.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] +* xref:../../installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc#installation-config-parameters-ibm-power-vs[Installation configuration parameters for {ibm-power-server-name}] include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2] @@ -78,12 +72,10 @@ include::modules/olm-restricted-networks-configuring-operatorhub.adoc[leveloffse include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -[id="additional-resources_installing-ibm-power-vs-restricted-telemetry"] -.Additional resources -* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] +[id="additional-resources_{context}"] +== Additional resources -[id="next-steps_installing-ibm-power-vs-restricted"] -== Next steps +* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] * xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] -* Optional: xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] -* Optional: xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#insights-operator-register-disconnected-cluster_remote-health-reporting[Registering your disconnected cluster] +* xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] +* xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#insights-operator-register-disconnected-cluster_remote-health-reporting[Registering your disconnected cluster] diff --git a/installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc b/installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc index 72c61d8bfe60..39c6dc6e9f82 100644 --- a/installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc +++ b/installing/installing_ibm_powervs/preparing-to-install-on-ibm-power-vs.adoc @@ -6,31 +6,38 @@ include::_attributes/common-attributes.adoc[] toc::[] -You can install {product-title} on {ibm-power-server-name} using installer-provisioned infrastructure. This process involves using an installation program to provision the underlying infrastructure for your cluster. Installing {product-title} on {ibm-power-server-name} using user-provisioned infrastructure is not supported at this time. +[role="_abstract"] +You can install {product-title} on {ibm-power-server-name} using installer-provisioned infrastructure. -See xref:../../architecture/architecture-installation.adoc#installation-process_architecture-installation[Installation process] for more information about installer-provisioned installation processes. +Installing {product-title} on {ibm-power-server-name} using user-provisioned infrastructure is not supported at this time. [id="choosing-an-method-to-install-ocp-on-power-vs-installer-provisioned"] == Installing a cluster on installer-provisioned infrastructure You can install a cluster on {ibm-power-server-name} infrastructure that is provisioned by the {product-title} installation program by using one of the following methods: -* **xref:../../installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc#installing-ibm-power-vs-customizations[Installing a customized cluster on {ibm-power-server-name}]**: You can install a customized cluster on {ibm-power-server-name} infrastructure that the installation program provisions. The installation program allows for some customization to be applied at the installation stage. Many other customization options are available xref:../../post_installation_configuration/cluster-tasks.adoc#post-install-cluster-tasks[post-installation]. +* **Installing a customized cluster on {ibm-power-server-name}**: You can install a customized cluster on {ibm-power-server-name} infrastructure that the installation program provisions. The installation program allows for some customization to be applied at the installation stage. Many other customization options are available postinstallation. -* **xref:../../installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc#installing-ibm-powervs-vpc[Installing a cluster on {ibm-power-server-name} into an existing VPC]**: You can install {product-title} on {ibm-power-server-name} into an existing Virtual Private Cloud (VPC). You can use this installation method if you have constraints set by the guidelines of your company, such as limits when creating new accounts or infrastructure. +* **Installing a cluster on {ibm-power-server-name} into an existing VPC**: You can install {product-title} on {ibm-power-server-name} into an existing Virtual Private Cloud (VPC). You can use this installation method if you have constraints set by the guidelines of your company, such as limits when creating new accounts or infrastructure. -* **xref:../../installing/installing_ibm_powervs/installing-ibm-power-vs-private-cluster.adoc#installing-ibm-power-vs-private-cluster[Installing a private cluster on {ibm-power-server-name}]**: You can install a private cluster on {ibm-power-server-name}. You can use this method to deploy {product-title} on an internal network that is not visible to the internet. +* **Installing a private cluster on {ibm-power-server-name}**: You can install a private cluster on {ibm-power-server-name}. You can use this method to deploy {product-title} on an internal network that is not visible to the internet. -* **xref:../../installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc#installing-restricted-networks-ibm-power-vs[Installing a cluster on {ibm-power-server-name} in a restricted network]**: You can install {product-title} on {ibm-power-server-name} on installer-provisioned infrastructure by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. +* **Installing a cluster on {ibm-power-server-name} in a restricted network**: You can install {product-title} on {ibm-power-server-name} on installer-provisioned infrastructure by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. include::modules/cco-ccoctl-configuring.adoc[leveloffset=+1] [role="_additional-resources"] [id="additional-resources_configuring-ibm-cloud-refreshing-ids"] - .Additional resources * xref:../../post_installation_configuration/changing-cloud-credentials-configuration.adoc#refreshing-service-ids-ibm-cloud_changing-cloud-credentials-configuration[Rotating API keys] -[id="next-steps_preparing-to-install-on-ibm-power-vs"] -== Next steps -* xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[Configuring an {ibm-cloud-name} account] \ No newline at end of file +[role="_additional-resources"] +[id="additional-resources_{context}"] +== Additional resources + +* xref:../../architecture/architecture-installation.adoc#installation-process_architecture-installation[Installation process] +* xref:../../installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc#installing-ibm-power-vs-customizations[Installing a customized cluster on {ibm-power-server-name}] +* xref:../../installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc#installing-ibm-powervs-vpc[Installing a cluster on {ibm-power-server-name} into an existing VPC] +* xref:../../installing/installing_ibm_powervs/installing-ibm-power-vs-private-cluster.adoc#installing-ibm-power-vs-private-cluster[Installing a private cluster on {ibm-power-server-name}] +* xref:../../installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc#installing-restricted-networks-ibm-power-vs[Installing a cluster on {ibm-power-server-name} in a restricted network] +* xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[Configuring an {ibm-cloud-name} account] diff --git a/installing/installing_ibm_powervs/uninstalling-cluster-ibm-power-vs.adoc b/installing/installing_ibm_powervs/uninstalling-cluster-ibm-power-vs.adoc index fb45a22abe56..9ad51ad5ce8b 100644 --- a/installing/installing_ibm_powervs/uninstalling-cluster-ibm-power-vs.adoc +++ b/installing/installing_ibm_powervs/uninstalling-cluster-ibm-power-vs.adoc @@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] You can remove a cluster that you deployed to {ibm-power-server-name}. include::modules/installation-uninstall-clouds.adoc[leveloffset=+1] \ No newline at end of file diff --git a/modules/creating-ibm-power-vs-workspace-procedure.adoc b/modules/creating-ibm-power-vs-workspace-procedure.adoc index cfde2fa57b53..a9e03049af7d 100644 --- a/modules/creating-ibm-power-vs-workspace-procedure.adoc +++ b/modules/creating-ibm-power-vs-workspace-procedure.adoc @@ -4,6 +4,7 @@ [id="creating-ibm-power-vs-workspace-procedure_{context}"] = Creating an {ibm-power-server-title} workspace +[role="_abstract"] Use the following procedure to create an {ibm-power-server-name} workspace. .Procedure diff --git a/modules/prereqs-ibm-power-vs-disconnected.adoc b/modules/prereqs-ibm-power-vs-disconnected.adoc new file mode 100644 index 000000000000..6581ba19e2b4 --- /dev/null +++ b/modules/prereqs-ibm-power-vs-disconnected.adoc @@ -0,0 +1,25 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc + +:_mod-docs-content-type: REFERENCE +[id="prereqs-ibm-power-vs-disconnected_{context}"] += Prerequisites + +[role="_abstract"] +Before beginning your cluster installation, you must complete prerequisite tasks that prepare your environment. + +* You reviewed details about the {product-title} installation and update processes. +* You read the documentation on selecting a cluster installation method and preparing it for users. +* You configured an {ibm-cloud-name} account to host the cluster. +* You mirrored the images for a disconnected installation to your registry and obtained the `imageContentSources` data for your version of {product-title}. ++ +[IMPORTANT] +==== +Because the installation media is on the mirror host, you can use that computer to complete all installation steps. +==== +* You have an existing VPC in {ibm-cloud-name}. When installing a cluster in a restricted network, you cannot use the installer-provisioned VPC. You must use a user-provisioned VPC that satisfies one of the following requirements: +** Contains the mirror registry +** Has firewall rules or a peering connection to access the mirror registry hosted elsewhere +* If you use a firewall, you configured it to allow the sites that your cluster requires access to. +* You configured the `ccoctl` utility before you installed the cluster. diff --git a/modules/prereqs-ibm-power-vs.adoc b/modules/prereqs-ibm-power-vs.adoc new file mode 100644 index 000000000000..3bffa6f7e053 --- /dev/null +++ b/modules/prereqs-ibm-power-vs.adoc @@ -0,0 +1,18 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_powervs/installing-ibm-power-vs-customizations.adoc +// * installing/installing_ibm_powervs/installing-ibm-powervs-vpc.adoc +// * installing/installing_ibm_powervs/installing-ibm-power-vs-private-cluster.adoc + +:_mod-docs-content-type: REFERENCE +[id="prereqs-ibm-power-vs_{context}"] += Prerequisites + +[role="_abstract"] +Before beginning your cluster installation, you must complete prerequisite tasks that prepare your environment. + +* You reviewed details about the {product-title} installation and update processes. +* You read the documentation on selecting a cluster installation method and preparing it for users. +* You configured an {ibm-cloud-name} account to host the cluster. +* If you use a firewall, you configured it to allow the sites that your cluster requires access to. +* You configured the `ccoctl` utility before you installed the cluster.