Skip to content

Commit f4e18cc

Browse files
committed
OSDOCS-16184: Oracle cloud install docs
1 parent 27a8721 commit f4e18cc

File tree

36 files changed

+258
-243
lines changed

36 files changed

+258
-243
lines changed

_attributes/common-attributes.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -330,6 +330,10 @@ endif::[]
330330
:oci-pca: Oracle(R) Private Cloud Appliance
331331
:oci-pca-no-rt: Oracle Private Cloud Appliance
332332
:oci-pca-short: Private Cloud Appliance
333+
:oci-distributed: Oracle(R) Distributed Cloud
334+
:oci-distributed-no-rt: Oracle Distributed Cloud
335+
:oci-edge: Oracle(R) Edge Cloud
336+
:oci-edge-no-rt: Oracle Edge Cloud
333337
// Red Hat OpenStack Platform (RHOSP)/OpenStack
334338
ifndef::openshift-origin[]
335339
:rh-openstack-first: Red{nbsp}Hat OpenStack Platform (RHOSP)

_topic_maps/_topic_map.yml

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -588,20 +588,22 @@ Topics:
588588
File: uninstalling-openstack-user
589589
- Name: Installation configuration parameters for OpenStack
590590
File: installation-config-parameters-openstack
591-
- Name: Installing on OCI
591+
- Name: Installing on Oracle Distributed Cloud
592592
Dir: installing_oci
593593
Distros: openshift-origin,openshift-enterprise
594594
Topics:
595-
- Name: Installing a cluster on Oracle Cloud Infrastructure by using the Assisted Installer
595+
- Name: Installing a cluster on Oracle Distributed Cloud by using the Assisted Installer
596596
File: installing-oci-assisted-installer
597-
- Name: Installing a cluster on Oracle Cloud Infrastructure by using the Agent-based Installer
597+
- Name: Installing a cluster on Oracle Distributed Cloud by using the Agent-based Installer
598598
File: installing-oci-agent-based-installer
599-
- Name: Installing a cluster on Oracle Compute Cloud@Customer by using the Agent-based Installer
600-
File: installing-c3-agent-based-installer
601-
- Name: Installing a cluster on Oracle Private Cloud Appliance by using the Agent-based Installer
602-
File: installing-pca-agent-based-installer
603-
- Name: Installing a cluster on Oracle Compute Cloud@Customer by using the Assisted Installer
599+
- Name: Installing on Oracle Edge Cloud
600+
Dir: installing_oci_edge
601+
Distros: openshift-enterprise
602+
Topics:
603+
- Name: Installing a cluster on Oracle Edge Cloud by using the Assisted Installer
604604
File: installing-c3-assisted-installer
605+
- Name: Installing a cluster on Oracle Edge Cloud by using the Agent-based Installer
606+
File: installing-c3-agent-based-installer
605607
- Name: Installing on VMware vSphere
606608
Dir: installing_vsphere
607609
Distros: openshift-origin,openshift-enterprise

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

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,17 @@
11
:_mod-docs-content-type: ASSEMBLY
22
include::_attributes/common-attributes.adoc[]
33
[id="installing-oci-agent-based-installer"]
4-
= Installing a cluster on {oci-first-no-rt} by using the Agent-based Installer
4+
= Installing a cluster on {oci-distributed-no-rt} by using the Agent-based Installer
55
:context: installing-oci-agent-based-installer
66

77
toc::[]
88

9-
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.
9+
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.
1010

11-
Installing a cluster on {oci} is supported for virtual machines (VMs) and bare-metal machines.
11+
Installing a cluster on {oci-distributed-no-rt} is supported for virtual machines (VMs) and bare-metal machines.
1212

13-
[NOTE]
14-
====
15-
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}.
16-
====
13+
// Supported Oracle Distributed Cloud Infrastructures
14+
include::modules/installing-oci-distributed-infra-support.adoc[leveloffset=+1]
1715

1816
// The Agent-based Installer and OCI overview
1917
include::modules/installing-oci-about-agent-based-installer.adoc[leveloffset=+1]
@@ -26,23 +24,23 @@ include::modules/installing-oci-about-agent-based-installer.adoc[leveloffset=+1]
2624
* 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]
2725
* link:https://docs.oracle.com/en-us/iaas/Content/Compute/Concepts/computeoverview.htm[Overview of the Compute Service (Oracle documentation)]
2826
* link:https://docs.oracle.com/en-us/iaas/Content/Block/Concepts/blockvolumeperformance.htm#vpus[Volume Performance Units (Oracle documentation)]
29-
* 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)]
27+
* 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)]
3028
3129
[id="abi-oci-process-checklist_{context}"]
3230
== Installation process workflow
3331

34-
The following workflow describes a high-level outline for the process of installing an {product-title} cluster on {oci} using the Agent-based Installer:
32+
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:
3533

36-
. Create {oci} resources and services (Oracle).
34+
. Create {oci-first-no-rt} resources and services (Oracle).
3735
. Disconnected environments: Prepare a web server that is accessible by {oci} instances (Red{nbsp}Hat).
3836
. Prepare configuration files for the Agent-based Installer (Red{nbsp}Hat).
3937
. Generate the agent ISO image (Red{nbsp}Hat).
4038
. Disconnected environments: Upload the rootfs image to the web server (Red{nbsp}Hat).
4139
. Configure your firewall for {product-title} (Red{nbsp}Hat).
4240
. Upload the agent ISO image to a storage bucket (Oracle).
4341
. Create a custom image from the uploaded agent ISO image (Oracle).
44-
. Create compute instances on {oci} (Oracle).
45-
. Verify that your cluster runs on {oci} (Oracle).
42+
. Create compute instances on {oci-distributed-no-rt} (Oracle).
43+
. Verify that your cluster runs on {oci-distributed-no-rt} (Oracle).
4644

