GlusterFS(8)

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

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)

COPYRIGHT
Copyright(c) 2006-2013 Red Hat, Inc. <http://www.redhat.com>