Skip to content

Commit d00f597

Browse files
committed
TELCODOCS-1052: Added requirements for installing an SNO cluster on AWS..
1 parent b5c7c1f commit d00f597

5 files changed

+47
-2
lines changed

installing/installing_aws/preparing-to-install-on-aws.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,11 @@ You can install {product-title} on installer-provisioned or user-provisioned inf
2626

2727
See xref:../../architecture/architecture-installation.adoc#installation-process_architecture-installation[Installation process] for more information about installer-provisioned and user-provisioned installation processes.
2828

29+
[id="choosing-an-method-to-install-ocp-on-aws-single-node"]
30+
=== Installing a cluster on a single node
31+
32+
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_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_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_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.
33+
2934
[id="choosing-an-method-to-install-ocp-on-aws-installer-provisioned"]
3035
=== Installing a cluster on installer-provisioned infrastructure
3136

installing/installing_sno/install-sno-installing-sno.adoc

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ include::modules/install-sno-installing-with-the-assisted-installer.adoc[levelof
2929

3030
endif::openshift-origin[]
3131

32+
[id="install-sno-installing-sno-manually"]
3233
== Installing {sno} manually
3334

3435
To install {product-title} on a single node, first generate the installation ISO, and then boot the server from the ISO. You can monitor the installation using the `openshift-install` installation program.
@@ -52,8 +53,19 @@ include::modules/install-sno-monitoring-the-installation-manually.adoc[leveloffs
5253

5354
* xref:../../nodes/nodes/nodes-sno-worker-nodes.adoc#nodes-sno-worker-nodes[Adding worker nodes to {sno} clusters]
5455

56+
== Installing {sno} on AWS
57+
58+
include::modules/install-sno_additional-requirements-for-installing-on-a-single-node-on-aws.adoc[leveloffset=+2]
59+
60+
include::modules/installation-aws_con_installing-sno-on-aws.adoc[leveloffset=+2]
61+
62+
[role="_additional-resources"]
63+
.Additional resources
64+
65+
* xref:../../installing/installing_aws/installing-aws-customizations.adoc#installing-aws-customizations[Installing a cluster on AWS with customizations]
66+
5567
include::modules/install-sno-installing-with-usb-media.adoc[leveloffset=+1]
5668

5769
include::modules/install-booting-from-an-iso-over-http-redfish.adoc[leveloffset=+1]
5870

59-
include::modules/creating-custom-live-rhcos-iso.adoc[leveloffset=+1]
71+
include::modules/creating-custom-live-rhcos-iso.adoc[leveloffset=+1]

modules/install-sno-requirements-for-installing-on-a-single-node.adoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
// This is included in the following assemblies:
22
//
33
// installing_sno/install-sno-preparing-to-install-sno.adoc
4+
:_content-type: CONCEPT
45

56
[id="install-sno-requirements-for-installing-on-a-single-node_{context}"]
67
= Requirements for installing OpenShift on a single node
@@ -11,7 +12,7 @@ Installing {product-title} on a single node alleviates some of the requirements
1112

1213
* *CPU Architecture:* Installing {product-title} on a single node supports `x86_64` and `arm64` CPU architectures.
1314

14-
* *Supported platforms:* Installing {product-title} on a single node is supported on bare metal, vSphere, Red Hat OpenStack, and Red Hat Virtualization platforms. In all cases, you must specify the `platform.none: {}` parameter in the `install-config.yaml` configuration file.
15+
* *Supported platforms:* Installing {product-title} on a single node is supported on bare metal, vSphere, AWS, Red Hat OpenStack, and Red Hat Virtualization platforms. In all cases, you must specify the `platform.none: {}` parameter in the `install-config.yaml` configuration file.
1516

1617
* *Production-grade server:* Installing {product-title} on a single node requires a server with sufficient resources to run {product-title} services and a production workload.
1718
+
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
// This module is included in the following assemblies:
2+
//
3+
// installing/installing_sno/install-sno-preparing-to-install-sno.adoc
4+
5+
:_content-type: CONCEPT
6+
[id="additional-requirements-for-installing-on-a-single-node-on-aws_{context}"]
7+
= Additional requirements for installing on a single node on AWS
8+
9+
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.
10+
11+
* The required machines for cluster installation in AWS documentation indicates a temporary bootstrap machine, three control plane machines, and at least two compute machines. You require only a temporary bootstrap machine and one AWS instance for the control plane node and no worker nodes.
12+
13+
* The minimum resource requirements for cluster installation in the AWS documentation indicates a control plane node with 4 vCPUs and 100GB of storage. For a single node cluster, you must have a minimum of 8 vCPU cores and 120GB of storage.
14+
15+
* The `controlPlane.replicas` setting in the `install-config.yaml` file should be set to `1`.
16+
17+
* The `compute.replicas` setting in the `install-config.yaml` file should be set to `0`.
18+
This makes the control plane node schedulable.
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
// This module is included in the following assemblies:
2+
//
3+
// installing/installing_sno/install-sno-installing-sno.adoc
4+
5+
:_content-type: CONCEPT
6+
[id="installing-sno-on-aws_{context}"]
7+
= Installing {sno} on AWS
8+
9+
Installing a single node cluster on AWS requires installer-provisioned installation using the "Installing a cluster on AWS with customizations" procedure.

0 commit comments

Comments
 (0)