pstorage-mount − mount client for working with Pstorage clusters
pstorage−mount −c CLUSTER_NAME mount_point [other options]
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.
−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.
−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.
−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
0
Success
Non−zero
Failure (syntax or usage error; configuration error; cluster failure; unexpected error).
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.
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
/sbin/mount.fuse.pstorage
Copyright © 2011−2013, Parallels, Inc. All rights reserved.
pstorage−overview(7), pstorage−ssd(7)