Merge pull request #74910 from dfitzmau/OCPBUGS-32490

OCPBUGS-32490: Removed OCI steps from ABI docs

Author: jldohmann

installing/installing_oci/installing-oci-agent-based-installer.adoc

@@ -19,20 +19,15 @@ include::modules/installing-oci-about-agent-based-installer.adoc[leveloffset=+1]
 * xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#understanding-agent-install_preparing-to-install-with-agent-based-installer[Understanding the Agent-based Installer]
 * link:https://docs.oracle.com/en-us/iaas/Content/Compute/Concepts/computeoverview.htm[Overview of the Compute Service (Oracle documentation)]
 * 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 infrastructure resources and services
-include::modules/creating-oci-infra-resources-services.adoc[leveloffset=+1]
+include::modules/abi-oci-resources-services.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
-* link:https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcompartments.htm#ariaid-title5[Creating compartments (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/Network/Tasks/create_vcn.htm[Creating a VCN (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/create-nsg.htm[Creating an NSG (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengdynamicgrouppolicyforselfmanagednodes.htm[Creating a dynamic group and a policy for self-managed nodes (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingpolicies.htm[Managing policies (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/Balance/Tasks/managingloadbalancer_topic-Creating_Load_Balancers.htm[Creating a load balancer (Oracle documentation)]
-* link:https://docs.oracle.com/en-us/iaas/Content/DNS/Tasks/record-add.htm[Adding a record to a DNS zone (Oracle documentation)]
+* link:https://docs.oracle.com/en-us/iaas/Content/GSG/Concepts/concepts.htm[Learn About Oracle Cloud Basics (Oracle documentation)]
 
 // Creating configuration files for installing a cluster on OCI
 include::modules/creating-config-files-cluster-install-oci.adoc[leveloffset=+1]
@@ -41,15 +36,10 @@ include::modules/creating-config-files-cluster-install-oci.adoc[leveloffset=+1]
 .Additional resources
 
 * xref:../../architecture/architecture-installation.adoc#installation-overview_architecture-installation[About {product-title} installation]
-
 * xref:../../installing/installing-preparing.adoc#installing-preparing-selecting-cluster-type[Selecting a cluster installation type]
-
 * xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#about-the-agent-based-installer[Preparing to install with the Agent-based Installer]
-
 * xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-retrieve_installing-with-agent-based-installer[Downloading the Agent-based Installer]
-
 * xref:../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository]
-
 * xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-ztp_installing-with-agent-based-installer[Optional: Using ZTP manifests]
 
 // Configuring your firewall
@@ -62,6 +52,8 @@ include::modules/running-cluster-oci-agent-based.adoc[leveloffset=+1]
 .Additional resources
 
 * xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#recommended-resources-for-topologies[Recommended resources for topologies]
+* 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)]
+* link:https://docs.oracle.com/iaas/Content/openshift-on-oci/openshift-troubleshooting.htm[Troubleshooting {product-title} on {oci} (Oracle documentation)]
 
 // Verifying a succesful cluster installation on OCI
 include::modules/verifying-cluster-install-oci-agent-based.adoc[leveloffset=+1]

modules/abi-oci-resources-services.adoc

@@ -0,0 +1,30 @@
+// Module included in the following assemblies:
+//
+// * installing/installing_oci/installing-oci-agent-based-installer.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="abi-oci-resources-services_{context}"]
+= Creating {oci} infrastructure resources and services
+
+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 an infrastructure that supports a wide range of cloud options and strong security policies. Having prior knowledge of {oci} components can help you with understanding the concept of {oci} resources and how you can configure them to meet your organizational needs.
+
+The Agent-based installer method for installing an {product-title} cluster on {oci} requires that you manually create {oci} resources and services.
+
+[IMPORTANT]
+====
+To ensure compatibility with {product-title}, you must set `A` as the record type for each DNS record and name records as follows:
+
+* `api.<cluster_name>.<base_domain>`, which targets the `apiVIP` parameter of the API load balancer.
+* `api-int.<cluster_name>.<base_domain>`, which targets the `apiVIP` parameter of the API load balancer.
+* `*.apps.<cluster_name>.<base_domain>`, which targets the `ingressVIP` parameter of the Ingress load balancer.
+
+The `api.+*+` and `api-int.+*+` DNS records relate to control plane machines, so you must ensure that all nodes in your installed {product-title} cluster can access these DNS records.
+====
+
+.Prerequisites
+
+* You configured an {oci} account to host the {product-title} cluster. See link:https://docs.oracle.com/iaas/Content/openshift-on-oci/install-prereq.htm[Prerequisites (Oracle documentation)].
+
+.Procedure
+
+* Create the required {oci} resources and services. See link:https://docs.oracle.com/iaas/Content/openshift-on-oci/agent-prereq.htm[{oci} Resources Needed for Using the Agent-based Installer (Oracle documentation)].

modules/creating-config-files-cluster-install-oci.adoc

@@ -4,19 +4,22 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="creating-config-files-cluster-install-oci_{context}"]
-= Creating configuration files for installing a cluster on OCI
+= Creating configuration files for installing a cluster on {oci}
 
 You need to create the `install-config.yaml` and the `agent-config.yaml` configuration files so that you can use the Agent-based Installer to generate a bootable ISO image. The Agent-based installation comprises a bootable ISO that has the Assisted discovery agent and the Assisted Service. Both of these components are required to perform the cluster installation, but the latter component runs on only one of the hosts.
 
