Skip to content

Added node boot order support#3309

Merged
rachel-netq merged 5 commits into
CumulusNetworks:stagefrom
sausuman-nvidia:rm-4786165-whats-new-boot-order
Jul 15, 2026
Merged

Added node boot order support#3309
rachel-netq merged 5 commits into
CumulusNetworks:stagefrom
sausuman-nvidia:rm-4786165-whats-new-boot-order

Conversation

@sausuman-nvidia

@sausuman-nvidia sausuman-nvidia commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Adds node boot order documentation to the DSX Air guide, since node boot order is being added to Air (Beta):

Added a Boot Order section to Custom-Topology.md covering the JSON boot attribute (a single device or an ordered list of hd/network/cdrom) and the equivalent DOT boot option.
Added a What's New entry (⚠️ version still TBD — set before merge).

Backing code MRs (GitLab, nbu-sws/air) — please merge only after these are merged:

  • air-common !36 — boot-order types (hd/network/cdrom + ordered list)
  • air-api !839 — list-valued advanced.boot with per-device validation
  • air-worker !147 — per-device boot order in libvirt XML
  • air-sdk !106 — NodeAdvanced.boot type stub (cdrom + list form)

…RM-4786165]

Add a Boot Order section to the JSON topology examples and a boot option to
the DOT customizations, covering single-device and ordered-list forms,
accepted devices (hd/network/cdrom), pxehost mutual-exclusivity, and the
cdrom-requires-attached-image constraint.
@sausuman-nvidia sausuman-nvidia changed the title Draft: What's New — Node boot order (Beta) [RM-4786165] Added node boot order support Jul 13, 2026
@sausuman-nvidia
sausuman-nvidia marked this pull request as ready for review July 13, 2026 06:54
@mergify

mergify Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

  • Queue this pull request

@sausuman-nvidia

Copy link
Copy Markdown
Contributor Author

@rachel-netq could you please review? I'm opening this from a fork and don't have permission to add reviewers directly. This documents the node boot order feature (Beta) — please merge only after the backing code MRs listed in the description are merged. Thanks!


By default a node boots from its disk (`hd`). Use the optional `boot` attribute to choose the boot device, or to specify an ordered list of devices to try. Provide either:

- **A single device** — for example `"hd"` or `"network"`. The default is `"hd"`.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we also please update example to include "cdrom" as these are the only possible types for boot

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in be2826f — added cdrom to the single-device example (now "hd", "network", or "cdrom"). Thanks!

Comment thread content/nvidia-air-v2/Whats-New.md Outdated
Check out the latest updates to {{<exlink url="https://dsx-air.nvidia.com" text="NVIDIA DSX Air">}}.

## July 2026
### <release version — TBD>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Version should be : 82.2.1.21.1000

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in be2826f — set the version to 82.2.1.21.1000. Thanks!

…-4786165]

Reproduce the internal air-scribe boot-order documentation verbatim (full
list-behavior description + dedicated CD-ROM section) instead of a trimmed
version. Only correctness fixes applied: use top-level `boot` (import ignores
user-supplied `advanced`), drop the internal-review TODO comments.
… example [RM-4786165]

- Whats-New: set version to 82.2.1.21.1000 (per review)
- Custom-Topology: include cdrom in the single-device boot example
@daroor-rgb

Copy link
Copy Markdown

LGTM

@rachel-netq
rachel-netq self-requested a review July 13, 2026 15:28
@rachel-netq
rachel-netq merged commit 393f1ab into CumulusNetworks:stage Jul 15, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants