Skip to content

Initial pNFS / ReadWriteMany documentation - #238

Merged
noctarius merged 4 commits into
mainfrom
docs/pnfs
Oct 11, 2026
Merged

noctarius merged 4 commits into
mainfrom
docs/pnfs

Conversation

@noctarius

Copy link
Copy Markdown
Collaborator

No description provided.

@noctarius noctarius self-assigned this Oct 10, 2026
Copilot AI balanced review requested due to automatic review settings October 10, 2026 19:14
@github-actions

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/docs-pnfs

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

Several requirements and verification steps incorrectly describe Linux pNFS behavior and could mislead operators.

8 open findings
What changed in this PR

Adds initial pNFS documentation for Kubernetes ReadWriteMany volumes, covering architecture, deployment requirements, configuration, operation, and terminology.

Changes:

  • Documents pNFS architecture and lifecycle.
  • Adds Kubernetes provisioning and troubleshooting guidance.
  • Records kernel, KVM, distribution, and cloud requirements.
File Description
docs/​architecture/​concepts/​pnfs.md Explains pNFS architecture and lifecycle.
docs/​kubernetes/​usage/​pnfs.md Adds configuration and usage guidance.
docs/​kubernetes/​usage/​index.md Links the new usage page.
docs/​reference/​supported-linux-kernels.md Adds pNFS kernel requirements.
docs/​reference/​supported-linux-distributions.md Adds distribution validation status.
docs/​deployment-preparation/​software-requirements.md Adds client software requirements.
docs/​deployment-preparation/​hardware-requirements.md Adds KVM requirements.
docs/​deployment-preparation/​cloud-instance-recommendations.md Adds cloud virtualization guidance.
docs/​important-notes/​terminology.md Defines pNFS terminology.
docs/​important-notes/​acronyms.md Adds related acronyms.

🧠 Review effort: Balanced


💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/architecture/concepts/pnfs.md Outdated
Comment thread docs/architecture/concepts/pnfs.md Outdated
Comment thread docs/deployment-preparation/cloud-instance-recommendations.md Outdated
Comment thread docs/deployment-preparation/software-requirements.md Outdated
Comment thread docs/kubernetes/usage/pnfs.md Outdated
Comment thread docs/kubernetes/usage/pnfs.md Outdated
Comment thread docs/kubernetes/usage/pnfs.md Outdated
Comment thread docs/reference/supported-linux-kernels.md Outdated
noctarius and others added 3 commits October 11, 2026 10:06
- Drop nvme_get_unique_id as a client requirement: it is called by nfsd
  on the metadata server, which brings its own kernel. The client needs
  the pNFS block layout driver with NVMe support (nvme-eui. lookup).
- Remove the unverified RHEL 9.5 client claim and the 6.11 statement.
- Qualify the direct data path where it read as unconditional.
- Check the direct path with the per-operation counters, since
  pnfs=LAYOUT_SCSI does not change when a client falls back.
- Narrow nested virtualization to virtualized instances, and stop
  promising /dev/kvm on bare-metal instances unconditionally.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/docs-pnfs

@noctarius
noctarius merged commit 3082c2a into main Oct 11, 2026
4 checks passed
@noctarius
noctarius deleted the docs/pnfs branch October 11, 2026 09:03
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