2 .\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
4 .\" Copyright (c) 2011, 2012, Intel Corporation.
6 .\" This file may be copied under the terms of the GNU Public License v2.
8 .TH mount.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
10 mount.lustre \- start a Lustre client or target service
13 .BI "mount \-t lustre [\-o " options "] " directory
16 is used to start a Lustre client or target service. This program should not be
17 called directly; rather it is a helper program invoked through
19 as above. Lustre clients and targets are stopped by using the
24 There are two forms for the
26 option, depending on whether a client or a target service is started:
28 .IR <mgsspec> :/ <fsname>
29 mounts the Lustre filesystem named
31 on the client by contacting the Management Service at
33 on the pathname given by
37 is defined below. A mounted client filesystem appears in
39 and is usable like any local filesystem and provides a full
40 POSIX-compilant interface.
43 starts the target service defined by the
45 command on the physical disk
47 A mounted target service filesystem is only useful for
49 operations and appears in
51 to show the device is in use.
54 .BI <mgsspec>:= <mgsnode>[:<mgsnode>]
55 The mgs specification may be a colon-separated list of nodes:
57 .BI <mgsnode>:= <mgsnid>[,<mgsnid>]
58 each node may be specified by a comma-separated list of NIDs.
60 In addition to the standard options listed in
62 Lustre understands the following
67 Enable full flock support, coherent across all client nodes.
70 Enable local flock support, using only client-local flock (faster, for applications that require flock but do not run on multiple nodes).
73 Disable flock support entirely. Applications calling flock will get an error.
76 Enable get/set of extended attributes by regular users. See the
81 Disable use of extended attributes by regular users. Root and system processes can still use extended attributes.
84 Enable POSIX Access Control List support. See the
89 Disable Access Control List support.
92 Force a client to keep pinging even if servers have enabled suppress_pings.
95 Enable mount/umount console messages.
98 Disable mount/umount console messages.
101 Enable FID to path translation by regular users.
104 Disable FID to path translation by regular users. Root and process with
105 CAP_DAC_READ_SEARCH can still perform FID to path translation.
107 In addition to the standard mount options and backing disk type
108 (e.g. ext3) options listed in
110 Lustre understands the following
115 Only start the MGC (and MGS, if co-located) for a target service, and not the actual service.
118 Start a MDT with a co-located MGS without starting the MGS.
121 Not trigger OI scrub automatically when detect some inconsistency, unless it is started explicitly.
124 Not resume the former paused/crashed LFSCK automatically when mount.
127 Start a client or MDT with a (colon-separated) list of known inactive OSTs.
130 Abort client recovery and start the target service immediately.
132 .BI md_stripe_cache_size
133 Sets the stripe cache size for server side disk with a striped raid
136 .BI recovery_time_soft= timeout
137 Allow 'timeout' seconds for clients to reconnect for recovery after a server
138 crash. This timeout will be incrementally extended if it is about to expire
139 and the server is still handling new connections from recoverable clients.
140 The default soft recovery timeout is set to 300 seconds (5 minutes).
142 .BI recovery_time_hard= timeout
143 The server will be allowed to incrementally extend its timeout up to a hard
144 maximum of 'timeout' seconds. The default hard recovery timeout is set to
145 900 seconds (15 minutes).
148 .B mount -t lustre cfs21@tcp0:/testfs /mnt/myfilesystem
149 Start a client for the Lustre filesystem 'testfs' at the mount point
150 /mnt/myfilesystem. The Management Service is running on a node reachable
151 from this client via the nid cfs21@tcp0.
153 .B mount -t lustre /dev/sda1 /mnt/test/mdt
154 Start the Lustre metadata target service from /dev/sda1 on mountpoint /mnt/test/mdt.
156 .B mount -t lustre -L testfs-MDT0000 -o abort_recov /mnt/test/mdt
157 Start the testfs-MDT0000 service (by using the disk label), but abort the
160 Not very many mount options can be changed with
171 .BR tunefs.lustre (8),