Skip to content

Install the Run:ai Control Plane

Create a Control Plane Configuration

Note

The control-plane installation on OpenShift assumes that an identity provider has been configured in OpenShift.

Run: oc login. Then create a configuration file to install the Run:ai control plane:

Generate a values file by running: 

runai-adm generate-values --openshift \
    --first-admin <FIRST_ADMIN_USER_OF_RUNAI> # (1)

  1. Name of the administrator user in the company directory

Generate a values file by running the following under the deploy folder: 

runai-adm generate-values --openshift  \
    --first-admin <FIRST_ADMIN_USER_OF_RUNAI> \ # (1)
    --airgapped

  1. Name of the administrator user in the company directory

Generate a values file by running the following under the deploy folder: 

runai-adm generate-values --openshift  \
    --first-admin <FIRST_ADMIN_USER_OF_RUNAI> \ # (1)
    --registry <docker-registry-address> # (2)

  1. Name of the administrator user in the company directory
  2. Docker Registry address in the form of NAME:PORT (do not add https):

A file called runai-backend-values.yaml will be created.

Upload images (Airgapped only)

Upload images to a local Docker Registry. Set the Docker Registry address in the form of NAME:PORT (do not add https):

export REGISTRY_URL=<Docker Registry address>

Run the following script (you must have at least 20GB of free disk space to run): 

sudo -E ./prepare_installation.sh

(If docker is configured to run as non-root then sudo is not required).

Install the Control Plane

Run the helm command below:

helm repo add runai-backend https://backend-charts.storage.googleapis.com
helm repo update
helm install runai-backend -n runai-backend runai-backend/runai-backend \
    -f runai-backend-values.yaml

Info

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.

helm install runai-backend ./runai-backend-<version>.tgz -n \
    runai-backend -f runai-backend-values.yaml
(replace <version> with the control plane version)

Tip

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

Connect to Run:ai User Interface

Run: oc get routes -n runai-backend to find the Run:ai Administration User Interface URL. Log in using the default credentials: User: test@run.ai, Password: Abcd!234. Go to the Users area and change the password.

Next Steps

Continue with installing a Run:ai Cluster.

Last update: 2023-03-26
Created: 2023-03-26