mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
OSDOCS-16184: Oracle cloud install docs
This commit is contained in:
Sebastian Kopacz
committed by
openshift-cherrypick-robot
openshift-cherrypick-robot
parent
aef232d4d5
commit
89368a9024
@@ -335,6 +335,10 @@ endif::[]
|
||||
:oci-pca: Oracle(R) Private Cloud Appliance
|
||||
:oci-pca-no-rt: Oracle Private Cloud Appliance
|
||||
:oci-pca-short: Private Cloud Appliance
|
||||
:oci-distributed: Oracle(R) Distributed Cloud
|
||||
:oci-distributed-no-rt: Oracle Distributed Cloud
|
||||
:oci-edge: Oracle(R) Edge Cloud
|
||||
:oci-edge-no-rt: Oracle Edge Cloud
|
||||
// Red Hat OpenStack Platform (RHOSP)/OpenStack
|
||||
ifndef::openshift-origin[]
|
||||
:rh-openstack-first: Red{nbsp}Hat OpenStack Platform (RHOSP)
|
||||
|
||||
@@ -588,20 +588,22 @@ Topics:
|
||||
File: uninstalling-openstack-user
|
||||
- Name: Installation configuration parameters for OpenStack
|
||||
File: installation-config-parameters-openstack
|
||||
- Name: Installing on OCI
|
||||
- Name: Installing on Oracle Distributed Cloud
|
||||
Dir: installing_oci
|
||||
Distros: openshift-origin,openshift-enterprise
|
||||
Topics:
|
||||
- Name: Installing a cluster on Oracle Cloud Infrastructure by using the Assisted Installer
|
||||
- Name: Installing a cluster on Oracle Distributed Cloud by using the Assisted Installer
|
||||
File: installing-oci-assisted-installer
|
||||
- Name: Installing a cluster on Oracle Cloud Infrastructure by using the Agent-based Installer
|
||||
- Name: Installing a cluster on Oracle Distributed Cloud by using the Agent-based Installer
|
||||
File: installing-oci-agent-based-installer
|
||||
- Name: Installing a cluster on Oracle Compute Cloud@Customer by using the Agent-based Installer
|
||||
File: installing-c3-agent-based-installer
|
||||
- Name: Installing a cluster on Oracle Private Cloud Appliance by using the Agent-based Installer
|
||||
File: installing-pca-agent-based-installer
|
||||
- Name: Installing a cluster on Oracle Compute Cloud@Customer by using the Assisted Installer
|
||||
- Name: Installing on Oracle Edge Cloud
|
||||
Dir: installing_oci_edge
|
||||
Distros: openshift-enterprise
|
||||
Topics:
|
||||
- Name: Installing a cluster on Oracle Edge Cloud by using the Assisted Installer
|
||||
File: installing-c3-assisted-installer
|
||||
- Name: Installing a cluster on Oracle Edge Cloud by using the Agent-based Installer
|
||||
File: installing-c3-agent-based-installer
|
||||
- Name: Installing on VMware vSphere
|
||||
Dir: installing_vsphere
|
||||
Distros: openshift-origin,openshift-enterprise
|
||||
|
||||
@@ -1,19 +1,17 @@
|
||||
:_mod-docs-content-type: ASSEMBLY
|
||||
include::_attributes/common-attributes.adoc[]
|
||||
[id="installing-oci-agent-based-installer"]
|
||||
= Installing a cluster on {oci-first-no-rt} by using the Agent-based Installer
|
||||
= Installing a cluster on {oci-distributed-no-rt} by using the Agent-based Installer
|
||||
:context: installing-oci-agent-based-installer
|
||||
|
||||
toc::[]
|
||||
|
||||
In {product-title} {product-version}, you can use the Agent-based Installer to install a cluster on {oci-first}, so that you can run cluster workloads on infrastructure that supports dedicated, hybrid, public, and multiple cloud environments.
|
||||
In {product-title} {product-version}, you can use the Agent-based Installer to install a cluster on {oci-distributed}, so that you can run cluster workloads on infrastructure that supports dedicated, hybrid, public, and multiple cloud environments.
|
||||
|
||||
Installing a cluster on {oci} is supported for virtual machines (VMs) and bare-metal machines.
|
||||
Installing a cluster on {oci-distributed-no-rt} is supported for virtual machines (VMs) and bare-metal machines.
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
You can deploy {product-title} on a link:https://www.oracle.com/uk/cloud/cloud-at-customer/dedicated-region/[Dedicated Region] (Oracle documentation) the same as any region from {oci-first-no-rt}.
|
||||
====
|
||||
// Supported Oracle Distributed Cloud Infrastructures
|
||||
include::modules/installing-oci-distributed-infra-support.adoc[leveloffset=+1]
|
||||
|
||||
// The Agent-based Installer and OCI overview
|
||||
include::modules/installing-oci-about-agent-based-installer.adoc[leveloffset=+1]
|
||||
@@ -26,14 +24,14 @@ 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)]
|
||||
* link:https://docs.oracle.com/iaas/Content/openshift-on-oci/installing-agent-about-instance-configurations.htm[Instance Sizing Recommendations for {product-title} Nodes (Oracle documentation)]
|
||||
|
||||
[id="abi-oci-process-checklist_{context}"]
|
||||
== Installation process workflow
|
||||
|
||||
The following workflow describes a high-level outline for the process of installing an {product-title} cluster on {oci} using the Agent-based Installer:
|
||||
The following workflow describes a high-level outline for the process of installing an {product-title} cluster on {oci-distributed-no-rt} using the Agent-based Installer:
|
||||
|
||||
. Create {oci} resources and services (Oracle).
|
||||
. Create {oci-first-no-rt} resources and services (Oracle).
|
||||
. Disconnected environments: Prepare a web server that is accessible by {oci} instances (Red{nbsp}Hat).
|
||||
. Prepare configuration files for the Agent-based Installer (Red{nbsp}Hat).
|
||||
. Generate the agent ISO image (Red{nbsp}Hat).
|
||||
@@ -41,8 +39,8 @@ The following workflow describes a high-level outline for the process of install
|
||||
. Configure your firewall for {product-title} (Red{nbsp}Hat).
|
||||
. Upload the agent ISO image to a storage bucket (Oracle).
|
||||
. Create a custom image from the uploaded agent ISO image (Oracle).
|
||||
. Create compute instances on {oci} (Oracle).
|
||||
. Verify that your cluster runs on {oci} (Oracle).
|
||||
. Create compute instances on {oci-distributed-no-rt} (Oracle).
|
||||
. Verify that your cluster runs on {oci-distributed-no-rt} (Oracle).
|
||||
|
||||
// Creating OCI infrastructure resources and services
|
||||
include::modules/abi-oci-resources-services.adoc[leveloffset=+1]
|
||||
@@ -76,7 +74,7 @@ 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#agent-based-installer-recommended-resources_preparing-to-install-with-agent-based-installer[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/installing-agent-about-instance-configurations.htm[Instance Sizing Recommendations for {product-title} Nodes (Oracle documentation)]
|
||||
* link:https://docs.oracle.com/iaas/Content/openshift-on-oci/openshift-troubleshooting.htm[Troubleshooting {product-title} on {oci} (Oracle documentation)]
|
||||
|
||||
// Verifying that your Agent-based cluster installation runs on {oci}
|
||||
|
||||
@@ -1,21 +1,19 @@
|
||||
:_mod-docs-content-type: ASSEMBLY
|
||||
include::_attributes/common-attributes.adoc[]
|
||||
[id="installing-oci-assisted-installer"]
|
||||
= Installing a cluster on {oci-first-no-rt} by using the {ai-full}
|
||||
= Installing a cluster on {oci-distributed-no-rt} by using the {ai-full}
|
||||
:context: installing-oci-assisted-installer
|
||||
|
||||
toc::[]
|
||||
|
||||
You can use the {ai-full} to install a cluster on {oci-first}. This method is recommended for most users, and requires an internet connection.
|
||||
You can use the {ai-full} to install a cluster on {oci-distributed}. This method is recommended for most users, and requires an internet connection.
|
||||
|
||||
If you want to set up the cluster manually or using other automation tools, or if you are working in a disconnected environment, you can use the Red Hat Agent-based Installer for the installation. For details, see xref:../../installing/installing_oci/installing-oci-agent-based-installer.adoc#installing-oci-agent-based-installer[Installing a cluster on {oci-first-no-rt} by using the Agent-based Installer].
|
||||
If you want to set up the cluster manually or using other automation tools, or if you are working in a disconnected environment, you can use the Red Hat Agent-based Installer for the installation. For details, see xref:../../installing/installing_oci/installing-oci-agent-based-installer.adoc#installing-oci-agent-based-installer[Installing a cluster on {oci-distributed-no-rt} by using the Agent-based Installer].
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
You can deploy {product-title} on a link:https://www.oracle.com/uk/cloud/cloud-at-customer/dedicated-region/[Dedicated Region] (Oracle documentation) the same as any region from {oci-first-no-rt}.
|
||||
====
|
||||
// Supported Oracle Distributed Cloud Infrastructures
|
||||
include::modules/installing-oci-distributed-infra-support.adoc[leveloffset=+1]
|
||||
|
||||
// The Assisted Installer and OCI overview
|
||||
// The Assisted Installer and Oracle Distributed Cloud overview
|
||||
include::modules/installing-oci-about-assisted-installer.adoc[leveloffset=+1]
|
||||
|
||||
[role="_additional-resources"]
|
||||
@@ -30,13 +28,13 @@ include::modules/creating-oci-resources-services.adoc[leveloffset=+1]
|
||||
|
||||
// Using the Assisted Installer to generate an OCI-compatible discovery ISO image
|
||||
[id="using-assisted-installer-oci-agent-iso_{context}"]
|
||||
== Using the {ai-full} to generate an {oci}-compatible discovery ISO image
|
||||
== Using the {ai-full} to generate a discovery ISO image
|
||||
|
||||
Create the cluster configuration and generate the discovery ISO image in the {ai-full} web console.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You created a child compartment and an object storage bucket on {oci}. For details, see _Preparing the {oci} environment_.
|
||||
* You created a child compartment and an object storage bucket on {oci-distributed-no-rt}. For details, see _Preparing the {oci-distributed-no-rt} environment_.
|
||||
* You reviewed details about the {product-title} installation and update processes.
|
||||
|
||||
include::modules/using-assisted-installer-oci-create-cluster.adoc[leveloffset=+2]
|
||||
@@ -57,7 +55,7 @@ include::modules/provision-oci-infrastructure-ocp-cluster.adoc[leveloffset=+1]
|
||||
[id="completing-assisted-installer-oci_{context}"]
|
||||
== 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}. These steps include assigning node roles and adding custom manifests.
|
||||
After you provision {oci-distributed} resources and upload {product-title} custom manifest configuration files to {oci-distributed-no-rt}, you must complete the remaining cluster installation steps on the {ai-full} before you can create an {oci-distributed-no-rt} instance. These steps include assigning node roles and adding custom manifests.
|
||||
|
||||
include::modules/complete-assisted-installer-oci-node-roles.adoc[leveloffset=+2]
|
||||
|
||||
|
||||
@@ -1,64 +0,0 @@
|
||||
:_mod-docs-content-type: ASSEMBLY
|
||||
include::_attributes/common-attributes.adoc[]
|
||||
[id="installing-pca-agent-based-installer"]
|
||||
= Installing a cluster on {oci-pca-no-rt} by using the Agent-based Installer
|
||||
:context: installing-pca-agent-based-installer
|
||||
|
||||
toc::[]
|
||||
|
||||
You can use the Agent-based Installer to install a cluster on {oci-pca}, so that you can run cluster workloads on on-premise infrastructure while still using {oci-first} services.
|
||||
|
||||
[id="abi-oci-pca-process-checklist_{context}"]
|
||||
== Installation process workflow
|
||||
|
||||
The following workflow describes a high-level outline for the process of installing an {product-title} cluster on {oci-pca-short} using the Agent-based Installer:
|
||||
|
||||
. Create {oci-pca-short} resources and services (Oracle).
|
||||
. Prepare configuration files for the Agent-based Installer (Red{nbsp}Hat).
|
||||
. Generate the agent ISO image (Red{nbsp}Hat).
|
||||
. Convert the ISO image to an {oci-first-no-rt} image, upload it to an {oci} Home Region Bucket, and then import the uploaded image to the {oci-pca-short} system (Oracle).
|
||||
. Disconnected environments: Prepare a web server that is accessible by {oci} instances (Red{nbsp}Hat).
|
||||
. Disconnected environments: Upload the rootfs image to the web server (Red{nbsp}Hat).
|
||||
. Configure your firewall for {product-title} (Red{nbsp}Hat).
|
||||
. Create control plane nodes and configure load balancers (Oracle).
|
||||
. Create compute nodes and configure load balancers (Oracle).
|
||||
. Verify that your cluster runs on {oci} (Oracle).
|
||||
|
||||
// Creating Private Cloud Appliance infrastructure resources and services
|
||||
include::modules/abi-pca-resources-services.adoc[leveloffset=+1]
|
||||
|
||||
[role="_additional-resources"]
|
||||
.Additional resources
|
||||
|
||||
* 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]
|
||||
|
||||
[role="_additional-resources"]
|
||||
.Additional resources
|
||||
|
||||
* xref:../../architecture/architecture-installation.adoc#installation-overview_architecture-installation[About {product-title} installation]
|
||||
* xref:../../installing/overview/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#preparing-to-install-with-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:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red{nbsp}Hat OpenShift]
|
||||
* xref:../../disconnected/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 Private Cloud Appliance
|
||||
include::modules/running-cluster-oci-pca-agent-based.adoc[leveloffset=+1]
|
||||
|
||||
// Verifying that your Agent-based cluster installation runs on {oci}
|
||||
include::modules/verifying-cluster-install-oci-agent-based.adoc[leveloffset=+1]
|
||||
|
||||
[role="_additional-resources"]
|
||||
[id="additional-resources_{context}"]
|
||||
== Additional resources
|
||||
|
||||
* 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]
|
||||
|
||||
* xref:../../nodes/nodes/nodes-nodes-adding-node-iso.adoc#adding-node-iso[Adding worker nodes to an on-premise cluster]
|
||||
1
installing/installing_oci_edge/_attributes
Symbolic link
1
installing/installing_oci_edge/_attributes
Symbolic link
@@ -0,0 +1 @@
|
||||
../../_attributes/
|
||||
1
installing/installing_oci_edge/images
Symbolic link
1
installing/installing_oci_edge/images
Symbolic link
@@ -0,0 +1 @@
|
||||
../../images/
|
||||
@@ -1,28 +1,33 @@
|
||||
:_mod-docs-content-type: ASSEMBLY
|
||||
include::_attributes/common-attributes.adoc[]
|
||||
[id="installing-c3-agent-based-installer"]
|
||||
= Installing a cluster on {oci-c3-no-rt} by using the Agent-based Installer
|
||||
= Installing a cluster on {oci-edge-no-rt} by using the Agent-based Installer
|
||||
:context: installing-c3-agent-based-installer
|
||||
|
||||
toc::[]
|
||||
|
||||
You can use the Agent-based Installer to install a cluster on {oci-c3}, so that you can run cluster workloads on on-premise infrastructure while still using {oci-first} services.
|
||||
You can use the Agent-based Installer to install a cluster on {oci-edge}, so that you can run cluster workloads on on-premise infrastructure while still using {oci-first} services.
|
||||
|
||||
The following procedures describe a cluster installation on {oci-c3} as an example.
|
||||
|
||||
// Supported Oracle Edge Cloud Infrastructures
|
||||
include::modules/installing-oci-edge-infra-support.adoc[leveloffset=+1]
|
||||
|
||||
[id="abi-oci-c3-process-checklist_{context}"]
|
||||
== Installation process workflow
|
||||
|
||||
The following workflow describes a high-level outline for the process of installing an {product-title} cluster on {oci-c3-short} using the Agent-based Installer:
|
||||
The following workflow describes a high-level outline for the process of installing an {product-title} cluster on {oci-edge-no-rt} using the Agent-based Installer:
|
||||
|
||||
. Create {oci-c3-short} resources and services (Oracle).
|
||||
. Create {oci-first-no-rt} resources and services (Oracle).
|
||||
. Prepare configuration files for the Agent-based Installer (Red{nbsp}Hat).
|
||||
. Generate the agent ISO image (Red{nbsp}Hat).
|
||||
. Convert the ISO image to an {oci-first-no-rt} image, upload it to an {oci} Home Region Bucket, and then import the uploaded image to the {oci-c3-short} system (Oracle).
|
||||
. Disconnected environments: Prepare a web server that is accessible by {oci} instances (Red{nbsp}Hat).
|
||||
. Convert the ISO image to an {oci} image, upload it to an {oci} Home Region Bucket, and then import the uploaded image to the {oci-edge-no-rt} system (Oracle).
|
||||
. Disconnected environments: Prepare a web server that is accessible by {oci-edge-no-rt} instances (Red{nbsp}Hat).
|
||||
. Disconnected environments: Upload the rootfs image to the web server (Red{nbsp}Hat).
|
||||
. Configure your firewall for {product-title} (Red{nbsp}Hat).
|
||||
. Create control plane nodes and configure load balancers (Oracle).
|
||||
. Create compute nodes and configure load balancers (Oracle).
|
||||
. Verify that your cluster runs on {oci} (Oracle).
|
||||
. Verify that your cluster runs on {oci-edge-no-rt} (Oracle).
|
||||
|
||||
// Creating Compute Cloud@Customer infrastructure resources and services
|
||||
include::modules/abi-c3-resources-services.adoc[leveloffset=+1]
|
||||
@@ -1,12 +1,17 @@
|
||||
:_mod-docs-content-type: ASSEMBLY
|
||||
include::_attributes/common-attributes.adoc[]
|
||||
[id="installing-c3-assisted-installer"]
|
||||
= Installing a cluster on {oci-c3-no-rt} by using the {ai-full}
|
||||
= Installing a cluster on {oci-edge-no-rt} by using the {ai-full}
|
||||
:context: installing-c3-assisted-installer
|
||||
|
||||
toc::[]
|
||||
|
||||
With {oci-c3} (C3), you can run applications and middleware by using {oci-first} services on high performance cloud infrastructure in your data center.
|
||||
With {oci-edge}, you can run applications and middleware by using {oci-first} services on high performance cloud infrastructure in your data center.
|
||||
|
||||
The following procedures describe a cluster installation on {oci-c3} as an example.
|
||||
|
||||
// Supported Oracle Edge Cloud Infrastructures
|
||||
include::modules/installing-oci-edge-infra-support.adoc[leveloffset=+1]
|
||||
|
||||
// Overview
|
||||
include::modules/c3-assisted-installer-overview.adoc[leveloffset=+1]
|
||||
@@ -19,11 +24,11 @@ include::modules/c3-assisted-installer-running-script-via-home.adoc[leveloffset=
|
||||
|
||||
// Preparing the OpenShift image
|
||||
[id="c3-assisted-installer-preparing-image_{context}"]
|
||||
== Preparing the {oci} image
|
||||
== Preparing the {oci} image
|
||||
|
||||
Generate the {product-title} ISO image in the {ai-full} on the Red{nbsp}Hat portal. Then, convert the image to an {oci-first-no-rt} compatible image and upload it to the *Custom Images* page of your {oci-c3-no-rt} environment.
|
||||
Generate the {product-title} ISO image in the {ai-full} on the Red{nbsp}Hat portal. Then, convert the image to an {oci-edge-no-rt} compatible image and upload it to the *Custom Images* page of your {oci-edge-no-rt} environment.
|
||||
|
||||
You can generate, convert and upload the image on your laptop and not on the bastion server or within environments such as Oracle Solution Center.
|
||||
You can generate, convert and upload the image on your laptop and not on the bastion server or within environments such as Oracle Solution Center.
|
||||
|
||||
include::modules/c3-assisted-installer-preparing-image-generating.adoc[leveloffset=+2]
|
||||
|
||||
@@ -37,7 +42,7 @@ include::modules/c3-assisted-installer-running-script-via-region.adoc[leveloffse
|
||||
[id="c3-ai-completing-installation_{context}"]
|
||||
== Completing the installation by using the {ai-full} web console
|
||||
|
||||
After you configure the infrastructure, the instances are now running and are ready to be registered with{nbsp}Red Hat.
|
||||
After you configure the infrastructure, the instances are now running and are ready to be registered with Red{nbsp}Hat.
|
||||
|
||||
include::modules/c3-assisted-installer-completing-installation-nodes.adoc[leveloffset=+2]
|
||||
|
||||
1
installing/installing_oci_edge/modules
Symbolic link
1
installing/installing_oci_edge/modules
Symbolic link
@@ -0,0 +1 @@
|
||||
../../modules/
|
||||
1
installing/installing_oci_edge/snippets
Symbolic link
1
installing/installing_oci_edge/snippets
Symbolic link
@@ -0,0 +1 @@
|
||||
../../snippets/
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="abi-c3-resources-services_{context}"]
|
||||
= Creating {oci-c3-no-rt} infrastructure resources and services
|
||||
= Creating {oci} infrastructure resources and services
|
||||
|
||||
You must create an {oci-c3-short} 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.
|
||||
You must create an {oci-edge-no-rt} 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-first-no-rt} components can help you with understanding the concept of {oci} resources and how you can configure them to meet your organizational needs.
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
@@ -28,7 +28,7 @@ Cloud@Customer] (Oracle documentation).
|
||||
|
||||
.Procedure
|
||||
|
||||
* Create the required {oci-c3-short} resources and services.
|
||||
* Create the required {oci} resources and services.
|
||||
+
|
||||
For more information, see "Terraform Script Execution" in link:https://www.oracle.com/a/otn/docs/compute_cloud_at_customer_agent_based_installation.pdf?source=:em:nl:mt::::PCATP[OpenShift Cluster Setup with
|
||||
Agent Based Installer on Compute
|
||||
|
||||
@@ -6,9 +6,9 @@
|
||||
[id="abi-oci-resources-services_{context}"]
|
||||
= Creating {oci} infrastructure resources and services
|
||||
|
||||
You must create an {oci} environment on your virtual machine (VM) or bare-metal 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.
|
||||
You must create an {oci-distributed-no-rt} environment on your virtual machine (VM) or bare-metal 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-first-no-rt} 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.
|
||||
The Agent-based Installer method for installing an {product-title} cluster on {oci-distributed-no-rt} requires that you manually create {oci} resources and services.
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
|
||||
@@ -4,6 +4,6 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="c3-ai-opening-cluster_{context}"]
|
||||
= Opening {product-title} from the {oci-c3-no-rt} web console
|
||||
= Opening {product-title} from the {oci-edge-no-rt} web console
|
||||
|
||||
For instructions to access the {product-title} console from {oci-c3-no-rt}, see step 15 - 17 in the "Install the Cluster using the RH Assisted Installer UI" section of the link:https://www.oracle.com/a/otn/docs/compute_cloud_at_customer_assisted_installer.pdf?source=:em:nl:mt::::PCATP[Oracle documentation].
|
||||
For instructions to access the {product-title} console from {oci-edge-no-rt}, see steps 15 - 17 in the "Install the Cluster using the RH Assisted Installer UI" section of the link:https://www.oracle.com/a/otn/docs/compute_cloud_at_customer_assisted_installer.pdf?source=:em:nl:mt::::PCATP[Oracle documentation].
|
||||
|
||||
@@ -6,9 +6,9 @@
|
||||
[id="c3-ai-overview_{context}"]
|
||||
= Overview
|
||||
|
||||
You can install {product-title} on {oci-c3-no-rt} by using the {ai-full}.
|
||||
You can install {product-title} on {oci-edge-no-rt} by using the {ai-full}.
|
||||
|
||||
For an alternative installation method, see "Installing a cluster on {oci-c3} by using the Agent-based Installer".
|
||||
For an alternative installation method, see "Installing a cluster on {oci-edge} by using the Agent-based Installer".
|
||||
|
||||
.Preinstallation considerations
|
||||
|
||||
@@ -22,25 +22,25 @@ For an alternative installation method, see "Installing a cluster on {oci-c3} by
|
||||
|
||||
The installation process builds a bastion host within the designated compartment of the {product-title} cluster. The bastion host is used to run two Terraform scripts:
|
||||
|
||||
* The first script builds IAM Resources in the {oci} Home region of the {oci-c3-short} system (two Dynamic Groups and one Policy).
|
||||
* The first script builds IAM Resources in the {oci} Home region of the {oci-edge} system (two Dynamic Groups and one Policy).
|
||||
|
||||
* The second script builds the infrastructure resources on the {oci-c3-short} system to support the {product-title} cluster, including the {product-title} VCN, public and private subnets, load balancers, Internet GW, NAT GW, and DNS server. The script includes all the resources needed to activate the control plane nodes and compute nodes that form a cluster.
|
||||
* The second script builds the infrastructure resources on the {oci-edge} system to support the {product-title} cluster, including the {product-title} VCN, public and private subnets, load balancers, Internet GW, NAT GW, and DNS server. The script includes all the resources needed to activate the control plane nodes and compute nodes that form a cluster.
|
||||
|
||||
The bastion host is installed in the designated {product-title} Compartment and configured to communicate through a designated {oci-c3-short} DRG Subnet or Internet GW Subnet within the {oci-c3-short} parent tenancy.
|
||||
The bastion host is installed in the designated {product-title} Compartment and configured to communicate through a designated {oci-edge} DRG Subnet or Internet GW Subnet within the {oci-edge} parent tenancy.
|
||||
|
||||
The installation process subsequently provisions three control plane (master) nodes and three compute (worker) nodes, together with the external and internal Load Balancers that form the cluster. This is the standard implementation for {oci-first-no-rt}.
|
||||
The installation process subsequently provisions three control plane (master) nodes and three compute (worker) nodes, together with the external and internal Load Balancers that form the cluster. This is the standard implementation for {oci-edge-no-rt}.
|
||||
|
||||
.Main steps
|
||||
|
||||
The main steps of the procedure are as follows:
|
||||
|
||||
. Preparing the {oci-c3-short} bastion server.
|
||||
. Preparing the {oci-edge} bastion server.
|
||||
|
||||
. Running the Terraform script via the Home region.
|
||||
. Running the Terraform script via the Home region.
|
||||
|
||||
. Preparing the {product-title} image for {oci-first-no-rt}.
|
||||
. Preparing the {product-title} image for {oci-edge-no-rt}.
|
||||
|
||||
. Running the Terraform script via the {oci-c3-short} region.
|
||||
. Running the Terraform script via the {oci-edge} region.
|
||||
|
||||
. Installing the cluster by using the {ai-full} web console.
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
[id="c3-ai-preparing-bastian-server_{context}"]
|
||||
= Preparing the {oci} bastion server
|
||||
|
||||
By implementing a bastion host, you can securely and efficiently manage access to your {oci-c3-no-rt} resources, ensuring that your private instances remain protected and accessible only through a secure, controlled entry point.
|
||||
By implementing a bastion host, you can securely and efficiently manage access to your {oci-first-no-rt} resources, ensuring that your private instances remain protected and accessible only through a secure, controlled entry point.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
|
||||
@@ -4,16 +4,16 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="c3-assisted-installer-preparing-image-converting_{context}"]
|
||||
= Converting and uploading the image to {oci-c3-no-rt}
|
||||
= Converting and uploading the image to {oci-edge-no-rt}
|
||||
|
||||
Convert the ISO image to an {oci} image and upload it to your {oci-c3-short} system from your OCI Home Region Object
|
||||
Convert the ISO image to an {oci-first-no-rt} image and upload it to your {oci-edge-no-rt} system from your OCI Home Region Object
|
||||
Store.
|
||||
|
||||
.Procedure
|
||||
|
||||
. Convert the image from ISO to {oci}.
|
||||
. Upload the {oci} image to an {oci} bucket, and generate a Pre-Authenticated Request (PAR) URL.
|
||||
. Import the {oci} image to the {oci-c3-short} portal.
|
||||
. Import the {oci} image to the {oci-edge} portal.
|
||||
. Copy the Oracle Cloud Identifier (OCID) of the image for use in the next procedure.
|
||||
|
||||
For the full procedure, see step 6 - 8 in the "OpenShift Image Preparation" section of the link:https://www.oracle.com/a/otn/docs/compute_cloud_at_customer_assisted_installer.pdf?source=:em:nl:mt::::PCATP[Oracle documentation].
|
||||
@@ -12,11 +12,11 @@ Create a cluster and download the discovery ISO image.
|
||||
|
||||
. Log in to link:https://console.redhat.com/[{ai-full} web console] with your credentials.
|
||||
|
||||
. In the *Red Hat OpenShift* tile, select *OpenShift*.
|
||||
. In the *Red Hat OpenShift* tile, select *OpenShift*.
|
||||
|
||||
. In the *Red Hat {product-title}* tile, select *Create Cluster*.
|
||||
|
||||
. On the *Cluster Type* page, scroll to the end of the *Cloud* tab, and select *Oracle Cloud Infrastructure (virtual machines)*.
|
||||
. On the *Cluster Type* page, scroll to the end of the *Cloud* tab, and select *Oracle Cloud Infrastructure (virtual machines)*.
|
||||
|
||||
. On the *Create an OpenShift Cluster* page, select the *Interactive* tile.
|
||||
|
||||
@@ -30,7 +30,7 @@ Create a cluster and download the discovery ISO image.
|
||||
|Specify the name of your {product-title} cluster. This name is the same name you used to create the resource via the Terraform scripts. The name must be between 1-54 characters. It can use lowercase alphanumeric characters or hyphen (-), but must start and end with a lowercase letter or a number.
|
||||
|
||||
|*Base domain*
|
||||
|Specify the base domain of the cluster. This is the value used for the `zone_dns` variables in the Terraform scripts that run on {oci-c3-short}. Make a note of the value.
|
||||
|Specify the base domain of the cluster. This is the value used for the `zone_dns` variables in the Terraform scripts that run on {oci-edge}. Make a note of the value.
|
||||
|
||||
|*OpenShift version*
|
||||
| Select *OpenShift 4.16.20*. If it is not immediately visible, scroll to the end of the dropdown menu, select *Show all available versions*, and type the version in the search box.
|
||||
@@ -49,10 +49,10 @@ After you specify this value, the *Include custom manifests* checkbox is selecte
|
||||
+
|
||||
[NOTE]
|
||||
====
|
||||
The minimal ISO image is the mandatory *Provisioning type* for the {oci-first-no-rt}, and cannot be changed.
|
||||
The minimal ISO image is the mandatory *Provisioning type* for the {oci-edge-no-rt}, and cannot be changed.
|
||||
====
|
||||
|
||||
.. In the *SSH public key* field, add the SSH public key by copying the output of the following command:
|
||||
.. In the *SSH public key* field, add the SSH public key by copying the output of the following command:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
@@ -67,11 +67,11 @@ The SSH public key will be installed on all {product-title} control plane and co
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
http_proxy=http://www-proxy.<your_domain>.com:80
|
||||
https_proxy=http://www-proxy.<your_domain>.com:80
|
||||
no_proxy=localhost,127.0.0.1,1,2,3,4,5,6,7,8,9,0,.<your_domain>.com
|
||||
#(ie.oracle.com,.oraclecorp.com)
|
||||
----
|
||||
http_proxy=http://www-proxy.<your_domain>.com:80
|
||||
https_proxy=http://www-proxy.<your_domain>.com:80
|
||||
no_proxy=localhost,127.0.0.1,1,2,3,4,5,6,7,8,9,0,.<your_domain>.com
|
||||
#(ie.oracle.com,.oraclecorp.com)
|
||||
----
|
||||
|
||||
.. Click *Generate Discovery ISO* to generate the discovery ISO image file.
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
[id="c3-ai-running-script-via-home_{context}"]
|
||||
= Running the Terraform script via the Home region
|
||||
|
||||
Copy the Terraform scripts `createInfraResources.tf` and `terraform.tfvars` onto the bastion server. Then run the `createInfraResources.tf` script to create the Dynamic Group Identity resources on your {oci-c3-short} {oci} Home Region. These resources include dynamic groups, policies, and tags.
|
||||
Copy the Terraform scripts `createInfraResources.tf` and `terraform.tfvars` onto the bastion server. Then run the `createInfraResources.tf` script to create the Dynamic Group Identity resources on your {oci-first-no-rt} Home Region. These resources include dynamic groups, policies, and tags.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
@@ -16,7 +16,7 @@ Copy the Terraform scripts `createInfraResources.tf` and `terraform.tfvars` onto
|
||||
|
||||
. Connect to the bastion server via SSH.
|
||||
|
||||
. Create `OpenShift\createResourceOnHomeRegion` folders.
|
||||
. Create `OpenShift\createResourceOnHomeRegion` folders.
|
||||
|
||||
. Copy the `createInfraResources.tf` and `terraform.tfvars` files from the C3_PCA GitHub repository into the `createResourceOnHomeRegion` folder.
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
[id="c3-ai-running-script-via-region_{context}"]
|
||||
= Running the Terraform script via the C3 region
|
||||
|
||||
Run the `terraform.tfvars` Terraform script to create all infrastructure resources on {oci-c3-short}. These resources include the {product-title} VCN, public and private subnets, load balancers, internet GW, NAT GW, and DNS server.
|
||||
Run the `terraform.tfvars` Terraform script to create all infrastructure resources on {oci-edge}. These resources include the {product-title} VCN, public and private subnets, load balancers, internet GW, NAT GW, and DNS server.
|
||||
|
||||
This procedure deploys a cluster consisting of three control plane (master) and three compute (worker) nodes. After deployment, you must rename and reboot the nodes. This process temporarily duplicates nodes, requiring manual cleanup in the next procedure.
|
||||
|
||||
@@ -14,13 +14,13 @@ This procedure deploys a cluster consisting of three control plane (master) and
|
||||
|
||||
. Connect to the bastion server via SSH.
|
||||
|
||||
. Set the C3 Certificate location and export the certificate.
|
||||
. Set the C3 Certificate location and export the certificate.
|
||||
|
||||
. Run the `terraform.tfvars` script to create three control plane nodes and three compute nodes.
|
||||
. Run the `terraform.tfvars` script to create three control plane nodes and three compute nodes.
|
||||
|
||||
. Update the labels for the control plane and compute nodes.
|
||||
|
||||
. Stop and restart the instances one by one on the {oci-c3-short} portal.
|
||||
. Stop and restart the instances one by one on the {oci-edge} portal.
|
||||
|
||||
For the full procedure, see the "Terraform Script Execution - Part 2" section in the link:https://www.oracle.com/a/otn/docs/compute_cloud_at_customer_assisted_installer.pdf?source=:em:nl:mt::::PCATP[Oracle documentation].
|
||||
|
||||
|
||||
@@ -6,11 +6,11 @@
|
||||
[id="adding-custom-manifests-oci_{context}"]
|
||||
= Adding custom manifests
|
||||
|
||||
Add the mandatory custom manifests provided by Oracle. For details, see link:https://github.com/dfoster-oracle/oci-openshift/blob/v1.0.0-release-preview/custom_manifests/README.md[Custom Manifests (Oracle documentation).]
|
||||
Add the mandatory custom manifests provided by Oracle. For details, see link:https://github.com/dfoster-oracle/oci-openshift/blob/v1.0.0-release-preview/custom_manifests/README.md[Custom Manifests (Oracle documentation).]
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You copied the `dynamic_custom_manifest.yml` file from the Terraform stack in {oci}. For details, see "Provisioning {oci} infrastructure for your cluster".
|
||||
* You copied the `dynamic_custom_manifest.yml` file from the Terraform stack in {oci-distributed-no-rt}. For details, see "Provisioning {oci} infrastructure for your cluster".
|
||||
|
||||
.Procedure
|
||||
|
||||
@@ -18,14 +18,14 @@ Add the mandatory custom manifests provided by Oracle. For details, see link:htt
|
||||
|
||||
. In the *File name* field, enter a filename, for example, `dynamic_custom_manifest.yml`.
|
||||
|
||||
. Paste the contents of the `dynamic_custom_manifest.yml` file that you copied from {oci}:
|
||||
. Paste the contents of the `dynamic_custom_manifest.yml` file that you copied from {oci-distributed-no-rt}:
|
||||
|
||||
.. In the *Content* section, click the *Paste content* icon.
|
||||
.. In the *Content* section, click the *Paste content* icon.
|
||||
|
||||
.. If you are using Firefox, click *OK* to close the dialog box, and then press *Ctrl+V*. Otherwise, skip this step.
|
||||
.. If you are using Firefox, click *OK* to close the dialog box, and then press *Ctrl+V*. Otherwise, skip this step.
|
||||
|
||||
. Click *Next* to save the custom manifest.
|
||||
|
||||
. From the *Review and create* page, click *Install cluster* to create your {product-title} cluster on {oci}.
|
||||
. From the *Review and create* page, click *Install cluster* to create your {product-title} cluster on {oci-distributed-no-rt}.
|
||||
|
||||
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.
|
||||
|
||||
@@ -10,7 +10,7 @@ Following host discovery, the role of all nodes appears as *Auto-assign* by defa
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You created and applied the Terraform stack in {oci}. For details, see "Provisioning {oci} infrastructure for your cluster".
|
||||
* You created and applied the Terraform stack in {oci-distributed-no-rt}. For details, see "Provisioning {oci} infrastructure for your cluster".
|
||||
|
||||
.Procedure
|
||||
|
||||
|
||||
@@ -16,7 +16,7 @@ endif::[]
|
||||
|
||||
ifdef::c3[]
|
||||
[id="creating-config-files-cluster-install-c3_{context}"]
|
||||
= Creating configuration files for installing a cluster on {oci-c3-short}
|
||||
= Creating configuration files for installing a cluster on {oci-edge-no-rt}
|
||||
|
||||
You must 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.
|
||||
endif::c3[]
|
||||
@@ -30,7 +30,7 @@ endif::pca[]
|
||||
|
||||
ifndef::pca,c3[]
|
||||
[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-distributed-no-rt}
|
||||
|
||||
You must 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.
|
||||
|
||||
|
||||
@@ -4,33 +4,33 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="creating-oci-resources-services_{context}"]
|
||||
= Preparing the {oci} environment
|
||||
= Preparing the {oci-distributed-no-rt} environment
|
||||
|
||||
Before installing {product-title} using Assisted Installer, create the necessary resources and download the configuration file in the {oci} environment.
|
||||
Before installing {product-title} using Assisted Installer, create the necessary resources and download the configuration file in the {oci-distributed-no-rt} environment.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You have an {oci} account to host the cluster.
|
||||
* You have an {oci-first-no-rt} account to host the cluster.
|
||||
* If you use a firewall and you plan to use a Telemetry service, you configured your firewall to allow {product-title} to access the sites required.
|
||||
|
||||
.Procedure
|
||||
|
||||
. Log in to your link:https://cloud.oracle.com/a/[{oci-first-no-rt}] account with administrator privileges.
|
||||
. Log in to your link:https://cloud.oracle.com/a/[{oci}] account with administrator privileges.
|
||||
|
||||
. Configure the account by defining the link:https://docs.oracle.com/iaas/Content/openshift-on-oci/install-prereq.htm[Cloud Accounts and Resources (Oracle documentation)]. Ensure that you create the following resources:
|
||||
|
||||
.. Create a child compartment for organizing, restricting access, and setting usage limits to {oci} resources. For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/Identity/compartments/To_create_a_compartment.htm#To[Creating a Compartment (Oracle documentation)].
|
||||
|
||||
.. Create a new object storage bucket into which you will upload the discovery ISO image.
|
||||
.. Create a new object storage bucket into which you will upload the discovery ISO image.
|
||||
For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/managingbuckets_topic-To_create_a_bucket.htm#top[Creating an Object Storage Bucket (Oracle documentation)].
|
||||
|
||||
. Download the latest version of the `create-cluster-vX.X.X.zip` configuration file from the link:https://github.com/oracle-quickstart/oci-openshift[`oracle-quickstart/oci-openshift`] repository. This file
|
||||
provides the infrastructure for the cluster and contains configurations for the following:
|
||||
provides the infrastructure for the cluster and contains configurations for the following:
|
||||
+
|
||||
--
|
||||
** *Terraform Stacks*: The Terraform stack code for provisioning {oci} resources to create and manage {product-title} clusters on {oci}.
|
||||
** *Terraform Stacks*: The Terraform stack code for provisioning {oci} resources to create and manage {product-title} clusters on {oci-distributed-no-rt}.
|
||||
|
||||
** *Custom Manifests*: The manifest files needed for the installation of {product-title} clusters on {oci}.
|
||||
** *Custom Manifests*: The manifest files needed for the installation of {product-title} clusters on {oci-distributed-no-rt}.
|
||||
--
|
||||
+
|
||||
[NOTE]
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
:_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-distributed-no-rt} overview
|
||||
|
||||
You can install an {product-title} cluster on {oci-first} by using the Agent-based Installer. Red{nbsp}Hat and Oracle test, validate, and support running {oci} workloads in an {product-title} cluster.
|
||||
You can install an {product-title} cluster on {oci-distributed} by using the Agent-based Installer. Red{nbsp}Hat and Oracle test, validate, and support running {oci-distributed-no-rt} workloads in an {product-title} cluster.
|
||||
|
||||
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.
|
||||
|
||||
@@ -14,28 +14,28 @@ The following diagrams show workflows for connected and disconnected environment
|
||||
|
||||
// TODO: update these images in light of new changes
|
||||
|
||||
.Workflow for using the Agent-based installer in a connected environment to install a cluster on {oci}
|
||||
.Workflow for using the Agent-based installer in a connected environment to install a cluster on {oci-first-no-rt}
|
||||
image::684_OpenShift_Installing_on_OCI_0624-connected.png[Image of a high-level workflow for using the Agent-based installer in a connected environment to install a cluster on {oci}]
|
||||
|
||||
.Workflow for using the Agent-based installer in a disconnected environment to install a cluster on {oci}
|
||||
image::684_OpenShift_Installing_on_OCI_0624-disconnected.png[Image of a high-level workflow for using the Agent-based installer in a disconnected environment to install a cluster on {oci}]
|
||||
|
||||
{oci} provides services that can meet your regulatory compliance, performance, and cost-effectiveness needs. {oci} supports 64-bit `x86` instances and 64-bit `ARM` instances.
|
||||
{oci-distributed-no-rt} provides services that can meet your regulatory compliance, performance, and cost-effectiveness needs. {oci-distributed-no-rt} supports 64-bit `x86` instances and 64-bit `ARM` instances.
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
Consider selecting a nonvolatile memory express (NVMe) drive or a solid-state drive (SSD) for your boot disk, because these drives offer low latency and high throughput capabilities for your boot disk.
|
||||
====
|
||||
|
||||
By running your {product-title} cluster on {oci}, you can access the following capabilities:
|
||||
By running your {product-title} cluster on {oci-distributed-no-rt}, you can access the following capabilities:
|
||||
|
||||
* Compute flexible shapes, where you can customize the number of Oracle(R) CPUs (OCPUs) and memory resources for your VM. With access to this capability, a cluster’s workload can perform operations in a resource-balanced environment. You can find all RHEL-certified {oci} shapes by going to the Oracle page on the Red Hat Ecosystem Catalog portal.
|
||||
* Compute flexible shapes, where you can customize the number of Oracle(R) CPUs (OCPUs) and memory resources for your VM. With access to this capability, a cluster's workload can perform operations in a resource-balanced environment. You can find all RHEL-certified {oci} shapes by going to the Oracle page on the Red Hat Ecosystem Catalog portal.
|
||||
|
||||
* Block Volume storage, where you can configure scaling and auto-tuning settings for your storage volume, so that the Block Volume service automatically adjusts the performance level to optimize performance.
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
To ensure the best performance conditions for your cluster workloads that operate on {oci} and on the OCVS service, ensure volume performance units (VPUs) for your block volume is sized for your workloads. The following list provides some guidance in selecting the VPUs needed for specific performance needs:
|
||||
To ensure the best performance conditions for your cluster workloads that operate on {oci-distributed-no-rt} and on the OCVS service, ensure volume performance units (VPUs) for your block volume is sized for your workloads. The following list provides some guidance in selecting the VPUs needed for specific performance needs:
|
||||
|
||||
* Test or proof of concept environment: 100 GB, and 20 to 30 VPUs.
|
||||
* Basic environment: 500 GB, and 60 VPUs.
|
||||
|
||||
@@ -4,30 +4,30 @@
|
||||
|
||||
:_mod-docs-content-type: CONCEPT
|
||||
[id="installing-oci-about-assisted-installer_{context}"]
|
||||
= About the {ai-full} and {oci} integration
|
||||
= About the {ai-full} and {oci-distributed-no-rt} integration
|
||||
|
||||
You can run cluster workloads on {oci-first} infrastructure that supports dedicated, hybrid, public, and multiple cloud environments. Both Red{nbsp}Hat and Oracle test, validate, and support running {oci} in an {product-title} cluster on {oci}.
|
||||
You can run cluster workloads on {oci-distributed} infrastructure that supports dedicated, hybrid, public, and multiple cloud environments. Both Red{nbsp}Hat and Oracle test, validate, and support running an {product-title} cluster on {oci-distributed-no-rt}.
|
||||
|
||||
This section explains how to use the {ai-full} to install an {product-title} cluster on the {oci} platform. The installation deploys cloud-native components such as {oci-ccm-full} and {oci-csi-full}, and integrates your cluster with {oci} API resources such as instance node, load balancer, and storage.
|
||||
This section explains how to use the {ai-full} to install an {product-title} cluster on the {oci-first-no-rt} platform. The installation deploys cloud-native components such as {oci-ccm-full} and {oci-csi-full}, and integrates your cluster with {oci} API resources such as instance node, load balancer, and storage.
|
||||
|
||||
The installation process uses the {product-title} discovery ISO image provided by Red Hat, together with the scripts and manifests provided and maintained by {oci}.
|
||||
The installation process uses the {product-title} discovery ISO image provided by Red Hat, together with the scripts and manifests provided and maintained by Oracle.
|
||||
|
||||
[id="installing-oci-preinstallation-considerations_{context}"]
|
||||
== Preinstallation considerations
|
||||
|
||||
Before installing {product-title} on {oci-first-no-rt}, you must consider the following configuration choices.
|
||||
Before installing {product-title} on {oci-distributed-no-rt}, you must consider the following configuration choices.
|
||||
|
||||
.Deployment platforms
|
||||
|
||||
The integration between {product-title} and {oci-first-no-rt} is certified on both virtual machines (VMs) and bare-metal (BM) machines. Bare-metal installations using iSCSI boot drives require a secondary vNIC that is automatically created in the Terraform stack provided by Oracle.
|
||||
The integration between {product-title} and {oci-distributed-no-rt} is certified on both virtual machines (VMs) and bare-metal (BM) machines. Bare-metal installations using iSCSI boot drives require a secondary vNIC that is automatically created in the Terraform stack provided by Oracle.
|
||||
|
||||
Before you create a virtual machine (VM) or bare-metal (BM) machine, you must identify the relevant {oci} shape. For details, see the following resource:
|
||||
Before you create a virtual machine (VM) or bare-metal (BM) machine, you must identify the relevant {oci} shape. For details, see the following resource:
|
||||
|
||||
* link:https://catalog.redhat.com/cloud/detail/216977[Cloud instance types (Red{nbsp}Hat Ecosystem Catalog portal)].
|
||||
|
||||
.VPU sizing recommendations
|
||||
|
||||
To ensure the best performance conditions for your cluster workloads that operate on {oci}, ensure that volume performance units (VPUs) for your block volume are sized for your workloads. The following list provides guidance for selecting the VPUs needed for specific performance needs:
|
||||
To ensure the best performance conditions for your cluster workloads that operate on {oci-distributed-no-rt}, ensure that volume performance units (VPUs) for your block volume are sized for your workloads. The following list provides guidance for selecting the VPUs needed for specific performance needs:
|
||||
|
||||
* Test or proof of concept environment: 100 GB, and 20 to 30 VPUs.
|
||||
* Basic environment: 500 GB, and 60 VPUs.
|
||||
@@ -37,21 +37,21 @@ Consider reserving additional VPUs to provide sufficient capacity for updates an
|
||||
|
||||
.Instance sizing recommendations
|
||||
|
||||
Find recommended values for compute instance CPU, memory, VPU, and volume size for {product-title} nodes. For details, see link:https://docs.oracle.com/en-us/iaas/Content/openshift-on-oci/installing-agent-about-instance-configurations.htm[Instance Sizing Recommendations for {product-title} on {oci} Nodes (Oracle documentation)].
|
||||
Find recommended values for compute instance CPU, memory, VPU, and volume size for {product-title} nodes. For details, see link:https://docs.oracle.com/en-us/iaas/Content/openshift-on-oci/installing-agent-about-instance-configurations.htm[Instance Sizing Recommendations for {product-title} Nodes (Oracle documentation)].
|
||||
|
||||
[id="installing-oci-workflow_{context}"]
|
||||
== Workflow
|
||||
|
||||
.High-level workflow for using the Assisted Installer in a connected environment to install a cluster on {oci}
|
||||
image::569_OpenShift_ai_install_oci_0725.png[High-level workflow for using the Assisted Installer in a connected environment to install a cluster on {oci}]
|
||||
.High-level workflow for using the Assisted Installer in a connected environment to install a cluster on {oci-distributed-no-rt}
|
||||
image::569_OpenShift_ai_install_oci_0725.png[High-level workflow for using the Assisted Installer in a connected environment to install a cluster on {oci-distributed-no-rt}]
|
||||
|
||||
The procedure for using the {ai-full} in a connected environment to install a cluster on {oci} is outlined below:
|
||||
The procedure for using the {ai-full} in a connected environment to install a cluster on {oci-distributed-no-rt} is outlined below:
|
||||
|
||||
. In the {oci} console, configure an {oci} account to host the cluster:
|
||||
. In the {oci-first-no-rt} console, configure an {oci} account to host the cluster:
|
||||
|
||||
.. Create a new child compartment under an existing compartment.
|
||||
|
||||
.. Create a new object storage bucket or use one provided by {oci}.
|
||||
.. Create a new object storage bucket or use one provided by {oci-distributed-no-rt}.
|
||||
|
||||
.. Download the stack file template stored locally.
|
||||
|
||||
@@ -81,5 +81,5 @@ The procedure for using the {ai-full} in a connected environment to install a cl
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
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} configurations to complete these steps, or use the configurations to model your own custom script.
|
||||
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} configurations to complete these steps, or use the configurations to model your own custom script.
|
||||
====
|
||||
|
||||
@@ -6,6 +6,6 @@
|
||||
[id="installing-oci-adding-hosts-day-two_{context}"]
|
||||
= Adding hosts to the cluster following the installation
|
||||
|
||||
After creating a cluster with the {ai-full}, you can use the {hybrid-console} to add new host nodes to the cluster and approve their certificate signing requests (CRSs).
|
||||
After creating a cluster with the {ai-full}, you can use the {hybrid-console} to add new host nodes to the cluster and approve their certificate signing requests (CSRs).
|
||||
|
||||
For details, see link:https://docs.oracle.com/en-us/iaas/Content/openshift-on-oci/adding-nodes.htm[Adding Nodes to a Cluster (Oracle documentation)].
|
||||
|
||||
37
modules/installing-oci-distributed-infra-support.adoc
Normal file
37
modules/installing-oci-distributed-infra-support.adoc
Normal file
@@ -0,0 +1,37 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// * installing/installing_oci/installing-oci-agent-based-installer.adoc
|
||||
// * installing/installing_oci/installing-oci-assisted-installer.adoc
|
||||
|
||||
:_mod-docs-content-type: CONCEPT
|
||||
[id="installing-oci-distributed-infra-support_{context}"]
|
||||
= Supported {oci-distributed-no-rt} infrastructures
|
||||
|
||||
The following table describes the support status of each {oci-distributed} infrastructure offering:
|
||||
|
||||
.{oci-distributed-no-rt} infrastructure support statuses
|
||||
[cols=".^,.^",options="header"]
|
||||
|====
|
||||
|Infrastructure type|Support status
|
||||
|
||||
|Commercial Public Cloud
|
||||
|General Availability
|
||||
|
||||
|Dedicated Region
|
||||
|General Availability
|
||||
|
||||
|US Government Cloud
|
||||
|Technology Preview
|
||||
|
||||
|UK Government Cloud
|
||||
|Technology Preview
|
||||
|
||||
|EU Sovereign Cloud
|
||||
|Technology Preview
|
||||
|
||||
|Isolated Region
|
||||
|Technology Preview
|
||||
|
||||
|Oracle Alloy
|
||||
|Technology Preview
|
||||
|====
|
||||
26
modules/installing-oci-edge-infra-support.adoc
Normal file
26
modules/installing-oci-edge-infra-support.adoc
Normal file
@@ -0,0 +1,26 @@
|
||||
// Module included in the following assemblies:
|
||||
//
|
||||
// * installing/installing_oci_edge/installing-c3-agent-based-installer.adoc
|
||||
// * installing/installing_oci_edge/installing-c3-assisted-installer.adoc
|
||||
|
||||
:_mod-docs-content-type: CONCEPT
|
||||
[id="installing-oci-edge-infra-support_{context}"]
|
||||
= Supported {oci-edge-no-rt} infrastructures
|
||||
|
||||
The following table describes the support status of each {oci-edge} infrastructure offering:
|
||||
|
||||
.{oci-edge-no-rt} infrastructure support statuses
|
||||
[cols=".^,.^",options="header"]
|
||||
|====
|
||||
|Infrastructure type|Support status
|
||||
|
||||
|Private Cloud Appliance
|
||||
|General Availability
|
||||
|
||||
|Oracle Compute Cloud@Customer
|
||||
|General Availability
|
||||
|
||||
|Roving Edge
|
||||
|Technology Preview
|
||||
|
||||
|====
|
||||
@@ -4,24 +4,24 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="installing-troubleshooting-assisted-installer-oci_{context}"]
|
||||
= Troubleshooting the installation of a cluster on {oci}
|
||||
= Troubleshooting the installation of a cluster on {oci-distributed-no-rt}
|
||||
|
||||
If you experience issues with using the {ai-full} to install an {product-title} cluster on {oci-first}, read the following sections to troubleshoot common problems.
|
||||
If you experience issues with using the {ai-full} to install an {product-title} cluster on {oci-distributed}, read the following sections to troubleshoot common problems.
|
||||
|
||||
[id="installing-troubleshooting-load-balancer_{context}"]
|
||||
== The Ingress Load Balancer in {oci-distributed-no-rt} is not at a healthy status
|
||||
|
||||
== The Ingress Load Balancer in {oci} is not at a healthy status
|
||||
This issue is classed as a `Warning` because by using {oci-distributed-no-rt} to create a stack, you created a pool of compute nodes, 3 by default, that are automatically added as backend listeners for the Ingress Load Balancer. By default, the {product-title} deploys 2 router pods, which are based on the default values from the {product-title} manifest files. The `Warning` is expected because a mismatch exists with the number of router pods available, 2, to run on the 3 compute nodes.
|
||||
|
||||
This issue is classed as a `Warning` because by using {oci} to create a stack, you created a pool of compute nodes, 3 by default, that are automatically added as backend listeners for the Ingress Load Balancer. By default, the {product-title} deploys 2 router pods, which are based on the default values from the {product-title} manifest files. The `Warning` is expected because a mismatch exists with the number of router pods available, two, to run on the three compute nodes.
|
||||
|
||||
.Example of a `Warning` message that is under the Backend set information tab on {oci}
|
||||
image::ingress_load_balancer_warning_message.png[Example of an warning message that is under the Backend set information tab on {oci}]
|
||||
.Example of a `Warning` message that is under the Backend set information tab on {oci-distributed-no-rt}
|
||||
image::ingress_load_balancer_warning_message.png[Example of an warning message that is under the Backend set information tab on {oci-distributed-no-rt}]
|
||||
|
||||
You do not need to modify the Ingress Load Balancer configuration. Instead, you can point the Ingress Load Balancer to specific compute nodes that operate in your cluster on {product-title}. To do this, use placement mechanisms, such as annotations, on {product-title} to ensure router pods only run on the compute nodes that you originally configured on the Ingress Load Balancer as backend listeners.
|
||||
|
||||
[id="installing-troubleshooting-stack-operation_{context}"]
|
||||
== {oci-distributed-no-rt} create stack operation fails with an Error: 400-InvalidParameter message
|
||||
|
||||
== {oci} create stack operation fails with an Error: 400-InvalidParameter message
|
||||
|
||||
On attempting to create a stack on {oci}, you identified that the *Logs* section of the job outputs an error message. For example:
|
||||
On attempting to create a stack on {oci-distributed-no-rt}, you identified that the *Logs* section of the job outputs an error message. For example:
|
||||
|
||||
[source,terminal]
|
||||
----
|
||||
|
||||
@@ -6,28 +6,28 @@
|
||||
[id="provision-oci-infrastructure-ocp-cluster_{context}"]
|
||||
= Provisioning {oci} infrastructure for your cluster
|
||||
|
||||
When using the {ai-full} to create details for your {product-title} cluster, you specify these details in a Terraform stack. A stack is an {oci} feature that automates the provisioning of all necessary {oci} infrastructure resources that are required for installing an {product-title} cluster on {oci}.
|
||||
When using the {ai-full} to create details for your {product-title} cluster, you specify these details in a Terraform stack. A stack is an {oci-first-no-rt} feature that automates the provisioning of all necessary {oci} infrastructure resources that are required for installing an {product-title} cluster on {oci-distributed-no-rt}.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You downloaded the discovery ISO image to a local directory. For details, see "Using the {ai-full} to generate an {oci}-compatible discovery ISO image".
|
||||
* You downloaded the Terraform stack template to a local directory. For details, see "Preparing the {oci} environment".
|
||||
* You downloaded the discovery ISO image to a local directory. For details, see _Using the {ai-full} to generate a discovery ISO image_.
|
||||
* You downloaded the Terraform stack template to a local directory. For details, see "Preparing the {oci-distributed-no-rt} environment".
|
||||
|
||||
.Procedure
|
||||
|
||||
. Log in to your link:https://cloud.oracle.com/a/[{oci-first-no-rt}] account.
|
||||
. Log in to your link:https://cloud.oracle.com/a/[{oci-distributed-no-rt}] account.
|
||||
|
||||
. Upload the discovery ISO image from your local drive to the new object storage bucket you created. For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/managingobjects_topic-To_upload_objects_to_a_bucket.htm[Uploading an Object Storage Object to a Bucket (Oracle documentation)].
|
||||
. Upload the discovery ISO image from your local drive to the new object storage bucket you created. For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/managingobjects_topic-To_upload_objects_to_a_bucket.htm[Uploading an Object Storage Object to a Bucket (Oracle documentation)].
|
||||
|
||||
. Locate the uploaded discovery ISO, and complete the following steps:
|
||||
+
|
||||
--
|
||||
.. Create a Pre-Authenticated Request (PAR) for the ISO from the adjacent options menu.
|
||||
|
||||
.. Copy the generated URL to use as the OpenShift Image Source URI in the next step.
|
||||
.. Copy the generated URL to use as the OpenShift Image Source URI in the next step.
|
||||
--
|
||||
+
|
||||
For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests_topic-To_create_a_preauthenticated_request_for_all_objects_in_a_bucket.htm[Creating a Pre-Authenticated Requests in Object Storage (Oracle documentation)].
|
||||
For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests_topic-To_create_a_preauthenticated_request_for_all_objects_in_a_bucket.htm[Creating a Pre-Authenticated Requests in Object Storage (Oracle documentation)].
|
||||
|
||||
. Create and apply the Terraform stack:
|
||||
+
|
||||
@@ -39,25 +39,25 @@ The Terraform stack includes files for creating cluster resources and custom man
|
||||
--
|
||||
.. Upload the Terraform stacks template link:https://github.com/oracle-quickstart/oci-openshift/tree/main/terraform-stacks[terraform-stacks] to the new object storage bucket.
|
||||
|
||||
.. Complete the stack information and click *Next*.
|
||||
.. Complete the stack information and click *Next*.
|
||||
+
|
||||
[IMPORTANT]
|
||||
====
|
||||
* Make sure that *Cluster Name* matches *Cluster Name* in {ai-full}, and *Zone DNS* matches *Base Domain* in {ai-full}.
|
||||
* In the *OpenShift Image Source URI* field, paste the Pre-Authenticated Request URL link that you generated in the previous step.
|
||||
* Ensure that the correct *Compute Shape* field value is defined, depending on whether you are installing on bare metal or a virtual machine. If not, select a different shape from the list. For details, see link:docs.oracle.com/en-us/iaas/Content/Compute/References/computeshapes.htm[Compute Shapes (Oracle documentation)].
|
||||
* Make sure that *Cluster Name* matches *Cluster Name* in {ai-full}, and *Zone DNS* matches *Base Domain* in {ai-full}.
|
||||
* In the *OpenShift Image Source URI* field, paste the Pre-Authenticated Request URL link that you generated in the previous step.
|
||||
* Ensure that the correct *Compute Shape* field value is defined, depending on whether you are installing on bare metal or a virtual machine. If not, select a different shape from the list. For details, see link:docs.oracle.com/en-us/iaas/Content/Compute/References/computeshapes.htm[Compute Shapes (Oracle documentation)].
|
||||
====
|
||||
|
||||
.. Click *Apply* to apply the stack.
|
||||
--
|
||||
+
|
||||
For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/openshift-on-oci/installing-assisted.htm#install-cluster-apply-stack[Creating {product-title} Infrastructure Using Resource Manager (Oracle documentation)].
|
||||
For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/openshift-on-oci/installing-assisted.htm#install-cluster-apply-stack[Creating {product-title} Infrastructure Using Resource Manager (Oracle documentation)].
|
||||
|
||||
. Copy the `dynamic_custom_manifest.yml` file from the *Outputs* page of the Terraform stack.
|
||||
. Copy the `dynamic_custom_manifest.yml` file from the *Outputs* page of the Terraform stack.
|
||||
+
|
||||
[NOTE]
|
||||
====
|
||||
The YAML file contains all the required manifests, concatenated and preformatted with the configuration values. For details, see the link:https://github.com/oracle-openshift/oci-openshift/blob/main/custom_manifests/README.md[Custom Manifests README file].
|
||||
The YAML file contains all the required manifests, concatenated and preformatted with the configuration values. For details, see the link:https://github.com/oracle-openshift/oci-openshift/blob/main/custom_manifests/README.md[Custom Manifests README file].
|
||||
====
|
||||
+
|
||||
For the full procedure, see link:https://docs.oracle.com/en-us/iaas/Content/openshift-on-oci/installing-assisted.htm#install-cluster-edit-manifests[Getting the {product-title} Custom Manifests for Installation (Oracle documentation)].
|
||||
|
||||
@@ -4,13 +4,13 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="running-cluster-oci-agent-based_{context}"]
|
||||
= Running a cluster on {oci}
|
||||
= Running a cluster on {oci-distributed-no-rt}
|
||||
|
||||
To run a cluster on {oci-first}, you must upload the generated agent ISO image to the default Object Storage bucket on {oci}. Additionally, you must create a compute instance from the supplied base image, so that your {product-title} and {oci} can communicate with each other for the purposes of running the cluster on {oci}.
|
||||
To run a cluster on {oci-distributed}, you must upload the generated agent ISO image to the default Object Storage bucket on {oci-distributed-no-rt}. Additionally, you must create a compute instance from the supplied base image, so that {product-title} and {oci-distributed-no-rt} can communicate with each other for the purposes of running the cluster on {oci-distributed-no-rt}.
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
{oci} supports the following {product-title} cluster topologies:
|
||||
{oci-distributed-no-rt} supports the following {product-title} cluster topologies:
|
||||
|
||||
* Installing an {product-title} cluster on a single node.
|
||||
* A highly available cluster that has a minimum of three control plane instances and two compute instances.
|
||||
|
||||
@@ -4,13 +4,13 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="running-cluster-oci-c3-agent-based_{context}"]
|
||||
= Running a cluster on {oci-c3-short}
|
||||
= Running a cluster on {oci-edge-no-rt}
|
||||
|
||||
To run a cluster on {oci-c3}, you must first convert your generated Agent ISO image into an {oci} image, upload it to an {oci} Home Region Bucket, and then import the uploaded image to the {oci-c3-short} system.
|
||||
To run a cluster on {oci-edge}, you must first convert your generated Agent ISO image into an {oci} image, upload it to an {oci} Home Region Bucket, and then import the uploaded image to the {oci-edge-no-rt} system.
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
{oci-c3-short} supports the following {product-title} cluster topologies:
|
||||
{oci-edge-no-rt} supports the following {product-title} cluster topologies:
|
||||
|
||||
* Installing an {product-title} cluster on a single node.
|
||||
* A highly available cluster that has a minimum of three control plane instances and two compute instances.
|
||||
@@ -19,16 +19,16 @@ To run a cluster on {oci-c3}, you must first convert your generated Agent ISO im
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You generated an Agent ISO image. See the "Creating configuration files for installing a cluster on {oci-c3-short}" section.
|
||||
* You generated an Agent ISO image. See the "Creating configuration files for installing a cluster on {oci-edge-no-rt}" section.
|
||||
|
||||
.Procedure
|
||||
|
||||
. Convert the agent ISO image to an {oci} image, upload it to an {oci} Home Region Bucket, and then import the uploaded image to the {oci-c3-short} system.
|
||||
. Convert the agent ISO image to an {oci} image, upload it to an {oci} Home Region Bucket, and then import the uploaded image to the {oci-edge-no-rt} system.
|
||||
See "Prepare the OpenShift Master Images" in link:https://www.oracle.com/a/otn/docs/compute_cloud_at_customer_agent_based_installation.pdf?source=:em:nl:mt::::PCATP[OpenShift Cluster Setup with
|
||||
Agent Based Installer on Compute
|
||||
Cloud@Customer (Oracle documentation)] for instructions.
|
||||
|
||||
. Create control plane instances on {oci-c3-short}.
|
||||
. Create control plane instances on {oci-edge-no-rt}.
|
||||
See "Create control plane instances on C3 and Master Node LB Backend Sets" in link:https://www.oracle.com/a/otn/docs/compute_cloud_at_customer_agent_based_installation.pdf?source=:em:nl:mt::::PCATP[OpenShift Cluster Setup with
|
||||
Agent Based Installer on Compute
|
||||
Cloud@Customer (Oracle documentation)] for instructions.
|
||||
|
||||
@@ -6,17 +6,17 @@
|
||||
[id="using-assisted-installer-oci-create-cluster_{context}"]
|
||||
= Creating the cluster
|
||||
|
||||
Set the cluster details.
|
||||
Set the cluster details.
|
||||
|
||||
.Procedure
|
||||
|
||||
. Log into link:https://console.redhat.com/[{ai-full} web console] with your credentials.
|
||||
. Log in to the link:https://console.redhat.com/[{ai-full} web console] with your credentials.
|
||||
|
||||
. In the *Red Hat OpenShift* tile, select *OpenShift*.
|
||||
. In the *Red Hat OpenShift* tile, select *OpenShift*.
|
||||
|
||||
. In the *Red Hat {product-title}* tile, select *Create Cluster*.
|
||||
|
||||
. On the *Cluster Type* page, scroll down to the end of the *Cloud* tab, and select *Oracle Cloud Infrastructure (virtual machines)*.
|
||||
. On the *Cluster Type* page, scroll down to the end of the *Cloud* tab, and select *Oracle Cloud Infrastructure (virtual machines)*.
|
||||
|
||||
. On the *Create an OpenShift Cluster* page, select the *Interactive* tile.
|
||||
|
||||
@@ -27,12 +27,12 @@ Set the cluster details.
|
||||
|Field |Action required
|
||||
|
||||
|*Cluster name*
|
||||
|Specify the name of your cluster, such as `oci`. This is the same value as the cluster name in {oci}.
|
||||
|Specify the name of your cluster, such as `oci`. This is the same value as the cluster name in {oci-distributed-no-rt}.
|
||||
|
||||
|*Base domain*
|
||||
|Specify the base domain of the cluster, such as `openshift-demo.devcluster.openshift.com`.
|
||||
|Specify the base domain of the cluster, such as `openshift-demo.devcluster.openshift.com`.
|
||||
|
||||
This must be the same value as the zone DNS server in {oci}.
|
||||
This must be the same value as the zone DNS server in {oci-distributed-no-rt}.
|
||||
|
||||
|*OpenShift version*
|
||||
| * For installations on virtual machines only, specify `OpenShift 4.14` or a later version.
|
||||
|
||||
@@ -4,13 +4,13 @@
|
||||
|
||||
:_mod-docs-content-type: PROCEDURE
|
||||
[id="verifying-cluster-install-ai-oci_{context}"]
|
||||
= Verifying a successful cluster installation on {oci}
|
||||
= Verifying a successful cluster installation on {oci-distributed-no-rt}
|
||||
|
||||
Verify that your cluster was installed and is running effectively on {oci-first}.
|
||||
Verify that your cluster was installed and is running effectively on {oci-distributed}.
|
||||
|
||||
.Procedure
|
||||
|
||||
. From the link:https://console.redhat.com/openshift[Red Hat Hybrid Cloud Console], go to *Clusters > Assisted Clusters* and select your cluster’s name.
|
||||
. From the link:https://console.redhat.com/openshift[Red Hat Hybrid Cloud Console], go to *Clusters > Assisted Clusters* and select your cluster's name.
|
||||
|
||||
. On the *Installation Progress* page, check that the Installation progress bar is at 100% and a message displays indicating `Installation completed successfully`.
|
||||
|
||||
@@ -33,4 +33,4 @@ Verify that your cluster was installed and is running effectively on {oci-first}
|
||||
|
||||
. Select the *YAML* tab.
|
||||
|
||||
. Check the `labels` parameter, and verify that the listed labels apply to your configuration. For example, the `topology.kubernetes.io/region=us-sanjose-1` label indicates in what {oci} region the node was deployed.
|
||||
. Check the `labels` parameter, and verify that the listed labels apply to your configuration. For example, the `topology.kubernetes.io/region=us-sanjose-1` label indicates in what {oci-distributed-no-rt} region the node was deployed.
|
||||
|
||||
@@ -14,15 +14,15 @@ endif::[]
|
||||
|
||||
ifdef::c3[]
|
||||
[id="verifying-cluster-install-oci-agent-based_{context}"]
|
||||
= Verifying that your Agent-based cluster installation runs on {oci-c3-short}
|
||||
= Verifying that your Agent-based cluster installation runs on {oci-edge-no-rt}
|
||||
|
||||
Verify that your cluster was installed and is running effectively on {oci-c3-short}.
|
||||
Verify that your cluster was installed and is running effectively on {oci-edge-no-rt}.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You created all the required {oci-c3} resources and services. See the "Creating {oci-c3-no-rt} infrastructure resources and services" section.
|
||||
* You created `install-config.yaml` and `agent-config.yaml` configuration files. See the "Creating configuration files for installing a cluster on {oci-c3-short}" section.
|
||||
* You uploaded the agent ISO image to a default Oracle Object Storage bucket, and you created a compute instance on {oci-c3-short}. For more information, see "Running a cluster on {oci-c3-short}".
|
||||
* You created all the required {oci-first-no-rt} resources and services. See the "Creating {oci} infrastructure resources and services" section.
|
||||
* You created `install-config.yaml` and `agent-config.yaml` configuration files. See the "Creating configuration files for installing a cluster on {oci-edge-no-rt}" section.
|
||||
* You uploaded the agent ISO image to a default Oracle Object Storage bucket, and you created a compute instance on {oci-edge-no-rt}. For more information, see "Running a cluster on {oci-edge-no-rt}".
|
||||
endif::c3[]
|
||||
|
||||
ifdef::pca[]
|
||||
@@ -40,15 +40,15 @@ endif::pca[]
|
||||
|
||||
ifndef::pca,c3[]
|
||||
[id="verifying-cluster-install-oci-agent-based_{context}"]
|
||||
= Verifying that your Agent-based cluster installation runs on {oci}
|
||||
= Verifying that your Agent-based cluster installation runs on {oci-distributed-no-rt}
|
||||
|
||||
Verify that your cluster was installed and is running effectively on {oci-first}.
|
||||
Verify that your cluster was installed and is running effectively on {oci-distributed}.
|
||||
|
||||
.Prerequisites
|
||||
|
||||
* You created all the required {oci} resources and services. See the "Creating OCI infrastructure resources and services" section.
|
||||
* You created `install-config.yaml` and `agent-config.yaml` configuration files. See the "Creating configuration files for installing a cluster on OCI" section.
|
||||
* You uploaded the agent ISO image to a default Oracle Object Storage bucket, and you created a compute instance on {oci}. For more information, see "Running a cluster on OCI".
|
||||
* You created all the required {oci} resources and services. See the "Creating {oci-distributed-no-rt} infrastructure resources and services" section.
|
||||
* You created `install-config.yaml` and `agent-config.yaml` configuration files. See the "Creating configuration files for installing a cluster on {oci-distributed-no-rt}" section.
|
||||
* You uploaded the agent ISO image to a default Oracle Object Storage bucket, and you created a compute instance on {oci-distributed-no-rt}. For more information, see "Running a cluster on {oci-distributed-no-rt}".
|
||||
endif::pca,c3[]
|
||||
|
||||
.Procedure
|
||||
@@ -64,14 +64,14 @@ $ ./openshift-install agent wait-for install-complete --log-level debug
|
||||
+
|
||||
Check the status of the `rendezvous` host node that runs the bootstrap node. After the host reboots, the host forms part of the cluster.
|
||||
+
|
||||
* Use the `kubeconfig` API to check the status of various {product-title} components. For the `KUBECONFIG` environment variable, set the relative path of the cluster’s `kubeconfig` configuration file:
|
||||
* Use the `kubeconfig` API to check the status of various {product-title} components. For the `KUBECONFIG` environment variable, set the relative path of the cluster's `kubeconfig` configuration file:
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
$ export KUBECONFIG=~/auth/kubeconfig
|
||||
----
|
||||
+
|
||||
Check the status of each of the cluster’s self-managed nodes. CCM applies a label to each node to designate the node as running in a cluster on {oci}.
|
||||
Check the status of each of the cluster's self-managed nodes. CCM applies a label to each node to designate the node as running in a cluster on {oci}.
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
@@ -88,7 +88,7 @@ main-1.private.agenttest.oraclevcn.com Ready control-plane, master 15m v1.27.4+
|
||||
main-2.private.agenttest.oraclevcn.com Ready control-plane, master 15m v1.27.4+d7fa83f
|
||||
----
|
||||
+
|
||||
Check the status of each of the cluster’s Operators, with the CCM Operator status being a good indicator that your cluster is running.
|
||||
Check the status of each of the cluster's Operators, with the CCM Operator status being a good indicator that your cluster is running.
|
||||
+
|
||||
[source,terminal]
|
||||
----
|
||||
|
||||
Reference in New Issue
Block a user