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> <mountpoint>
17
19 This tool is part of glusterfs(8) package, which is used to mount using
20 GlusterFS native binary.
21 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
28 Basic options
29 log-file=LOG-FILE
30 File to use for logging [default:/var/log/glusterfs/glus‐
31 terfs.log]
32 log-level=LOG-LEVEL
34 Logging severity. Valid options are TRACE, DEBUG, WARNING, ER‐
35 ROR, CRITICAL INFO and NONE [default: INFO]
36 acl Mount the filesystem with POSIX ACL support
38 fopen-keep-cache[=BOOL]
40 Do not purge the cache on file open (default: false)
41 worm Mount the filesystem in 'worm' mode
43 aux-gfid-mount
45 Enable access to filesystem through gfid directly
46 ro Mount the filesystem read-only
48 enable-ino32=BOOL
50 Use 32-bit inodes when mounting to workaround broken applica‐
51 tions that don't support 64-bit inodes
52 mem-accounting
54 Enable internal memory accounting
55 capability
57 Enable file capability setting and retrival
58 thin-client
60 Enables thin mount and connects via gfproxyd daemon
61 localtime-logging
63 Use local timestamps instead of UTC in mount log entries
64 Advanced options
67 attribute-timeout=SECONDS
68 Set attribute timeout to SECONDS for inodes in fuse kernel mod‐
69 ule [default: 1]
70 entry-timeout=SECONDS
72 Set entry timeout to SECONDS in fuse kernel module [default: 1]
73 background-qlen=N
75 Set fuse module's background queue length to N [default: 64]
76 gid-timeout=SECONDS
78 Set auxiliary group list timeout to SECONDS for fuse translator
79 [default: 0]
80 negative-timeout=SECONDS
82 Set negative timeout to SECONDS in fuse kernel module [default:
83 0]
84 volume-name=VOLUME-NAME
86 Volume name to be used for MOUNT-POINT [default: top most volume
87 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 subdi‐
97 rectory mount]
98 backup-volfile-servers=SERVERLIST
101 Provide list of backup volfile servers in the following format
102 [default: None] If use IPv6 address in SERVERLIST, it is re‐
103 quired to use '[' and ']' to surround IPv6 address.
104 $ mount -t glusterfs -obackup-volfile-servers=<server2>:
106 <server3>:...:<serverN> <server1>:/<volname>
107 <mount_point> $ mount -t glusterfs
108 -obackup-volfile-servers=<[ipv6_addr2]>:
109 <[ipv6_addr3]>:...:<[ipv6_addrN]> <ipv6_addr1>:/<volname>
110 <mount_point>
111 backupvolfile-server=SERVER
115 Provide list of backup volfile servers in the following format
116 [default: None]
117 $ mount -t glusterfs -obackupvolfile-server=<server2>
119 <server1>:/<volname> <mount_point>
120 fetch-attempts=N
124 Deprecated option - placed here for backward compatibility [de‐
125 fault: 1]
126 lru-limit=N
129 Set fuse module's limit for number of inodes kept in LRU list to
130 N [default: 65536]
131 inode-table-size=N
134 Set the inode hash table size to N - this must be a power of 2
135 greater than or equal to 65536 and will be rounded up if not
136 [default: 65536]
137 invalidate-limit=N
140 Suspend fuse invalidations implied by 'lru-limit' if number of
141 outstanding invalidations reaches N
142 background-qlen=N
145 Set fuse module's background queue length to N [default: 64]
146 no-root-squash=BOOL
148 disable root squashing for the trusted client [default: off]
149 root-squash=BOOL
151 enable root squashing for the trusted client [default: on]
152 use-readdirp=BOOL
154 Use readdirp() mode in fuse kernel module [default: on]
155 dump-fuse=PATH
157 Dump fuse traffic to PATH
158 kernel-writeback-cache=BOOL
160 Enable fuse in-kernel writeback cache [default: off]
161 attr-times-granularity=NS
163 Declare supported granularity of file attribute [default: 0]
164 auto-invalidation=BOOL
166 controls whether fuse-kernel can auto-invalidate attribute, den‐
167 try and page-cache. Disable this only if same files/directories
168 are not accessed across two different mounts concurrently [de‐
169 fault: on]
170
172 /etc/fstab
173 A typical GlusterFS entry in /etc/fstab looks like below
174 server1:/mirror /mnt/mirror glusterfs log-file=/var/log/mir‐
176 ror.log,acl 0 0
177 /proc/mounts
180 An example entry of a GlusterFS mountpoint in /proc/mounts looks
181 like below
182 server1:/mirror /mnt/glusterfs fuse.glusterfs rw,allow_other,de‐
184 fault_permissions,max_read=131072 0 0
185
188 glusterfs(8), mount(8), gluster(8)
189
192 Copyright(c) 2006-2013 Red Hat, Inc. <http://www.redhat.com>
19314 September 2013 Cluster Filesystem GlusterFS(8)