Skip to content

Cluster Bring-Up and Commissioning

Building the model…

Bring-up as a gate sequence across the cluster: nodes advance gate by gate, and a node that fails a gate is held back while the rest move on.

A checklist can be worked in any order. A bring-up cannot. Every step in commissioning an AI cluster produces evidence that the next step depends on, and skipping ahead does not save time — it moves a defect from a domain where one person can find it in an hour to a domain where five people argue about it for a week.

The discipline that makes this tractable is the gate: a named point with written exit criteria, evidence attached, and an explicit statement of what it blocks. Gates are how you keep a 250-node build from turning into a diffuse cloud of half-finished work, and they are also how you keep the vendor conversation honest, because a gate that has not passed is not an opinion.

GateWhat it provesWhat it blocks
G0 — PhysicalRacks landed, power live, cooling loop commissioned and balanced, structured cabling in and labelledAny power-on
G1 — Out-of-bandEvery BMC discovered, addressed, reachable, and inventoried; console path independent of the production fabricAny in-band work
G2 — Firmware baselineOne frozen manifest applied fleet-wide: BIOS, BMC, GPU VBIOS, NIC firmware, switch OS, DPU imageNode health testing
G3 — Physical layerAll compute links up at rate, rail audit clean, 24-hour error soak with zero symbol/CRC growthFabric feature work
G4 — Node health100 % of nodes pass health checks: GPU count and health, NVLink topology, PCIe width and speed, clean logsAny collective run
G5 — Fabric featuresAdaptive routing, congestion control, MTU, ECN/PFC verified and captured as config evidenceAcceptance measurement
G6 — Scheduler and runtimeSlurm partitions aligned to scalable units, container runtime working, fabric environment pinnedBenchmark execution
GateG0 — Physical
What it provesRacks landed, power live, cooling loop commissioned and balanced, structured cabling in and labelled
What it blocksAny power-on
GateG1 — Out-of-band
What it provesEvery BMC discovered, addressed, reachable, and inventoried; console path independent of the production fabric
What it blocksAny in-band work
GateG2 — Firmware baseline
What it provesOne frozen manifest applied fleet-wide: BIOS, BMC, GPU VBIOS, NIC firmware, switch OS, DPU image
What it blocksNode health testing
GateG3 — Physical layer
What it provesAll compute links up at rate, rail audit clean, 24-hour error soak with zero symbol/CRC growth
What it blocksFabric feature work
GateG4 — Node health
What it proves100 % of nodes pass health checks: GPU count and health, NVLink topology, PCIe width and speed, clean logs
What it blocksAny collective run
GateG5 — Fabric features
What it provesAdaptive routing, congestion control, MTU, ECN/PFC verified and captured as config evidence
What it blocksAcceptance measurement
GateG6 — Scheduler and runtime
What it provesSlurm partitions aligned to scalable units, container runtime working, fabric environment pinned
What it blocksBenchmark execution

Everything downstream of G6 is the subject of the next chapter. The rest of this one is how each gate is actually passed.

BRING-UP
Seven gates. Each one blocks the next.
G0PhysicalG1Out-of-bandG2Firmware bas…G3Physical lay…G4Node healthG5Fabric featu…G6Scheduler + …
G3 — Physical layer
All compute links at design rate, rail map verified, 24-hour error soak with zero counter growth.
Blocks: Fabric feature work
Evidence: Link report, LLDP rail audit, before/after counter deltas
Freeze before you measure: any change to the manifest re-opens G2 and everything after it.

One rule underpins all of them: freeze before you measure. The single most common way a commissioning effort loses a fortnight is that somebody upgrades a driver, a switch image, or a NIC firmware in the middle of the process to fix one node. The fleet is now non-uniform, every comparison across scalable units is invalid, and the only honest recovery is to re-freeze and re-run. Write the manifest down at G2, put it under change control, and treat any change to it as re-opening the gate.


Read aloudPage 1