Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions cloud_service/acscs-default-requirements.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.AssemblyContents: Content other than additional resources cannot follow include directives.


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"]
Expand Down
53 changes: 1 addition & 52 deletions modules/acs-cloud-requirements.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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].
Before you can install {product-title-managed}, your system must meet several requirements.
19 changes: 19 additions & 0 deletions modules/acscs-helm-requirements.adoc
Original file line number Diff line number Diff line change
@@ -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".
52 changes: 52 additions & 0 deletions modules/acscs-system-requirements.adoc
Original file line number Diff line number Diff line change
@@ -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}.
====