Overview#
Base Command Manager (BCM) supports deploying operating systems beyond its default Ubuntu image
through a custom image import workflow. A compatible image root can be
built for any BCM-supported OS, packaged as a tarball, and imported
through BCM’s cm-create image tooling. BCM handles the rest: ramdisk
creation, Preboot Execution Environment (PXE) boot configuration, disk setup, and image distribution.
This guide walks through the full process using Red Hat Enterprise Linux (RHEL) 9.6 as the example OS. The six-part structure and the BCM-specific steps (Parts 2–4) are the same regardless of distribution. The parts that vary by OS — how the image root is bootstrapped, which package manager is used, and which subscription or repository setup is required — are in Part 1, and are clearly marked as RHEL-specific where applicable.
This guide is organized into six parts:
Building the OS image — installing the target OS bare-metal on a DGX node and constructing a BCM-compatible image root
Importing the image into BCM — transferring and registering the image on the head node
Configuring BCM — assigning the image to a node category and preparing for PXE boot
Installing NVIDIA software — installing drivers, and DOCA-OFED inside the image
Reconfiguring Slurm — extending the existing Slurm installation to support the RHEL image
Validating Slurm — verifying GPU access and container runtime on the provisioned nodes
References#
The following reference documents can be helpful during the deployment: