diff options
| author | Shyam <srangana@redhat.com> | 2017-02-03 09:43:01 -0500 |
|---|---|---|
| committer | Shyamsundar Ranganathan <srangana@redhat.com> | 2017-02-03 11:22:49 -0500 |
| commit | 29e01aa65075031b9cd5f0d94d90df0c3a59980d (patch) | |
| tree | a8c56a2fbe3cf6f4cddfe4d8a923bb566035a89e /doc/release-notes | |
| parent | ef25dbe39fd5e89a208b9c1698aaab74c014d7d5 (diff) | |
doc: Updated release notes for readdir ahead improvements
Change-Id: I6190cb6883b16316a076052f64314a8c0813529e
BUG: 1417735
Signed-off-by: Shyam <srangana@redhat.com>
Reviewed-on: https://review.gluster.org/16543
CentOS-regression: Gluster Build System <jenkins@build.gluster.org>
NetBSD-regression: NetBSD Build System <jenkins@build.gluster.org>
Smoke: Gluster Build System <jenkins@build.gluster.org>
Diffstat (limited to 'doc/release-notes')
| -rw-r--r-- | doc/release-notes/3.10.0.md | 26 |
1 files changed, 20 insertions, 6 deletions
diff --git a/doc/release-notes/3.10.0.md b/doc/release-notes/3.10.0.md index e3eb1ab9e25..f04c8de4f5e 100644 --- a/doc/release-notes/3.10.0.md +++ b/doc/release-notes/3.10.0.md @@ -153,14 +153,28 @@ manually delete the directory from the mount point. ### Implemented parallel readdirp with distribute xlator *Notes for users:* -Note is WIP! -Improves directory enumeration performance in large clusters, by performing -readdir ahead in parallel. +Currently the directory listing gets slower as the number of bricks/nodes +increases in a volume, though the file/directory numbers remain unchanged. +With this feature, the performance of directory listing is made mostly +independent of the number of nodes/bricks in the volume. Thus scale doesn't +exponentially reduce the directory listing performance. (On a 2, 5, 10, 25 brick +setup we saw ~5, 100, 400, 450% improvement consecutively) + +To enable this feature: +```bash +# gluster volume set <VOLNAME> performance.readdir-ahead on +# gluster volume set <VOLNAME> performance.parallel-readdir on +``` + +To disable this feature: +```bash +# gluster volume set <VOLNAME> performance.parallel-readdir off +``` -To test the benefits of this this feature set the following 2 volume options, +If there are more than 50 bricks in the volume it is good to increase the cache +size to be more than 10Mb (default value): ```bash -# gluster volume set <volname> performance.readdir-ahead on -# gluster volume set <volname> performance.parallel-readdir on +# gluster volume set <VOLNAME> performance.rda-cache-limit <CACHE SIZE> ``` *Limitations:* |