---
name: "mount.lustre"
section: "8"
platform: "linux"
package: "lustre-utils"
version: "1.8.3-4"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/mount.lustre"
---

# mount.lustre(8)

start a Lustre client or target service

## 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)](/mount/8.md) as above.  Lustre clients and targets are stopped by using the  [**umount**(8)](/umount/8.md) 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)](/fstab/5.md) 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)](/df/1.md) operations and appears in [**fstab**(5)](/fstab/5.md) 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)](/mount/8.md), 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)](/attr/5.md) 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)](/acl/5.md) 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)](/mount/8.md), 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)](/mount/8.md), [**mkfs.lustre**(8)](/mkfs.lustre/8.md), [**tunefs.lustre**(8)](/tunefs.lustre/8.md), **lctl**(8), **lfs**(1)