OCPBUGS-32475: Remove direct OCI steps from RH docs

Author: dfitzmau

installing/installing_oci/installing-oci-assisted-installer.adoc

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="installing-oci-assisted-installer"]
-= Installing a cluster on {oci-first-no-rt} by using the Assisted Installer
+= Installing a cluster on {oci-first-no-rt} by using the {ai-full}
 include::_attributes/common-attributes.adoc[]
 :context: installing-oci-assisted-installer
 
@@ -17,17 +17,12 @@ include::modules/installing-oci-about-assisted-installer.adoc[leveloffset=+1]
 * link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform/[{ai-full} for {product-title}]
 * xref:../../installing/installing_platform_agnostic/installing-platform-agnostic.adoc#cluster-entitlements_installing-platform-agnostic[Internet access for {product-title}]
 * link:https://docs.oracle.com/en-us/iaas/Content/Block/Concepts/blockvolumeperformance.htm#vpus[Volume Performance Units (Oracle documentation)]
+* link:https://docs.oracle.com/iaas/Content/openshift-on-oci/installing-agent-about-instance-configurations.htm[Instance Sizing Recommendations for {product-title} on {oci} Nodes (Oracle) documentation]
 
-// Creating OCI resources
+// Creating OCI resources and services
 include::modules/creating-oci-resources-services.adoc[leveloffset=+1]
 
