Skip to content

Add Linux block device (lblk) mode documentation (experimental) - #182

Merged
noctarius merged 8 commits into
mainfrom
lblk-device-mode
Aug 7, 2026
Merged

Add Linux block device (lblk) mode documentation (experimental)#182
noctarius merged 8 commits into
mainfrom
lblk-device-mode

Conversation

@schmidt-scaled

Copy link
Copy Markdown
Contributor

Documents the new experimental cluster-global lblk device mode (arbitrary Linux block devices — SAS/SATA, virtio, cloud volumes — via SPDK AIO bdevs), implemented on sbcli md-journal.

Three pages, all carrying the experimental chip:

  • Architecture › Concepts › Linux Block Devices: device modes (nvme/lblk), eligibility rules, serial-first device identity, failure-detection parity (IO errors, control-plane hung-IO watchdog, disappearance sweep), restrictions (cluster-global/deploy-time, journal-on-device only, no SMART).
  • Deployments › Install on Linux › Deploy with Linux Block Devices: cluster create --device-mode lblk, storage-node configure --lblk with --blk-names / --blk-names-exclude / --blk-serials selectors, partitioned-device handling (--force at configure, --force-format at add-node), verification.
  • Maintenance & Operations › Linux Block Device Operations: restart semantics (serial re-resolution, missing → removed), adding devices via reconfigure + re-add (--ssd-pcie rejected on lblk), failed/hung/removed device handling.

🤖 Generated with Claude Code

auto-merge was automatically disabled August 6, 2026 21:21

Pull request was closed

@schmidt-scaled schmidt-scaled reopened this Aug 6, 2026
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/lblk-device-mode

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/lblk-device-mode

1 similar comment
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/lblk-device-mode

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/lblk-device-mode

1 similar comment
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/lblk-device-mode

michixs and others added 8 commits August 7, 2026 10:27
Three pages covering the cluster-global lblk device mode (arbitrary Linux
block devices via SPDK AIO bdevs), rebased onto the reorganized tree
(non-kubernetes/) and brought into house style (impersonal voice, lowercase
brand, capitalized Linux, American English, Oxford commas):
- architecture/concepts/linux-block-devices.md — device modes, eligibility,
  serial-first identity, failure-detection parity, restrictions
- non-kubernetes/installation/linux-block-devices.md — cluster create
  --device-mode lblk, storage-node configure --lblk selectors,
  --force / --force-format for partitioned devices
- non-kubernetes/operations/lblk-device-operations.md — restarts,
  adding devices via reconfigure + re-add, failed-device handling

All pages carry the experimental chip. Local quality gates green
(spelling, terminology, American English, voice; syntax findings limited
to pre-existing generated-reference targets).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The trimmed description, the Simplyblock Storage Plane Container wording,
and the simplified device-selection paragraph from the web-UI edits
(506d988, 78bba45) — adapted to the casing gates (lowercase brand
mid-sentence, capitalized Linux).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/lblk-device-mode

@noctarius
noctarius merged commit 33874f3 into main Aug 7, 2026
4 checks passed
@noctarius
noctarius deleted the lblk-device-mode branch August 7, 2026 08:51
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