lustre/doc/lfs-mirror-verify.1

   1 .TH LFS-MIRROR-VERIFY 1 2017-07-25 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs mirror verify \- verify mirrored file(s)
   4 .SH SYNOPSIS
   5 .B lfs mirror verify
   6 [\fB\-\-only\fR <\fImirror_id\fR,\fImirror_id2\fR[,...]>]
   7 [\fB\-\-verbose\fR|\fB\-v\fR] <\fImirrored_file\fR> [<\fImirrored_file2\fR> ...]
   8 .SH DESCRIPTION
   9 This command verifies that each SYNC mirror of a mirrored file specified by the
  10 path name \fImirrored_file\fR contains exactly the same data. It supports
  11 specifying multiple mirrored files in one command line.
  12 .br
  13 This is a scrub tool that should be run in regular basis to make sure that
  14 mirrored files are not corrupted. The command won't repair the file if it turns
  15 out to be corrupted. Usually administrator should check the file content from
  16 each mirror and decide which one is correct and then invoke \fBlfs\ mirror\
  17  resync\fR to repair it manually.
  18 .br
  19 If \fB\-\-only\fR <\fImirror_id\fR,\fImirror_id2\fR[,...]> option is specified,
  20 then the command will only verify the mirrors specified by \fImirror_id\fRs
  21 contain exactly the same data. At least two \fImirror_id\fRs are required.
  22 This option cannot be used when multiple mirrored files are specified.
  23 .br
  24 If \fB\-\-verbose\fR|\fB\-v\fR option is specified, then the command will print
  25 where the differences are if the data do not match. Otherwise, the command will
  26 just return an error in that case. This option can be repeated for multiple
  27 times to print more information.
  28 .SH OPTIONS
  29 .TP
  30 .B \fB\-\-only\fR <\fImirror_id\fR,\fImirror_id2\fR[,...]>
  31 This option indicates which mirrors specified by \fImirror_id\fRs need to
  32 be verified. The \fImirror_id\fR is the numerical unique identifier for
  33 a mirror. Multiple \fImirror_id\fRs are separated by comma.
  34 .TP
  35 .B \fB\-\-verbose\fR|\fB\-v\fR
  36 This option indicates the command will print where the differences are if the
  37 data do not match.
  38 .SH EXAMPLES
  39 .TP
  40 .B lfs mirror verify /mnt/lustre/file1
  41 Verify that each mirror of /mnt/lustre/file1 contains exactly the same data.
  42 .TP
  43 .B lfs mirror verify -v /mnt/lustre/file1 /mnt/lustre/file2
  44 Separately verify that each mirror of /mnt/lustre/file1 and /mnt/lustre/file2
  45 contain exactly the same data. Print where the differences are if the data do
  46 not match.
  47 .TP
  48 .B lfs mirror verify --only 4,5 /mnt/lustre/file1
  49 Verify mirrors with mirror ID 4 and 5 of /mnt/lustre/file1 contain exactly
  50 the same data.
  51 .SH AUTHOR
  52 The \fBlfs mirror verify\fR command is part of the Lustre filesystem.
  53 .SH SEE ALSO
  54 .BR lfs (1),
  55 .BR lfs-setstripe (1),
  56 .BR lfs-mirror-create (1),
  57 .BR lfs-mirror-extend (1),
  58 .BR lfs-mirror-split (1),
  59 .BR lfs-mirror-resync (1)