[WIP] OCP 4.11 - IBM Cloud Power VS using installer-provisioned infrastructure

_topic_maps/_topic_map.yml

@@ -258,6 +258,22 @@ Topics:
     File: installing-ibm-cloud-network-customizations
   - Name: Uninstalling a cluster on IBM Cloud VPC
     File: uninstalling-cluster-ibm-cloud
+- Name: Installing on IBM Cloud Power VS
+  Dir: installing_ibm_cloud_power_vs
+  Distros: openshift-origin,openshift-enterprise
+  Topics:
+  - Name: Preparing to install on IBM Cloud Power VS
+    File: preparing-to-install-on-ibm-cloud-power-vs
+  - Name: Configuring an IBM Cloud account
+    File: installing-ibm-cloud-account-power-vs
+  - Name: Configuring IAM for IBM Cloud
+    File: configuring-iam-ibm-cloud-power-vs
+  - Name: Installing a cluster on Power VS with customizations
+    File: installing-power-vs-customizations
+  - Name: Installing a cluster on Power VS with network customizations
+    File: installing-power-vs-network-customizations
+  - Name: Uninstalling a cluster on Power VS
+    File: uninstalling-cluster-power-vs
 - Name: Installing on bare metal
   Dir: installing_bare_metal
   Distros: openshift-origin,openshift-enterprise

installing/installing_ibm_cloud_power_vs/_attributes

@@ -0,0 +1 @@
+../../_attributes/

installing/installing_ibm_cloud_power_vs/configuring-iam-ibm-cloud-power-vs.adoc

@@ -0,0 +1,29 @@
+:_content-type: ASSEMBLY
+[id="configuring-iam-ibm-cloud"]
+= Configuring IAM for IBM Cloud
+include::_attributes/common-attributes.adoc[]
+:context: configuring-iam-ibm-cloud
+
+toc::[]
+
+In environments where the cloud identity and access management (IAM) APIs are not reachable, you must put the Cloud Credential Operator (CCO) into manual mode before you install the cluster.
+
+include::modules/alternatives-to-storing-admin-secrets-in-kube-system.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_configuring-iam-ibm-cloud-about-cco"]
+.Additional resources
+* xref:../../authentication/managing_cloud_provider_credentials/about-cloud-credential-operator.adoc#about-cloud-credential-operator[About the Cloud Credential Operator]
+
+include::modules/cco-ccoctl-configuring-power-vs.adoc[leveloffset=+1]
+//include::modules/manually-maintained-credentials-upgrade.adoc[leveloffset=+1]
+// Will need to revisit upgrade scenario for IBM Cloud; not needed until OCP 4.11. Tentative instructions have been added for reference later.
+
+[role="_additional-resources"]
+[id="additional-resources_configuring-iam-ibm-cloud-refreshing-ids"]
+.Additional resources
+* xref:../../post_installation_configuration/cluster-tasks.adoc#refreshing-service-ids-ibm-cloud_post-install-cluster-tasks[Rotating API keys for IBM Cloud VPC]
+
+[id="next-steps_configuring-iam-ibm-cloud"]
+== Next steps
+* xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-customizations.adoc#installing-ibm-cloud-customizations[Installing a cluster on IBM Cloud VPC with customizations]

installing/installing_ibm_cloud_power_vs/images

@@ -0,0 +1 @@
+../../images

installing/installing_ibm_cloud_power_vs/installing-ibm-cloud-account-power-vs.adoc

@@ -0,0 +1,30 @@
+:_content-type: ASSEMBLY
+[id="installing-ibm-cloud-account"]
+= Configuring an IBM Cloud account
+include::_attributes/common-attributes.adoc[]
+:context: installing-ibm-cloud-account
+
+toc::[]
+
+Before you can install {product-title}, you must configure an IBM Cloud account.
+
+:FeatureName: IBM Cloud VPC using installer-provisioned infrastructure
+include::snippets/technology-preview.adoc[]
+
+[id="prerequisites_installing-ibm-cloud-account"]
+== Prerequisites
+
+* You have an IBM Cloud account with a subscription. You cannot install {product-title} on a free or trial IBM Cloud VPC account.
+
+include::modules/quotas-and-limits-ibm-cloud-power-vs.adoc[leveloffset=+1]
+
+include::modules/installation-cis-ibm-cloud.adoc[leveloffset=+1]
+
+include::modules/installation-ibm-cloud-iam-policies-api-key.adoc[leveloffset=+1]
+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"]
+== Next steps
+* xref:../../installing/installing_ibm_cloud_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud VPC]

