From 11814c906a87fef59c371b9676c00edc387fe6eb Mon Sep 17 00:00:00 2001 From: Poornima G Date: Fri, 23 Feb 2018 20:02:24 +0530 Subject: Release notes 4.0: Fill up data for some topics in performance Change-Id: I04c41296f878d6e2d94344b621733f7c7f07c337 Signed-off-by: Poornima G --- doc/release-notes/4.0.0.md | 40 +++++++++++++++++++++++++++++----------- 1 file changed, 29 insertions(+), 11 deletions(-) diff --git a/doc/release-notes/4.0.0.md b/doc/release-notes/4.0.0.md index 7e1be513e0c..5b7211a12aa 100644 --- a/doc/release-notes/4.0.0.md +++ b/doc/release-notes/4.0.0.md @@ -94,29 +94,47 @@ Disperse translator, now forwards the request to one of the bircks that is deemed to have a good copy, instead of all, thus improving the efficiency of the operation. -#### 2. To make md-cache capable to serve nameless lookup +#### 2. Allow md-cache to serve nameless lookup from cache +With this enhancement, some more lookups will be served from the cache. The workloads +that will perform better with this change are: +- Directory listing in FUSE mount with ACL enabled, will be faster. +- NFS workloads also will be benifited. + **Notes for users:** -- https://github.com/gluster/glusterfs/issues/232 -- Release notes: - - Need to have some detail on what workloads will stand to gain by this change +Issue: https://github.com/gluster/glusterfs/issues/232 +There is no specific option to enable this feature, it the default behaviour +when metadata caching is enabled. To enable metadata caching please refet to +Performance Tuning section in Admin Guide. **Limitations:** - +None **Known Issues:** +None #### 3. md-cache: Allow runtime addition of xattrs to the list of xattrs that md-cache caches + Md-cache caches the stat and xattrs on the client side. In all the previous releases, the +list of xattrs that can be cached in the client side was hardcoded in the libraries, user could +only enable or disable the prelisted xattrs cache. With this feature, we can add new xattrs to +the list of xattrs that can be cached on the client side. + **Notes for users:** -- https://github.com/gluster/glusterfs/issues/297 -- Needs user documentation for option performance.xattr-cache-list -- Release notes: - - Need documentation of the option, and also some details of when to use this feature - - Maybe better if this appeared in the documentation and we could point to the same +Issue: https://github.com/gluster/glusterfs/issues/297 +To add xattrs to the cache list, execute the following command: + ``` + # gluster volume set xattr-cache-list "comma separated xattr list" + ``` +The option like "cache-samba-metadata" "cache-swift-metadata" which also adds some xattrs +to the cache list, still works. The new option "xattr-cache-list" appends to the list +generated by the old options. Refer to the Performance Tuning section in the Admin Guide +for further information. **Limitations:** - +Currently, setting this option overwrites the previous value set for this option. +The append to the existing list of xattr is currently not available **Known Issues:** +None #### 4. Cache last stripe of an EC volume while write is going on **Notes for users:** -- cgit