Skip to content

Conversation

@rmloveland
Copy link
Contributor

Fixes DOC-15399

Summary of changes:

  • Remove all mentions of RAID from various places

  • Also update the "don't use LVM" guidance to point users to multi-store instead

@netlify
Copy link

netlify bot commented Nov 17, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 241b8d6
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/691b9b0cad4ff300087576d6

@github-actions
Copy link

github-actions bot commented Nov 17, 2025

Files changed:

@netlify
Copy link

netlify bot commented Nov 17, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 241b8d6
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/691b9b0cceeee800085257a3

@rmloveland
Copy link
Contributor Author

once the v25.4 update is reviewed I will backport the change to all supported versions v23.2+

@netlify
Copy link

netlify bot commented Nov 17, 2025

Netlify Preview

Name Link
🔨 Latest commit 241b8d6
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/691b9b0c4ba1c900094e3470
😎 Deploy Preview https://deploy-preview-21163--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Contributor

@jhlodin jhlodin left a comment

Choose a reason for hiding this comment

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

Left a suggestion across two files.

Do we need to explicitly say that RAID is not supported? For the paragraph in recommended-production-settings.md in particular I could see a customer reading "this is recommended if you are using local disks... because they have a greater risk of failure" and going "oh well I'll just set them up in a RAID array for redundancy." Unless nobody's doing RAID for this type of infrastructure anymore - I'd ask support or a PM.

@rmloveland
Copy link
Contributor Author

Left a suggestion across two files.

Thanks, updated!

Do we need to explicitly say that RAID is not supported? For the paragraph in recommended-production-settings.md in particular I could see a customer reading "this is recommended if you are using local disks... because they have a greater risk of failure" and going "oh well I'll just set them up in a RAID array for redundancy." Unless nobody's doing RAID for this type of infrastructure anymore - I'd ask support or a PM.

For this PR I'd rather get this change in sooner and do a couple fast-follow PRs to address the language around that num_replicas=5 suggestion and also figure out if we want to explicitly say "don't use RAID" more vocally. I agree with your assessment that that language seems to imply "you need to replicate your local disks somehow" and it feels off. I've filed the following issues to follow up:

any objections to getting this one in ASAP and doing the above followup work in other PRs?

@rmloveland rmloveland requested a review from jhlodin November 17, 2025 21:40
Copy link
Contributor

@jhlodin jhlodin left a comment

Choose a reason for hiding this comment

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

LGTM. Would like to see what product recommendations are for "don't recommend RAID" vs "explicitly discourage RAID as unsupported" but this works for now.

Fixes DOC-15399

Summary of changes:

- Remove all mentions of RAID from various places

- Also update the "don't use LVM" guidance to point users to multi-store
  instead

NB. These changes are backported to all supported versions v23.2+
@rmloveland rmloveland enabled auto-merge (squash) November 17, 2025 22:01
@rmloveland rmloveland merged commit 80051f4 into main Nov 17, 2025
6 checks passed
@rmloveland rmloveland deleted the 20251117-DOC-15399 branch November 17, 2025 22:12
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