NAME¶
GlusterFS - clustered file system
SYNOPSIS¶
glusterfs [options] [mountpoint]
DESCRIPTION¶
GlusterFS is a clustered file system, capable of scaling to several peta-bytes.
It aggregates various storage bricks over Infiniband RDMA or TCP/IP and
interconnect into one large parallel network file system. Storage bricks can
be made of any commodity hardware, such as x86-64 server with SATA-II RAID and
Infiniband HBA.
GlusterFS is fully POSIX compliant file system. On client side, it has
dependency on FUSE package, on server side, it works seemlessly on different
operating systems. Currently supported on GNU/Linux and Solaris.
OPTIONS¶
Basic options¶
- -f, --volfile=VOLUME-FILE
- File to use as VOLUME-FILE.
- -l, --log-file=LOGFILE
- File to use for logging (the default is
<INSTALL-DIR>/var/log/glusterfs/<MOUNT-POINT>.log).
- -L, --log-level=LOGLEVEL
- Logging severity. Valid options are TRACE, DEBUG, INFO,
WARNING, ERROR and CRITICAL (the default is INFO).
- -s, --volfile-server=SERVER
- Server to get the volume from. This option overrides
--volfile option.
- --volfile-max-fetch-attempts=MAX-ATTEMPTS
- Maximum number of connect attempts to server. This option
should be provided with --volfile-server option (the default is 1).
Advanced options¶
- --acl
- Mount the filesystem with POSIX ACL support.
- --debug
- Run in debug mode. This option sets --no-daemon,
--log-level to DEBUG, and --log-file to console.
- --enable-ino32=BOOL
- Use 32-bit inodes when mounting to workaround application
that doesn't support 64-bit inodes.
- --fopen-keep-cache
- Do not purge the cache on file open.
- --mac-compat=BOOL
- Provide stubs for attributes needed for seamless operation
on Macs (the default is off).
- -N, --no-daemon
- Run in the foreground.
- -p, --pid-file=PIDFILE
- File to use as PID file.
- --read-only
- Mount the file system in 'read-only' mode.
- --selinux
- Enable SELinux label (extended attributes) support on
inodes.
- -S, --socket-file=SOCKFILE
- File to use as unix-socket.
- --volfile-id=KEY
- Key of the volume file to be fetched from the server.
- --volfile-server-port=PORT
- Port number of volfile server.
- --volfile-server-transport=TRANSPORT
- Transport type to get volume file from server (the default
is tcp).
- --volume-name=VOLUME-NAME
- Volume name to be used for MOUNT-POINT (the default is top
most volume in VOLUME-FILE).
- --worm
- Mount the filesystem in 'worm' mode.
- --xlator-option=VOLUME-NAME.OPTION=VALUE
- Add/Override a translator option for a volume with the
specified value.
Fuse options¶
-
--attribute-timeout=SECONDS
- Set attribute timeout to SECONDS for inodes in fuse kernel
module (the default is 1).
- --background-qlen=N
- Set fuse module's background queue length to N (the default
is 64).
- --congestion-threshold=N
- Set fuse module's congestion threshold to N (the default is
48).
- --direct-io-mode=BOOL
- Enable/Disable the direct-I/O mode in fuse module (the
default is enable).
- --dump-fuse=PATHR
- Dump fuse traffic to PATH
- --entry-timeout=SECONDS
- Set entry timeout to SECONDS in fuse kernel module (the
default is 1).
- --gid-timeout=SECONDS
- Set auxilary group list timeout to SECONDS for fuse
translator (the default is 0).
- --negative-timeout=SECONDS
- Set negative timeout to SECONDS in fuse kernel module (the
default is 0).
- --volfile-check
- Enable strict volume file checking.
Miscellaneous Options¶
-
-?, --help
- Display this help.
- --usage
- Display a short usage message.
- -V, --version
- Print the program version.
FILES¶
/var/lib/glusterd/vols/*/*.vol
EXAMPLES¶
mount a volume named foo on server bar with log level DEBUG on mount point
/mnt/foo
# glusterfs --log-level=DEBUG --volfile-id=foo --volfile-server=bar /mnt/foo
SEE ALSO¶
fusermount(1), mount.glusterfs(8), gluster(8)
COPYRIGHT¶
Copyright(c) 2006-2011 Red Hat, Inc. <http://www.redhat.com>