1GlusterFS(8) Gluster Inc. GlusterFS(8)
2
3
4
6 GlusterFS - clustered file system
7
9 glusterfs [options] [mountpoint]
10
12 GlusterFS is a clustered file system, capable of scaling to several
13 peta-bytes. It aggregates various storage bricks over Infiniband RDMA
14 or TCP/IP and interconnect into one large parallel network file system.
15 Storage bricks can be made of any commodity hardware, such as x86-64
16 server with SATA-II RAID and Infiniband HBA.
17
18 GlusterFS is fully POSIX compliant file system. On client side, it has
19 dependency on FUSE package, on server side, it works seemlessly on dif‐
20 ferent operating systems. Currently supported on GNU/Linux and
21 Solaris.
22
23
25 Basic options
26 -f, --volfile=VOLUME-FILE
27 File to use as VOLUME-FILE.
28
29 -l, --log-file=LOGFILE
30 File to use for logging (the default is <INSTALL-
31 DIR>/var/log/glusterfs/<MOUNT-POINT>.log).
32
33 -L, --log-level=LOGLEVEL
34 Logging severity. Valid options are TRACE, DEBUG, INFO, WARN‐
35 ING, ERROR and CRITICAL (the default is INFO).
36
37 -s, --volfile-server=SERVER
38 Server to get the volume from. This option overrides --volfile
39 option.
40
41 --volfile-max-fetch-attempts=MAX-ATTEMPTS
42 Maximum number of connect attempts to server. This option should
43 be provided with --volfile-server option (the default is 1).
44
45
46 Advanced options
47 --acl Mount the filesystem with POSIX ACL support.
48
49 -L, --localtime-logging=on|off
50 Enable or disable localtime log timestamps. Valid options are on
51 and off (the default is off).
52
53 --debug
54 Run in debug mode. This option sets --no-daemon, --log-level to
55 DEBUG, and --log-file to console.
56
57 --enable-ino32=BOOL
58 Use 32-bit inodes when mounting to workaround application that
59 doesn't support 64-bit inodes.
60
61 --fopen-keep-cache
62 Do not purge the cache on file open.
63
64 --mac-compat=BOOL
65 Provide stubs for attributes needed for seamless operation on
66 Macs (the default is off).
67
68 -N, --no-daemon
69 Run in the foreground.
70
71 -p, --pid-file=PIDFILE
72 File to use as PID file.
73
74 --read-only
75 Mount the file system in 'read-only' mode.
76
77 --selinux
78 Enable SELinux label (extended attributes) support on inodes.
79
80 -S, --socket-file=SOCKFILE
81 File to use as unix-socket.
82
83 --volfile-id=KEY
84 Key of the volume file to be fetched from the server.
85
86 --volfile-server-port=PORT
87 Port number of volfile server.
88
89 --volfile-server-transport=TRANSPORT
90 Transport type to get volume file from server (the default is
91 tcp).
92
93 --volume-name=VOLUME-NAME
94 Volume name to be used for MOUNT-POINT (the default is top most
95 volume in VOLUME-FILE).
96
97 --worm Mount the filesystem in 'worm' mode.
98
99 --xlator-option=VOLUME-NAME.OPTION=VALUE
100 Add/Override a translator option for a volume with the specified
101 value.
102
103 --subdir-mount=SUBDIR-MOUNT-PATH
104 Mount subdirectory instead of the '/' of volume.
105
106
107 Fuse options
108 --attribute-timeout=SECONDS
109 Set attribute timeout to SECONDS for inodes in fuse kernel mod‐
110 ule (the default is 1).
111
112 --background-qlen=N
113 Set fuse module's background queue length to N (the default is
114 64).
115
116 --congestion-threshold=N
117 Set fuse module's congestion threshold to N (the default is 48).
118
119 --direct-io-mode=BOOL
120 Enable/Disable the direct-I/O mode in fuse module (the default
121 is enable).
122
123 --dump-fuse=PATHR
124 Dump fuse traffic to PATH
125
126 --entry-timeout=SECONDS
127 Set entry timeout to SECONDS in fuse kernel module (the default
128 is 1).
129
130 --gid-timeout=SECONDS
131 Set auxiliary group list timeout to SECONDS for fuse translator
132 (the default is 0).
133
134 --negative-timeout=SECONDS
135 Set negative timeout to SECONDS in fuse kernel module (the
136 default is 0).
137
138 --volfile-check
139 Enable strict volume file checking.
140
141
142 Miscellaneous Options
143 -?, --help
144 Display this help.
145
146 --usage
147 Display a short usage message.
148
149 -V, --version
150 Print the program version.
151
152
154 /var/lib/glusterd/vols/*/*.vol
155
157 mount a volume named foo on server bar with log level DEBUG on mount
158 point /mnt/foo
159
160 # glusterfs --log-level=DEBUG --volfile-id=foo --volfile-server=bar
161 /mnt/foo
162
163
165 fusermount(1), mount.glusterfs(8), gluster(8)
166
168 Copyright(c) 2006-2011 Red Hat, Inc. <http://www.redhat.com>
169
170
171
17207 March 2011 Clustered File System GlusterFS(8)