Skip to content

[DOC-14444][AI] Add memory and XDCR criteria for choosing 1024 vBuckets - #4160

Draft
TimLFletcher wants to merge 1 commit into
release/8.0from
DOC-14444
Draft

[DOC-14444][AI] Add memory and XDCR criteria for choosing 1024 vBuckets#4160
TimLFletcher wants to merge 1 commit into
release/8.0from
DOC-14444

Conversation

@TimLFletcher

@TimLFletcher TimLFletcher commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Fixes DOC-14444.

What changed

modules/learn/pages/buckets-memory-and-storage/storage-engines.adoc, in Which Storage Engine Should You Use?

The ticket asks for two criteria to be highlighted in the Magma 128 vs 1024 vBucket decision. Both were documented elsewhere on the site but missing from the list a reader actually consults when choosing. Added as two bullets to When to choose Magma with 1024 vBuckets.

Sources

Claim Source
At least 1 GiB per node points to 1024 vBuckets, for better performance at scale storage-engines.adoc:30, and the ticket
Pre-8.0 clusters require matching vBucket counts and do not support 128 xdcr-overview.adoc:319-334
So an XDCR target replicated into from pre-8.0 must use 1024 learn/partials/xdcr-magma-128-vbucket-incompatibility.adoc

The ticket phrases the second point as "XDCR replication from a bucket in Server version earlier than 8.0". I used the repository's own wording for the constraint instead, since xdcr-overview.adoc states it more precisely and distinguishes direction, which matters here.

The added xref points at the page rather than a section anchor, so there is no anchor to verify by hand.

Verification

PASS[docs-server @ DOC-14444 vs baseline release/8.0]: no new build diagnostics.

🤖 Generated with Claude Code

Which Storage Engine Should You Use? did not mention two criteria that
point at the 1024 vBucket configuration: having at least 1 GiB of memory
per node available for the bucket, and needing XDCR replication from a
cluster older than 8.0.

Both are already documented elsewhere on the site. This surfaces them in
the decision list where a reader making the choice will see them.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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.

1 participant