summaryrefslogtreecommitdiff
path: root/docs-xml
diff options
context:
space:
mode:
authorMichael Adam <obnox@samba.org>2015-02-19 16:59:00 +0100
committerKarolin Seeger <kseeger@samba.org>2015-03-01 21:29:09 +0100
commitaadfc401a2ed686cee2222a4b2f117e46c53bd5e (patch)
tree902a52c8674aa7bd18f4cec1f8654368c2898af9 /docs-xml
parent081a73054666fc97a996e596901e081a1882302b (diff)
downloadsamba-aadfc401a2ed686cee2222a4b2f117e46c53bd5e.tar.gz
doc:man:vfs_glusterfs: improve the configuration section.
Signed-off-by: Michael Adam <obnox@samba.org> Reviewed-by: Guenther Deschner <gd@samba.org> Autobuild-User(master): Günther Deschner <gd@samba.org> Autobuild-Date(master): Fri Feb 20 14:29:21 CET 2015 on sn-devel-104 (cherry picked from commit e6e6f563e6968dcb3ae558a7857f8dff49d2939f) The last 3 patches address BUG: https://bugzilla.samba.org/show_bug.cgi?id=11117 vfs_glusterfs manpage corrections
Diffstat (limited to 'docs-xml')
-rw-r--r--docs-xml/manpages/vfs_glusterfs.8.xml23
1 files changed, 21 insertions, 2 deletions
diff --git a/docs-xml/manpages/vfs_glusterfs.8.xml b/docs-xml/manpages/vfs_glusterfs.8.xml
index f569201ad8c..c0c320c76af 100644
--- a/docs-xml/manpages/vfs_glusterfs.8.xml
+++ b/docs-xml/manpages/vfs_glusterfs.8.xml
@@ -62,14 +62,33 @@
<title>CONFIGURATION</title>
<para>
- <command>vfs_glusterfs</command> requires that the underlying share
- path is a Gluster filesystem.
+ A basic configuration looks like this.
</para>
<programlisting>
<smbconfsection name="[share]"/>
<smbconfoption name="vfs objects">glusterfs</smbconfoption>
+ <smbconfoption name="path">/relative/base/path</smbconfoption>
+ <smbconfoption name="glusterfs:volume">gv0</smbconfoption>
+ <smbconfoption name="kernel share modes">no</smbconfoption>
</programlisting>
+
+ <para>
+ Note that since <command>vfs_glusterfs</command> does not
+ require a Gluster mount, the share <command>path</command> is
+ treated differently than for other shares: It is interpreted as
+ the base path of the share relative to the gluster volume used.
+ Because this is usually not at the same time a system path, in a
+ ctdb cluster setup where ctdb manages Samba, you need to set
+ <command>CTDB_SAMBA_SKIP_SHARE_CHECK=yes</command> in ctdb's
+ configuration file. Otherwise ctdb will not get healthy.
+ </para>
+
+ <para>
+ Note that currently kernel share modes have to be disabled
+ in a share running with the glusterfs vfs module for file
+ serving to work properly.
+ </para>
</refsect1>
<refsect1>