diff --git a/installing/installing_aws/preparing-to-install-on-aws.adoc b/installing/installing_aws/preparing-to-install-on-aws.adoc index 5d69399034..f3098e4bef 100644 --- a/installing/installing_aws/preparing-to-install-on-aws.adoc +++ b/installing/installing_aws/preparing-to-install-on-aws.adoc @@ -29,7 +29,7 @@ See xref:../../architecture/architecture-installation.adoc#installation-process_ [id="choosing-an-method-to-install-ocp-on-aws-single-node"] === Installing a cluster on a single node -Installing {product-title} on a single node alleviates some of the requirements for high availability and large scale clusters. However, you must address the xref:../../installing/installing_sno/install-sno-preparing-to-install-sno.adoc#install-sno-requirements-for-installing-on-a-single-node_install-sno-preparing[requirements for installing on a single node], and the xref:../../installing/installing_sno/install-sno-installing-sno.adoc#additional-requirements-for-installing-on-a-single-node-on-aws_install-sno-installing-sno-with-the-assisted-installer[additional requirements for installing on a single node on AWS]. After addressing the requirements for single node installation, use the xref:../../installing/installing_aws/installing-aws-customizations.adoc#installing-aws-customizations[Installing a customized cluster on AWS] procedure to install the cluster. The xref:../../installing/installing_sno/install-sno-installing-sno.adoc#install-sno-installing-sno-manually[installing single-node OpenShift manually] section contains an exemplary `install-config.yaml` file when installing an {product-title} cluster on a single node. +Installing {product-title} on a single node alleviates some of the requirements for high availability and large scale clusters. However, you must address the xref:../../installing/installing_sno/install-sno-preparing-to-install-sno.adoc#install-sno-requirements-for-installing-on-a-single-node_install-sno-preparing[requirements for installing on a single node], and the xref:../../installing/installing_sno/install-sno-installing-sno.adoc#additional-requirements-for-installing-sno-on-a-cloud-provider_install-sno-installing-sno-with-the-assisted-installer[additional requirements for installing {sno} on a cloud provider]. After addressing the requirements for single node installation, use the xref:../../installing/installing_aws/installing-aws-customizations.adoc#installing-aws-customizations[Installing a customized cluster on AWS] procedure to install the cluster. The xref:../../installing/installing_sno/install-sno-installing-sno.adoc#install-sno-installing-sno-manually[installing single-node OpenShift manually] section contains an exemplary `install-config.yaml` file when installing an {product-title} cluster on a single node. [id="choosing-an-method-to-install-ocp-on-aws-installer-provisioned"] === Installing a cluster on installer-provisioned infrastructure diff --git a/installing/installing_sno/install-sno-installing-sno.adoc b/installing/installing_sno/install-sno-installing-sno.adoc index e200ac0f47..d1e3c3aec1 100644 --- a/installing/installing_sno/install-sno-installing-sno.adoc +++ b/installing/installing_sno/install-sno-installing-sno.adoc @@ -60,9 +60,12 @@ include::modules/install-sno-monitoring-the-installation-manually.adoc[leveloffs * xref:../../nodes/nodes/nodes-sno-worker-nodes.adoc#nodes-sno-worker-nodes[Adding worker nodes to {sno} clusters] -== Installing {sno} on AWS +[id="install-sno-installing-sno-on-cloud-providers"] +== Installing {sno} on cloud providers -include::modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-aws.adoc[leveloffset=+2] +include::modules/install-sno-additional-requirements-for-installing-sno-on-a-cloud-provider.adoc[leveloffset=+2] + +include::modules/install-sno-supported-cloud-providers-for-single-node-openshift.adoc[leveloffset=+2] include::modules/installation-aws_con_installing-sno-on-aws.adoc[leveloffset=+2] @@ -71,12 +74,30 @@ include::modules/installation-aws_con_installing-sno-on-aws.adoc[leveloffset=+2] * xref:../../installing/installing_aws/installing-aws-customizations.adoc#installing-aws-customizations[Installing a cluster on AWS with customizations] + +include::modules/install-sno-installing-sno-on-azure.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* xref:../../installing/installing_azure/installing-azure-customizations.adoc#installing-azure-customizations[Installing a cluster on Azure with customizations] + + +include::modules/install-sno-installing-sno-on-gcp.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* xref:../../installing/installing_gcp/installing-gcp-customizations.adoc#installing-gcp-customizations[Installing a cluster on GCP with customizations] + + include::modules/install-sno-installing-with-usb-media.adoc[leveloffset=+1] include::modules/install-booting-from-an-iso-over-http-redfish.adoc[leveloffset=+1] include::modules/creating-custom-live-rhcos-iso.adoc[leveloffset=+1] +[id="install-sno-with-ibmz"] == Installing {sno} with {ibmzProductName} and {linuxoneProductName} Installing a single-node cluster on {ibmzProductName} and {linuxoneProductName} requires user-provisioned installation using either the "Installing a cluster with {op-system-base} KVM on {ibmzProductName} and {linuxoneProductName}" or the "Installing a cluster with z/VM on {ibmzProductName} and {linuxoneProductName}" procedure. diff --git a/modules/install-sno-additional-requirements-for-installing-sno-on-a-cloud-provider.adoc b/modules/install-sno-additional-requirements-for-installing-sno-on-a-cloud-provider.adoc new file mode 100644 index 0000000000..2d55ce73e0 --- /dev/null +++ b/modules/install-sno-additional-requirements-for-installing-sno-on-a-cloud-provider.adoc @@ -0,0 +1,18 @@ +// This module is included in the following assemblies: +// +// installing/installing_sno/install-sno-preparing-to-install-sno.adoc + +:_content-type: CONCEPT +[id="additional-requirements-for-installing-sno-on-a-cloud-provider_{context}"] += Additional requirements for installing {sno} on a cloud provider + +The documentation for installer-provisioned installation on cloud providers is based on a high availability cluster consisting of three control plane nodes. When referring to the documentation, consider the differences between the requirements for a {sno} cluster and a high availability cluster. + +* A high availability cluster requires a temporary bootstrap machine, three control plane machines, and at least two compute machines. For a {sno} cluster, you need only a temporary bootstrap machine and one cloud instance for the control plane node and no worker nodes. + +* The minimum resource requirements for high availability cluster installation include a control plane node with 4 vCPUs and 100GB of storage. For a {sno} cluster, you must have a minimum of 8 vCPU cores and 120GB of storage. + +* The `controlPlane.replicas` setting in the `install-config.yaml` file should be set to `1`. + +* The `compute.replicas` setting in the `install-config.yaml` file should be set to `0`. +This makes the control plane node schedulable. diff --git a/modules/install-sno-installing-sno-on-azure.adoc b/modules/install-sno-installing-sno-on-azure.adoc new file mode 100644 index 0000000000..dcd2879196 --- /dev/null +++ b/modules/install-sno-installing-sno-on-azure.adoc @@ -0,0 +1,9 @@ +// This module is included in the following assemblies: +// +// installing/installing_sno/install-sno-installing-sno.adoc + +:_content-type: CONCEPT +[id="installing-sno-on-azure_{context}"] += Installing {sno} on Azure + +Installing a single node cluster on Azure requires installer-provisioned installation using the "Installing a cluster on Azure with customizations" procedure. \ No newline at end of file diff --git a/modules/install-sno-installing-sno-on-gcp.adoc b/modules/install-sno-installing-sno-on-gcp.adoc new file mode 100644 index 0000000000..9a2086de67 --- /dev/null +++ b/modules/install-sno-installing-sno-on-gcp.adoc @@ -0,0 +1,9 @@ +// This module is included in the following assemblies: +// +// installing/installing_sno/install-sno-installing-sno.adoc + +:_content-type: CONCEPT +[id="installing-sno-on-gcp_{context}"] += Installing {sno} on GCP + +Installing a single node cluster on GCP requires installer-provisioned installation using the "Installing a cluster on GCP with customizations" procedure. diff --git a/modules/install-sno-supported-cloud-providers-for-single-node-openshift.adoc b/modules/install-sno-supported-cloud-providers-for-single-node-openshift.adoc new file mode 100644 index 0000000000..6da9aab405 --- /dev/null +++ b/modules/install-sno-supported-cloud-providers-for-single-node-openshift.adoc @@ -0,0 +1,18 @@ +// This module is included in the following assemblies: +// +// installing/installing_sno/install-sno-installing-sno.adoc + +:_content-type: REFERENCE +[id="supported-cloud-providers-for-single-node-openshift_{context}"] += Supported cloud providers for {sno} + +The following table contains a list of supported cloud providers and CPU architectures. + +.Supported cloud providers +[options="header"] +|==== +|Cloud provider |CPU architecture +|Amazon Web Service (AWS)|x86_64 and AArch64 +|Microsoft Azure|x86_64 +|Google Cloud Platform (GCP) | x86_64 and AArch64 +|==== diff --git a/modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-aws.adoc b/modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-a-cloud-provider.adoc similarity index 89% rename from modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-aws.adoc rename to modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-a-cloud-provider.adoc index 69b6038d43..84c8693eb5 100644 --- a/modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-aws.adoc +++ b/modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-a-cloud-provider.adoc @@ -3,8 +3,8 @@ // installing/installing_sno/install-sno-preparing-to-install-sno.adoc :_content-type: CONCEPT -[id="additional-requirements-for-installing-on-a-single-node-on-aws_{context}"] -= Additional requirements for installing on a single node on AWS +[id="additional-requirements-for-installing-sno-on-a-cloud-provider_{context}"] += Additional requirements for installing {sno} on a cloud provider The AWS documentation for installer-provisioned installation is written with a high availability cluster consisting of three control plane nodes. When referring to the AWS documentation, consider the differences between the requirements for a {sno} cluster and a high availability cluster.