GlusterFS

Section: Red Hat, Inc. (8)
Updated: Cluster Filesystem
Page Index

NAME

mount.glusterfs - script to mount native GlusterFS volume

SYNOPSIS

mount -t glusterfs [-o <options>] <volumeserver>:/<volume>[/<subdir>] <mountpoint>

mount -t glusterfs [-o <options>] <server1>,<server2>,: <server3>,..<serverN>:/<volname>[/<subdir>] <mount_point>

mount -t glusterfs [-o <options>] <path/to/volumefile> <mountpoint>

DESCRIPTION

This tool is part of glusterfs(8) package, which is used to mount using GlusterFS native binary.

mount.glusterfs is meant to be used by the mount(8) command for mounting native GlusterFS client. This subcommand, however, can also be used as a standalone command with limited functionality.

OPTIONS

Basic options

log-file=LOG-FILE: File to use for logging [default:/var/log/glusterfs/glusterfs.log]
log-level=LOG-LEVEL: Logging severity. Valid options are TRACE, DEBUG, WARNING, ERROR, CRITICAL INFO and NONE [default: INFO]
acl: Mount the filesystem with POSIX ACL support
fopen-keep-cache[=BOOL]: Do not purge the cache on file open (default: false)
worm: Mount the filesystem in 'worm' mode
aux-gfid-mount: Enable access to filesystem through gfid directly
ro: Mount the filesystem read-only
enable-ino32=BOOL: Use 32-bit inodes when mounting to workaround broken applications that don't support 64-bit inodes
mem-accounting: Enable internal memory accounting
capability: Enable file capability setting and retrival
thin-client: Enables thin mount and connects via gfproxyd daemon

Advanced options

attribute-timeout=SECONDS

Set attribute timeout to SECONDS for inodes in fuse kernel module [default: 1]

entry-timeout=SECONDS

Set entry timeout to SECONDS in fuse kernel module [default: 1]

background-qlen=N

Set fuse module's background queue length to N [default: 64]

gid-timeout=SECONDS

Set auxiliary group list timeout to SECONDS for fuse translator [default: 0]

negative-timeout=SECONDS

Set negative timeout to SECONDS in fuse kernel module [default: 0]

volume-name=VOLUME-NAME

Volume name to be used for MOUNT-POINT [default: top most volume in VOLUME-FILE]

direct-io-mode=BOOL|auto

Specify fuse direct I/O strategy [default: auto]

congestion-threshold=N

Set fuse module's congestion threshold to N [default: 48]

ubdir-mount=N

Set the subdirectory mount option [default: NULL, ie, no subdirectory mount]

backup-volfile-servers=SERVERLIST

Provide list of backup volfile servers in the following format [default: None]

$ mount -t glusterfs -obackup-volfile-servers=<server2>: <server3>:...:<serverN> <server1>:/<volname> <mount_point>

backupvolfile-server=SERVER

Provide list of backup volfile servers in the following format [default: None]

$ mount -t glusterfs -obackupvolfile-server=<server2> <server1>:/<volname> <mount_point>

fetch-attempts=N

Deprecated option - placed here for backward compatibility [default: 1]

lru-limit=N

Set fuse module's limit for number of inodes kept in LRU list to N [default: 65536]

invalidate-limit=N

Suspend fuse invalidations implied by 'lru-limit' if number of outstanding invalidations reaches N

background-qlen=N

Set fuse module's background queue length to N [default: 64]

no-root-squash=BOOL

disable root squashing for the trusted client [default: off]

root-squash=BOOL

enable root squashing for the trusted client [default: on]

use-readdirp=BOOL

Use readdirp() mode in fuse kernel module [default: on]

dump-fuse=PATH

Dump fuse traffic to PATH

kernel-writeback-cache=BOOL

Enable fuse in-kernel writeback cache [default: off]

attr-times-granularity=NS

Declare supported granularity of file attribute [default: 0]

auto-invalidation=BOOL

controls whether fuse-kernel can auto-invalidate attribute, dentry and page-cache. Disable this only if same files/directories are not accessed across two different mounts concurrently [default: on]

FILES

/etc/fstab

A typical GlusterFS entry in /etc/fstab looks like below

server1:/mirror /mnt/mirror glusterfs log-file=/var/log/mirror.log,acl 0 0

/proc/mounts

An example entry of a GlusterFS mountpoint in /proc/mounts looks like below

server1:/mirror /mnt/glusterfs fuse.glusterfs rw,allow_other,default_permissions,max_read=131072 0 0