[enterprise-4.16] OCPBUGS-30076: Fixed minor bugs with OCI docs

_attributes/common-attributes.adoc

@@ -49,6 +49,7 @@ endif::openshift-origin[]
 :oadp-version: 1.3.1
 :oc-first: pass:quotes[OpenShift CLI (`oc`)]
 :product-registry: OpenShift image registry
+:product-mirror-registry: Mirror registry for Red Hat OpenShift
 :rh-storage-first: Red Hat OpenShift Data Foundation
 :rh-storage: OpenShift Data Foundation
 :rh-rhacm-first: Red Hat Advanced Cluster Management (RHACM)
@@ -268,6 +269,7 @@ endif::[]
 :vmw-short: vSphere
 //Oracle
 :oci-first: Oracle(R) Cloud Infrastructure (OCI)
+:oci-first-no-rt: Oracle Cloud Infrastructure (OCI)
 :oci: OCI
 :oci-ccm-full: Oracle Cloud Controller Manager (CCM)
 :oci-ccm: Oracle CCM

_topic_maps/_topic_map.yml

@@ -479,9 +479,9 @@ Topics:
   Dir: installing_oci
   Distros: openshift-origin,openshift-enterprise
   Topics:
-  - Name: Using the Assisted Installer to install a cluster on OCI
+  - Name: Installing a cluster on Oracle Cloud Infrastructure by using the Assisted Installer
     File: installing-oci-assisted-installer
-  - Name: Using the Agent-based Installer to install a cluster on OCI
+  - Name: Installing a cluster on Oracle Cloud Infrastructure by using the Agent-based Installer
     File: installing-oci-agent-based-installer
 - Name: Installing on vSphere
   Dir: installing_vsphere

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

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="installing-oci-agent-based-installer"]
-= Installing a cluster OCI by using the Agent-based Installer 
+= Installing a cluster on {oci-first-no-rt} by using the Agent-based Installer
 include::_attributes/common-attributes.adoc[]
 :context: installing-oci-agent-based-installer
 
@@ -14,43 +14,59 @@ include::modules/installing-oci-about-agent-based-installer.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../architecture/architecture-installation.html#installation-process_architecture-installation[Installation process]
-* xref:../../installing/installing_platform_agnostic/installing-platform-agnostic.html#cluster-entitlements_installing-platform-agnostic[Internet access for {product-title}]
-* xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.html#understanding-agent-install_preparing-to-install-with-agent-based-installer[Understanding the Agent-based Installer]
-* See link:https://docs.oracle.com/en-us/iaas/Content/Compute/Concepts/computeoverview.htm[Overview of the Compute Service] in the Oracle documentation.
-* See link:https://docs.oracle.com/en-us/iaas/Content/Block/Concepts/blockvolumeperformance.htm#vpus[Volume Performance Units] in the Oracle documentation.
+* xref:../../architecture/architecture-installation.adoc#installation-process_architecture-installation[Installation process]
+* xref:../../installing/installing_platform_agnostic/installing-platform-agnostic.adoc#cluster-entitlements_installing-platform-agnostic[Internet access for {product-title}]
+* 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)]
 
 // Creating OCI infrastructure resources and services
 include::modules/creating-oci-infra-resources-services.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
-See the following Oracle documentation resources: 
-
-* link:https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcompartments.htm#ariaid-title5[Creating compartments] 
-* link:https://docs.oracle.com/en-us/iaas/Content/Network/Tasks/create_vcn.htm[Creating a VCN]
-* link:https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/create-nsg.htm[Creating an NSG]
-* link:https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengdynamicgrouppolicyforselfmanagednodes.htm[Creating a dynamic group and a policy for self-managed nodes]
-* link:https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingpolicies.htm[Managing policies]
-* link:https://docs.oracle.com/en-us/iaas/Content/Balance/Tasks/managingloadbalancer_topic-Creating_Load_Balancers.htm[Creating a load balancer]
-* link:https://docs.oracle.com/en-us/iaas/Content/DNS/Tasks/record-add.htm[Adding a record to a DNS zone]
+* 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)]
 
 // Creating configuration files for installing a cluster on OCI
 include::modules/creating-config-files-cluster-install-oci.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.html#installing-ocp-agent-ztp_installing-with-agent-based-installer[Optional: Using ZTP manifests]
+* 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
+include::modules/configuring-firewall.adoc[leveloffset=+1]
 
 // Running your cluster on OCI
 include::modules/running-cluster-oci-agent-based.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.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]
+
 // Verifying a succesful cluster installation on OCI
 include::modules/verifying-cluster-install-oci-agent-based.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.html#installing-ocp-agent-gather-log_installing-with-agent-based-installer[Gathering log data from a failed Agent-based installation]
+* xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-gather-log_installing-with-agent-based-installer[Gathering log data from a failed Agent-based installation]

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

