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> <mountpoint>
17

DESCRIPTION

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

OPTIONS

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

FILES

159       /etc/fstab
160              A typical GlusterFS entry in /etc/fstab looks like below
161
162              server1:/mirror  /mnt/mirror   glusterfs  log-file=/var/log/mir‐
163              ror.log,acl   0  0
164
165
166       /proc/mounts
167              An example entry of a GlusterFS mountpoint in /proc/mounts looks
168              like below
169
170              server1:/mirror          /mnt/glusterfs           fuse.glusterfs
171              rw,allow_other,default_permissions,max_read=131072 0 0
172
173

SEE ALSO

175       glusterfs(8), mount(8), gluster(8)
176
177

COPYRIGHT

179       Copyright(c) 2006-2013   Red Hat, Inc.   <http://www.redhat.com>
180
181
182
18314 September 2013             Cluster Filesystem                  GlusterFS(8)