mount.glusterfs - Man Page

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

localtime-logging

Use local timestamps instead of UTC in mount log entries

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] If use IPv6 address in SERVERLIST, it is required to use '[' and ']' to surround IPv6 address.

$ mount -t glusterfs -obackup-volfile-servers=<server2>:       <server3>:...:<serverN> <server1>:/<volname> <mount_point> $ mount -t glusterfs -obackup-volfile-servers=<[ipv6_addr2]>:       <[ipv6_addr3]>:...:<[ipv6_addrN]> <ipv6_addr1>:/<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]

inode-table-size=N

Set the inode hash table size to N - this must be a power of 2 greater than or equal to 65536 and will be rounded up if not [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

See Also

glusterfs(8), mount(8), gluster(8)

Referenced By

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

Cluster Filesystem 14 September 2013 Red Hat, Inc.