1GlusterFS(8) Red Hat, Inc. GlusterFS(8)
2
6 mount.glusterfs - script to mount native GlusterFS volume
7
9 mount -t glusterfs [-o <options>] <volumeserver>:/<volume>[/<subdir>]
10 <mountpoint>
11 mount -t glusterfs [-o <options>] <server1>,<server2>,
13 <server3>,..<serverN>:/<volname>[/<subdir>] <mount_point>
14 mount -t glusterfs [-o <options>] <path/to/volumefile> <mount‐
17 point>
18
20 This tool is part of glusterfs(8) package, which is used to
21 mount using GlusterFS native binary.
22 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
29 Basic options
30 log-file=LOG-FILE
31 File to use for logging [default:/var/log/glusterfs/glus‐
32 terfs.log]
33 log-level=LOG-LEVEL
35 Logging severity. Valid options are TRACE, DEBUG, WARN‐
36 ING, ERROR, CRITICAL INFO and NONE [default: INFO]
37 acl Mount the filesystem with POSIX ACL support
39 fopen-keep-cache
41 Do not purge the cache on file open
42 worm Mount the filesystem in 'worm' mode
44 aux-gfid-mount
46 Enable access to filesystem through gfid directly
47 ro Mount the filesystem read-only
49 enable-ino32=BOOL
51 Use 32-bit inodes when mounting to workaround broken
52 applications that don't support 64-bit inodes
53 mem-accounting
55 Enable internal memory accounting
56 capability
58 Enable file capability setting and retrival
59 thin-client
61 Enables thin mount and connects via gfproxyd daemon
62 Advanced options
65 attribute-timeout=SECONDS
66 Set attribute timeout to SECONDS for inodes in fuse ker‐
67 nel module [default: 1]
68 entry-timeout=SECONDS
70 Set entry timeout to SECONDS in fuse kernel module
71 [default: 1]
72 background-qlen=N
74 Set fuse module's background queue length to N [default:
75 64]
76 gid-timeout=SECONDS
78 Set auxiliary group list timeout to SECONDS for fuse
79 translator [default: 0]
80 negative-timeout=SECONDS
82 Set negative timeout to SECONDS in fuse kernel module
83 [default: 0]
84 volume-name=VOLUME-NAME
86 Volume name to be used for MOUNT-POINT [default: top most
87 volume in VOLUME-FILE]
88 direct-io-mode=BOOL|auto
90 Specify fuse direct I/O strategy [default: auto]
91 congestion-threshold=N
93 Set fuse module's congestion threshold to N [default: 48]
94 ubdir-mount=N
96 Set the subdirectory mount option [default: NULL, ie, no
97 subdirectory mount]
98 backup-volfile-servers=SERVERLIST
101 Provide list of backup volfile servers in the fol‐
102 lowing format [default: None]
103 $ mount -t glusterfs
105 -obackup-volfile-servers=<server2>:
106 <server3>:...:<serverN> <server1>:/<vol‐
107 name> <mount_point>
108 backupvolfile-server=SERVER
112 Provide list of backup volfile servers in
113 the following format [default: None]
114 $ mount -t glusterfs -oback‐
116 upvolfile-server=<server2>
117 <server1>:/<volname> <mount_point>
118 fetch-attempts=N
122 Deprecated option - placed here for
123 backward compatibility [default: 1]
124 lru-limit=N
127 Set fuse module's limit for
128 number of inodes kept in LRU
129 list to N [default: 131072]
130 background-qlen=N
133 Set fuse module's
134 background queue
135 length to N [default:
136 64]
137 no-root-squash=BOOL
139 disable root squashing
140 for the trusted client
141 [default: off]
142 root-squash=BOOL
144 enable root squashing
145 for the trusted client
146 [default: on]
147 use-readdirp=BOOL
149 Use readdirp() mode in
150 fuse kernel module
151 [default: on]
152 dump-fuse=PATH
154 Dump fuse traffic to
155 PATH
156 kernel-writeback-cache=BOOL
158 Enable fuse in-kernel
159 writeback cache
160 [default: off]
161 attr-times-granularity=NS
163 Declare supported
164 granularity of file
165 attribute [default: 0]
166 auto-invalidation=BOOL
168 controls whether fuse-
169 kernel can auto-inval‐
170 idate attribute, den‐
171 try and page-cache.
172 Disable this only if
173 same files/directories
174 are not accessed
175 across two different
176 mounts concurrently
177 [default: on]
178
180 /etc/fstab
181 A typical GlusterFS
182 entry in /etc/fstab
183 looks like below
184 server1:/mirror
186 /mnt/mirror glusterfs
187 log-file=/var/log/mir‐
188 ror.log,acl 0 0
189 /proc/mounts
192 An example entry of a
193 GlusterFS mountpoint
194 in /proc/mounts looks
195 like below
196 server1:/mirror
198 /mnt/glusterfs
199 fuse.glusterfs
200 rw,allow_other,default_per‐
201 mis‐
202 sions,max_read=131072
203 0 0
204
207 glusterfs(8), mount(8), glus‐
208 ter(8)
209
212 Copyright(c) 2006-2013 Red
213 Hat, Inc. <http://www.red‐
214 hat.com>
21514 September 2013 Cluster Filesystem GlusterFS(8)