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       --attr-times-granularity=NANOSECONDS
109              Declare  supported  granularity of file attribute times (default
110              is 0 which kernel handles as unspecified; valid real values  are
111              between 1 and 1000000000).
112
113       --attribute-timeout=SECONDS
114              Set  attribute timeout to SECONDS for inodes in fuse kernel mod‐
115              ule (the default is 1).
116
117       --background-qlen=N
118              Set fuse module's background queue length to N (the  default  is
119              64).
120
121       --congestion-threshold=N
122              Set fuse module's congestion threshold to N (the default is 48).
123
124       --direct-io-mode=BOOL|auto
125              Specify fuse direct I/O strategy (the default is auto).
126
127       --dump-fuse=PATHR
128              Dump fuse traffic to PATH
129
130       --entry-timeout=SECONDS
131              Set  entry timeout to SECONDS in fuse kernel module (the default
132              is 1).
133
134       --gid-timeout=SECONDS
135              Set auxiliary group list timeout to SECONDS for fuse  translator
136              (the default is 0).
137
138       --kernel-writeback-cache=BOOL
139              Enable fuse in-kernel writeback cache.
140
141       --negative-timeout=SECONDS
142              Set  negative  timeout  to  SECONDS  in  fuse kernel module (the
143              default is 0).
144
145       --volfile-check
146              Enable strict volume file checking.
147
148
149   Miscellaneous Options
150       -?, --help
151              Display this help.
152
153       --usage
154              Display a short usage message.
155
156       -V, --version
157              Print the program version.
158
159

FILES

161       /var/lib/glusterd/vols/*/*.vol
162

EXAMPLES

164       mount a volume named foo on server bar with log level  DEBUG  on  mount
165       point /mnt/foo
166
167       #  glusterfs  --log-level=DEBUG  --volfile-id=foo  --volfile-server=bar
168       /mnt/foo
169
170

COPYRIGHT

175       Copyright(c) 2006-2011  Red Hat, Inc.  <http://www.redhat.com>
176
177
178
17907 March 2011                Clustered File System                GlusterFS(8)