NAME
lfs − helper utility to administrate lustre clusters
SYNOPSIS
lfs <options> [values]
DESCRIPTION
lfs lfs is used to administrate a lustre filesystem, you’ll need it to get or set various informations concerning the filesystem usage (e.g. striping, quota, osts, ..)
lfs can be invoked in interactive and non-interative mode. In order to use it interactive call lfs without arguments. The available commands in lfs are: setstripe , getstripe , find , check , catinfo , join , osts , df , quotachown , quotacheck , quotaon , quotaoff , setquota , quota , help , exit , quit
In order to get
help type lfs help
If you want more specific help on a command type lfs help
$command
where $command is one of the ones in the list above.
OPTIONS
setstripe:
Create a new file with a
specific striping pattern or set the default striping
pattern on an existing directory or delete the default
striping pattern from an existing directory
usage: setstripe <filename|dirname>
<stripe_size> <stripe_index>
<stripe_count>
or
setstripe <filename|dirname> [--size|-s stripe_size]
[--index|-i stripe_index]
[--count|-c stripe_count]
or
setstripe -d <dirname> (to delete default
striping)
stripe_size:
Number of bytes on each OST (0 filesystem default)
Can be specified with k, m or g (in KB, MB and GB
respectively)
stripe_index: OST index of first stripe (-1 filesystem
default)
stripe_count: Number of OSTs to stripe over (0 default, -1
all)
getstripe:
To list the striping info for a given filename or files in a directory or recursively for all files in a directory tree.
usage:
getstripe [--obd|-O <uuid>] [--quiet | -q] [--verbose
| -v]
[--recursive | -r] <dir|file> ...
|
find: |
To find files that match given parameters recursively in a directory tree. |
usage: find
<dir/file> ...
[[!] --atime|-A [+-]N] [[!] --mtime|-M [+-]N] [[!]
--ctime|-C [+-]N]
[--maxdepth|-D N] [[!] --name|-n <pattern>]
[--print0|-P]
[--print|-p] [--obd|-O <uuid>] [[!] --type|-t
<filetype>]
!: used before an option indicates ’NOT’ the
requested attribute
-: used before an value indicates ’AT MOST’ the
requested value
+: used before an option indicates ’AT LEAST’
the requested value
|
check: |
Display the status of MDS or OSTs (as specified in the command) or all the servers (MDS and OSTs). |
usage: check <osts|mds|servers>
catinfo:
Show information of specified type logs.
usage: catinfo
{keyword} [node name]
keywords are one of followings: config, deletions.
node name must be provided when use keyword config.
|
join: |
join two lustre files into one - join A, B, will be like cat B >> A & del B |
usage: join <filename_A> <filename_B>
|
osts: |
osts FIXME | ||
|
df: |
report filesystem disk space usage or inodes usageof each MDS/OSD. |
usage: df [-i] [-h] [path]
quotachown:
Change files’ owner or group on the specified filesystem.
usage:
quotachown [-i] <filesystem>
-i: ignore error if file is not exist
quotacheck:
Scan the specified filesystem for disk usage, and create, or update quota files.
usage: quotacheck [ -ug ] <filesystem>
quotaon:
Turn filesystem quotas on.
usage: quotaon [ -ugf ] <filesystem>
quotaoff:
Turn filesystem quotas off.
usage: quotaoff [ -ug ] <filesystem>
setquota:
Set filesystem quotas.
usage: setquota
[ -u | -g ] <name> <block-softlimit>
<block-hardlimit> <inode-softlimit>
<inode-hardlimit> <filesystem>
setquota -t [ -u | -g ] <block-grace>
<inode-grace> <filesystem>
|
quota: |
Display disk usage and limits. |
usage: quota [ -o obd_uuid ] [{-u|-g <name>}|-t] <filesystem>
|
help: |
help |
|||
|
exit: |
quit |
|||
|
quit: |
quit |
EXAMPLES
$ lfs setstripe /mnt/lustre/file1 131072 -1 2
This creats a file striped on two OSTs with 128kB on each stripe.
$ lfs setstripe -d /mnt/lustre/dir
This deletes a default stripe pattern on dir. New files will use the default striping pattern created therein.
$ lfs find /mnt/lustre/file1
Lists the object allocation of a given file
$ lfs find /mnt/lustre/
Lists the object allocationss of all files in a given directory
$ lfs find -r /mnt/lustre/
Recursively list the objects of all files in a given directory tree
$ lfs find -r --obd OST2-UUID /mnt/lustre/
Recursively list all files in a given directory that have objects on OST2-UUID.
$ lfs quotachown -i /mnt/lustre
Change file owner and group
$ lfs quotacheck -ug /mnt/lustre
Quotacheck for user and group - will turn on quotas after making the check.
$ lfs quotaon -ug /mnt/lustre
Turn quotas of user and group on
$ lfs quotaoff -ug /mnt/lustre
Turn quotas of user and group off
$ lfs setquota -u bob 0 1000000 0 10000 /mnt/lustre
Set quotas of user ’bob’: 1GB block quota and 10,000 file quota
$ lfs quota -u bob /mnt/lustre
List quotas of user ’bob’
$ lfs check servers
Check the status of all servers (MDT, OST)
$ lfs osts
List all the OSTs $ lfs df -i Lists inode consumpton per OST and MDT
SEE ALSO
lustre(7) Lustre(7), mount(8), mkfs.lustre(8), tunefs.lustre(8), lctl(8),
AUTHOR
lustre was written by ClusterFileSystems <info [AT] clusterfs.com>
This manpage was written by Patrick Winnertz <patrick.winnertz [AT] credativ.de> for the Debian GNU/Linux system (but may be used by others).
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License version 2 or any later version published by the Free Software Foundation.