1GlusterFS(8)                     Red Hat, Inc.                    GlusterFS(8)
2
3
4

NAME

6       mount.glusterfs - script to mount native GlusterFS volume
7

SYNOPSIS

9       mount  -t  glusterfs [-o <options>] <volumeserver>:/<volume>[/<subdir>]
10       <mountpoint>
11
12       mount -t glusterfs [-o <options>] <server1>,<server2>,
13              <server3>,..<serverN>:/<volname>[/<subdir>] <mount_point>
14
15
16       mount -t glusterfs [-o <options>]  <path/to/volumefile>  <mount‐
17       point>
18

DESCRIPTION

20       This  tool  is  part  of  glusterfs(8) package, which is used to
21       mount using GlusterFS native binary.
22
23       mount.glusterfs is meant to be used by the mount(8) command  for
24       mounting  native GlusterFS client. This subcommand, however, can
25       also be used as a standalone command with limited functionality.
26
27

OPTIONS

29   Basic options
30       log-file=LOG-FILE
31              File to use for logging [default:/var/log/glusterfs/glus‐
32              terfs.log]
33
34       log-level=LOG-LEVEL
35              Logging  severity.  Valid options are TRACE, DEBUG, WARN‐
36              ING, ERROR, CRITICAL INFO and NONE [default: INFO]
37
38       acl    Mount the filesystem with POSIX ACL support
39
40       fopen-keep-cache
41              Do not purge the cache on file open
42
43       worm   Mount the filesystem in 'worm' mode
44
45       aux-gfid-mount
46              Enable access to filesystem through gfid directly
47
48       ro     Mount the filesystem read-only
49
50       enable-ino32=BOOL
51              Use 32-bit inodes  when  mounting  to  workaround  broken
52              applications that don't support 64-bit inodes
53
54       mem-accounting
55              Enable internal memory accounting
56
57       capability
58              Enable file capability setting and retrival
59
60       thin-client
61              Enables thin mount and connects via gfproxyd daemon
62
63
64   Advanced options
65       attribute-timeout=SECONDS
66              Set  attribute timeout to SECONDS for inodes in fuse ker‐
67              nel module [default: 1]
68
69       entry-timeout=SECONDS
70              Set entry  timeout  to  SECONDS  in  fuse  kernel  module
71              [default: 1]
72
73       background-qlen=N
74              Set  fuse module's background queue length to N [default:
75              64]
76
77       gid-timeout=SECONDS
78              Set auxiliary group list  timeout  to  SECONDS  for  fuse
79              translator [default: 0]
80
81       negative-timeout=SECONDS
82              Set  negative  timeout  to  SECONDS in fuse kernel module
83              [default: 0]
84
85       volume-name=VOLUME-NAME
86              Volume name to be used for MOUNT-POINT [default: top most
87              volume in VOLUME-FILE]
88
89       direct-io-mode=BOOL|auto
90              Specify fuse direct I/O strategy [default: auto]
91
92       congestion-threshold=N
93              Set fuse module's congestion threshold to N [default: 48]
94
95       ubdir-mount=N
96              Set  the subdirectory mount option [default: NULL, ie, no
97              subdirectory mount]
98
99
100       backup-volfile-servers=SERVERLIST
101              Provide list of backup volfile servers in the fol‐
102              lowing format [default: None]
103
104              $           mount           -t           glusterfs
105              -obackup-volfile-servers=<server2>:
106                     <server3>:...:<serverN>    <server1>:/<vol‐
107              name> <mount_point>
108
109
110
111       backupvolfile-server=SERVER
112              Provide  list  of backup volfile servers in
113              the following format [default: None]
114
115               $    mount    -t     glusterfs     -oback‐
116              upvolfile-server=<server2>
117                       <server1>:/<volname> <mount_point>
118
119
120
121       fetch-attempts=N
122              Deprecated  option - placed here for
123              backward compatibility [default: 1]
124
125
126       lru-limit=N
127              Set fuse module's  limit  for
128              number  of inodes kept in LRU
129              list to N [default: 131072]
130
131
132       background-qlen=N
133              Set   fuse    module's
134              background       queue
135              length to N  [default:
136              64]
137
138       no-root-squash=BOOL
139              disable root squashing
140              for the trusted client
141              [default: off]
142
143       root-squash=BOOL
144              enable  root squashing
145              for the trusted client
146              [default: on]
147
148       use-readdirp=BOOL
149              Use readdirp() mode in
150              fuse   kernel   module
151              [default: on]
152
153       dump-fuse=PATH
154              Dump  fuse  traffic to
155              PATH
156
157       kernel-writeback-cache=BOOL
158              Enable fuse  in-kernel
159              writeback        cache
160              [default: off]
161
162       attr-times-granularity=NS
163              Declare      supported
164              granularity   of  file
165              attribute [default: 0]
166

FILES

168       /etc/fstab
169              A  typical   GlusterFS
170              entry   in  /etc/fstab
171              looks like below
172
173              server1:/mirror
174              /mnt/mirror  glusterfs
175              log-file=/var/log/mir‐
176              ror.log,acl   0  0
177
178
179       /proc/mounts
180              An  example entry of a
181              GlusterFS   mountpoint
182              in  /proc/mounts looks
183              like below
184
185              server1:/mirror
186              /mnt/glusterfs
187              fuse.glusterfs
188              rw,allow_other,default_per‐
189              mis‐
190              sions,max_read=131072
191              0 0
192
193

SEE ALSO

195       glusterfs(8), mount(8), glus‐
196       ter(8)
197
198

COPYRIGHT

200       Copyright(c)  2006-2013   Red
201       Hat, Inc.    <http://www.red‐
202       hat.com>
203
204
205
20614 September 2013             Cluster Filesystem                  GlusterFS(8)