Description of problem: The man pages are out of date and missing a significant portion of the newer features. For example mount.glusterfs is fails to cover the following options: * backupvolfile-server=server name - name of the backup volfile server to mount the client. If this option is added while mounting fuse client, when the first volfile server fails, then the server specified in backupvolfile-server option is used as volfile server to mount the client. * fetch-attempts=number - number of attempts to fetch volume files while mounting a volume. This option is useful when you mount a server with multiple IP addresses or when round-robin DNS is configured for the server name. * acl - enables POSIX Access Control List on mount. * selinux - enables handling of SELinux xattrs through the mount point. * background-qlen=length - this option enables FUSE to handle n number of requests to be queued before stopping to accept new requests. Default value of n is 64. * enable-ino32 - this option enables file system to present 32-bit inodes instead of 64- bit inodes. This is covered in the online docs for example at: https://access.redhat.com/site/documentation/en-US/Red_Hat_Storage/2.0/html/Administration_Guide/chap-Administration_Guide-GlusterFS_Client.html We really need correct man pages!
Also it would be good if there are descriptions for what things like "direct-io-mode=[enable|disable]" actually do.
http://review.gluster.com/#/c/5931/ - RFC patch available please review - this also updates the man pages
Looking over the patch by Harshavardhana, it's missing: * fetch-attempts * background-qlen * enable-ino32 * direct-io-mode
(In reply to Justin Clift from comment #3) > Looking over the patch by Harshavardhana, it's missing: > > * fetch-attempts > * background-qlen > * enable-ino32 > * direct-io-mode Can you send a patch?
Unfortunately, not in the near future. :(
REVIEW: http://review.gluster.org/7338 (doc: Update manpages) posted (#1) for review on master by Harshavardhana (harsha)
REVIEW: http://review.gluster.org/7338 (doc: Update manpages) posted (#2) for review on master by Harshavardhana (harsha)
COMMIT: http://review.gluster.org/7338 committed in master by Vijay Bellur (vbellur) ------ commit 7c36d9ec0de67b9b9a0803fcd378ef8d3b453c87 Author: Harshavardhana <harsha> Date: Tue Mar 25 10:13:35 2014 -0700 doc: Update manpages Change-Id: Id14c7c3229ed266cd15915a2136e3290ce2c5ed2 BUG: 1031328 Signed-off-by: Harshavardhana <harsha> Reviewed-on: http://review.gluster.org/7338 Reviewed-by: Lalatendu Mohanty <lmohanty> Reviewed-by: Vijay Bellur <vbellur> Tested-by: Vijay Bellur <vbellur>
REVIEW: http://review.gluster.org/8656 (doc: Remove volume rename from gluster's man page.) posted (#1) for review on master by Vijay Bellur (vbellur)
REVIEW: http://review.gluster.org/8656 (doc: Remove volume rename from gluster's man page.) posted (#2) for review on master by Humble Devassy Chirammal (humble.devassy)
COMMIT: http://review.gluster.org/8656 committed in master by Vijay Bellur (vbellur) ------ commit c2513927b3aeaf03e0cfe1c1869c43f2a8f84153 Author: Vijay Bellur <vbellur> Date: Mon Sep 8 23:33:00 2014 +0530 doc: Remove volume rename from gluster's man page. Change-Id: I5cde789088417f26d0c8319a1b24fdaa2c37dfe6 BUG: 1031328 Signed-off-by: Vijay Bellur <vbellur> Reviewed-on: http://review.gluster.org/8656 Reviewed-by: Humble Devassy Chirammal <humble.devassy> Reviewed-by: Atin Mukherjee <amukherj> Tested-by: Gluster Build System <jenkins.com>
A beta release for GlusterFS 3.6.0 has been released. Please verify if the release solves this bug report for you. In case the glusterfs-3.6.0beta1 release does not have a resolution for this issue, leave a comment in this bug and move the status to ASSIGNED. If this release fixes the problem for you, leave a note and change the status to VERIFIED. Packages for several distributions should become available in the near future. Keep an eye on the Gluster Users mailinglist [2] and the update (possibly an "updates-testing" repository) infrastructure for your distribution. [1] http://supercolony.gluster.org/pipermail/gluster-users/2014-September/018836.html [2] http://supercolony.gluster.org/pipermail/gluster-users/
This bug is getting closed because a release has been made available that should address the reported issue. In case the problem is still not fixed with glusterfs-3.6.1, please reopen this bug report. glusterfs-3.6.1 has been announced [1], packages for several distributions should become available in the near future. Keep an eye on the Gluster Users mailinglist [2] and the update infrastructure for your distribution. [1] http://supercolony.gluster.org/pipermail/gluster-users/2014-November/019410.html [2] http://supercolony.gluster.org/mailman/listinfo/gluster-users