@@ -1,38 +1,41 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="installing-oci-assisted-installer"]
-= Using the Assisted Installer to install a cluster on OCI
+= Installing a cluster on {oci-first-no-rt} by using the Assisted Installer
 include::_attributes/common-attributes.adoc[]
 :context: installing-oci-assisted-installer
 
 toc::[]
 
-From {product-title} {product-version} and later versions, you can use the Assisted Installer to install a cluster on {oci-first} by using infrastructure that you provide.
+From {product-title} {product-version} and later versions, you can use the {ai-full} to install a cluster on {oci-first} by using infrastructure that you provide.
 
 // The Assisted Installer and OCI overview
 include::modules/installing-oci-about-assisted-installer.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
-* link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform/2024[Assisted Installer for {product-title}]
+* link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform/2024[{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]
-
+* link:https://docs.oracle.com/en-us/iaas/Content/Block/Concepts/blockvolumeperformance.htm#vpus[Volume Performance Units (Oracle documentation)]
 
 // Creating OCI resources
 include::modules/creating-oci-resources-services.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
-See the following Oracle web-based documents:
-
-* link:https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcompartments.htm[Managing compartments]
-* link:https://docs.oracle.com/en-us/iaas/Content/Object/Concepts/objectstorageoverview.htm[Overview of Object Storage]
+* 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
 include::modules/using-assisted-installer-oci-agent-iso.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* 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]
 
@@ -48,8 +51,7 @@ include::modules/installing-troubleshooting-assisted-installer-oci.adoc[leveloff
 [role="_additional-resources"]
 .Additional resources
 
-* 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 Assisted Installer]
-* link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform/2022/html-single/assisted_installer_for_openshift_container_platform/index[Assisted Installer for {product-title}]
-//* link:https://access.redhat.com/node/7038262[Using the Agent-based Installer to install a cluster on OCI]
-* link:https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Concepts/resourcemanager.htm#ways[Ways to access Resource Manager]
-* link:https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Tasks/create-stack.htm#top[Creating a stack] in the 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/2022/html-single/assisted_installer_for_openshift_container_platform/index[{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

@@ -1,33 +1,37 @@
 // Module included in the following assemblies:
 //
-// * installing/installing_oci/installing-oci-assisted-installer.adoc [Using the Assisted Installer to install a cluster on OCI]
+// * installing/installing_oci/installing-oci-assisted-installer.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="complete-assisted-installer-oci_{context}"]
 = Completing the remaining Assisted Installer 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 Assisted Installer before you can create an instance {oci}.
+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}, and the stack includes the custom manifest configuration files and {oci} Resource Manager configuration resources.
+* 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.
 
 .Procedure
 
-. From the link:https://console.redhat.com/[Red Hat Hybrid Cloud Console] web console, go to the **Host discovery** step. Under the **Role** column, assign a node role, `Control plane node` or `Worker`, for each targeted hostname.
+. From the link:https://console.redhat.com/[Red Hat Hybrid Cloud Console] web console, go to the *Host discovery* page.
+
+.Under the *Role* column, select either `Control plane node` or `Worker` for each targeted hostname.
 +
 [IMPORTANT]
 ====
 Before, you can continue to the next steps, wait for each node to reach the `Ready` status.
 ====
 
-. Accept the default settings for the **Storage** and **Networking** steps. Click the **Next** button to go to the **Custom manifests** step. 
+. Accept the default settings for the *Storage* and *Networking* steps, and then Click *Next*.
 
-. Select the value `manifests` in the **Folder** field and enter a value in the **File name** field, such as `oci-ccm.yml`. From the **Content** section, click **Browse** and select the CCM manifest from your drive located in `custom_ manifest/manifests/oci-ccm.yml`. 
+. On the *Custom manifests* page, in the *Folder* field, select `manifest`. This is the {ai-full} folder where you want to save the custom manifest file.
+.. In the *File name* field, enter a value such as `oci-ccm.yml`.
+.. From the *Content* section, click *Browse*, and select the CCM manifest from your drive located in `custom_manifest/manifests/oci-ccm.yml`.
 
-. Expand the next **Custom manifest** section and repeat the same steps for the following manifests:
-    - CSI driver manifest: `custom_ manifest/manifests/oci-csi.yml`
-    - CCM machine configuration: `custom_ manifest/openshift/machineconfig-ccm.yml`
-    - CSI driver machine configuration: `custom_ manifest/openshift/machineconfig-csi.yml`
+. Expand the next *Custom manifest* section and repeat the same steps for the following manifests:
+ - CSI driver manifest: `custom_manifest/manifests/oci-csi.yml`
+ - CCM machine configuration: `custom_manifest/openshift/machineconfig-ccm.yml`
+ - CSI driver machine configuration: `custom_manifest/openshift/machineconfig-csi.yml`
 
-. Complete the **Review and create** step to create your {product-title} cluster on {oci}. Click the **Install cluster** button to complete the cluster installation. 
+. From the *Review and create* page, click *Install cluster* to create your {product-title} cluster on {oci}.