glusterfs man page

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 auxiliary 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)

Referenced By

gluster(8), glusterd(8), mount.glusterfs(8).

Clustered File System 07 March 2011 Gluster Inc.