Whamcloud - gitweb
land 1.0.1 fixes on main development branch (head)
[fs/lustre-release.git] / lustre / doc / lfs.lyx
1 #LyX 1.3 created this file. For more info see http://www.lyx.org/
2 \lyxformat 221
3 \textclass amsart
4 \language english
5 \inputencoding auto
6 \fontscheme times
7 \graphics default
8 \paperfontsize default
9 \spacing single 
10 \papersize letterpaper
11 \paperpackage a4
12 \use_geometry 0
13 \use_amsmath 0
14 \use_natbib 0
15 \use_numerical_citations 0
16 \paperorientation portrait
17 \secnumdepth 3
18 \tocdepth 3
19 \paragraph_separation skip
20 \defskip medskip
21 \quotes_language english
22 \quotes_times 2
23 \papercolumns 1
24 \papersides 1
25 \paperpagestyle default
26
27 \layout Section
28
29 LFS
30 \layout Subsection
31
32 NAME
33 \layout Description
34
35 lfs Lustre utility to create a file with specific striping pattern
36 \layout Subsection
37
38 SYNOPSIS
39 \layout Standard
40
41
42 \series bold 
43 lfs
44 \layout Standard
45
46
47 \series bold 
48 lfs\SpecialChar ~
49 find [--obd <uuid>] [--quiet | --verbose] [--recursive] <dir|file>
50 \layout Standard
51
52
53 \series bold 
54 lfs\SpecialChar ~
55 getstripe <file_name> 
56 \layout Standard
57
58
59 \series bold 
60 lfs\SpecialChar ~
61 setstripe <filename> <stripe_size> <start_ost> <stripe_cnt>
62 \layout Standard
63
64
65 \series bold 
66 lfs\SpecialChar ~
67 check <mds| osts| servers>
68 \layout Subsection
69
70 DESCRIPTION
71 \layout Standard
72
73 This utility can be used to create a new file with a specific striping pattern,
74  determine the default striping pattern, gather the extended attributes
75  (object numbers and location) for a specific file.
76  It can be invoked interactively without any arguments or in a non-interactive
77  mode with one of the arguements listed and explained below:
78 \layout List
79 \labelwidthstring 00.00.0000
80
81
82 \series bold 
83 setstripe
84 \series default 
85  To create a new file with a specific striping pattern
86 \layout List
87 \labelwidthstring 00.00.0000
88
89
90 \series bold 
91 find
92 \series default 
93  To list the extended attributes for a given filename or files in a directory
94  or recursively for all files in a directory tree.
95  It can also be used to list the files that have objects on a specific OST.
96  
97 \layout List
98 \labelwidthstring 00.00.0000
99
100
101 \series bold 
102 getstripe
103 \series default 
104  To list the striping pattern for given filename
105 \layout List
106 \labelwidthstring 00.00.0000
107
108
109 \series bold 
110 check 
111 \series default 
112 Display the status of MDS or OSTs (as specified in the command) or all the
113  servers (MDS and OSTs)
114 \layout List
115 \labelwidthstring 00.00.0000
116
117
118 \series bold 
119 osts
120 \series default 
121  List all the OSTs for the filesystem
122 \layout List
123 \labelwidthstring 00.00.0000
124
125
126 \series bold 
127 help
128 \series default 
129  Provides brief help on the various arguments
130 \layout List
131 \labelwidthstring 00.00.0000
132
133
134 \series bold 
135 exit/quit
136 \series default 
137  Quit the interactive lfs session
138 \layout Subsection
139
140 EXAMPLES
141 \layout Description
142
143 Creating\SpecialChar ~
144 a\SpecialChar ~
145 file\SpecialChar ~
146 striped\SpecialChar ~
147 on\SpecialChar ~
148 one\SpecialChar ~
149 OST
150 \layout LyX-Code
151
152    $lfs setstripe /mnt/lustre/file1 131072 0 1
153 \layout Description
154
155 Listing
156 \series bold 
157 \SpecialChar ~
158
159 \series default 
160 the
161 \series bold 
162 \SpecialChar ~
163
164 \series default 
165 extended
166 \series bold 
167 \SpecialChar ~
168
169 \series default 
170 attributes
171 \series bold 
172 \SpecialChar ~
173
174 \series default 
175 of
176 \series bold 
177 \SpecialChar ~
178
179 \series default 
180 a
181 \series bold 
182 \SpecialChar ~
183
184 \series default 
185 given
186 \series bold 
187 \SpecialChar ~
188
189 \series default 
190 file
191 \layout LyX-Code
192
193    $lfs find /mnt/lustre/foo1
194 \layout LyX-Code
195
196    OBDS:    
197 \layout LyX-Code
198
199       0: OST_localhost_UUID 
200 \layout LyX-Code
201
202    /mnt/lustre/foo1         
203 \layout LyX-Code
204
205    obdidx           objid          objid            group              
206 \layout LyX-Code
207
208    0                 1            0x1                0 
209 \layout Description
210
211 Listing\SpecialChar ~
212 the\SpecialChar ~
213 extended\SpecialChar ~
214 attributes\SpecialChar ~
215 of\SpecialChar ~
216 all\SpecialChar ~
217 files\SpecialChar ~
218 in\SpecialChar ~
219 a\SpecialChar ~
220 given\SpecialChar ~
221 directory
222 \layout LyX-Code
223
224    $lfs find /mnt/lustre/
225 \layout Description
226
227 Recursively\SpecialChar ~
228 list\SpecialChar ~
229 the\SpecialChar ~
230 extended\SpecialChar ~
231 attributes\SpecialChar ~
232 of\SpecialChar ~
233 all\SpecialChar ~
234 files\SpecialChar ~
235 in\SpecialChar ~
236 a\SpecialChar ~
237 given\SpecialChar ~
238 directory\SpecialChar ~
239 tree
240 \layout LyX-Code
241
242    $lfs find -r /mnt/lustre/
243 \layout Description
244
245 List\SpecialChar ~
246 all\SpecialChar ~
247 the\SpecialChar ~
248 files\SpecialChar ~
249 that\SpecialChar ~
250 have\SpecialChar ~
251 objects\SpecialChar ~
252 on\SpecialChar ~
253 a\SpecialChar ~
254 specific\SpecialChar ~
255 OST
256 \layout LyX-Code
257
258    $lfs find -r --obd OST2_UUID /mnt/lustre/
259 \layout Description
260
261 Check\SpecialChar ~
262 the\SpecialChar ~
263 status\SpecialChar ~
264 of\SpecialChar ~
265 all\SpecialChar ~
266 servers(mds,\SpecialChar ~
267 osts)
268 \layout LyX-Code
269
270    $lfs check servers 
271 \layout LyX-Code
272
273    OSC_localhost.localdomain_OST_localhost_mds1 active.
274  
275 \layout LyX-Code
276
277    OSC_localhost.localdomain_OST_localhost_MNT_localhost active.
278  
279 \layout LyX-Code
280
281    MDC_localhost.localdomain_mds1_MNT_localhost active.
282 \layout LyX-Code
283
284    $
285 \layout Description
286
287 List\SpecialChar ~
288 all\SpecialChar ~
289 the\SpecialChar ~
290 OSTs
291 \layout LyX-Code
292
293    $lfs osts 
294 \layout LyX-Code
295
296    OBDS:    
297 \layout LyX-Code
298
299    0: OST_localhost_UUID   
300 \layout LyX-Code
301
302    $
303 \layout Subsection
304
305 BUGS
306 \layout Standard
307
308 None are known.
309 \the_end