Self Hosted installation over OpenShift - prerequisites¶

Before proceeding with this document, please review the installation types documentation to understand the difference between air-gapped and connected installations.

Run:ai components¶

As part of the installation process you will install:

• A control-plane managing cluster
• One or more clusters

Both the control plane and clusters require Kubernetes. Typically the control plane and first cluster are installed on the same Kubernetes cluster but this is not a must.

Installer machine¶

The machine running the installation script (typically the Kubernetes master) must have:

• At least 50GB of free space.
• Docker installed.

Helm¶

Run:ai requires Helm 3.14 or later. To install Helm, see Installing Helm. If you are installing an air-gapped version of Run:ai, The Run:ai tar file contains the helm binary.

Cluster hardware requirements¶

See Cluster prerequisites hardware requirements.

Run:ai software requirements¶

Operating System¶

OpenShift has specific operating system requirements that can be found in the RedHat documentation.

OpenShift¶

Run:ai supports OpenShift. OpenShift Versions supported are detailed here.

• OpenShift must be configured with a trusted certificate. Run:ai installation relies on OpenShift to create certificates for subdomains.
• OpenShift must have a configured identity provider (Idp).
• If your network is air-gapped, you will need to provide the Run:ai control-plane and cluster with information about the local certificate authority.

Install prerequisites¶

NVIDIA GPU Operator¶

See Run:ai Cluster prerequisites installing NVIDIA dependencies in OpenShift.

The Run:ai control plane, when installed without a Run:ai cluster, does not require the NVIDIA prerequisites.

Information on how to download the GPU Operator for air-gapped installation can be found in the NVIDIA GPU Operator pre-requisites.

Inference (optional)¶

See Run:ai Cluster prerequisites Inference requirements.

The Run:ai control plane, when installed without a Run:ai cluster, does not require the Inference prerequisites.

Next steps¶

Continue to Preparing for a Run:ai OpenShift Installation .