installing/installing_ibm_cloud_power_vs/installing-power-vs-customizations.adoc

@@ -0,0 +1,68 @@
+:_content-type: ASSEMBLY
+[id="installing-ibm-cloud-customizations"]
+= Installing a cluster on Power VS with customizations
+include::_attributes/common-attributes.adoc[]
+:context: installing-ibm-cloud-customizations
+
+toc::[]
+
+In {product-title} version {product-version}, you can install a customized cluster on infrastructure that the installation program provisions on Power VS. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster.
+
+:FeatureName: Power VS using installer-provisioned infrastructure
+include::snippets/technology-preview.adoc[]
+
+[id="prerequisites_installing-ibm-cloud-customizations"]
+== 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/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
+* You xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an IBM Cloud account] to host the cluster.
+* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#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_cloud_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud].
+* You’ve created a Power VS Service Instance.
+
+include::modules/cluster-entitlements.adoc[leveloffset=+1]
+
+include::modules/power-vs-ssh-agent-using.adoc[leveloffset=+1]
+
+include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
+
+include::modules/installation-ibm-cloud-power-vs-export-variables.adoc[leveloffset=+1]
+
+include::modules/installation-initializing-power-vs.adoc[leveloffset=+1]
+
+include::modules/installation-configuration-parameters-power-vs.adoc[leveloffset=+2]
+
+include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2]
+
+//.Additional resources
+
+//* ../../machine_management/creating_machinesets/creating-machineset-ibm-cloud.adoc#machineset-enabling-customer-managed-encryption_creating-machineset-ibm-cloud[Enabling customer-managed encryption keys for a machine set]
+
+include::modules/installation-configure-proxy.adoc[leveloffset=+2]
+
+include::modules/manually-create-iam-ibm-cloud.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]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-ibm-cloud-customizations-console"]
+.Additional resources
+* xref:../../web_console/web-console.adoc#web-console[Accessing the web console]
+
+include::modules/cluster-telemetry.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-ibm-cloud-customizations-telemetry"]
+.Additional resources
+* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]
+
+[id="next-steps_installing-ibm-cloud-customizations"]
+== Next steps
+* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
+* If necessary, you can
+xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting].

installing/installing_ibm_cloud_power_vs/installing-power-vs-network-customizations.adoc

@@ -0,0 +1,76 @@
+:_content-type: ASSEMBLY
+[id="installing-ibm-cloud-network-customizations"]
+= Installing a cluster on Power VS with network customizations
+include::_attributes/common-attributes.adoc[]
+:context: installing-ibm-cloud-network-customizations
+
+toc::[]
+
+In {product-title} version {product-version}, you can install a cluster with a
+customized network configuration on infrastructure that the installation program provisions on Power VS. By customizing your network configuration, your cluster can coexist with existing IP address allocations in your environment and integrate with existing MTU and VXLAN configurations. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster.
+
+You must set most of the network configuration parameters during installation, and you can modify only `kubeProxy` configuration parameters in a running cluster.
+
+:FeatureName: Power VS using installer-provisioned infrastructure
+include::snippets/technology-preview.adoc[]
+
+[id="prerequisites_installing-ibm-cloud-network-customizations"]
+== 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/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
+* You xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an IBM Cloud VPC account] to host the cluster.
+* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#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_cloud_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud VPC].
+
+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-ibm-cloud-export-variables.adoc[leveloffset=+1]
+
+include::modules/installation-initializing.adoc[leveloffset=+1]
+
+include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
+
+include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2]
+
+//.Additional resources
+
+//* ../../machine_management/creating_machinesets/creating-machineset-ibm-cloud.adoc#machineset-enabling-customer-managed-encryption_creating-machineset-ibm-cloud[Enabling customer-managed encryption keys for a machine set]
+
+include::modules/installation-configure-proxy.adoc[leveloffset=+2]
+
+include::modules/manually-create-iam-ibm-cloud.adoc[leveloffset=+1]
+
+// Network Operator specific configuration
+include::modules/nw-network-config.adoc[leveloffset=+1]
+include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1]
+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]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-ibm-cloud-network-customizations-console"]
+.Additional resources
+* xref:../../web_console/web-console.adoc#web-console[Accessing the web console]
+
+include::modules/cluster-telemetry.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_installing-ibm-cloud-network-customizations-telemetry"]
+.Additional resources
+* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]
+
+[id="next-steps_installing-ibm-cloud-network-customizations"]
+== Next steps
+
+* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
+* If necessary, you can
+xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting].

