[OSDOCS-17002] IBM Power VS CQA3 xrefs prereqs

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]

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]

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]

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]

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]

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]