Skip to content

docs: failure domains, storage network multipathing, CLI migration/replication/backup, limits + consistency fixes - #183

Open
schmidt-scaled wants to merge 4 commits into
mainfrom
docs/dev-fd-multipath-consistency
Open

docs: failure domains, storage network multipathing, CLI migration/replication/backup, limits + consistency fixes#183
schmidt-scaled wants to merge 4 commits into
mainfrom
docs/dev-fd-multipath-consistency

Conversation

@schmidt-scaled

Copy link
Copy Markdown
Contributor

Summary

Documentation review against current sbcli / ultra / spdk main (dev docs).

New pages

  • Failure domains: concept page (placement contract, balance rules, recovery behavior) + CLI operations page (create, tag nodes, expansion, removal, moving hosts)
  • Storage network multipathing: setup of NVMe-oF multipathing over separate storage VLANs as the alternative to a bonded HA network (--data-nics eth1,eth2, separate-subnet requirement, client connect guidance, verification)
  • Volume migration (non-Kubernetes): CLI workflow incl. the 5-minute migrate-continue window and batch migration
  • Asynchronous replication (non-Kubernetes): CLI workflows incl. cross-cluster volume migration via replication-commit, failover and failback
  • Limits reference: hard per-node object limits (6000 objects/lvstore, 75 subsystems/node, 50 namespaces/subsystem) and vCPU-dependent limits

Consistency fixes

  • --max-lvol -> --max-subsys; --journal-partition -> --enable-journal-device; multiple data NICs supported (drop "R25.10 zero or one NICs")
  • Encryption pages rewritten for KMS-based keys (--crypto-key1/2 hard-fail since 26.2)
  • Online node removal semantics (no volumes/snapshots, node ONLINE/SUSPENDED, async task, --force-remove only cancels tasks)
  • Cluster expansion: single-node expansion supported, drop "pairs only"
  • Correct defaults (--qpair-count 32, --max-size 1000T, --ha-type default), lvol ports 4420, port 5000 = storage node API, QoS example syntax, FTT2 tertiary, StorageNodeSet.maxParallelNodeAdds, pool cluster_id positional
  • 26.2 release notes: failure domains are flat integer domains (hierarchical labels were removed)

Open questions (not changed here)

  • 26-2 release notes GA/PRE contradiction; which release /dev targets
  • suspend/resume deprecation direction (RN vs CLI)
  • upgrade matrix 26.x rows
  • CLI reference generator drops deprecated metadata and renders list/secret types as "unknown"

🤖 Generated with Claude Code

michixs and others added 3 commits August 7, 2026 14:15
…nd limits pages

- Failure domains: concept page (placement contract, balance rules, recovery)
  and CLI operations page (create, tag, expand, remove, immutable membership)
- Storage network multipathing: setup as the alternative to a bonded HA
  network (separate VLANs, --data-nics, client connect, verification)
- Volume migration: bare-metal CLI workflow (migrate / connect / continue,
  5-minute continue window, batch migration, preconditions)
- Asynchronous replication: CLI workflows incl. cross-cluster volume
  migration via replication-commit, failover and failback
- Limits: hard per-node object limits (6000/75/50) and vCPU-dependent limits

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…sbcli main

- --max-lvol renamed to --max-subsys (storage-node configure/restart)
- --journal-partition deprecated: document --enable-journal-device instead
- --data-nics: multiple comma-separated data NICs supported (multipathing);
  drop the 'R25.10, zero or one NICs' claim
- --crypto-key1/2 removed (KMS-based since 26.2): rewrite encrypting page,
  fix provisioning parameter table (defaults: --max-size 1000T,
  --ha-type default; host ACLs moved to storage-pool add-host)
- QoS examples: remove copied metavars (invalid syntax)
- Node removal: reflect online node removal semantics (no volumes/snapshots,
  node must be ONLINE/SUSPENDED, async task; --force-remove only cancels tasks)
- Cluster expansion: single-node expansion supported, drop 'pairs only'
- find-secondary-node: mention tertiary path at FTT 2
- reconnect-nvme-device: lvol listener ports start at 4420, not 9100
- network-port-table: port 5000 is the storage node API, not spdk-http-proxy
- cluster-deployment-options: --qpair-count default is 32 (client 3);
  add --enable-failure-domain
- parallel-node-addition: maxParallelNodeAdds lives on StorageNodeSet
- nvmf-security: storage-pool add requires cluster id positional
- 26-2 release notes: failure domains are flat integer domains, not
  hierarchical
- HA page: add failure domains and storage-network multipathing sections

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The new failure-domain, multipathing, volume-migration, asynchronous
replication, and limits pages predate the quality gate rules on main.
Applied the auto-fixers: American English (canceled, toward, afterward),
bold list-item subjects with the colon inside the asterisks, and table
re-alignment.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@noctarius
noctarius force-pushed the docs/dev-fd-multipath-consistency branch from 55a7b9f to 52733f1 Compare August 7, 2026 12:52
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/docs-dev-fd-multipath-consistency

Clears the 73 style warnings on the lines this branch introduces, all of
them rules the gates report but do not fail on:

- em dashes setting off a clause replaced by parentheses, a comma, or a
  colon (34)
- semicolons between clauses split into sentences (34)
- a numbered list whose items no longer read as continuations (3)
- two Oxford-comma series disambiguated (2)

Also applies rules no gate checks: the actor 'the operator' removed from
a migration step in favor of the passive, four sentences past 30 words
split at their natural break, and three run-on conditions in
volume-migration turned into separate list items. No facts changed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/docs-dev-fd-multipath-consistency

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