installing/installing_ibm_cloud_power_vs/modules

@@ -0,0 +1 @@
+../../modules

installing/installing_ibm_cloud_power_vs/preparing-to-install-on-ibm-cloud-power-vs.adoc

@@ -0,0 +1,44 @@
+:_content-type: ASSEMBLY
+[id="preparing-to-install-on-ibm-cloud"]
+= Preparing to install on IBM Cloud VPC
+include::_attributes/common-attributes.adoc[]
+:context: preparing-to-install-on-ibm-cloud
+
+toc::[]
+
+The installation workflows documented in this section are for IBM Cloud VPC infrastructure environments. IBM Cloud Classic is not supported at this time. For more information on the difference between Classic and VPC infrastructures, see IBM's link:https://cloud.ibm.com/docs/cloud-infrastructure?topic=cloud-infrastructure-compare-infrastructure[documentation].
+
+[id="prerequisites_preparing-to-install-on-ibm-cloud"]
+== 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/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
+
+:FeatureName: IBM Cloud using installer-provisioned infrastructure
+include::snippets/technology-preview.adoc[]
+
+[id="requirements-for-installing-ocp-on-ibm-cloud"]
+== Requirements for installing {product-title} on IBM Cloud VPC
+
+Before installing {product-title} on IBM Cloud Power VS, you must create a service account and configure an IBM Cloud account. See xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[Configuring an IBM Cloud VPC account] for details about creating an account, configuring DNS and supported IBM Cloud Power VS regions.
+
+You must manually manage your cloud credentials when installing a cluster to IBM Cloud Power VS. Do this by configuring the Cloud Credential Operator (CCO) for manual mode before you install the cluster. For more information, see xref:../../installing/installing_ibm_cloud_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud VPC].
+
+[id="choosing-a-method-to-install-ocp-on-ibm-cloud"]
+== Choosing a method to install {product-title} on IBM Cloud VPC
+
+You can install {product-title} on IBM Cloud Power VS using installer-provisioned infrastructure. This process involves using an installation program to provision the underlying infrastructure for your cluster.
+
+See xref:../../architecture/architecture-installation.adoc#installation-process_architecture-installation[Installation process] for more information about installer-provisioned installation processes.
+
+[id="choosing-an-method-to-install-ocp-on-ibm-cloud-installer-provisioned"]
+=== Installing a cluster on installer-provisioned infrastructure
+
+You can install a cluster on IBM Cloud Power VS infrastructure that is provisioned by the {product-title} installation program by using one of the following methods:
+
+* **xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-customizations.adoc#installing-ibm-cloud-customizations[Installing a customized cluster on IBM Cloud VPC]**: You can install a customized cluster on IBM Cloud VPC 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].
+
+[id="next-steps_preparing-to-install-on-ibm-cloud"]
+== Next steps
+* xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[Configuring an IBM Cloud VPC account]

installing/installing_ibm_cloud_power_vs/snippets

@@ -0,0 +1 @@
+../../snippets/

installing/installing_ibm_cloud_power_vs/uninstalling-cluster-power-vs.adoc

@@ -0,0 +1,11 @@
+:_content-type: ASSEMBLY
+[id="uninstalling-cluster-ibm-cloud"]
+= Uninstalling a cluster on Power VS
+include::_attributes/common-attributes.adoc[]
+:context: uninstalling-cluster-ibm-cloud
+
+toc::[]
+
+You can remove a cluster that you deployed to Power VS.
+
+include::modules/installation-uninstall-clouds-power-vs.adoc[leveloffset=+1]