-[role="_additional-resources"]
-.Additional resources
-
-* link:https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcompartments.htm[Managing compartments (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/Object/Concepts/objectstorageoverview.htm[Overview of Object Storage (Oracle documentation)]
-
-// Using the Assisted Installer to generate an OCI-compatible Agent ISO image
+// Using the Assisted Installer to generate an OCI-compatible discovery ISO image
 include::modules/using-assisted-installer-oci-agent-iso.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
@@ -36,22 +31,25 @@ include::modules/using-assisted-installer-oci-agent-iso.adoc[leveloffset=+1]
 * xref:../../architecture/architecture-installation.adoc#architecture-installation[Installation and update]
 * xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[Configuring your firewall]
 
-// Downloading manifest files and deployment resources
-include::modules/downloading-manifest-files-resources-oci.adoc[leveloffset=+1]
+// Provisioning OCI infrastructure for your cluster
+include::modules/provision-oci-infrastructure-ocp-cluster.adoc[leveloffset=+1]
 
 // Completing the remaining Assisted Installer steps
 include::modules/complete-assisted-installer-oci.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform/[{ai-full} for {product-title}]
+
 // Verifying a successful cluster installation on OCI
 include::modules/verifying-cluster-install-ai-oci.adoc[leveloffset=+1]
 
-// Troubleshooting installation of a cluster on OCI
+// Troubleshooting the installation of a cluster on OCI
 include::modules/installing-troubleshooting-assisted-installer-oci.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
+* link:https://docs.oracle.com/iaas/Content/openshift-on-oci/openshift-troubleshooting.htm[Troubleshooting {product-title} on {oci} (Oracle documentation)]
 * xref:../../installing/installing_on_prem_assisted/installing-on-prem-assisted.adoc#using-the-assisted-installer_installing-on-prem-assisted[Installing an on-premise cluster using the {ai-full}]
-* link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform/[{ai-full} for {product-title}]
-* link:https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Concepts/resourcemanager.htm#ways[Ways to access Resource Manager (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Tasks/create-stack.htm#top[Creating a stack (Oracle documentation)]

modules/complete-assisted-installer-oci.adoc

@@ -4,17 +4,17 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="complete-assisted-installer-oci_{context}"]
-= Completing the remaining Assisted Installer steps
+= Completing the remaining {ai-full} steps
 
 After you provision {oci-first} resources and upload {product-title} custom manifest configuration files to {oci}, you must complete the remaining cluster installation steps on the {ai-full} before you can create an instance {oci}.
 
 .Prerequisites
 
-* You created a resource stack on {oci} that includes the custom manifest configuration files and {oci} Resource Manager configuration resources. See the "Downloading manifest files and deployment resources" section.
+* You created a resource stack on {oci} that includes the custom manifest configuration files and {oci} Resource Manager configuration resources. See "Provisioning {oci} infrastructure for your cluster".
 
 .Procedure
 
-. From the link:https://console.redhat.com/[Red Hat Hybrid Cloud Console] web console, go to the *Host discovery* page.
+. From the link:https://console.redhat.com/[{hybrid-console}] web console, go to the *Host discovery* page.
 
 . Under the *Role* column, select either `Control plane node` or `Worker` for each targeted hostname.
 +
@@ -35,3 +35,5 @@ Before, you can continue to the next steps, wait for each node to reach the `Rea
  - CSI driver machine configuration: `custom_manifest/openshift/machineconfig-csi.yml`
 
 . From the *Review and create* page, click *Install cluster* to create your {product-title} cluster on {oci}.
+
+After the cluster installation and initialization operations, the {ai-full} indicates the completion of the cluster installation operation. For more information, see "Completing the installation" section in the _{ai-full} for {product-title}_ document.

modules/creating-oci-infra-resources-services.adoc

@@ -10,8 +10,8 @@
 Before you install {product-title} on {oci-first}, you must create an {oci} environment on your virtual machine (VM) shape. By creating this environment, you can install {product-title} and deploy a cluster on infrastructure that supports a wide range of cloud options and strong security policies.
 
 .Prerequisites
-* You have prior knowledge of {oci} components. See link:https://docs.oracle.com/en-us/iaas/Content/GSG/Concepts/concepts.htm[Learn About Oracle Cloud Basics] in the Oracle documentation.
-* Your organization signed up for an Oracle account and Identity Domain. This step is required so that you can access an administrator account, which is the initial cloud-identity and access management (IAM) user for your organization. See link:https://docs.oracle.com/en-us/iaas/Content/Identity/Concepts/overview.htm#ariaid-title4[The administrators group and policy] section in the Oracle documentation.
+* You have prior knowledge of {oci} components. See link:https://docs.oracle.com/en-us/iaas/Content/GSG/Concepts/concepts.htm[Learn About Oracle Cloud Basics (Oracle documentation)].
+* Your organization signed up for an Oracle account and Identity Domain. This step is required so that you can access an administrator account, which is the initial cloud-identity and access management (IAM) user for your organization. See link:https://docs.oracle.com/en-us/iaas/Content/Identity/Concepts/overview.htm#ariaid-title4[The administrators group and policy (Oracle documentation)].
 * You have logged in to your organization’s {oci} account with administrator privileges.
 
 .Procedure

modules/creating-oci-resources-services.adoc

@@ -4,29 +4,16 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="creating-oci-resources-services_{context}"]
-= Creating OCI resources and services
+= Creating {oci} resources and services
 
 Create {oci-first} resources and services so that you can establish infrastructure with governance standards that meets your organization's requirements.
 
-By creating a compartment, you can better organize, restrict access, and set usage limits to {oci} resources. Additionally, by creating an object storage bucket, you can safely and securely store the ISO image. You can access the image at a later stage for the purposes of booting the instances, so that you can then create your cluster.
-
 .Prerequisites
 
-* You configured an {oci} account to host the cluster. See link:https://docs.oracle.com/en/cloud/get-started/subscriptions-cloud/csgsg/create-users-and-assign-roles.html#GUID-1041AC78-9E43-42CF-B5A5-73F8B8FEB39A[Create Users and Assign Roles] in the Oracle documentation.
+* You configured an {oci} account to host the cluster. See link:https://docs.oracle.com/iaas/Content/openshift-on-oci/install-prereq.htm[Prerequisites (Oracle documentation)].
 
 .Procedure
 
-. Log in to your link:https://cloud.oracle.com/a/[Oracle Cloud Infrastructure] account with administrator privileges.
-
-. Create a child compartment. See link:https://docs.public.oneportal.content.oci.oraclecloud.com/en-us/iaas/process-automation/oci-process-automation/create-compartment.html[Create a compartment] in the Oracle documentation.
-+
-[NOTE]
-====
-When creating the child compartment, specify the default parent compartment or any other parent compartment from the list.
-====
-
-. Record the name and the link:https://docs.oracle.com/en-us/iaas/Content/libraries/glossary/ocid.htm[{ocid-first}] of the compartment.
-
-. Create a bucket resource for your child compartment. Ensure that you specify your child compartment in the *Create in compartment* field for the bucket resource.
+. Log in to your link:https://cloud.oracle.com/a/[{oci-first-no-rt}] account with administrator privileges.
 
-. Go to *Object Storage & Archive Storage* -> *Buckets* and create a bucket, where *Bucket name* refers to your cluster's name.
+. Download an archive file from an Oracle resource. The archive file includes files for creating cluster resources and custom manifests. The archive file also includes a script, and when you run the script, the script creates {oci} resources, such as DNS records, an instance, and so on. For more information, see link:https://docs.oracle.com/iaas/Content/openshift-on-oci/install-prereq.htm#install-configuration-files[Configuration Files (Oracle documentation)].

modules/downloading-manifest-files-resources-oci.adoc

@@ -53,5 +53,5 @@ The following list provides some guidance in selecting the VPUs needed for speci
 * Base-production environment: 500 GB, and 60 VPUs.
 * Heavy-use production environment: More than 500 GB, and 100 or more VPUs.
 
-Consider allocating additional VPUs to give enough capacity for updates and scaling activities. See link:https://docs.oracle.com/en-us/iaas/Content/Block/Concepts/blockvolumeperformance.htm[Block Volume Performance Levels] in the Oracle documentation.
+Consider allocating additional VPUs to give enough capacity for updates and scaling activities. See link:https://docs.oracle.com/en-us/iaas/Content/Block/Concepts/blockvolumeperformance.htm[Block Volume Performance Levels (Oracle documentation)].
 ====

modules/installation-vsphere-infrastructure.adoc

@@ -36,5 +36,5 @@ To ensure the best performance conditions for your cluster workloads that operat
 * Basic environment: 500 GB, and 60 VPUs.
 * Heavy production environment: More than 500 GB, and 100 or more VPUs.
 
-Consider reserving additional VPUs to provide sufficient capacity for updates and scaling activities. For more information about VPUs, see Volume Performance Units in the Oracle documentation.
+Consider reserving additional VPUs to provide sufficient capacity for updates and scaling activities. For more information about VPUs, see Volume Performance Units (Oracle_ documentatio).
 ====

modules/installing-oci-about-agent-based-installer.adoc

@@ -4,7 +4,7 @@
 
 :_mod-docs-content-type: CONCEPT
 [id="installing-oci-about-assisted-installer_{context}"]
-= The Assisted Installer and OCI overview
+= The {ai-full} and {oci} overview
 
 You can run cluster workloads on {oci-first} infrastructure that supports dedicated, hybrid, public, and multiple cloud environments. Both Red Hat and Oracle test, validate, and support running {oci} in an {product-title} cluster on {oci}.
 
@@ -20,7 +20,7 @@ include::snippets/technology-preview.adoc[]
 The steps for provisioning {oci} resources are provided as an example only. You can also choose to create the required resources through other methods; the scripts are just an example. Installing a cluster with infrastructure that you provide requires knowledge of the cloud provider and the installation process on {product-title}. You can access {oci} Resource Manager configurations to complete these steps, or use the configurations to model your own custom script.
 ====
 
-Follow the steps in this document to understand how to use the {ai-full} to install a {product-title} cluster on {oci}. The document demonstrates the use of the {oci} Manager (CCM) and Oracle’s Container Storage Interface (CSI) objects to link your {product-title} cluster with the {oci} API.
+Follow the steps in the _Installing a cluster on {oci-first-no-rt} by using the Assisted Installer_ document to understand how to use the {ai-full} to install a {product-title} cluster on {oci}. This document demonstrates the use of the {oci} Cloud Controller Manager (CCM) and Oracle’s Container Storage Interface (CSI) objects to link your {product-title} cluster with the {oci} API.
 
 [IMPORTANT]
 ====
@@ -30,7 +30,7 @@ To ensure the best performance conditions for your cluster workloads that operat
 * Basic environment: 500 GB, and 60 VPUs.
 * Heavy production environment: More than 500 GB, and 100 or more VPUs.
 
-Consider reserving additional VPUs to provide sufficient capacity for updates and scaling activities. For more information about VPUs, see Volume Performance Units in the Oracle documentation.
+Consider reserving additional VPUs to provide sufficient capacity for updates and scaling activities. For more information about VPUs, see Volume Performance Units (Oracle documentation).
 ====
 
 If you are unfamiliar with the {product-title} {ai-full}, see "Assisted Installer for {product-title}".