From 6d02cb699c2d119cb5ba494134441d4ae1d9b5df Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Tue, 8 Apr 2025 22:22:36 +0300 Subject: [PATCH 1/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- .../installing-c3-assisted-installer.adoc | 19 +++++------- ...ler-completing-installation-manifests.adoc | 10 ++++--- ...er-completing-installation-networking.adoc | 8 ++++- ...staller-completing-installation-nodes.adoc | 14 +++++---- ...c3-assisted-installer-copying-scripts.adoc | 29 ++++++++++++++++++ modules/c3-assisted-installer-overview.adoc | 30 +++++++++---------- ...ed-installer-preparing-bastion-server.adoc | 6 ++-- ...-installer-preparing-image-converting.adoc | 7 +++-- ...-installer-preparing-image-generating.adoc | 28 ++++++++++------- ...ted-installer-running-script-via-home.adoc | 12 ++++---- ...d-installer-running-script-via-region.adoc | 10 +++++-- 11 files changed, 111 insertions(+), 62 deletions(-) create mode 100644 modules/c3-assisted-installer-copying-scripts.adoc diff --git a/installing/installing_oci/installing-c3-assisted-installer.adoc b/installing/installing_oci/installing-c3-assisted-installer.adoc index bb07983faef8..a769cff89a26 100644 --- a/installing/installing_oci/installing-c3-assisted-installer.adoc +++ b/installing/installing_oci/installing-c3-assisted-installer.adoc @@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[] 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-c3}, you can run applications and middleware by using {oci-first} services on high performance cloud infrastructure in your data center. // Overview include::modules/c3-assisted-installer-overview.adoc[leveloffset=+1] @@ -14,20 +14,17 @@ include::modules/c3-assisted-installer-overview.adoc[leveloffset=+1] // Preparing the Bastian server include::modules/c3-assisted-installer-preparing-bastion-server.adoc[leveloffset=+1] +// Copying the Terraform scripts onto the Bastian server +include::modules/c3-assisted-installer-copying-scripts.adoc[leveloffset=+1] + // Terraform script execution - part 1 include::modules/c3-assisted-installer-running-script-via-home.adoc[leveloffset=+1] -// Preparing the OpenShift image -[id="c3-assisted-installer-preparing-image_{context}"] -== 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. - -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] +// Generating the OpenShift image +include::modules/c3-assisted-installer-preparing-image-generating.adoc[leveloffset=+1] -include::modules/c3-assisted-installer-preparing-image-converting.adoc[leveloffset=+2] +// Converting and uploading the image +include::modules/c3-assisted-installer-preparing-image-converting.adoc[leveloffset=+1] // Terraform script execution - part 2 include::modules/c3-assisted-installer-running-script-via-region.adoc[leveloffset=+1] diff --git a/modules/c3-assisted-installer-completing-installation-manifests.adoc b/modules/c3-assisted-installer-completing-installation-manifests.adoc index 2c565455b069..dd5b9cfe2524 100644 --- a/modules/c3-assisted-installer-completing-installation-manifests.adoc +++ b/modules/c3-assisted-installer-completing-installation-manifests.adoc @@ -20,11 +20,13 @@ Create, modify, and upload the four mandatory custom manifests provided by Oracl .Prerequisites -* Prepare the custom manifests. For details, see step 8 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]. +* You have prepared the custom manifests. For details, see step 8 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]. + +* You have added NTP sources to failed hosts on the *Networking* page of the {ai-full} wizard. .Procedure -. Navigate to the *Custom manifests* page. +. In the {ai-full} wizard, navigate to the *Custom manifests* page. . Upload and save the `oci-ccm.yml` and `oci-csi.yml` manifest files: @@ -36,7 +38,7 @@ Create, modify, and upload the four mandatory custom manifests provided by Oracl .. Select the *oci-ccm.yml* file from the `C3/custom_ manifest_C3/manifests` folder. -.. Click *Add another manifest* and repeat the previous substeps for the `oci-csi.yml` file. +.. Click *Add another manifest*. Then repeat the previous substeps for the `oci-csi.yml` file. . Upload and save the `machineconfig-ccm.yml` and `machineconfig-csi.yml` manifest files: @@ -50,7 +52,7 @@ Create, modify, and upload the four mandatory custom manifests provided by Oracl .. Select the *machineconfig-ccm.yml* file from the `C3/custom_ manifest_C3/openshift` folder. -.. Click *Add another manifest* and repeat the previous substeps for the `machineconfig-csi.yml` file. +.. Click *Add another manifest*. Then repeat the previous substeps for the `machineconfig-csi.yml` file. . Click *Next* to save the custom manifests. diff --git a/modules/c3-assisted-installer-completing-installation-networking.adoc b/modules/c3-assisted-installer-completing-installation-networking.adoc index 862a6681a20b..943f3289e2bd 100644 --- a/modules/c3-assisted-installer-completing-installation-networking.adoc +++ b/modules/c3-assisted-installer-completing-installation-networking.adoc @@ -8,12 +8,18 @@ On the *Networking* page, add the NTP sources for any hosts that display the `Some validations failed` status. +.Prerequisites + +* You have deleted the disconnected hosts on the *Host discovery* page of the {ai-full} wizard. + .Procedure +. In the {ai-full} wizard, navigate to the *Networking* page. + . In the *Host inventory* table, click the *Some validations failed* link for each host displaying this status. . Click *Add NTP sources*, and then add the IP address `169.254.169.254` for one of the nodes. -. Wait for 2 - 3 minutes until all the *Some validations failed* indicators disappear. +. Wait for 2 - 3 minutes until all of the *Some validations failed* indicators disappear. . Select *Next*. \ No newline at end of file diff --git a/modules/c3-assisted-installer-completing-installation-nodes.adoc b/modules/c3-assisted-installer-completing-installation-nodes.adoc index 5fdd00cbd356..0f0cfdb03ffe 100644 --- a/modules/c3-assisted-installer-completing-installation-nodes.adoc +++ b/modules/c3-assisted-installer-completing-installation-nodes.adoc @@ -6,19 +6,23 @@ [id="c3-ai-completing-installation-nodes_{context}"] = Assigning node roles -If the Terraform scripts completed successfully, twelve hosts are now listed for the cluster. Three control plane hosts and three compute hosts have the status "Disconnected". Three control plane hosts and three compute hosts have the status "Insufficient". +If the Terraform scripts completed successfully, the installation process lists twelve hosts for the cluster. Three control plane hosts and three compute hosts have the status "Disconnected". Three control plane hosts and three compute hosts have the status "Insufficient". -Delete the disconnected hosts and assign roles to the remaining hosts. +Delete the disconnected hosts and assign roles to the remaining hosts. + +.Prerequisites + +* You have created all infrastructure resources by running the Terraform script via the {oci-c3-short} region. .Procedure . From the link:https://console.redhat.com/openshift/assisted-installer/clusters[{ai-full} web console], select the cluster and navigate to the *Host discovery* page. -. Delete the six hosts with a "Disconnected" status, by clicking the option button for each host and selecting *Remove host*. The status of the remaining hosts changes from "Insufficient" to "Ready". This process can take up to three minutes. +. Delete the six hosts with a "Disconnected" status by clicking the option button for each host and selecting *Remove host*. The status of the remaining hosts changes from "Insufficient" to "Ready". This process can take up to three minutes. -. From the *Role* column, assign the *Control plane* role to the three nodes with a boot size of 1.10 TB. Assign the *Worker* role to the three nodes with boot size of 100 GB. +. From the *Role* column, assign the *Control plane* role to the three nodes with a boot size of 1.10 TB. Assign the *Worker* role to the three nodes with a boot size of 100 GB. -. Rename any hosts with a name shorter than 63 characters, by clicking the option button for the host and selecting *Change hostname*. Otherwise the cluster installation will fail. +. Rename any hosts with a name shorter than 63 characters by clicking the option button for the host and selecting *Change hostname*. Otherwise the cluster installation will fail. . Click *Next*. diff --git a/modules/c3-assisted-installer-copying-scripts.adoc b/modules/c3-assisted-installer-copying-scripts.adoc new file mode 100644 index 000000000000..aee1f4ba8127 --- /dev/null +++ b/modules/c3-assisted-installer-copying-scripts.adoc @@ -0,0 +1,29 @@ +// Module included in the following assemblies: +// +// * installing/installing_oci/installing-c3-assisted-installer.adoc + +:_mod-docs-content-type: PROCEDURE +[id="c3-ai-copying-scripts_{context}"] += Copying the Terraform scripts onto the bastion server + +The bastion host is used to run two Terraform scripts: + +* `createInfraResources.tf` - Builds IAM Resources in the {oci} Home region of the {oci-c3-short} system (two Dynamic Groups and one Policy). + +* `terraform.tfvars` - Builds the infrastructure resources on the {oci-c3-short} system to support the {product-title} cluster. The script includes all the resources needed to activate the control plane nodes and compute nodes that form a cluster. + +Copy the `createInfraResources.tf` and `terraform.tfvars` scripts onto the bastion server. + +.Prerequisites + +* You have prepared the bastion server in the {oci-first-no-rt} home region. + +.Procedure + +. Connect to the bastion server via SSH. + +. Create `OpenShift\createResourceOnHomeRegion` folders. + +. Copy the `createInfraResources.tf` and `terraform.tfvars` files from the C3_PCA GitHub repository into the `createResourceOnHomeRegion` folder. + +For the full procedure, see the "Terraform Script Execution Part-1 (Run Script via Home Region)" 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]. \ No newline at end of file diff --git a/modules/c3-assisted-installer-overview.adoc b/modules/c3-assisted-installer-overview.adoc index c95ca756793f..8bc64fa0a62e 100644 --- a/modules/c3-assisted-installer-overview.adoc +++ b/modules/c3-assisted-installer-overview.adoc @@ -4,9 +4,9 @@ :_mod-docs-content-type: CONCEPT [id="c3-ai-overview_{context}"] -= Overview += Installation process overview -You can install {product-title} on {oci-c3-no-rt} by using the {ai-full}. +You can install {product-title} on {oci-c3} by using the {ai-full}. The installation process 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}. For an alternative installation method, see "Installing a cluster on {oci-c3} by using the Agent-based Installer". @@ -18,29 +18,27 @@ For an alternative installation method, see "Installing a cluster on {oci-c3} by * Ensure that you are performing the installation on a virtual machine. -.Installation process +.Installation process workflow -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 following workflow describes a high-level outline for installing an {product-title} on {oci-c3-short} using the {ai-full}: -* The first script builds IAM Resources in the {oci} Home region of the {oci-c3-short} system (two Dynamic Groups and one Policy). +. Prepare the {oci-c3-short} bastion server (Oracle). -* 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. +. Copy the `createInfraResources.tf` and `terraform.tfvars` Terraform scripts onto the bastion server. -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. +. Run the `createInfraResources.tf` script via the Home region (Oracle). -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}. +. Generate the {product-title} image in the {ai-full} web console (Red Hat). -.Main steps +. Convert and upload the image to {oci-first-no-rt} (Oracle). -The main steps of the procedure are as follows: +. Run the `terraform.tfvars` script via the {oci-c3-short} region (Oracle). -. Preparing the {oci-c3-short} bastion server. +. Complete the cluster installation by using the {ai-full} web console (Red Hat): -. Running the Terraform script via the Home region. +.. Assign node roles. -. Preparing the {product-title} image for {oci-first-no-rt}. +.. Configure networking. -. Running the Terraform script via the {oci-c3-short} region. - -. Installing the cluster by using the {ai-full} web console. +.. Add custom manifests diff --git a/modules/c3-assisted-installer-preparing-bastion-server.adoc b/modules/c3-assisted-installer-preparing-bastion-server.adoc index ed78095a2e62..453e9d396662 100644 --- a/modules/c3-assisted-installer-preparing-bastion-server.adoc +++ b/modules/c3-assisted-installer-preparing-bastion-server.adoc @@ -4,9 +4,11 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-preparing-bastian-server_{context}"] -= Preparing the {oci} bastion server += Preparing the bastion server in the {oci-first} home region -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 installing 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. + +The installation process builds a bastion host within the designated compartment of the {product-title} cluster. The host is configured to communicate through a designated {oci-c3-short} DRG Subnet or Internet GW Subnet within the {oci-c3-short} parent tenancy. .Prerequisites diff --git a/modules/c3-assisted-installer-preparing-image-converting.adoc b/modules/c3-assisted-installer-preparing-image-converting.adoc index 11ff53cd6568..550557ea202c 100644 --- a/modules/c3-assisted-installer-preparing-image-converting.adoc +++ b/modules/c3-assisted-installer-preparing-image-converting.adoc @@ -6,8 +6,11 @@ [id="c3-assisted-installer-preparing-image-converting_{context}"] = Converting and uploading the image to {oci-c3-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 -Store. +Convert the ISO image to an {oci} image and upload it to your {oci-c3-short} system from your {oci-first} Home Region Object Store. You can perform this step on your local machine, rather than on the bastion server or within environments such as Oracle Solution Center. + +.Prerequisites + +* You have generated the {product-title} Discovery ISO in the {ai-full} web console, and saved the file to your local system. .Procedure diff --git a/modules/c3-assisted-installer-preparing-image-generating.adoc b/modules/c3-assisted-installer-preparing-image-generating.adoc index 36c1018698d2..5ac651f243a8 100644 --- a/modules/c3-assisted-installer-preparing-image-generating.adoc +++ b/modules/c3-assisted-installer-preparing-image-generating.adoc @@ -4,17 +4,21 @@ :_mod-docs-content-type: PROCEDURE [id="c3-assisted-installer-preparing-image-generating_{context}"] -= Generating the image in the {ai-full} += Generating the image in the Red{nbsp}Hat {ai-full} -Create a cluster and download the discovery ISO image. +Create a cluster and generate the {product-title} Discovery ISO image in the {ai-full} on the Red{nbsp}Hat portal. You can perform this step on your local machine, rather than on the bastion server or within environments such as Oracle Solution Center. + +.Prerequisites + +* You have run the `createInfraResources.tf` Terraform script to create the Dynamic Group Identity resources on your {oci-first-no-rt} Home region. .Procedure . 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{nbsp}Hat OpenShift* tile, select *OpenShift*. -. In the *Red Hat {product-title}* tile, select *Create Cluster*. +. In the *Red{nbsp}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)*. @@ -27,10 +31,10 @@ Create a cluster and download the discovery ISO image. |Field |Action required |*Cluster name* -|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. +|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 and hyphens (-), 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-c3-short}. Make a note of the value for later use. |*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. @@ -52,19 +56,21 @@ After you specify this value, the *Include custom manifests* checkbox is selecte The minimal ISO image is the mandatory *Provisioning type* for the {oci-first-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: +.. Create the SSH public key by running the following command: + [source,terminal] ---- $ cat ~/.ssh/id_rsa.put ---- -+ -The SSH public key will be installed on all {product-title} control plane and compute nodes. + +.. Copy the output from the previous step into the *SSH public key* field. The SSH public key will be installed on all {product-title} control plane and compute nodes. .. Click the *Show proxy settings* checkbox. .. Add the proxy variables from the `/etc/environment` file of the bastion server that you configured earlier: + +.Proxy variables + [source,terminal] ---- http_proxy=http://www-proxy..com:80 @@ -73,6 +79,6 @@ no_proxy=localhost,127.0.0.1,1,2,3,4,5,6,7,8,9,0,..com #(ie.oracle.com,.oraclecorp.com) ---- -.. Click *Generate Discovery ISO* to generate the discovery ISO image file. +.. Click *Generate Discovery ISO* to generate the Discovery ISO image file. -. Click *Download Discovery ISO* to save the file to your local system. After you download the ISO file, you can rename it as required, for example `discovery_image_.iso`. +. Click *Download Discovery ISO* to save the file to your local system. After you download the Discovery ISO file, you can rename it as required, for example `discovery_image_.iso`. diff --git a/modules/c3-assisted-installer-running-script-via-home.adoc b/modules/c3-assisted-installer-running-script-via-home.adoc index 6107a7adaf76..e596fc440acd 100644 --- a/modules/c3-assisted-installer-running-script-via-home.adoc +++ b/modules/c3-assisted-installer-running-script-via-home.adoc @@ -4,23 +4,21 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-running-script-via-home_{context}"] -= Running the Terraform script via the Home region += Running the Terraform script via the {oci-first-no-rt} 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. +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 +* You have copied + * You have tenancy privileges to create Dynamic Groups and Policies. If not, you can manually provision them during this procedure. .Procedure . Connect to the bastion server via SSH. -. Create `OpenShift\createResourceOnHomeRegion` folders. - -. Copy the `createInfraResources.tf` and `terraform.tfvars` files from the C3_PCA GitHub repository into the `createResourceOnHomeRegion` folder. - -. Ensure that you have access to the source environment, and that your C3 certificate has been exported. +. Ensure that you have access to the source environment, and that your {oci-c3-short} certificate has been exported. . Run the `createInfraResources.tf` Terraform script. diff --git a/modules/c3-assisted-installer-running-script-via-region.adoc b/modules/c3-assisted-installer-running-script-via-region.adoc index 8def1fe8298a..64e6e78ebb2d 100644 --- a/modules/c3-assisted-installer-running-script-via-region.adoc +++ b/modules/c3-assisted-installer-running-script-via-region.adoc @@ -4,17 +4,21 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-running-script-via-region_{context}"] -= Running the Terraform script via the C3 region += Running the Terraform script via the {oci-c3-short} 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-c3-short}. 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. +.Prerequisites + +* You have converted and uploaded the image to {oci-first-no-rt}. + .Procedure . Connect to the bastion server via SSH. -. Set the C3 Certificate location and export the certificate. +. Set the {oci-c3-short} Certificate location and export the certificate. . Run the `terraform.tfvars` script to create three control plane nodes and three compute nodes. From ae5a63f24b9b4b2698efc2d6997314fbafeaf1c9 Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Wed, 16 Apr 2025 09:31:21 +0300 Subject: [PATCH 2/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- ...-installer-completing-installation-manifests.adoc | 2 +- modules/c3-assisted-installer-overview.adoc | 12 +++++++----- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/modules/c3-assisted-installer-completing-installation-manifests.adoc b/modules/c3-assisted-installer-completing-installation-manifests.adoc index dd5b9cfe2524..5f673eeb8368 100644 --- a/modules/c3-assisted-installer-completing-installation-manifests.adoc +++ b/modules/c3-assisted-installer-completing-installation-manifests.adoc @@ -20,7 +20,7 @@ Create, modify, and upload the four mandatory custom manifests provided by Oracl .Prerequisites -* You have prepared the custom manifests. For details, see step 8 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]. +* You have created the custom manifests. For details, see step 8 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]. * You have added NTP sources to failed hosts on the *Networking* page of the {ai-full} wizard. diff --git a/modules/c3-assisted-installer-overview.adoc b/modules/c3-assisted-installer-overview.adoc index 8bc64fa0a62e..39ece162b41c 100644 --- a/modules/c3-assisted-installer-overview.adoc +++ b/modules/c3-assisted-installer-overview.adoc @@ -28,17 +28,19 @@ The following workflow describes a high-level outline for installing an {product . Run the `createInfraResources.tf` script via the Home region (Oracle). -. Generate the {product-title} image in the {ai-full} web console (Red Hat). +. Generate the {product-title} image in the {ai-full} web console (Red{nbsp}Hat). . Convert and upload the image to {oci-first-no-rt} (Oracle). . Run the `terraform.tfvars` script via the {oci-c3-short} region (Oracle). -. Complete the cluster installation by using the {ai-full} web console (Red Hat): +. Complete the cluster installation by using the {ai-full} web console (Red{nbsp}Hat): -.. Assign node roles. +.. Assign node roles to control plane (master) and compute (worker) nodes. -.. Configure networking. +.. Configure networking by adding the NTP sources for any failed hosts. -.. Add custom manifests +.. Create the custom manifests and add them through the {ai} web console. + +. Open {product-title} from the {oci-first-no-rt} web console (Oracle). From b0df276519ace2c125d7aa1224c98e16b6a95f17 Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Wed, 16 Apr 2025 09:53:04 +0300 Subject: [PATCH 3/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- modules/c3-assisted-installer-overview.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/modules/c3-assisted-installer-overview.adoc b/modules/c3-assisted-installer-overview.adoc index 39ece162b41c..0e4ce750563b 100644 --- a/modules/c3-assisted-installer-overview.adoc +++ b/modules/c3-assisted-installer-overview.adoc @@ -34,13 +34,13 @@ The following workflow describes a high-level outline for installing an {product . Run the `terraform.tfvars` script via the {oci-c3-short} region (Oracle). -. Complete the cluster installation by using the {ai-full} web console (Red{nbsp}Hat): +. Complete the cluster installation by using the {ai-full} web console: -.. Assign node roles to control plane (master) and compute (worker) nodes. +.. Assign node roles to control plane (master) and compute (worker) nodes (Red{nbsp}Hat). -.. Configure networking by adding the NTP sources for any failed hosts. +.. Configure networking by adding the NTP sources for any failed hosts (Red{nbsp}Hat). -.. Create the custom manifests and add them through the {ai} web console. +.. Create the custom manifests and add them through the {ai} web console (Oracle/Red{nbsp}Hat). . Open {product-title} from the {oci-first-no-rt} web console (Oracle). From e982bafdfeef78a59af7f5fc9013d4a6eaefe86a Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Wed, 16 Apr 2025 10:16:28 +0300 Subject: [PATCH 4/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- modules/c3-assisted-installer-overview.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/c3-assisted-installer-overview.adoc b/modules/c3-assisted-installer-overview.adoc index 0e4ce750563b..079aed703596 100644 --- a/modules/c3-assisted-installer-overview.adoc +++ b/modules/c3-assisted-installer-overview.adoc @@ -40,7 +40,7 @@ The following workflow describes a high-level outline for installing an {product .. Configure networking by adding the NTP sources for any failed hosts (Red{nbsp}Hat). -.. Create the custom manifests and add them through the {ai} web console (Oracle/Red{nbsp}Hat). +.. Create the custom manifests (Oracle) and add them through the {ai} web console (Red{nbsp}Hat). . Open {product-title} from the {oci-first-no-rt} web console (Oracle). From 8047ad940d39d0f3dcc330b131e5f64419682d95 Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Wed, 16 Apr 2025 15:34:15 +0300 Subject: [PATCH 5/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- modules/c3-assisted-installer-copying-scripts.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/c3-assisted-installer-copying-scripts.adoc b/modules/c3-assisted-installer-copying-scripts.adoc index aee1f4ba8127..25ca1b072803 100644 --- a/modules/c3-assisted-installer-copying-scripts.adoc +++ b/modules/c3-assisted-installer-copying-scripts.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-copying-scripts_{context}"] -= Copying the Terraform scripts onto the bastion server += Copying the Terraform scripts onto the bastion server in the {oci-first} home region The bastion host is used to run two Terraform scripts: From f3b11344ddfd6b608214ef0fc6d2d04bf35a62ee Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Thu, 17 Apr 2025 20:36:41 +0300 Subject: [PATCH 6/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- modules/c3-assisted-installer-overview.adoc | 28 +++++++++++++------ ...ed-installer-preparing-bastion-server.adoc | 2 +- 2 files changed, 21 insertions(+), 9 deletions(-) diff --git a/modules/c3-assisted-installer-overview.adoc b/modules/c3-assisted-installer-overview.adoc index 079aed703596..209293607431 100644 --- a/modules/c3-assisted-installer-overview.adoc +++ b/modules/c3-assisted-installer-overview.adoc @@ -24,23 +24,35 @@ The following workflow describes a high-level outline for installing an {product . Prepare the {oci-c3-short} bastion server (Oracle). -. Copy the `createInfraResources.tf` and `terraform.tfvars` Terraform scripts onto the bastion server. +. Create the `createIdentityResources.tf` script in the Home region (Oracle): -. Run the `createInfraResources.tf` script via the Home region (Oracle). +.. Copy the Identity resources from GitHub to the bastian server (Oracle). -. Generate the {product-title} image in the {ai-full} web console (Red{nbsp}Hat). +.. Modify the `terraform.tfvars` as instructed (Oracle). + +.. Run the `Terraform Init`, `Terraform Plan`, `Terraform Apply` commands in the home region. + +. Create the `createInfraResources.tf` script in the {oci-c3-short} region (Oracle). + +. Generate the {product-title} Discovery image in the {ai-full} web console (Red{nbsp}Hat). . Convert and upload the image to {oci-first-no-rt} (Oracle). -. Run the `terraform.tfvars` script via the {oci-c3-short} region (Oracle). +. Copy the Infrastructure Terraform files from GitHub to the bastion server (Oracle). + +. Modify the `terraform.tfvars` on the bastion server as instructed, including the converted Discovery image (Oracle). + +. Run the `Terraform Init`, `Terraform Plan`, `Terraform Apply` commands in the {oci-c3-short} region (Oracle). + +. Tag the control plane (master) nodes and the compute (worker) nodes with your cluster {product-title} name (Oracle). -. Complete the cluster installation by using the {ai-full} web console: +. Use the script output to update the custom manifest files to be uploaded to the {product-title} console (Oracle). -.. Assign node roles to control plane (master) and compute (worker) nodes (Red{nbsp}Hat). +. Assign node roles to control plane (master) and compute (worker) nodes (Red{nbsp}Hat). Remove disconnected nodes. -.. Configure networking by adding the NTP sources for any failed hosts (Red{nbsp}Hat). +. Configure networking by adding the NTP sources for any failed hosts (Red{nbsp}Hat). -.. Create the custom manifests (Oracle) and add them through the {ai} web console (Red{nbsp}Hat). +. Add the custom manifests through the {ai} web console (Red{nbsp}Hat). . Open {product-title} from the {oci-first-no-rt} web console (Oracle). diff --git a/modules/c3-assisted-installer-preparing-bastion-server.adoc b/modules/c3-assisted-installer-preparing-bastion-server.adoc index 453e9d396662..b902a8572cf9 100644 --- a/modules/c3-assisted-installer-preparing-bastion-server.adoc +++ b/modules/c3-assisted-installer-preparing-bastion-server.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-preparing-bastian-server_{context}"] -= Preparing the bastion server in the {oci-first} home region += Preparing the bastion server in the {oci-c3-no-rt} Compartment for the {product-title} cluster installation By installing 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. From f6b8e497c666c3b0bb8373774884338dbdf5f95a Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Fri, 18 Apr 2025 07:55:03 +0300 Subject: [PATCH 7/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- modules/c3-assisted-installer-overview.adoc | 39 +++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/modules/c3-assisted-installer-overview.adoc b/modules/c3-assisted-installer-overview.adoc index 209293607431..54f41ce1e5d6 100644 --- a/modules/c3-assisted-installer-overview.adoc +++ b/modules/c3-assisted-installer-overview.adoc @@ -56,3 +56,42 @@ The following workflow describes a high-level outline for installing an {product . Open {product-title} from the {oci-first-no-rt} web console (Oracle). +//// + +The following workflow describes a high-level outline for installing an {product-title} on {oci-c3-short} using the {ai-full}: + +. Prepare the {oci-c3-short} bastion server (Oracle). + +. Create the `createIdentityResources.tf` script in the Home region (Oracle): + +.. Copy the Identity resources from GitHub to the bastian server (Oracle). + +.. Modify the `terraform.tfvars` as instructed (Oracle). + +.. Run the `Terraform Init`, `Terraform Plan`, `Terraform Apply` commands in the home region. + +. Create the `createInfraResources.tf` script in the {oci-c3-short} region (Oracle). + +. Generate the {product-title} Discovery image in the {ai-full} web console (Red{nbsp}Hat). + +. Convert and upload the image to {oci-first-no-rt} (Oracle). + +. Copy the Infrastructure Terraform files from GitHub to the bastion server (Oracle). + +. Modify the `terraform.tfvars` on the bastion server as instructed, including the converted Discovery image (Oracle). + +. Run the `Terraform Init`, `Terraform Plan`, and `Terraform Apply` commands in the {oci-c3-short} region (Oracle). + +. Tag the control plane (master) nodes and the compute (worker) nodes with your cluster {product-title} name (Oracle). + +. Use the script output to update the custom manifest files to be uploaded to the {product-title} console (Oracle). + +. Assign node roles to control plane (master) and compute (worker) nodes (Red{nbsp}Hat). Remove disconnected nodes. + +. Configure networking by adding the NTP sources for any failed hosts (Red{nbsp}Hat). + +. Add the custom manifests through the {ai} web console (Red{nbsp}Hat). + +. Open {product-title} from the {oci-first-no-rt} web console (Oracle). + +//// \ No newline at end of file From 85085867d16a6076a53e41d3b031362c6dc627a3 Mon Sep 17 00:00:00 2001 From: Talia Shwartzberg Date: Sun, 20 Apr 2025 13:41:12 +0300 Subject: [PATCH 8/8] HCIDOCS-651-followup: Oracle Cloud C3 finalizing --- .../installing-c3-assisted-installer.adoc | 16 ++++++---------- ...taller-completing-installation-manifests.adoc | 2 +- ...aller-completing-installation-networking.adoc | 2 +- ...-installer-completing-installation-nodes.adoc | 4 +++- .../c3-assisted-installer-copying-scripts.adoc | 2 +- modules/c3-assisted-installer-overview.adoc | 9 +++------ ...isted-installer-preparing-bastion-server.adoc | 4 ++-- ...sisted-installer-running-script-via-home.adoc | 2 +- ...sted-installer-running-script-via-region.adoc | 2 +- 9 files changed, 19 insertions(+), 24 deletions(-) diff --git a/installing/installing_oci/installing-c3-assisted-installer.adoc b/installing/installing_oci/installing-c3-assisted-installer.adoc index a769cff89a26..3e5316c8c0cc 100644 --- a/installing/installing_oci/installing-c3-assisted-installer.adoc +++ b/installing/installing_oci/installing-c3-assisted-installer.adoc @@ -29,18 +29,14 @@ include::modules/c3-assisted-installer-preparing-image-converting.adoc[leveloffs // Terraform script execution - part 2 include::modules/c3-assisted-installer-running-script-via-region.adoc[leveloffset=+1] -// Completing the installation +//completing installation - adding roles to nodes +include::modules/c3-assisted-installer-completing-installation-nodes.adoc[leveloffset=+1] -[id="c3-ai-completing-installation_{context}"] -== Completing the installation by using the {ai-full} web console +//completing installation - configuring networking +include::modules/c3-assisted-installer-completing-installation-networking.adoc[leveloffset=+1] -After you configure the infrastructure, the instances are now running and are ready to be registered with{nbsp}Red Hat. - -include::modules/c3-assisted-installer-completing-installation-nodes.adoc[leveloffset=+2] - -include::modules/c3-assisted-installer-completing-installation-networking.adoc[leveloffset=+2] - -include::modules/c3-assisted-installer-completing-installation-manifests.adoc[leveloffset=+2] +//completing installation - uploading custom manifests +include::modules/c3-assisted-installer-completing-installation-manifests.adoc[leveloffset=+1] // Opening the cluster include::modules/c3-assisted-installer-opening-cluster.adoc[leveloffset=+1] \ No newline at end of file diff --git a/modules/c3-assisted-installer-completing-installation-manifests.adoc b/modules/c3-assisted-installer-completing-installation-manifests.adoc index 5f673eeb8368..b4a2b8e5a39f 100644 --- a/modules/c3-assisted-installer-completing-installation-manifests.adoc +++ b/modules/c3-assisted-installer-completing-installation-manifests.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-completing-installation-manifests_{context}"] -= Adding custom manifests += Adding custom manifests in the Red{nbsp}Hat {ai-full} Create, modify, and upload the four mandatory custom manifests provided by Oracle. diff --git a/modules/c3-assisted-installer-completing-installation-networking.adoc b/modules/c3-assisted-installer-completing-installation-networking.adoc index 943f3289e2bd..dfe458cd27ee 100644 --- a/modules/c3-assisted-installer-completing-installation-networking.adoc +++ b/modules/c3-assisted-installer-completing-installation-networking.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-completing-installation-networking_{context}"] -= Configuring networking += Configuring networking in the Red{nbsp}Hat {ai-full} On the *Networking* page, add the NTP sources for any hosts that display the `Some validations failed` status. diff --git a/modules/c3-assisted-installer-completing-installation-nodes.adoc b/modules/c3-assisted-installer-completing-installation-nodes.adoc index 0f0cfdb03ffe..9f857776d06c 100644 --- a/modules/c3-assisted-installer-completing-installation-nodes.adoc +++ b/modules/c3-assisted-installer-completing-installation-nodes.adoc @@ -4,7 +4,9 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-completing-installation-nodes_{context}"] -= Assigning node roles += Assigning roles to nodes in the Red{nbsp}Hat {ai-full} + +After you configure the infrastructure, the instances are now running and are ready to be registered with{nbsp}Red Hat. If the Terraform scripts completed successfully, the installation process lists twelve hosts for the cluster. Three control plane hosts and three compute hosts have the status "Disconnected". Three control plane hosts and three compute hosts have the status "Insufficient". diff --git a/modules/c3-assisted-installer-copying-scripts.adoc b/modules/c3-assisted-installer-copying-scripts.adoc index 25ca1b072803..7d13e34469de 100644 --- a/modules/c3-assisted-installer-copying-scripts.adoc +++ b/modules/c3-assisted-installer-copying-scripts.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-copying-scripts_{context}"] -= Copying the Terraform scripts onto the bastion server in the {oci-first} home region += Copying the Terraform scripts onto the bastion server in {oci-c3-no-rt} The bastion host is used to run two Terraform scripts: diff --git a/modules/c3-assisted-installer-overview.adoc b/modules/c3-assisted-installer-overview.adoc index 54f41ce1e5d6..a1428ae2edaf 100644 --- a/modules/c3-assisted-installer-overview.adoc +++ b/modules/c3-assisted-installer-overview.adoc @@ -30,7 +30,7 @@ The following workflow describes a high-level outline for installing an {product .. Modify the `terraform.tfvars` as instructed (Oracle). -.. Run the `Terraform Init`, `Terraform Plan`, `Terraform Apply` commands in the home region. +.. Run the `Terraform Init`, `Terraform Plan`, and `Terraform Apply` commands in the home region. . Create the `createInfraResources.tf` script in the {oci-c3-short} region (Oracle). @@ -42,7 +42,7 @@ The following workflow describes a high-level outline for installing an {product . Modify the `terraform.tfvars` on the bastion server as instructed, including the converted Discovery image (Oracle). -. Run the `Terraform Init`, `Terraform Plan`, `Terraform Apply` commands in the {oci-c3-short} region (Oracle). +. Run the `Terraform Init`, `Terraform Plan`, and `Terraform Apply` commands in the {oci-c3-short} region (Oracle). . Tag the control plane (master) nodes and the compute (worker) nodes with your cluster {product-title} name (Oracle). @@ -57,9 +57,6 @@ The following workflow describes a high-level outline for installing an {product . Open {product-title} from the {oci-first-no-rt} web console (Oracle). //// - -The following workflow describes a high-level outline for installing an {product-title} on {oci-c3-short} using the {ai-full}: - . Prepare the {oci-c3-short} bastion server (Oracle). . Create the `createIdentityResources.tf` script in the Home region (Oracle): @@ -80,7 +77,7 @@ The following workflow describes a high-level outline for installing an {product . Modify the `terraform.tfvars` on the bastion server as instructed, including the converted Discovery image (Oracle). -. Run the `Terraform Init`, `Terraform Plan`, and `Terraform Apply` commands in the {oci-c3-short} region (Oracle). +. Run the `Terraform Init`, `Terraform Plan`, `Terraform Apply` commands in the {oci-c3-short} region (Oracle). . Tag the control plane (master) nodes and the compute (worker) nodes with your cluster {product-title} name (Oracle). diff --git a/modules/c3-assisted-installer-preparing-bastion-server.adoc b/modules/c3-assisted-installer-preparing-bastion-server.adoc index b902a8572cf9..d3b68b9a6c85 100644 --- a/modules/c3-assisted-installer-preparing-bastion-server.adoc +++ b/modules/c3-assisted-installer-preparing-bastion-server.adoc @@ -4,11 +4,11 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-preparing-bastian-server_{context}"] -= Preparing the bastion server in the {oci-c3-no-rt} Compartment for the {product-title} cluster installation += Preparing the bastion server in {oci-c3-no-rt} By installing 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. -The installation process builds a bastion host within the designated compartment of the {product-title} cluster. The host is configured to communicate through a designated {oci-c3-short} DRG Subnet or Internet GW Subnet within the {oci-c3-short} parent tenancy. +The installation process builds a bastion host within the {oci-c3-no-rt} compartment of the {product-title} cluster. The host is configured to communicate through a designated {oci-c3-short} DRG Subnet or Internet GW Subnet within the {oci-c3-short} parent tenancy. .Prerequisites diff --git a/modules/c3-assisted-installer-running-script-via-home.adoc b/modules/c3-assisted-installer-running-script-via-home.adoc index e596fc440acd..6a99dd2636dd 100644 --- a/modules/c3-assisted-installer-running-script-via-home.adoc +++ b/modules/c3-assisted-installer-running-script-via-home.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-running-script-via-home_{context}"] -= Running the Terraform script via the {oci-first-no-rt} Home region += Running the Terraform script in the Home region of {oci-c3-no-rt} 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. diff --git a/modules/c3-assisted-installer-running-script-via-region.adoc b/modules/c3-assisted-installer-running-script-via-region.adoc index 64e6e78ebb2d..edb12d99d3b3 100644 --- a/modules/c3-assisted-installer-running-script-via-region.adoc +++ b/modules/c3-assisted-installer-running-script-via-region.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: PROCEDURE [id="c3-ai-running-script-via-region_{context}"] -= Running the Terraform script via the {oci-c3-short} region += Running the Terraform script via the {oci-c3-short} region of {oci-c3-no-rt} 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.