Install the Control Plane

System and Network Requirements

Before installing the NVIDIA Run:ai control plane, validate that the system requirements and network requirements are met.

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

Note

• To customize the installation based on your environment, see Advanced control plane configurations.

• PostgreSQL and Keycloakx are installed with default usernames and passwords. To change the default credentials, see Additional third-party configurations.

1. It’s recommended to install the latest NVIDIA Run:ai release. If you need to install a specific version, you can browse the available versions using the following command:

helm search repo -l runai-backend

1. Create a values.yaml file using the appropriate example below based on your metrics backend:

YAML with Grafana Labs

global:
  domain: <RUNAI_DOMAIN> # example: "runai.hostorg.com"
  multiTenancy: true
metricsService:
  config:
   datasourceUrl: <METRIC_STORE_READ_URL> # example: https://prometheus-prod-13-prod-us-east-0.grafana.net/api/prom
tenantsManager:
  config:
    defaultMetricStore:
      read:
        auth:
          basic:
            password: <METRIC_STORE_READ_PASSWORD>
            username: "1434499"
        url: <METRIC_STORE_READ_URL> # example: https://prometheus-prod-13-prod-us-east-0.grafana.net/api/prom
      useXscopeHeader: true
      write:
        auth:
          basic:
            password: <METRIC_STORE_WRITE_PASSWORD>
            username: "1434499"
        url: <METRIC_STORE_WRITE_URL> # example: https://prometheus-prod-56-prod-us-east-2.grafana.net/api/prom
thanos:
  enabled: false
authorization:
  config:
    isCSPEnv: true

YAML with Mimir

1. Run the following commands to install the NVIDIA Run:ai control plane using your configured values.yaml file:

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 \ 
    -f /path/to/your/values.yaml 

Note

• To install a specific version, add --version <VERSION> to the install command. You can find all available versions by using the helm search repo runai-backend/control-plane --versions command.

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