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 invalidate-limit=N
134 Suspend fuse invalidations implied by 'lru-limit' if number of
135 outstanding invalidations reaches N
136 background-qlen=N
139 Set fuse module's background queue length to N [default: 64]
140 no-root-squash=BOOL
142 disable root squashing for the trusted client [default: off]
143 root-squash=BOOL
145 enable root squashing for the trusted client [default: on]
146 use-readdirp=BOOL
148 Use readdirp() mode in fuse kernel module [default: on]
149 dump-fuse=PATH
151 Dump fuse traffic to PATH
152 kernel-writeback-cache=BOOL
154 Enable fuse in-kernel writeback cache [default: off]
155 attr-times-granularity=NS
157 Declare supported granularity of file attribute [default: 0]
158 auto-invalidation=BOOL
160 controls whether fuse-kernel can auto-invalidate attribute, den‐
161 try and page-cache. Disable this only if same files/directories
162 are not accessed across two different mounts concurrently [de‐
163 fault: on]
164
166 /etc/fstab
167 A typical GlusterFS entry in /etc/fstab looks like below
168 server1:/mirror /mnt/mirror glusterfs log-file=/var/log/mir‐
170 ror.log,acl 0 0
171 /proc/mounts
174 An example entry of a GlusterFS mountpoint in /proc/mounts looks
175 like below
176 server1:/mirror /mnt/glusterfs fuse.glusterfs rw,allow_other,de‐
178 fault_permissions,max_read=131072 0 0
179
182 glusterfs(8), mount(8), gluster(8)
183
186 Copyright(c) 2006-2013 Red Hat, Inc. <http://www.redhat.com>
18714 September 2013 Cluster Filesystem GlusterFS(8)