Install control plane

Note

This section applies to self-hosted installation only.

System and network requirements

Before installing the NVIDIA Run:ai control plane, validate that the system requirements and network requirements are met. For air-gapped environments, make sure you have the software artifacts prepared.

Permissions

As part of the installation, you will be required to install the NVIDIA Run:ai control plane Helm chart. The Helm charts require Kubernetes administrator permissions. You can review the exact objects that are created by the charts using the --dry-run on both helm charts.

Installation

Kubernetes

Connected

Run the following command. Replace global.domain=<DOMAIN> with the one obtained here:

helm repo add runai-backend https://runai.jfrog.io/artifactory/cp-charts-prod
helm repo update
helm upgrade -i runai-backend -n runai-backend runai-backend/control-plane \ 
    --set global.domain=<DOMAIN>

Note: To install a specific version, add --version <VERSION> to the install command. You can find available versions by running helm search repo -l runai-backend.

Note: Use the --dry-run flag to gain an understanding of what is being installed before the actual installation.

Air-gapped

To run the following command, make sure to replace the following. The custom-env.yaml is created when preparing the installation script:

1. control-plane-<VERSION>.tgz - The NVIDIA Run:ai control plane version

2. global.domain=<DOMAIN> - The domain name set here

3. global.customCA.enabled=true as described here

helm upgrade -i runai-backend control-plane-<VERSION>.tgz \
    --set global.domain=<DOMAIN> \ 
    --set global.customCA.enabled=true \ 
    -n runai-backend -f custom-env.yaml

Note: Use the --dry-run flag to gain an understanding of what is being installed before the actual installation.

OpenShift

Connected

Run the following command. The <OPENSHIFT-CLUSTER-DOMAIN> is the subdomain configured for the OpenShift cluster:

helm repo add runai-backend https://runai.jfrog.io/artifactory/cp-charts-prod
helm repo update
helm upgrade -i runai-backend -n runai-backend runai-backend/control-plane \
    --set global.domain=runai.apps.<OPENSHIFT-CLUSTER-DOMAIN> \ 
    --set global.config.kubernetesDistribution=openshift

Note: To install a specific version, add --version <VERSION> to the install command. You can find available versions by running helm search repo -l runai-backend.

Air-gapped

To run the following command, make sure to replace the following. The custom-env.yaml is created when preparing the installation script:

1. control-plane-<VERSION>.tgz - The NVIDIA Run:ai control plane version

2. <OPENSHIFT-CLUSTER-DOMAIN> - The domain configured for the OpenShift cluster. To find out the OpenShift cluster domain, run oc get routes -A

3. global.customCA.enabled=true as described here

helm upgrade -i runai-backend ./control-plane-<VERSION>.tgz -n runai-backend \
    --set global.domain=runai.apps.<OPENSHIFT-CLUSTER-DOMAIN> \ 
    --set global.config.kubernetesDistribution=openshift \
    --set global.customCA.enabled=true \ 
    -f custom-env.yaml 

Note

To customize the installation based on your environment, see Customized installation.

Connect to NVIDIA Run:ai user interface

1. Open your browser and go to:

Kubernetes

https://<DOMAIN>

OpenShift

https://runai.apps.<OpenShift-DOMAIN>

1. Log in using the default credentials:

   • User: [email protected]

   • Password: Abcd!234

You will be prompted to change the password.