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]
103 $ mount -t glusterfs -obackup-volfile-servers=<server2>:
105 <server3>:...:<serverN> <server1>:/<volname>
106 <mount_point>
107 backupvolfile-server=SERVER
111 Provide list of backup volfile servers in the following format
112 [default: None]
113 $ mount -t glusterfs -obackupvolfile-server=<server2>
115 <server1>:/<volname> <mount_point>
116 fetch-attempts=N
120 Deprecated option - placed here for backward compatibility [de‐
121 fault: 1]
122 lru-limit=N
125 Set fuse module's limit for number of inodes kept in LRU list to
126 N [default: 65536]
127 invalidate-limit=N
130 Suspend fuse invalidations implied by 'lru-limit' if number of
131 outstanding invalidations reaches N
132 background-qlen=N
135 Set fuse module's background queue length to N [default: 64]
136 no-root-squash=BOOL
138 disable root squashing for the trusted client [default: off]
139 root-squash=BOOL
141 enable root squashing for the trusted client [default: on]
142 use-readdirp=BOOL
144 Use readdirp() mode in fuse kernel module [default: on]
145 dump-fuse=PATH
147 Dump fuse traffic to PATH
148 kernel-writeback-cache=BOOL
150 Enable fuse in-kernel writeback cache [default: off]
151 attr-times-granularity=NS
153 Declare supported granularity of file attribute [default: 0]
154 auto-invalidation=BOOL
156 controls whether fuse-kernel can auto-invalidate attribute, den‐
157 try and page-cache. Disable this only if same files/directories
158 are not accessed across two different mounts concurrently [de‐
159 fault: on]
160
162 /etc/fstab
163 A typical GlusterFS entry in /etc/fstab looks like below
164 server1:/mirror /mnt/mirror glusterfs log-file=/var/log/mir‐
166 ror.log,acl 0 0
167 /proc/mounts
170 An example entry of a GlusterFS mountpoint in /proc/mounts looks
171 like below
172 server1:/mirror /mnt/glusterfs fuse.glusterfs rw,allow_other,de‐
174 fault_permissions,max_read=131072 0 0
175
178 glusterfs(8), mount(8), gluster(8)
179
182 Copyright(c) 2006-2013 Red Hat, Inc. <http://www.redhat.com>
18314 September 2013 Cluster Filesystem GlusterFS(8)