diff options
author | Raghavendra Talur <rtalur@redhat.com> | 2016-08-25 16:03:55 +0530 |
---|---|---|
committer | Günther Deschner <gd@samba.org> | 2016-10-14 17:09:24 +0200 |
commit | 857745655bd29656de3b0f96765d6b65221f3a3e (patch) | |
tree | 8fb06f09158b9f94f116753ba2c993f0894eeddd /docs-xml | |
parent | 1d2d0c34fc6e7d217f322adb6b6d3e920cbedf89 (diff) | |
download | samba-857745655bd29656de3b0f96765d6b65221f3a3e.tar.gz |
support volfile fetch from multiple glusterd nodes
glusterfs:volfile_server option can be used in smb.conf to define where
to fetch the volfile from. Currently it supports only a single IP or a
hostname. The default is 'localhost'.
glfs_set_volfile_server() has been enhanced in gfapi to support
multiple invocations. A list is maintained in libgfapi which gets
appended on every invocation. When glfs_init is performed, libgfapi
would first try to fetch the volfile from glusterd on that node.
However, on failure to fetch the volfile, it would proceed to contact
glusterd on every node in the list until it gets the volfile or
exhausts the list. This enhacement was done in Gluster commit [2].
This commit is available in 3.6, 3.7, 3.8 versions of Gluster.
As we cannot have multiple lines having the same key of
glusterfs:volfile_server in a share definition in smb.conf, we propose
a scheme like this:
where value of glusterfs:volfile_server could be list of white space seperated
elements where each element could be unix+/path/to/socket/file or
[tcp+]IP|hostname|\[IPv6\][:port].
Note the restriction on naming a IPv6 host, it follows the same
restriction that is based on IPv6 naming in URL as per RFC 2732[1].
[1] http://www.ietf.org/rfc/rfc2732.txt
[2] 0c1d78f5c52c69268ec3a1d8d5fcb1a1bf15f243
Signed-off-by: Raghavendra Talur <rtalur@redhat.com>
Reviewed-by: Jeremy Allison <jra@samba.org>
Reviewed-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 Oct 14 17:09:24 CEST 2016 on sn-devel-144
Diffstat (limited to 'docs-xml')
-rw-r--r-- | docs-xml/manpages/vfs_glusterfs.8.xml | 16 |
1 files changed, 14 insertions, 2 deletions
diff --git a/docs-xml/manpages/vfs_glusterfs.8.xml b/docs-xml/manpages/vfs_glusterfs.8.xml index 5e18e533c2a..5e67f715b21 100644 --- a/docs-xml/manpages/vfs_glusterfs.8.xml +++ b/docs-xml/manpages/vfs_glusterfs.8.xml @@ -131,7 +131,19 @@ <listitem> <para> Defines which volfile server to use, defaults to - localhost. + localhost. It could be list of white space + seperated elements where each element could be + </para> + <para> + 1. unix+/path/to/socket/file + </para> + <para> + 2. [tcp+]IP|hostname|\[IPv6\][:port] + </para> + <para> + Note the restriction on naming a IPv6 host, it follows + the same restriction that is based on IPv6 naming in + URL as per RFC 2732. </para> </listitem> </varlistentry> @@ -153,7 +165,7 @@ <title>VERSION</title> <para> - This man page is correct for version 4.2.0 of the Samba suite. + This man page is correct for version 4.6.0 of the Samba suite. </para> </refsect1> |