190 lines
6.4 KiB
Groff
190 lines
6.4 KiB
Groff
.TH mount.xtreemfs 1 "July 2011" "The XtreemFS Distributed File System" "XtreemFS client"
|
|
.SH NAME
|
|
mount.xtreemfs \- mounts an XtreemFS volume
|
|
.SH SYNOPSIS
|
|
\fBmount.xtreemfs [\fIoptions\fB] [pbrpc[g|s]://]\fIdir-host\fR[:\fIport\fR]/\fIvolume mountpoint
|
|
.br
|
|
|
|
.SH DESCRIPTION
|
|
.I mount.xtreemfs
|
|
mounts the volume \fIvolume\fR registered at the Directory Service \fIdir-host\fR:\fIport\fR to the local directory \fImountpoint\fR. \fImount.xtreemfs\fR is implemented as a FUSE user-level file system driver.
|
|
|
|
.SH EXAMPLE USAGE
|
|
.TP
|
|
Mount the volume "MyVolume" (which is registered at the DIR server "remote.dirservice.machine") to the mount point "/mnt":
|
|
.TP
|
|
.B "mount.xtreemfs remote.dirservice.machine/MyVolume /mnt"
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
Fuse Options:
|
|
.TP
|
|
.B "-f, \--foreground"
|
|
Do not fork into background.
|
|
.TP
|
|
.BI "-o, \--fuse_option " option
|
|
Passes \-o=<\fIoption\fR> to Fuse.
|
|
|
|
.TP
|
|
ACL and extended attributes Support:
|
|
.TP
|
|
.B "-o xtreemfs_acl"
|
|
Enable the correct evaluation of XtreemFS ACLs. (Note that you cannot use the system tools getfattr and setfattr; use
|
|
.BR xtfsutil (1)
|
|
instead to set and retrieve ACLs.)
|
|
.TP
|
|
.B "-o user_xattr"
|
|
Enable user defined extended attributes.
|
|
|
|
.TP
|
|
General Options:
|
|
.TP
|
|
.BI "-d, \--log-level " EMERG|ALERT|CRIT|ERR|WARNING|NOTICE|INFO|DEBUG
|
|
The log level of the XtreemFS client.
|
|
.TP
|
|
.B "-h, \--help"
|
|
Print help and exit.
|
|
.TP
|
|
.BI "-l, \--log-file-path " log_file_path
|
|
Path to log file.
|
|
.TP
|
|
.BI "-V, \--version"
|
|
Shows the version number.
|
|
|
|
.TP
|
|
Optimizations:
|
|
.TP
|
|
.BI "--metadata-cache-size " size
|
|
Number of entries which will be cached. (Set to 0 to disable the cache.)
|
|
.TP
|
|
.BI "--metadata-cache-ttl-s " ttl
|
|
Time to live after which cached entries will expire.
|
|
.TP
|
|
.BI "--enable-async-writes"
|
|
Enables asynchronous writes.
|
|
.TP
|
|
.BI "--async-writes-max-reqs " count
|
|
Maximum number of pending write requests per file. Asynchronous writes will block if this limit is reached first.
|
|
.TP
|
|
.BI "--readdir-chunk-size " size
|
|
Number of directory entries which will be fetched from the MRC per readdir request. Do not set this value too high - otherwise the MRC will spent too much time generating the response containing thousands of directory entries. In general, you should not have directories with multiple thousands of entries. If you stick to this, all directory entries are fetched with one request as long as this value is lower than the number of entries.
|
|
|
|
.TP
|
|
Error Handling options:
|
|
.TP
|
|
.BI "--max-tries " attempts
|
|
Maximum number of
|
|
.I attempts
|
|
to send a request (0 means infinite).
|
|
.TP
|
|
.BI "--max-read-tries " attempts
|
|
Maximum number of
|
|
.I attempts
|
|
to send a
|
|
.I read
|
|
request (0 means infinite).
|
|
.TP
|
|
.BI "--max-write-tries " attempts
|
|
Maximum number of
|
|
.I attempts
|
|
to send a
|
|
.I write
|
|
request (0 means infinite).
|
|
.TP
|
|
.BI "--retry-delay " delay
|
|
Wait time after a request failed until next attempt (in seconds).
|
|
.TP
|
|
.BI "--connect-timeout " connection-timeout
|
|
Timeout after which a connection attempt will be retried (in seconds).
|
|
.TP
|
|
.BI "--request-timeout " timeout
|
|
Timeout after which a request will be retried (in seconds).
|
|
.TP
|
|
.BI "--linger-timeout " linger-time
|
|
Time after which idle connections will be closed (in seconds).
|
|
|
|
.TP
|
|
SSL Options:
|
|
.TP
|
|
.BI "--pem-certificate-file-path " certfile
|
|
Path to PEM certificate file (for SSL installations only).
|
|
.TP
|
|
.BI "--pem-private-key-file-path " file
|
|
Path to PEM private key file (for SSL installations only).
|
|
.TP
|
|
.BI "--pem-private-key-passphrase " pass
|
|
Passphrase for PEM private key file (for SSL installations only). If the argument \fIpass\fR is set to "-", the user will be prompted for the passphrase.
|
|
.TP
|
|
.BI "--pkcs12-file-path " file
|
|
Path to PKCS#12 file (for SSL installations only).
|
|
.TP
|
|
.BI "--pkcs12-passphrase " pass
|
|
Passphrase for PKCS#12 file (for SSL installations only). If the argument \fIpass\fR is set to "-", the user will be prompted for the passphrase.
|
|
|
|
.TP
|
|
Grid Support options:
|
|
.TP
|
|
.B "--grid-ssl "
|
|
Explicitily use the XtreemFS Grid-SSL mode. Same as specifying pbrpcg:// in the volume URL.
|
|
.TP
|
|
.B "--globus-gridmap"
|
|
Authorize using globus gridmap file.
|
|
.TP
|
|
.B "--unicore-gridmap"
|
|
Authorize using unicore gridmap file.
|
|
.TP
|
|
.BI "--gridmap-location " path
|
|
Location of the gridmap file. If this option is not set, the default path will be used, depending on the chosen gridmap file:
|
|
.RS
|
|
Unicore default: /etc/grid-security/d-grid_uudb
|
|
Globus default: /etc/grid-security/grid-mapfile
|
|
.RE
|
|
.TP
|
|
.BI "--gridmap-reload-interval-m " interval
|
|
Interval (in minutes) after which the gridmap file will be checked for changes and reloaded if necessary. 60 minutes by default.
|
|
|
|
.TP
|
|
Vivaldi options:
|
|
.TP
|
|
.B "--vivaldi-enable"
|
|
Enables the vivaldi coordinate calculation for the client.
|
|
.TP
|
|
.B "--vivaldi-enable-dir-updates"
|
|
Enables sending the coordinates to the DIR after each recalculation. This is only needed to add the clients to the vivaldi visualization at the cost of some additional traffic between client and DIR.
|
|
.TP
|
|
.B "--vivaldi-filename " path
|
|
The file where the vivaldi coordinates should be saved after each recalculation.
|
|
.TP
|
|
.BI "--vivaldi-recalculation-interval " seconds
|
|
The interval between coordinate recalculations in seconds. Also see vivaldi-recalculation-epsilon.
|
|
.TP
|
|
.BI "--vivaldi-recalculation-epsilon " seconds
|
|
The recalculation interval will be randomly chosen from vivaldi-recalculation-inverval +/- vivaldi-recalculation-epsilon.
|
|
.TP
|
|
.BI "--vivaldi-max-iterations-before-updating " count
|
|
Number of coordinate recalculations before updating the list of OSDs.
|
|
.TP
|
|
.BI "--vivaldi-max-request-retries " retries
|
|
Maximal number of retries when requesting coordinates from another vivaldi node.
|
|
|
|
.SH "SEE ALSO"
|
|
.BR lsfs.xtreemfs (1),
|
|
.BR mkfs.xtreemfs (1),
|
|
.BR rmfs.xtreemfs (1),
|
|
.BR umount.xtreemfs (1),
|
|
.BR xtfsutil (1)
|
|
.BR
|
|
|
|
.SH "KNOWN ISSUES"
|
|
FUSE does not support mmap in connection with direct I/O. In order to get applications running on XtreemFS that rely on mmap, volumes have to be mounted without using the FUSE option
|
|
.BR "-o direct_io" .
|
|
However, this might lead to inconsistencies if different clients access a file concurrently, as requests might be serviced from the local page cache.
|
|
|
|
If
|
|
.B "-o xtreemfs_acl"
|
|
or a gridmap file is used, the Fuse default permissions check will be disabled. In consequence, the Fuse Option "\-o default_permissions" will not be sent to Fuse. In these cases, the content of the metadata cache may be spoofed by users although they are not allowed to list the directory or retrieve the stat information of a file.
|
|
|
|
.SH AVAILABILITY
|
|
The mount.xtreemfs command is part of the XtreemFS-client package and is available from \fIhttp://www.xtreemfs.org\fP.
|