Skip to content

docs(nodes): hugepages tutorial (aleph-vm 2.0) - #84

Merged
odesenfans merged 1 commit into
mainfrom
docs/crn-hugepages
Aug 27, 2026
Merged

docs(nodes): hugepages tutorial (aleph-vm 2.0)#84
odesenfans merged 1 commit into
mainfrom
docs/crn-hugepages

Conversation

@odesenfans

Copy link
Copy Markdown
Contributor

Adds `docs/nodes/compute/advanced/hugepages/` and a sidebar entry under Compute Nodes → Advanced Features.

Covers, for CRN operators on aleph-vm 2.0:

  • prerequisites: Rust supervisor (`ALEPH_VM_SUPERVISOR_IMPL=rust`) and a host with more than one NUMA node
  • how NUMA placement + hugepage backing work, and the fail-safe fallbacks
  • `ALEPH_VM_NUMA_HUGEPAGES`, `_HEADROOM_MB`, `_LIMIT_MB` with a worked example
  • verification via supervisor logs, `/proc/meminfo`, sysfs and the QEMU memory-backend argv
  • 1 GiB pages (operator-reserved via the kernel cmdline), disabling, troubleshooting

Independent of the volume-pools PR; both touch adjacent lines of the sidebar config, so whichever merges second needs a trivial rebase.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WuSSYXc921wiHCUweF1ANC

Explains the opt-in NUMA hugepage backing for CRN operators: the Rust
supervisor and multi-NUMA-node prerequisites, ALEPH_VM_NUMA_HUGEPAGES with
its headroom and limit settings, boot-time reservation behaviour,
verification via logs, sysfs and the QEMU argv, 1 GiB pages, disabling,
and a troubleshooting table.
@github-actions

github-actions Bot commented Aug 27, 2026

Copy link
Copy Markdown

Deployed on:

Preview for this pull request, updated on every commit and removed once the PR is closed.

@foxpatch-aleph foxpatch-aleph left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Well-structured documentation for a new aleph-vm 2.0 hugepages feature. The build passes cleanly, the sidebar entry is correctly placed and linked, the internal anchor link is valid, and the worked example math is correct (192 GiB limit is properly binding on a 256 GiB / 2-node host with 16 GiB headroom per node). The content covers prerequisites, how-it-works, configuration, verification, 1 GiB pages, disabling, and troubleshooting comprehensively. All VitePress container blocks are properly opened and closed. No security concerns — the doc describes standard root-level kernel operations with no credentials or injection vectors.

@odesenfans
odesenfans merged commit 5c0dbeb into main Aug 27, 2026
1 check 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.

2 participants