NAME
mount.lustre - start a Lustre client or target service
SYNOPSIS
mount -t lustre [-o options] directory
DESCRIPTION
mount.lustre is used to start a Lustre client or target service. This
program should not be called directly; rather it is a helper program
invoked through mount(8) as above. Lustre clients and targets are
stopped by using the umount(8) command.
There are two forms for the device option, depending on whether a
client or a target service is started:
<mgsspec>:/<fsname>
mounts the Lustre filesystem named fsname on the client by
contacting the Management Service at mgsspec on the pathname
given by directory. The format for mgsspec is defined below. A
mounted client filesystem appears in fstab(5) and is usable like
any local filesystem and provides a full POSIX-compilant
interface.
disk_device
starts the target service defined by the mkfs.lustre command on
the physical disk disk_device. A mounted target service
filesystem is only useful for df(1) operations and appears in
fstab(5) to show the device is in use.
OPTIONS
<mgsspec>:=<mgsnode>[:<mgsnode>]
The mgs specification may be a colon-separated list of nodes:
<mgsnode>:=<mgsnid>[,<mgsnid>]
each node may be specified by a comma-separated list of NIDs.
In addition to the standard options listed in mount(8), Lustre
understands the following client-specific options:
flock Enable full flock support, coherent across all client nodes.
localflock
Enable local flock support, using only client-local flock
(faster, for applications that require flock but do not run on
multiple nodes).
noflock
Disable flock support entirely. Applications calling flock will
get an error.
user_xattr
Enable get/set of extended attributes by regular users. See the
attr(5) manual page.
nouser_xattr
Disable use of extended attributes by regular users. Root and
system processes can still use extended attributes.
acl Enable POSIX Access Control List support. See the acl(5) manual
page.
noacl Disable Access Control List support.
In addition to the standard mount options and backing disk type (e.g.
ext3) options listed in mount(8), Lustre understands the following
server-specific options:
nosvc Only start the MGC (and MGS, if co-located) for a target
service, and not the actual service.
nomgs Start a MDT with a co-located MGS without starting the MGS.
exclude=ostlist
Start a client or MDT with a (colon-separated) list of known
inactive OSTs.
abort_recov
Abort client recovery and start the target service immediately.
md_stripe_cache_size
Sets the stripe cache size for server side disk with a striped
raid configuration.
recovery_time_soft=timeout
Allow ’timeout’ seconds for clients to reconnect for recovery
after a server crash. This timeout will be incrementally
extended if it is about to expire and the server is still
handling new connections from recoverable clients. The default
soft recovery timeout is set to 300 seconds (5 minutes).
recovery_time_hard=timeout
The server will be allowed to incrementally extend its timeout
up to a hard maximum of ’timeout’ seconds. The default hard
recovery timeout is set to 900 seconds (15 minutes).
EXAMPLES
mount -t lustre cfs21@tcp0:/testfs /mnt/myfilesystem
Start a client for the Lustre filesystem ’testfs’ at the mount
point /mnt/myfilesystem. The Management Service is running on a
node reachable from this client via the nid cfs21@tcp0.
mount -t lustre /dev/sda1 /mnt/test/mdt
Start the Lustre metadata target service from /dev/sda1 on
mountpoint /mnt/test/mdt.
mount -t lustre -L testfs-MDT0000 -o abort_recov /mnt/test/mdt
Start the testfs-MDT0000 service (by using the disk label), but
abort the recovery process.
NOTES
If the Service Tags tool (from the sun-servicetag package) can be found
in /opt/sun/servicetag/bin/stclient an inventory service tag will be
created reflecting the Lustre service being provided. If this tool
cannot be found mount.lustre will silently ignore it and no service tag
is created. The stclient(1) tool only creates the local service tag.
No information is sent to the asset management system until you run the
Registration Client to collect the tags and then upload them to the
inventory system using your inventory system account. See
https://inventory.sun.com/ for more details on a web-based, free, IT
asset management system.
BUGS
Not very many mount options can be changed with -o remount. Please
report all bugs to Sun Microsystems using http://bugzilla.lustre.org/
AVAILABILITY
mount.lustre is part of the Lustre(7) filesystem package and is
available from Sun Microsystems, Inc.
http://downloads.lustre.org
SEE ALSO
Lustre(7), mount(8), mkfs.lustre(8), tunefs.lustre(8), lctl(8), lfs(1)