diff --git a/cloud_service/acscs-default-requirements.adoc b/cloud_service/acscs-default-requirements.adoc index 3d30d803828a..a3f5e15a6289 100644 --- a/cloud_service/acscs-default-requirements.adoc +++ b/cloud_service/acscs-default-requirements.adoc @@ -4,10 +4,25 @@ include::modules/common-attributes.adoc[] :context: acscs-default-requirements +[role="_abstract"] +This document describes the default CPU, memory, and storage requirements for {product-title-managed} components. + toc::[] +//General requirements for RHACS Cloud Service include::modules/acs-cloud-requirements.adoc[leveloffset=+1] +include::modules/acscs-system-requirements.adoc[leveloffset=+2] + +include::modules/acscs-helm-requirements.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* link:https://access.redhat.com/articles/7045053[{product-title} Support Matrix] +* link:https://access.redhat.com/RegistryAuthentication[Red{nbsp}Hat Container Registry Authentication] + +//Secured cluster services include::modules/default-requirements-secured-cluster-services.adoc[leveloffset=+1] [role="_additional-resources"] diff --git a/modules/acs-cloud-requirements.adoc b/modules/acs-cloud-requirements.adoc index 4dc52fa6c633..03fa25552e4c 100644 --- a/modules/acs-cloud-requirements.adoc +++ b/modules/acs-cloud-requirements.adoc @@ -6,55 +6,4 @@ = General requirements for RHACS Cloud Service [role="_abstract"] -Before you can install {product-title-managed}, your system must meet several requirements. - -[WARNING] -==== -You must not install {product-title-managed-short} on: - -* Amazon Elastic File System (Amazon EFS). Use the Amazon Elastic Block Store (Amazon EBS) with the default *gp2* volume type instead. -* Older CPUs that do not have the Streaming SIMD Extensions (SSE) 4.2 instruction set. -For example, Intel processors older than _Sandy Bridge_ and AMD processors older than _Bulldozer_. -These processors were released in 2011. -==== - -To install {product-title-managed-short}, you must have one of the following systems: - -* {ocp} version {ocp-supported-version} or later, and cluster nodes with a supported operating system of {op-system-first} or {op-system-base-full} -* A supported managed Kubernetes platform, and cluster nodes with a supported operating system of Amazon Linux, CentOS, Container-Optimized OS from Google, {op-system-first}, Debian, {op-system-base-full}, or Ubuntu -+ -For information about supported platforms and architecture, see the link:https://access.redhat.com/articles/7045053[{product-title} Support Matrix]. - -The following minimum requirements and suggestions apply to cluster nodes. - -Architecture:: Supported architectures are `amd64`, `ppc64le`, or `s390x`. -+ -[NOTE] -==== -Secured cluster services are supported on {ibm-power} (`ppc64le`), {ibm-z} (`s390x`), and {ibm-linuxone} (`s390x`) clusters. -==== - -Processor:: 3 CPU cores are required. - -Memory:: 6 GiB of RAM is required. -+ -[NOTE] -==== -See the default memory and CPU requirements for each component and ensure that the node size can support them. -==== - -Storage:: For {product-title-managed-short}, a persistent volume claim (PVC) is not required. However, a PVC is strongly recommended if you have secured clusters with Scanner V4 enabled. Use Solid-State Drives (SSDs) for best performance. However, you can use another storage type if you do not have SSDs available. -+ -[IMPORTANT] -==== -You must not use Ceph FS storage with {product-title-managed-short}. Red{nbsp}Hat recommends using RBD block mode PVCs for {product-title-managed-short}. -==== - -If you plan to install {product-title-managed-short} by using Helm charts, you must meet the following requirements: - -* You must have Helm command-line interface (CLI) v3.2 or newer, if you are installing or configuring {product-title-managed-short} using Helm charts. -Use the `helm version` command to verify the version of Helm you have installed. -ifdef::op[] -* You must have the required permissions to configure deployments in the Central cluster. -endif::op[] -* You must have access to the Red{nbsp}Hat Container Registry. For information about downloading images from `registry.redhat.io`, see link:https://access.redhat.com/RegistryAuthentication[Red{nbsp}Hat Container Registry Authentication]. \ No newline at end of file +Before you can install {product-title-managed}, your system must meet several requirements. \ No newline at end of file diff --git a/modules/acscs-helm-requirements.adoc b/modules/acscs-helm-requirements.adoc new file mode 100644 index 000000000000..33151a7e0082 --- /dev/null +++ b/modules/acscs-helm-requirements.adoc @@ -0,0 +1,19 @@ +// Module included in the following assemblies: +// +// * cloud_service/acscs-default-requirements.adoc + +:_mod-docs-content-type: REFERENCE +[id="acscs-helm-requirements_{context}"] += Helm requirements + +[role="_abstract"] +Requirements for installing {product-title-managed-short} using Helm charts. + +If you plan to install {product-title-managed-short} by using Helm charts, you must meet the following requirements: + +* You must have Helm command-line interface (CLI) v3.2 or newer, if you are installing or configuring {product-title-managed-short} using Helm charts. +Use the `helm version` command to verify the version of Helm you have installed. +ifdef::op[] +* You must have the required permissions to configure deployments in the Central cluster. +endif::op[] +* You must have access to the Red{nbsp}Hat Container Registry. For information about downloading images from `registry.redhat.io`, see "Red{nbsp}Hat Container Registry Authentication". diff --git a/modules/acscs-system-requirements.adoc b/modules/acscs-system-requirements.adoc new file mode 100644 index 000000000000..9a15467d1252 --- /dev/null +++ b/modules/acscs-system-requirements.adoc @@ -0,0 +1,52 @@ +// Module included in the following assemblies: +// +// * cloud_service/acscs-default-requirements.adoc + +:_mod-docs-content-type: REFERENCE +[id="acscs-system-requirements_{context}"] += System requirements + +[role="_abstract"] +System, architecture, processor, memory, and storage requirements for installing {product-title-managed-short}. + +[WARNING] +==== +You must not install {product-title-managed-short} on: + +* Amazon Elastic File System (Amazon EFS). Use the Amazon Elastic Block Store (Amazon EBS) with the default *gp2* volume type instead. +* Older CPUs that do not have the Streaming SIMD Extensions (SSE) 4.2 instruction set. +For example, Intel processors older than _Sandy Bridge_ and AMD processors older than _Bulldozer_. +These processor families became available in 2011. +==== + +To install {product-title-managed-short}, you must have one of the following systems: + +* {ocp} version {ocp-supported-version} or later, and cluster nodes with a supported operating system of {op-system-first} or {op-system-base-full} +* A supported managed Kubernetes platform, and cluster nodes with a supported operating system of Amazon Linux, CentOS, Container-Optimized operating system from Google, {op-system-first}, Debian, {op-system-base-full}, or Ubuntu + +For information about supported platforms and architecture, see the "{product-title} Support Matrix". + +The following minimum requirements and suggestions apply to cluster nodes. + +Architecture:: Supported architectures are `amd64`, `ppc64le`, or `s390x`. ++ +[NOTE] +==== +Secured cluster services are supported on {ibm-power} (`ppc64le`), {ibm-z} (`s390x`), and {ibm-linuxone} (`s390x`) clusters. +==== + +Processor:: Requires 3 CPU cores. + +Memory:: Requires 6 GiB of RAM. ++ +[NOTE] +==== +See the default memory and CPU requirements for each component and ensure that the node size can support them. +==== + +Storage:: For {product-title-managed-short}, a persistent volume claim (PVC) is not required. However, a PVC is strongly recommended if you have secured clusters with Scanner V4 enabled. Use Solid-State Drives (SSDs) for best performance. However, you can use another storage type if you do not have SSDs available. ++ +[IMPORTANT] +==== +You must not use Ceph FS storage with {product-title-managed-short}. Red{nbsp}Hat recommends using RBD block mode PVCs for {product-title-managed-short}. +====