blob: 363ee74e1de9c4d0411ec8b5e7e31918a49bab62 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
<refentry id="vfs_glusterfs.8">
<refmeta>
<refentrytitle>vfs_glusterfs</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="source">Samba</refmiscinfo>
<refmiscinfo class="manual">System Administration tools</refmiscinfo>
<refmiscinfo class="version">4.2</refmiscinfo>
</refmeta>
<refnamediv>
<refname>vfs_glusterfs</refname>
<refpurpose>
Utilize features provided by GlusterFS
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>vfs objects = glusterfs</command>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>This VFS module is part of the
<citerefentry><refentrytitle>samba</refentrytitle>
<manvolnum>8</manvolnum></citerefentry> suite.</para>
<para>
The <command>vfs_glusterfs</command> VFS module exposes
GlusterFS specific features for use by Samba.
</para>
<para>
GlusterFS is a clustered file system, capable of scaling
to several peta-bytes. It aggregates various storage bricks
over Infiniband RDMA or TCP/IP and interconnect into one large
parallel network file system. Storage bricks can be made of any
commodity hardware, such as x86-64 server with SATA-II RAID and
Infiniband HBA.
GlusterFS is fully POSIX compliant file system. It supports
standard clients running standard applications over any standard
IP network and also FUSE. It works seemlessly on
different operating systems, currently supported on GNU/Linux
and Solaris.
</para>
<para>
This module is stackable, provided glusterfs lies in the bottom
of the stack.
</para>
</refsect1>
<refsect1>
<title>CONFIGURATION</title>
<para>
<command>vfs_glusterfs</command> requires that the underlying share
path is a Gluster filesystem.
</para>
<programlisting>
<smbconfsection name="[share]"/>
<smbconfoption name="vfs objects">glusterfs</smbconfoption>
</programlisting>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>glusterfs:logfile = path</term>
<listitem>
<para>
Defines whether and where to store a vfs_glusterfs specific
logfile. Client variable substitution is supported (i.e.
%M, %m, %I), hence per client log file can be specified.
</para>
<para>
Example: glusterfs:logfile =
/var/log/samba/glusterfs-vol2.%M.log
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>glusterfs:loglevel = 0-9</term>
<listitem>
<para>
Defines the level of logging, with higher numbers corresponding to more verbosity.
0 - No logs; 9 - Trace log level; 7 being the info log level is preferred.
</para>
<para>
If this option is not defined with an explicit loglevel,
the glusterfs default is used (currently loglevel 7).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>glusterfs:volfile_server = servername</term>
<listitem>
<para>
Defines which volfile server to use, defaults to
localhost.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>glusterfs:volume = volumename</term>
<listitem>
<para>
Defines the glusterfs volumename to use for this share.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>VERSION</title>
<para>
This man page is correct for version 4.2.0 of the Samba suite.
</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>The original Samba software and related utilities
were created by Andrew Tridgell. Samba is now developed
by the Samba Team as an Open Source project similar
to the way the Linux kernel is developed.</para>
</refsect1>
</refentry>
|
