diff --git a/modules/installation/proc-install-operator.adoc b/modules/installation/proc-install-operator.adoc index 02c0e58f1b..250734340e 100644 --- a/modules/installation/proc-install-operator.adoc +++ b/modules/installation/proc-install-operator.adoc @@ -14,8 +14,9 @@ Containers are available for the following CPU architectures: .Prerequisites * You are logged in as an administrator on the {ocp-short} web console. -* You have configured the appropriate roles and permissions within your project to create or access an application. For more information, see the link:https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single/building_applications/index#building-applications-overview[{ocp-brand-name} documentation on Building applications]. -* You have installed {ocp-brand-name} 4.17 or later. +* You have configured the appropriate roles and permissions within your project to create or access an application. For more information, see the {ocp-docs-link}/html-single/building_applications/index#building-applications-overview[{ocp-brand-name} documentation on Building applications]. +* You have installed {ocp-brand-name} {ocp-version-min} to {ocp-version}. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure diff --git a/modules/installation/proc-install-rhdh-helm-airgapped-full.adoc b/modules/installation/proc-install-rhdh-helm-airgapped-full.adoc index 5ad3a6b9b5..184a650742 100644 --- a/modules/installation/proc-install-rhdh-helm-airgapped-full.adoc +++ b/modules/installation/proc-install-rhdh-helm-airgapped-full.adoc @@ -16,6 +16,7 @@ If your network has access to the registry through a bastion host, you can use t ** You have installed the oc-mirror {openshift-cli} plugin, for more information see https://docs.openshift.com/container-platform/4.17/disconnected/mirroring/installing-mirroring-disconnected.html#installation-oc-mirror-installing-plugin_installing-mirroring-disconnected[Installing the oc-mirror OpenShift CLI plugin]. ** You have installed {ocp-brand-name} {ocp-version-min} or later. ** You have installed the {openshift-cli} on your workstation. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure . Create an `ImageSetConfiguration` file to specify the resources that you want to mirror. For example: diff --git a/modules/installation/proc-install-rhdh-helm-airgapped-partial.adoc b/modules/installation/proc-install-rhdh-helm-airgapped-partial.adoc index f6d75e2634..553a307161 100644 --- a/modules/installation/proc-install-rhdh-helm-airgapped-partial.adoc +++ b/modules/installation/proc-install-rhdh-helm-airgapped-partial.adoc @@ -13,6 +13,7 @@ If your network has access to the `registry.redhat.io` registry and the `charts. * You have installed the {openshift-cli} on your workstation. * You have installed the oc-mirror {openshift-cli} plugin, for more information see https://docs.openshift.com/container-platform/4.17/disconnected/mirroring/installing-mirroring-disconnected.html#installation-oc-mirror-installing-plugin_installing-mirroring-disconnected[Installing the oc-mirror OpenShift CLI plugin]. * You have an account in https://developers.redhat.com/[{rhdeveloper-name}] portal. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure . Log in to your {ocp-short} account using the {openshift-cli} by running the following command: diff --git a/modules/installation/proc-install-rhdh-ocp-helm-gui.adoc b/modules/installation/proc-install-rhdh-ocp-helm-gui.adoc index 5bf3c684dc..9ad1fe1115 100644 --- a/modules/installation/proc-install-rhdh-ocp-helm-gui.adoc +++ b/modules/installation/proc-install-rhdh-ocp-helm-gui.adoc @@ -18,8 +18,9 @@ The {product} Helm chart is available in the Helm catalog on {osd-short} and {oc .Prerequisites * You are logged in to your {ocp-short} account. -* A user with the {ocp-short} `admin` role has configured the appropriate roles and permissions within your project to create an application. For more information about {ocp-short} roles, see link:https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single/authentication_and_authorization/index#authorization-overview_using-rbac[Using RBAC to define and apply permissions]. -* You have created a project in {ocp-short}. For more information about creating a project in {ocp-short}, see link:https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single/building_applications/index#working-with-projects[{ocp-brand-name} documentation]. +* A user with the {ocp-short} `admin` role has configured the appropriate roles and permissions within your project to create an application. For more information about {ocp-short} roles, see {ocp-docs-link}/html-single/authentication_and_authorization/index#authorization-overview_using-rbac[Using RBAC to define and apply permissions]. +* You have created a project in {ocp-short}. For more information about creating a project in {ocp-short}, see {ocp-docs-link}/html-single/building_applications/index#working-with-projects[{ocp-brand-name} documentation]. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure diff --git a/modules/installation/proc-install-rhdh-operator-airgapped-full.adoc b/modules/installation/proc-install-rhdh-operator-airgapped-full.adoc index aacb27585d..ba57af7f35 100644 --- a/modules/installation/proc-install-rhdh-operator-airgapped-full.adoc +++ b/modules/installation/proc-install-rhdh-operator-airgapped-full.adoc @@ -13,8 +13,9 @@ If your network has access to the registry through a bastion host, you can use t * You have installed `yq` 4.44 or later. * You have installed the GNU `sed` command line text editor. * You have installed `umoci` CLI tool. -* You have an active `oc registry`, `podman`, or `skopeo` session to the `registry.redhat.io` {company-name} Ecosystem Catalog. For more information, see link:https://access.redhat.com/RegistryAuthentication[{company-name} Container Registry Authentication]. -* You have installed the `opm` CLI tool. For more information, see link:https://docs.redhat.com/en/documentation/openshift_container_platform/4.17/html/cli_tools/opm-cli#olm-about-opm_cli-opm-install[Installing the opm CLI]. +* You have an active `oc registry`, `podman`, or `skopeo` session to the `registry.redhat.io` {company-name} Ecosystem Catalog. For more information, see link:link:https://access.redhat.com/articles/RegistryAuthentication[{company-name} Container Registry Authentication]. +* You have installed the `opm` CLI tool. For more information, see {ocp-docs-link}/html/cli_tools/opm-cli#olm-about-opm_cli-opm-install[Installing the opm CLI]. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure . Download the mirroring script to disk by running the following command: diff --git a/modules/installation/proc-install-rhdh-operator-airgapped-partial.adoc b/modules/installation/proc-install-rhdh-operator-airgapped-partial.adoc index 725af137f8..7afdaeb4eb 100644 --- a/modules/installation/proc-install-rhdh-operator-airgapped-partial.adoc +++ b/modules/installation/proc-install-rhdh-operator-airgapped-partial.adoc @@ -27,6 +27,7 @@ When connected to a {ocp-short} cluster, the helper script detects it and automa * If you are using a supported Kubernetes cluster, you have the following prerequisites: ** You have installed the Operator Lifecycle Manager (OLM) on the disconnected cluster. ** You have a mirror registry that is reachable from the disconnected cluster. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure . In your terminal, navigate to the directory where you want to save the mirroring script. diff --git a/modules/installation/proc-install-rhdh-osd-gcp-helm.adoc b/modules/installation/proc-install-rhdh-osd-gcp-helm.adoc index ebddb9701c..f8bc12476f 100644 --- a/modules/installation/proc-install-rhdh-osd-gcp-helm.adoc +++ b/modules/installation/proc-install-rhdh-osd-gcp-helm.adoc @@ -10,6 +10,7 @@ You can install {product-short} on {osd-short} on {gcp-short} using the {product * You have a valid {gcp-short} account. * Your {osd-short} cluster is running on {gcp-short}. For more information, see link:https://docs.redhat.com/en/documentation/openshift_dedicated/4/html/installing_accessing_and_deleting_openshift_dedicated_clusters/osd-creating-a-cluster-on-gcp[Creating a cluster on GCP] in {osd-brand-name} documentation. * You have installed Helm 3 or the latest. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure . From the *Developer* perspective on the {product-short} web console, click *+Add*. diff --git a/modules/installation/proc-install-rhdh-osd-gcp-operator.adoc b/modules/installation/proc-install-rhdh-osd-gcp-operator.adoc index 0f3e392f99..9b9ae8d824 100644 --- a/modules/installation/proc-install-rhdh-osd-gcp-operator.adoc +++ b/modules/installation/proc-install-rhdh-osd-gcp-operator.adoc @@ -10,6 +10,7 @@ You can install {product-short} on {osd-short} on {gcp-short} using the {product * You have a valid {gcp-short} account. * Your {osd-short} cluster is running on {gcp-short}. For more information, see link:https://docs.redhat.com/en/documentation/openshift_dedicated/4/html/installing_accessing_and_deleting_openshift_dedicated_clusters/osd-creating-a-cluster-on-gcp[Creating a cluster on GCP] in {osd-brand-name} documentation. * You have administrator access to {osd-short} cluster and {gcp-short} project. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure diff --git a/modules/installation/proc-rhdh-deploy-aks-helm.adoc b/modules/installation/proc-rhdh-deploy-aks-helm.adoc index 7118e0a636..35a7544897 100644 --- a/modules/installation/proc-rhdh-deploy-aks-helm.adoc +++ b/modules/installation/proc-rhdh-deploy-aks-helm.adoc @@ -13,6 +13,7 @@ You can deploy your {product-short} application on {aks-name} ({aks-short}) to a * You have installed the link:https://kubernetes.io/docs/reference/kubectl/[`kubectl` CLI]. * You are logged into your cluster using `kubectl`, and have `developer` or `admin` permissions. * You have installed Helm 3 or the latest. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Comparison of {aks-short} specifics with the base {product-short} deployment diff --git a/modules/installation/proc-rhdh-deploy-eks-helm.adoc b/modules/installation/proc-rhdh-deploy-eks-helm.adoc index c6aff3342e..c5da874d51 100644 --- a/modules/installation/proc-rhdh-deploy-eks-helm.adoc +++ b/modules/installation/proc-rhdh-deploy-eks-helm.adoc @@ -15,6 +15,7 @@ When you install the {product-short} Helm chart in {eks-name} ({eks-short}), it * You have set the context to the {eks-short} cluster in your current `kubeconfig`. For more information, see https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html[Creating or updating a kubeconfig file for an Amazon {eks-short} cluster]. * You have installed `kubectl`. For more information, see https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html[Installing or updating kubectl]. * You have installed Helm 3 or the latest. For more information, see https://docs.aws.amazon.com/eks/latest/userguide/helm.html[Using Helm with Amazon {eks-short}]. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure diff --git a/modules/installation/proc-rhdh-deploy-eks-operator.adoc b/modules/installation/proc-rhdh-deploy-eks-operator.adoc index 55faec2668..002df7e626 100644 --- a/modules/installation/proc-rhdh-deploy-eks-operator.adoc +++ b/modules/installation/proc-rhdh-deploy-eks-operator.adoc @@ -13,6 +13,7 @@ You can install the {product-short} Operator on {eks-short} using the https://ol * You have installed `kubectl`. For more information, see https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html[Installing or updating kubectl]. * You have subscribed to `registry.redhat.io`. For more information, see https://access.redhat.com/RegistryAuthentication[{company-name} Container Registry Authentication]. * You have installed the Operator Lifecycle Manager (OLM). For more information about installation and troubleshooting, see https://olm.operatorframework.io/docs/getting-started/[OLM QuickStart] or https://operatorhub.io/how-to-install-an-operator#How-do-I-get-Operator-Lifecycle-Manager?[How do I get Operator Lifecycle Manager?] +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. .Procedure diff --git a/modules/installation/proc-rhdh-deploy-gke-helm.adoc b/modules/installation/proc-rhdh-deploy-gke-helm.adoc index 55f56d4207..2be182a7cd 100644 --- a/modules/installation/proc-rhdh-deploy-gke-helm.adoc +++ b/modules/installation/proc-rhdh-deploy-gke-helm.adoc @@ -8,11 +8,10 @@ When you install the {product-short} Helm chart in {gke-brand-name} ({gke-short} * You have installed `kubectl`. For more information, see https://kubernetes.io/docs/tasks/tools/#kubectl[Install kubetl]. * You have installed the Google Cloud CLI. For more information, see https://cloud.google.com/sdk/docs/install[Install the gcloud CLI]. * You have logged in to your Google account and created a https://cloud.google.com/kubernetes-engine/docs/how-to/creating-an-autopilot-cluster[GKE Autopilot] or https://cloud.google.com/kubernetes-engine/docs/how-to/creating-a-zonal-cluster[GKE Standard] cluster. - - * You have configured a domain name for your {product-short} instance. * You have reserved a static external Premium IPv4 Global IP address that is not attached to any VM. For more information see https://cloud.google.com/vpc/docs/reserve-static-external-ip-address#reserve_new_static[Reserve a new static external IP address] -* You have configured the DNS records for your domain name to point to the IP address that has been reserved. +* You have configured the DNS records for your domain name to point to the IP address that has been reserved. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. + [NOTE] ==== diff --git a/modules/installation/proc-rhdh-deploy-gke-operator.adoc b/modules/installation/proc-rhdh-deploy-gke-operator.adoc index 3500187076..7ca29c6383 100644 --- a/modules/installation/proc-rhdh-deploy-gke-operator.adoc +++ b/modules/installation/proc-rhdh-deploy-gke-operator.adoc @@ -16,6 +16,8 @@ For information about the OLM, see link:https://olm.operatorframework.io/docs/[O * You have logged in to your Google account and created a https://cloud.google.com/kubernetes-engine/docs/how-to/creating-an-autopilot-cluster[GKE Autopilot] or https://cloud.google.com/kubernetes-engine/docs/how-to/creating-a-zonal-cluster[GKE Standard] cluster. +* Make sure that your system meets the minimum sizing requirements. See link:{about-book-url}#rhdh-sizing_about-rhdh[Sizing requirements for {product}]. + .Procedure . Connect to your GKE cluster using the following command: +