NAME
lfsck - check a Lustre distributed filesystem
SYNOPSIS
lfsck [ -cdfhlnv ] --mdsdb mds_database_file --ostdb ost1_database_file
[ost2_database_file ...] filesystem
DESCRIPTION
lfsck is used to check and repair the distributed coherency of a Lustre
filesystem.
filesystem is the mountpoint of the Lustre filesystem to be checked.
e.g. /mnt/lustre).
DESCRIPTION
Lfsck is used to do the distributed coherency checking of a Lustre
filesystem after e2fsck has been run on each of the local MDS and OST
device filesystems. Lfsck will ensure that objects are not referenced
by multiple MDS files, that there are no orphan objects on the OSTs
(objects that do not have any file on the MDS which references them),
and that all of the objects referenced by the MDS exist. Under normal
circumstances Lustre will maintain such coherency by distributed
logging mechanisms, but under exceptional circumstances that may fail
(e.g. disk failure, filesystem corruption leading to e2fsck repair).
OPTIONS
-c Create (empty) missing OST objects referenced by MDS inodes.
-d Delete orphaned objects from the filesystem. Since objects on
the OST are often only one of several stripes of a file it can
be difficult to put multiple objects back together into a single
usable file.
-h Print a brief help message.
-l Put orphaned objects into a lost+found directory in the root of
the filesystem.
-n Do not repair the filesystem, just perform a read-only check
(default).
-v Verbose operation - more verbosity by specifing option multiple
times.
--mdsdb mds_database_file
The MDS database file created by running e2fsck --mdsdb
mds_database_file device on the MDS backing device. This is
required.
--ostdb ost1_database_file [ost2_database_file ...]
The OST database files created by running e2fsck --ostdb
ost_database_file device on each of the OST backing devices.
These are required, unless an OST is unavailable, in which case
all objects thereon will be considered missing.
REPORTING BUGS
Bugs should be reported to Sun Microsystems, Inc. via Bugzilla:
http://bugzilla.lustre.org/
AUTHOR
This version of lfsck was originally written by Liam Kelleher
<liam.kelleher@hp.com> and maintained by Andreas Dilger
<adilger@clusterfs.com>
SEE ALSO
e2fsck(8)