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 and manipulat
  36 e disk quotas
  37 \layout Subsection
  38
  39 SYNOPSIS
  40 \layout Standard
  41
  42
  43 \series bold
  44 lfs
  45 \layout Standard
  46
  47
  48 \series bold
  49 lfs\SpecialChar ~
  50 find [--obd <uuid>] [--quiet | --verbose] [--recursive] <dir|file>
  51 \layout Standard
  52
  53
  54 \series bold
  55 lfs\SpecialChar ~
  56 getstripe <filename>
  57 \layout Standard
  58
  59
  60 \series bold
  61 lfs\SpecialChar ~
  62 setstripe <filename|dirname> <stripe_size> <start_ost> <stripe_cnt>
  63 \layout Standard
  64
  65 \series bold
  66 lfs\SpecialChar ~
  67 setstripe -d <dirname>
  68 \layout Standard
  69
  70
  71 \series bold
  72 lfs\SpecialChar ~
  73 check <mds| osts| servers>
  74 \layout Standard
  75
  76
  77 \series bold
  78 lfs\SpecialChar ~
  79 quotachog [-i] <filesystem>
  80 \layout Standard
  81
  82
  83 \series bold
  84 lfs\SpecialChar ~
  85 quotacheck [-ug] <filesystem>
  86 \layout Standard
  87
  88
  89 \series bold
  90 lfs\SpecialChar ~
  91 quotaon [-ugf] <filesystem>
  92 \layout Standard
  93
  94
  95 \series bold
  96 lfs\SpecialChar ~
  97 quotaoff [-ug] <filesystem>
  98 \layout Standard
  99
 100
 101 \series bold
 102 lfs\SpecialChar ~
 103 setquota [-u|-g] <name> <block-softlimit> <block-hardlimit> <inode-softlimit>
 104  <inode-hardlimit> <filesystem>
 105 \layout Standard
 106
 107
 108 \series bold
 109 lfs\SpecialChar ~
 110 quota [-o obd_uuid] [-u|-g] <name> <filesystem>
 111 \layout Subsection
 112
 113 DESCRIPTION
 114 \layout Standard
 115
 116 This utility can be used to create a new file with a specific striping pattern,
 117  determine the default striping pattern, gather the extended attributes
 118  (object numbers and location) for a specific file, and manipulate disk
 119  quotas.
 120  It can be invoked interactively without any arguments or in a non-interactive
 121  mode with one of the arguements listed and explained below:
 122 \layout List
 123 \labelwidthstring 00.00.0000
 124
 125
 126 \series bold
 127 setstripe
 128 \series default
 129  To create a new file with a specific striping pattern
 130 \layout List
 131 \labelwidthstring 00.00.0000
 132
 133
 134 \series bold
 135 find
 136 \series default
 137  To list the extended attributes for a given filename or files in a directory
 138  or recursively for all files in a directory tree.
 139  It can also be used to list the files that have objects on a specific OST.
 140
 141 \layout List
 142 \labelwidthstring 00.00.0000
 143
 144
 145 \series bold
 146 getstripe
 147 \series default
 148  To list the striping pattern for given filename
 149 \layout List
 150 \labelwidthstring 00.00.0000
 151
 152
 153 \series bold
 154 check
 155 \series default
 156 Display the status of MDS or OSTs (as specified in the command) or all the
 157  servers (MDS and OSTs)
 158 \layout List
 159 \labelwidthstring 00.00.0000
 160
 161
 162 \series bold
 163 osts
 164 \series default
 165  List all the OSTs for the filesystem
 166 \layout List
 167 \labelwidthstring 00.00.0000
 168
 169
 170 \series bold
 171 quotachog
 172 \series default
 173  Change files' owner and group on OSTs of the specified filesystem
 174 \layout List
 175 \labelwidthstring 00.00.0000
 176
 177
 178 \series bold
 179 quotacheck
 180 \series default
 181  Scan the specified filesystem for disk usage, and create or update quota
 182  files
 183 \layout List
 184 \labelwidthstring 00.00.0000
 185
 186
 187 \series bold
 188 quotaon
 189 \series default
 190  Turn filesystem quotas on
 191 \layout List
 192 \labelwidthstring 00.00.0000
 193
 194
 195 \series bold
 196 quotaoff
 197 \series default
 198  Turn filesystem quotas off
 199 \layout List
 200 \labelwidthstring 00.00.0000
 201
 202
 203 \series bold
 204 setquota
 205 \series default
 206  Set filesystem quotas
 207 \layout List
 208 \labelwidthstring 00.00.0000
 209
 210
 211 \series bold
 212 quota
 213 \series default
 214  Display disk usage and limits
 215 \layout List
 216 \labelwidthstring 00.00.0000
 217
 218
 219 \series bold
 220 help
 221 \series default
 222  Provides brief help on the various arguments
 223 \layout List
 224 \labelwidthstring 00.00.0000
 225
 226
 227 \series bold
 228 exit/quit
 229 \series default
 230  Quit the interactive lfs session
 231 \layout Subsection
 232
 233 EXAMPLES
 234 \layout Description
 235
 236 This creates a file striped on one OST
 237 \layout LyX-Code
 238
 239    $ lfs setstripe /mnt/lustre/file1 131072 0 1
 240 \layout Description
 241
 242 This creates a default stripe pattern on and existing dir for all new files
 243  created therein.
 244 \layout LyX-Code
 245
 246    $ lfs setstripe /mnt/lustre/dir 131072 0 1
 247 \layout Description
 248
 249 This deletes a default stripe pattern on dir.  New files will use the
 250  default striping pattern.
 251  created therein.
 252 \layout LyX-Code
 253
 254    $ lfs setstripe -d /mnt/lustre/dir
 255 \layout Description
 256
 257 Listing the extended attributes of a given file
 258 \layout LyX-Code
 259
 260    $ lfs find /mnt/lustre/foo1
 261 \layout LyX-Code
 262
 263    OBDS:
 264 \layout LyX-Code
 265
 266       0: OST_localhost_UUID
 267 \layout LyX-Code
 268
 269    /mnt/lustre/foo1
 270 \layout LyX-Code
 271
 272    obdidx           objid          objid            group
 273 \layout LyX-Code
 274
 275    0                 1            0x1                0
 276 \layout Description
 277
 278 Listing the extended attributes of all files in a given directory
 279 \layout LyX-Code
 280
 281    $ lfs find /mnt/lustre/
 282 \layout Description
 283
 284 Recursively list the extended attributes of all files in a given directory
 285  tree
 286 \layout LyX-Code
 287
 288    $ lfs find -r /mnt/lustre/
 289 \layout Description
 290
 291 List all the files that have objects on a specific OST
 292 \layout LyX-Code
 293
 294    $ lfs find -r --obd OST2_UUID /mnt/lustre/
 295 \layout Description
 296
 297 Check the status of all servers(mds, osts)
 298 \layout LyX-Code
 299
 300    $ lfs check servers
 301 \layout LyX-Code
 302
 303    OSC_localhost.localdomain_OST_localhost_mds1 active.
 304
 305 \layout LyX-Code
 306
 307    OSC_localhost.localdomain_OST_localhost_MNT_localhost active.
 308
 309 \layout LyX-Code
 310
 311    MDC_localhost.localdomain_mds1_MNT_localhost active.
 312 \layout LyX-Code
 313
 314    $
 315 \layout Description
 316
 317 List all the OSTs
 318 \layout LyX-Code
 319
 320    $ lfs osts
 321 \layout LyX-Code
 322
 323    OBDS:
 324 \layout LyX-Code
 325
 326    0: OST_localhost_UUID
 327 \layout LyX-Code
 328
 329    $
 330 \layout Description
 331
 332 Change\SpecialChar ~
 333 file\SpecialChar ~
 334 owner\SpecialChar ~
 335 and\SpecialChar ~
 336 group
 337 \layout LyX-Code
 338
 339    $lfs quotachog -i /mnt/lustre
 340 \layout Description
 341
 342 Quotacheck\SpecialChar ~
 343 for\SpecialChar ~
 344 user\SpecialChar ~
 345 and\SpecialChar ~
 346 group
 347 \layout LyX-Code
 348
 349    $lfs quotacheck -ug /mnt/lustre
 350 \layout Description
 351
 352 Turn\SpecialChar ~
 353 quotas\SpecialChar ~
 354 of\SpecialChar ~
 355 user\SpecialChar ~
 356 and\SpecialChar ~
 357 group\SpecialChar ~
 358 on
 359 \layout LyX-Code
 360
 361    $lfs quotaon -ug /mnt/lustre
 362 \layout Description
 363
 364 Turn\SpecialChar ~
 365 quotas\SpecialChar ~
 366 of\SpecialChar ~
 367 user\SpecialChar ~
 368 and\SpecialChar ~
 369 group\SpecialChar ~
 370 off
 371 \layout LyX-Code
 372
 373    $lfs quotaoff -ug /mnt/lustre
 374 \layout Description
 375
 376 Set\SpecialChar ~
 377 quotas\SpecialChar ~
 378 of\SpecialChar ~
 379 user\SpecialChar ~
 380 `bob':\SpecialChar ~
 381 1GB\SpecialChar ~
 382 block\SpecialChar ~
 383 quota\SpecialChar ~
 384 and\SpecialChar ~
 385 10,000\SpecialChar ~
 386 file\SpecialChar ~
 387 quota
 388 \layout LyX-Code
 389
 390    $lfs setquota -u bob 0 1000000 0 10000 /mnt/lustre
 391 \layout Description
 392
 393 List\SpecialChar ~
 394 quotas\SpecialChar ~
 395 of\SpecialChar ~
 396 user\SpecialChar ~
 397 `bob'
 398 \layout LyX-Code
 399
 400    $lfs quota -u bob /mnt/lustre
 401 \layout Subsection
 402
 403 BUGS
 404 \layout Standard
 405
 406 None are known.
 407 \the_end