-In a later procedure, you can upload your generated agent ISO image to Oracle’s default Object Storage bucket, which is the initial step for integrating your {product-title} cluster on {oci-first}.
+At a later stage, you must follow the steps in the Oracle documentation for uploading your generated agent ISO image to Oracle’s default Object Storage bucket, which is the initial step for integrating your {product-title} cluster on {oci-first}.
 
+[NOTE]
+====
 You can also use the Agent-based Installer to generate or accept Zero Touch Provisioning (ZTP) custom resources.
+====
 
 .Prerequisites
 * 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 read the documentation on selecting a cluster installation method and preparing the method for users.
 * You have read the "Preparing to install with the Agent-based Installer" documentation.
-* You downloaded the Agent-Based Installer and the command-line interface (CLI) from the Red{nbsp}Hat Hybrid Cloud Console.
+* You downloaded the Agent-Based Installer and the command-line interface (CLI) from the {hybrid-console}.
 * You have logged in to the {product-title} with administrator privileges.
 
 .Procedure
@@ -83,7 +86,7 @@ pullSecret: '<pull_secret>' <6>
 <3> Depending on your infrastructure, you can select either `x86_64`, or `amd64`.
 <4> Set `OCI` as the external platform, so that {product-title} can integrate with {oci}.
 <5> Specify your SSH public key.
-<6> The pull secret that you need for authenticate purposes when downloading container images for {product-title} components and services, such as Quay.io. See link:https://console.redhat.com/openshift/install/pull-secret[Install {product-title} 4] from the Red{nbsp}Hat Hybrid Cloud Console.
+<6> The pull secret that you need for authenticate purposes when downloading container images for {product-title} components and services, such as Quay.io. See link:https://console.redhat.com/openshift/install/pull-secret[Install {product-title} 4] from the {hybrid-console}.
 
 . Create a directory on your local system named `openshift`.
 +
@@ -92,16 +95,11 @@ pullSecret: '<pull_secret>' <6>
 Do not move the `install-config.yaml` and `agent-config.yaml` configuration files to the `openshift` directory.
 ====
 
-. From the link:https://github.com/oracle-quickstart/oci-openshift[`oracle-quickstart / oci-openshift`] GitHub web page, select the *<> Code* button and click *Download ZIP*. Save the archive file to your `openshift` directory,  so that all the {oci-ccm-full} and {oci-csi-full} manifests exist in the same directory. The downloaded archive file includes files for creating cluster resources and custom manifests.
+. Complete the steps in the link:https://docs.oracle.com/iaas/Content/openshift-on-oci/install-prereq.htm#install-configuration-files["Configuration Files"] section of the _Oracle_ documentation to download {oci-ccm-full} and {oci-csi-full} manifests as an archive file and save the archive file in your `openshift` directory. You need the {oci-ccm} manifests for deploying the {oci-ccm} during cluster installation so that {product-title} can connect to the external {oci} platform. You need the {oci-csi} custom manifests for deploying the {oci-csi} driver during cluster installation so that {product-title} can claim required objects from {oci}.
 
-. Go to the link:https://github.com/oracle-quickstart/oci-openshift/tree/main/custom_manifests[custom_manifests] web page on GitHub to access the custom manifest files.
-+
-The {oci-ccm} manifest are required for deploying the {oci-ccm} during cluster installation so that {product-title} can connect to the external {oci} platform. The {oci-csi} custom manifests are required for deploying the {oci-csi} driver during cluster installation so that {product-title} can claim required objects from {oci}.
+. Access the custom manifest files that are provided in the link:https://docs.oracle.com/iaas/Content/openshift-on-oci/install-prereq.htm#install-configuration-files["Configuration Files"] section of the _Oracle_ documentation.
 +
-[IMPORTANT]
-====
-You must change the secret `oci-cloud-controller-manager` defined in the link:https://github.com/oracle-quickstart/oci-openshift/blob/main/custom_manifests/manifests/oci-ccm.yml[`oci-ccm.yml`] configuration file to match your organization's region, compartment {ocid}, VCN {ocid}, and the subnet {ocid} from the load balancer.
-====
+.. Change the `oci-cloud-controller-manager` secret that is defined in the `oci-ccm.yml` configuration file to match your organization's region, compartment {ocid}, VCN {ocid}, and the subnet {ocid} from the load balancer.
 
 . Use the Agent-based Installer to generate a minimal ISO image, which excludes the rootfs image, by entering the following command in your {product-title} CLI. You can use this image later in the process to boot all your cluster’s nodes.
 +

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

@@ -4,11 +4,11 @@
 
 :_mod-docs-content-type: CONCEPT
 [id="installing-oci-about-agent-based-installer_{context}"]
-= The Agent-based Installer and OCI overview
+= The Agent-based Installer and {oci} overview
 
 You can install an {product-title} cluster on {oci-first} by using the Agent-based Installer. Both Red Hat and Oracle test, validate, and support running {oci} and {ocvs-first} workloads in an {product-title} cluster on {oci}.
 
-:FeatureName: Using the Agent-based Installer to install an {product-title} cluster on OCI that is configured with a virtual machine (VM) compute instance
+:FeatureName: Using the Agent-based Installer to install an {product-title} cluster on {oci} that is configured with a virtual machine (VM) compute instance
 include::snippets/technology-preview.adoc[]
 
 The Agent-based installer provides the ease of use of the Assisted Installation service, but with the capability to install a cluster in either a connected or disconnected environment.
@@ -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 (Oracle_ documentatio).
+Consider reserving additional VPUs to provide sufficient capacity for updates and scaling activities. For more information about VPUs, see Volume Performance Units (Oracle documentation).
 ====