glusterfs(8)

1GlusterFS(8)                     Gluster Inc.                     GlusterFS(8)
2
3
4

NAME

6       GlusterFS - clustered file system
7

SYNOPSIS

9       glusterfs [options] [mountpoint]
10

DESCRIPTION

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

OPTIONS

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

FILES

154       /var/lib/glusterd/vols/*/*.vol
155

EXAMPLES

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

COPYRIGHT

168       Copyright(c) 2006-2011  Red Hat, Inc.  <http://www.redhat.com>
169
170
171
17207 March 2011                Clustered File System                GlusterFS(8)