Whamcloud - gitweb
b=16432
[fs/lustre-release.git] / lustre / doc / mount.lustre.8
1 .\" -*- nroff -*-
2 .\" Copyright 2008 by Sun Microsystems.  All Rights Reserved.
3 .\" This file may be copied under the terms of the GNU Public License v2.
4 .\"
5 .TH mount.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
6 .SH NAME
7 mount.lustre \- start a Lustre client or target service 
8 .SH SYNOPSIS
9 .br
10 .BI "mount \-t lustre [\-o " options "] " directory
11 .SH DESCRIPTION
12 .B mount.lustre
13 is used to start a Lustre client or target service.  This program should not be
14 called directly; rather it is a helper program invoked through 
15 .BR mount (8)
16 as above.  Lustre clients and targets are stopped by using the 
17 .BR umount (8)
18 command.
19 .br
20
21 There are two forms for the 
22 .I device
23 option, depending on whether a client or a target service is started:
24 .TP
25 .IR <mgsspec> :/ <fsname>
26 mounts the Lustre filesystem named
27 .I fsname
28 on the client by contacting the Management Service at 
29 .IR mgsspec 
30 on the pathname given by
31 .IR directory .
32 The format for
33 .I mgsspec
34 is defined below.  A mounted client filesystem appears in
35 .BR fstab (5)
36 and is usable like any local filesystem and provides a full
37 POSIX-compilant interface.
38 .TP
39 .I disk_device
40 starts the target service defined by the 
41 .I mkfs.lustre
42 command on the physical disk
43 .IR disk_device .  
44 A mounted target service filesystem is only useful for
45 .BR df (1)
46 operations and appears in
47 .BR fstab (5)
48 to show the device is in use.
49 .SH OPTIONS
50 .TP
51 .BI <mgsspec>:= <mgsnode>[:<mgsnode>]
52 The mgs specification may be a colon-separated list of nodes:
53 .TP
54 .BI <mgsnode>:= <mgsnid>[,<mgsnid>]
55 each node may be specified by a comma-separated list of NIDs.
56 .PP
57 In addition to the standard options listed in
58 .BR mount (8),
59 Lustre understands the following
60 .B client-specific
61 options:
62 .TP
63 .BI flock
64 Enable full flock support, coherent across all client nodes.
65 .TP
66 .BI localflock
67 Enable local flock support, using only client-local flock (faster, for applications that require flock but do not run on multiple nodes).
68 .TP
69 .BI noflock
70 Disable flock support entirely.  Applications calling flock will get an error.
71 .TP
72 .BI user_xattr
73 Enable get/set of extended attributes by regular users.  See the
74 .BR attr (5)
75 manual page.
76 .TP
77 .BI nouser_xattr
78 Disable use of extended attributes by regular users.  Root and system processes can still use extended attributes.
79 .TP
80 .BI acl
81 Enable POSIX Access Control List support.  See the
82 .BR acl (5)
83 manual page.
84 .TP
85 .BI noacl
86 Disable Access Control List support.
87 .PP
88 In addition to the standard mount options and backing disk type
89 (e.g. ext3) options listed in
90 .BR mount (8),
91 Lustre understands the following
92 .B server-specific
93 options:
94 .TP
95 .BI nosvc
96 Only start the MGC (and MGS, if co-located) for a target service, and not the actual service.
97 .TP
98 .BI nomgs
99 Start a MDT with a co-located MGS without starting the MGS.
100 .TP
101 .BI exclude= ostlist
102 Start a client or MDT with a (colon-separated) list of known inactive OSTs.
103 .TP
104 .BI abort_recov
105 Abort client recovery and start the target service immediately.
106 .SH EXAMPLES
107 .TP
108 .B mount -t lustre cfs21@tcp0:/testfs /mnt/myfilesystem
109 Start a client for the Lustre filesystem 'testfs' at the mount point
110 /mnt/myfilesystem. The Management Service is running on a node reachable
111 from this client via the nid cfs21@tcp0.
112 .TP
113 .B mount -t lustre /dev/sda1 /mnt/test/mdt
114 Start the Lustre metadata target service from /dev/sda1 on mountpoint /mnt/test/mdt.
115 .TP
116 .B mount -t lustre -L testfs-MDT0000 -o abort_recov /mnt/test/mdt
117 Start the testfs-MDT0000 service (by using the disk label), but abort the
118 recovery process.
119 .SH NOTES
120 If the Service Tags tool (from the sun-servicetag package) can be found in
121 /opt/sun/servicetag/bin/stclient an inventory service tag will be created
122 reflecting the Lustre service being provided.  If this tool cannot be found
123 .B mount.lustre
124 will silently ignore it and no service tag is created.  The
125 .BR stclient (1)
126 tool only creates the local service tag.  No information is sent to the asset
127 management system until you run the Registration Client to collect the tags
128 and then upload them to the inventory system using your inventory system account.
129 See https://inventory.sun.com/ for more details on a web-based, free, IT asset
130 management system.
131 .SH BUGS
132 Not very many mount options can be changed with
133 .BR "-o remount" .
134 Please report all bugs to Sun Microsystems using http://bugzilla.lustre.org/
135 .SH AVAILABILITY
136 .B mount.lustre
137 is part of the 
138 .BR Lustre (7) 
139 filesystem package and is available from Sun Microsystems, Inc.
140 .br
141 http://downloads.lustre.org
142 .SH SEE ALSO
143 .BR Lustre (7),
144 .BR mount (8),
145 .BR mkfs.lustre (8),
146 .BR tunefs.lustre (8),
147 .BR lctl (8),
148 .BR lfs (1)