4745
// Creating OCI infrastructure resources and services
4846
include::modules/abi-oci-resources-services.adoc[leveloffset=+1]
@@ -76,7 +74,7 @@ include::modules/running-cluster-oci-agent-based.adoc[leveloffset=+1]
7674
.Additional resources
7775

7876
* 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]
79-
* 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)]
77+
* 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)]
8078
* link:https://docs.oracle.com/iaas/Content/openshift-on-oci/openshift-troubleshooting.htm[Troubleshooting {product-title} on {oci} (Oracle documentation)]
8179

8280
// Verifying that your Agent-based cluster installation runs on {oci}

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

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,19 @@
11
:_mod-docs-content-type: ASSEMBLY
22
include::_attributes/common-attributes.adoc[]
33
[id="installing-oci-assisted-installer"]
4-
= Installing a cluster on {oci-first-no-rt} by using the {ai-full}
4+
= Installing a cluster on {oci-distributed-no-rt} by using the {ai-full}
55
:context: installing-oci-assisted-installer
66

77
toc::[]
88

9-
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.
9+
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.
1010

11-
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].
11+
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].
1212

13-
[NOTE]
14-
====
15-
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}.
16-
====
13+
// Supported Oracle Distributed Cloud Infrastructures
14+
include::modules/installing-oci-distributed-infra-support.adoc[leveloffset=+1]
1715

18-
// The Assisted Installer and OCI overview
16+
// The Assisted Installer and Oracle Distributed Cloud overview
1917
include::modules/installing-oci-about-assisted-installer.adoc[leveloffset=+1]
2018

2119
[role="_additional-resources"]
@@ -30,13 +28,13 @@ include::modules/creating-oci-resources-services.adoc[leveloffset=+1]
3028

3129
// Using the Assisted Installer to generate an OCI-compatible discovery ISO image
3230
[id="using-assisted-installer-oci-agent-iso_{context}"]
33-
== Using the {ai-full} to generate an {oci}-compatible discovery ISO image
31+
== Using the {ai-full} to generate a discovery ISO image
3432

3533
Create the cluster configuration and generate the discovery ISO image in the {ai-full} web console.
3634

3735
.Prerequisites
3836

39-
* You created a child compartment and an object storage bucket on {oci}. For details, see _Preparing the {oci} environment_.
37+
* 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_.
4038
* You reviewed details about the {product-title} installation and update processes.
4139

4240
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]
5755
[id="completing-assisted-installer-oci_{context}"]
5856
== Completing the remaining {ai-full} steps
5957

60-
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.
58+
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.
6159

6260
include::modules/complete-assisted-installer-oci-node-roles.adoc[leveloffset=+2]
6361

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

Lines changed: 0 additions & 64 deletions
This file was deleted.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
../../_attributes/
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
../../images/

installing/installing_oci/installing-c3-agent-based-installer.adoc renamed to installing/installing_oci_edge/installing-c3-agent-based-installer.adoc

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,33 @@
11
:_mod-docs-content-type: ASSEMBLY
22
include::_attributes/common-attributes.adoc[]
33
[id="installing-c3-agent-based-installer"]
4-
= Installing a cluster on {oci-c3-no-rt} by using the Agent-based Installer
4+
= Installing a cluster on {oci-edge-no-rt} by using the Agent-based Installer
55
:context: installing-c3-agent-based-installer
66

77
toc::[]
88

9-
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.
9+
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.
10+
11+
The following procedures describe a cluster installation on {oci-c3} as an example.
12+
13+
// Supported Oracle Edge Cloud Infrastructures
14+
include::modules/installing-oci-edge-infra-support.adoc[leveloffset=+1]
1015

1116
[id="abi-oci-c3-process-checklist_{context}"]
1217
== Installation process workflow
1318

14-
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:
19+
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:
1520

16-
. Create {oci-c3-short} resources and services (Oracle).
21+
. Create {oci-first-no-rt} resources and services (Oracle).
1722
. Prepare configuration files for the Agent-based Installer (Red{nbsp}Hat).
1823
. Generate the agent ISO image (Red{nbsp}Hat).
19-
. 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).
20-
. Disconnected environments: Prepare a web server that is accessible by {oci} instances (Red{nbsp}Hat).
24+
. 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).
25+
. Disconnected environments: Prepare a web server that is accessible by {oci-edge-no-rt} instances (Red{nbsp}Hat).
2126
. Disconnected environments: Upload the rootfs image to the web server (Red{nbsp}Hat).
2227
. Configure your firewall for {product-title} (Red{nbsp}Hat).
2328
. Create control plane nodes and configure load balancers (Oracle).
2429
. Create compute nodes and configure load balancers (Oracle).
25-
. Verify that your cluster runs on {oci} (Oracle).
30+
. Verify that your cluster runs on {oci-edge-no-rt} (Oracle).
2631

2732
// Creating Compute Cloud@Customer infrastructure resources and services
2833
include::modules/abi-c3-resources-services.adoc[leveloffset=+1]

0 commit comments

Comments
 (0)