RavenDB-26218 Document read_ahead_kb tuning and the new storage config options#2504
Open
arekpalinski wants to merge 2 commits into
Open
RavenDB-26218 Document read_ahead_kb tuning and the new storage config options#2504arekpalinski wants to merge 2 commits into
arekpalinski wants to merge 2 commits into
Conversation
…g options - Add a block-device tuning section (read_ahead_kb, scheduler, rotational) to the system configuration recommendations, framed as opt-in for heavy random-access load. - Document Storage.ReadAheadKbAlertThresholdInKb and Storage.UseSequentialReadAheadHintForJournalRecovery in the storage configuration reference. - Drop the stale "Ubuntu 16.04" qualifier from the Linux heading.
26 tasks
gregolsky
reviewed
Jun 17, 2026
|
|
||
| # Installation: System Configuration Recommendations | ||
|
|
||
| ## Linux - Ubuntu 16.04 |
gregolsky
reviewed
Jun 17, 2026
|
|
||
| Also check `rotational` and `scheduler`. They matter most on virtualized disks (Azure managed disks in particular), which are often misreported as `rotational` even when backed by SSD/NVMe, so the kernel picks HDD-oriented defaults. Bare-metal SSD/NVMe is usually detected correctly. For SSD/NVMe, `rotational=0` and `scheduler=none` are usually better. | ||
|
|
||
| Persist these across reboots with a udev rule: |
Member
There was a problem hiding this comment.
need to mention this applies the values to ALL disks here and users should check and apply the rule for the disks used by RavenDB.
…ll users to scope it to the disks RavenDB actually uses.
ppekrol
approved these changes
Jun 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue link
https://issues.hibernatingrhinos.com/issue/RavenDB-26218
Additional description
PR in RavenDB: ravendb/ravendb#22676
Type of change
/templatesor readme)Changes in docs URLs
/scripts/redirects.jsonfile, setDocuments MovedPR label)Changes in UX/UI