lustre/doc/lfs-mirror-resync.1

   1 .TH LFS-MIRROR-RESYNC 1 2017-07-25 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs mirror resync \- resynchronize an out-of-sync mirrored file
   4 .SH SYNOPSIS
   5 .B lfs mirror resync
   6 [\fB\-\-only\fR <\fImirror_id\fR[,...]>]
   7 <\fImirrored_file\fR> [<\fImirrored_file2\fR>...]
   8 .SH DESCRIPTION
   9 This command resynchronizes out-of-sync mirrored file(s) specified by the path
  10 name \fImirrored_file\fR.
  11 .br
  12 If there is no stale mirror for the \fImirrored_file(s)\fR, then the command does
  13 nothing. Otherwise, it will copy data from synced mirror to stale mirror(s), and
  14 mark all successfully copied mirror(s) as SYNC.
  15 .br
  16 If \fB\-\-only\fR option is not specified, the \fBnosync\fR mirror(s) (i.e.
  17 components that have this flag set) will not be synced.
  18 .br
  19 If \fB\-\-only\fR <\fImirror_id\fR[,...]> option is specified, then the
  20 command will resynchronize the mirror(s) specified by the \fImirror_id\fR(s),
  21 even nosync mirror(s) will be resynchronized as well.
  22 This option cannot be used when multiple mirrored files are specified.
  23 .SH OPTIONS
  24 .TP
  25 .BR \-\-only\fR\ <\fImirror_id\fR[,...]>
  26 This option indicates which mirror(s) specified by \fImirror_id\fR(s) needs to
  27 be resynchronized. The \fImirror_id\fR is the numerical unique identifier for
  28 a mirror. Multiple \fImirror_id\fRs are separated by comma. This option cannot
  29 be used when multiple mirrored files are specified.
  30 .SH EXAMPLES
  31 .TP
  32 .B lfs mirror resync /mnt/lustre/file1 /mnt/lustre/file2
  33 Resynchronize all of the stale and sync-able mirror(s) for /mnt/lustre/file1 and /mnt/lustre/file2.
  34 .TP
  35 .B lfs mirror resync --only 4,5 /mnt/lustre/file1
  36 Resynchronize mirrors with mirror ID 4 and 5 for /mnt/lustre/file1 even if they
  37 are not marked as STALE.
  38 .SH AUTHOR
  39 The \fBlfs mirror resync\fR command is part of the Lustre filesystem.
  40 .SH SEE ALSO
  41 .BR lfs (1),
  42 .BR lfs-setstripe (1),
  43 .BR lfs-mirror-create (1),
  44 .BR lfs-mirror-extend (1),
  45 .BR lfs-mirror-split (1),
  46 .BR lfs-mirror-verify (1)