PSTORAGE−MOUNT

NAME
SYNOPSIS
DESCRIPTION
GENERAL OPTIONS
LOCAL (SSD) CACHING OPTIONS
ADVANCED OPTIONS
EXIT STATUS
FSTAB ENTRY
EXAMPLES
FILES
AUTHOR
SEE ALSO

NAME

pstorage-mount − mount client for working with Pstorage clusters

SYNOPSIS

pstorage−mount −c CLUSTER_NAME mount_point [other options]

DESCRIPTION

Pstorage mount client provides a convenient way to access a Pstorage cluster as a file system, manage the global namespace, and upload/download image files using conventional tools like cp or tar. You can mount the FUSE client using pstorage−mount. Internally, pstorage−mount uses libpcs_client, so MDS discovery rules apply to the former as well (see pstorage−discovery(1)).

Note: Although the mount client provides a file system interface to Pstorage clusters, it does not provide full POSIX semantics and should not be used as a conventional file system. For example, it lacks hard links, users and some other POSIX features.

Note: Pstorage file system is not optimized for small files and, therefore, is not recommended for use in benchmarks. If you want to benchmark a performance do this from inside the Containers, Virtual Machines or over ploop/ext4 images.

GENERAL OPTIONS

−c CLUSTER_NAME

Set the name of the cluster to connect to.

−l LOGFILE

Set the log file to write all output to.

−L NUMxSIZE

Set the number of rotated log files and their maximum size.

−d LOGLEVEL

Set the verbosity level.

−v

Increase the verbosity level.

LOCAL (SSD) CACHING OPTIONS

−C CACHEFILE

Set the read cache file path (mandatory).

−R Mbytes

The read cache total size, in megabytes. If this parameter is not specified and the valid cache file cannot be found, the size is calculated from the free space available on the device where the cache file is located.

−B Mbytes

Boot cache size, in megabytes (the default is 1/8 of the total size).

−S

Disable the read cache checksum protection (enabled by default).

−b Kbytes

Set the read cache block size, in kilobytes (default is 64K).

See pstorage−ssd(7) for the cache discussion.

ADVANCED OPTIONS

−u user

Set mount owner user name.

−g group

Set mount owner group name.

−m mode

Set access mode (octal). For ex., −m 750 to enable read−only access for the group members.

−t TIMEOUT

Set the request timeout (in seconds).

−i

Interactive mode (do not demonize).

−f flags

Set additional mount flags. For ex., −f 1 to mount the cluster read only.

−s

Add entry to /etc/fstab (or update existing).

−−fail−on−nospace

Fail IO with ENOSPACE if current cluster capacity is exhausted

EXIT STATUS

0

Success

Non−zero

Failure (syntax or usage error; configuration error; cluster failure; unexpected error).

FSTAB ENTRY

The description of static pstorage mount points may be added to /etc/fstab to allow mounting with the mount command. The first column must contain the target cluster name, the second column must define the mount point, and the third column must specify fuse.pstorage as the filesystem type. The forth column may contain the options below; these options are translated to pstorage−mount command−line arguments by the /sbin/mount.fuse.pstorage mount script:

logfile=LOGFILE, loglevel=LOGLEVEL, cache=CACHEFILE, cachesize=MBytes, cachebootsize=MBytes, cachechksum=(y|n), cacheblock=KBytes, user=USER_NAME, group=GROUP_NAME, mode=ACCESS_MODE, timeout=TIMEOUT_SEC, flags=MOUNT_FLAGS

All listed options are optional. If the noauto option is omitted, the pstorage file system is mounted on system startup. Default logfile is /var/log/pstorage/$PSTORAGE_NAME/pstorage−mount.log.gz.

EXAMPLES

Mount without the cache:

pstorage−mount −c mycluster /pstorage The corresponding /etc/fstab entry: mycluster /pstorage fuse.pstorage defaults 0 0

Mount with the default cache size:

pstorage−mount −c mycluster /pstorage −C /mnt/ssd/mycluster_cache The corresponding /etc/fstab entry: mycluster /pstorage fuse.pstorage defaults,cache=/mnt/ssd/mycluster_cache 0 0

Mount with the 64 GB cache and the checksum disabled:

pstorage−mount −c mycluster /pstorage −C /mnt/ssd/mycluster_cache −R 64000 −S The corresponding /etc/fstab entry: mycluster /pstorage fuse.pstorage defaults,cache=/mnt/ssd/mycluster_cache,cachesize=64000,cachechksum=n 0 0

Mount cluster read−only:

pstorage−mount −c mycluster /pstorage −f 1 The corresponding /etc/fstab entry: mycluster /pstorage fuse.pstorage flags=1 0 0

Mount with read−only access for non−root users:

pstorage−mount −c mycluster /pstorage −m 755 The corresponding /etc/fstab entry: mycluster /pstorage fuse.pstorage mode=755 0 0

Mount with read−only access for www−data group members:

pstorage−mount −c mycluster /pstorage −g www−data −m 750 The corresponding /etc/fstab entry: mycluster /pstorage fuse.pstorage group=www−data,mode=750 0 0

FILES

/sbin/mount.fuse.pstorage

AUTHOR

Copyright © 2011−2013, Parallels, Inc. All rights reserved.

SEE ALSO

pstorage−overview(7), pstorage−ssd(7)