From 29e01aa65075031b9cd5f0d94d90df0c3a59980d Mon Sep 17 00:00:00 2001 From: Shyam Date: Fri, 3 Feb 2017 09:43:01 -0500 Subject: doc: Updated release notes for readdir ahead improvements Change-Id: I6190cb6883b16316a076052f64314a8c0813529e BUG: 1417735 Signed-off-by: Shyam Reviewed-on: https://review.gluster.org/16543 CentOS-regression: Gluster Build System NetBSD-regression: NetBSD Build System Smoke: Gluster Build System --- doc/release-notes/3.10.0.md | 26 ++++++++++++++++++++------ 1 file changed, 20 insertions(+), 6 deletions(-) (limited to 'doc') 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 performance.readdir-ahead on +# gluster volume set performance.parallel-readdir on +``` + +To disable this feature: +```bash +# gluster volume set 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 performance.readdir-ahead on -# gluster volume set performance.parallel-readdir on +# gluster volume set performance.rda-cache-limit ``` *Limitations:* -- cgit