NMC Launchpad Installation#

Overview#

NMC Launchpad provides a centralized landing page that serves as a unified entry point for accessing all NMC components through an intuitive web interface.

Key features include:

  • Centralized Access: Provides links to core components:

    • NVIDIA Base Command Manager

    • Run:ai

    • Autonomous Job Recovery

    • Autonomous Hardware Recovery

    • Grafana Dashboards

  • System Compatibility: Supports GB200, GB300, B200, and B300 systems, automatically displaying relevant components based on the deployed hardware.

  • Authentication: Features Keycloak-based integration for secure access control, supporting configurable OAuth/OIDC endpoints.

    Note

    Authentication is disabled by default for NMC 2.2.

  • Deployment: Utilizes Helm Charts for Kubernetes deployment configurations with environment-specific values.

Prerequisites#

Before installing NMC Launchpad, ensure the following prerequisites are met:

  • Assumes k8s-admin exists and is accessible from BCM head node

  • Kubernetes cluster is operational and accessible via kubectl

  • NGC API key with access to the NMC catalog (see how to generate an NGC API key)

  • Necessary permissions to access the NGC registry (nvcr.io) or the Product Information Database (PID) for package download

Download NMC Launchpad Helm Chart#

The NMC Launchpad Helm chart (version 0.2.11) can be obtained from two sources:

Option 1: Download from NGC Catalog#

To download the Helm chart from NGC Catalog:

# Set your NGC API key
export NGC_API_KEY=<your-ngc-api-key>

# Download the Helm chart
helm pull https://helm.ngc.nvidia.com/nvidia/nv-mission-control/charts/nmc-launchpad-0.2.11.tgz \
  --username='$oauthtoken' \
  --password=$NGC_API_KEY

# Extract the chart
tar xvzf nmc-launchpad-0.2.11.tgz

Option 2: Download from Product Information Database (PID)#

Alternatively, download the Helm chart package from the NVIDIA Product Information Database (PID):

  1. Navigate to the NMC Launchpad product page: https://apps.nvidia.com/PID/ContentLibraries/Detail?id=1149315

  2. Download the nmc-launchpad-0.2.11.tgz package

  3. Transfer the package to the BCM head node

  4. Extract the chart:

tar xvzf nmc-launchpad-0.2.11.tgz

Prepare Helm Values#

Platform Feature Support#

The following table shows which NMC Launchpad features are available on each platform:

Feature

B200

B300

GB200

GB300

Base Command Manager

✓

✓

✓

✓

Run:ai

✓

✓

✓

✓

Autonomous Job Recovery

✓

✗

✓

✗

Autonomous Hardware Recovery

✓

✗

✓

✓

Grafana Dashboards

✓

✗

✓

✓

Based on the supported features, configure the following URLs for your platform:

  • B200/B300: Only runai.url is required. The shoreline.url configuration is not needed.

  • GB200/GB300: Both runai.url and shoreline.url are required.

Create a custom values file as below to configure the NMC Launchpad for your environment:

cat <<EOF > values-custom.yaml
# NGC Registry Credentials
ngcImageCredentials:
  registry: nvcr.io
  username: "\$oauthtoken"
  # NGC API key with access to NMC catalog
  password: "<your-ngc-api-key>"

# DGX System Type (Required)
# Must be one of: gb200, gb300, b200, b300
dgx_system: "gb200"

# External Service URLs
runai:
  # URL for Run:ai web interface
  # Example: https://runai.<domain>/
  url: ""

shoreline:
  # URL for Autonomous Hardware Recovery (AHR) interface
  # Example: https://ahr.dgx-<cluster>.nvidia.com
  url: ""

EOF

Edit the values-custom.yaml file and configure the following parameters:

  • <your-ngc-api-key>: Your NGC API key with access to the NMC catalog

  • image.tag: Container image version

  • dgx_system: Set to your system type (gb200, gb300, b200, or b300)

  • runai.url: URL to your Run:ai installation (typically https://<headnode-ip>/runai or a custom domain)

  • shoreline.url: URL to your Autonomous Hardware Recovery installation (typically https://<ahr-domain>)

Install NMC Launchpad#

Install NMC Launchpad using Helm on the k8s-admin cluster.

  1. Verify Kubernetes cluster access:

    module load kubernetes/k8s-admin/
kubectl get nodes

  2. Install NMC Launchpad using Helm:

    helm upgrade --install launchpad ./nmc-launchpad \
  --create-namespace \
  --namespace launchpad \
  -f values-custom.yaml

Verify Installation#

After installation, verify that NMC Launchpad is running correctly.

Check Pod Status#

Verify that the NMC Launchpad pod is running:

kubectl get pods -n launchpad

Access NMC Launchpad#

Access NMC Launchpad through your web browser: https://<headnode-external-ip>/launchpad

You should see the NMC Launchpad interface with links to all configured NMC components.

Upgrade NMC Launchpad#

To upgrade NMC Launchpad to a newer version:

  1. Download the new Helm chart version

  2. Update your values-custom.yaml if needed

  3. Run the upgrade command:

    module load kubernetes/k8s-admin/
helm upgrade launchpad ./nmc-launchpad-<new-version> \
  --namespace launchpad \
  -f values-custom.yaml

Uninstall NMC Launchpad#

To remove NMC Launchpad from your cluster:

module load kubernetes/k8s-admin/
helm uninstall launchpad --namespace launchpad