1 .TH LFS-MIRROR-RESYNC 1 2017-07-25 "Lustre" "Lustre Utilities"
3 lfs-mirror-resync \- resynchronize an out-of-sync mirrored file
6 [\fB\-\-only\fR <\fImirror_id\fR[,...]>]
7 <\fB\-\-bandwidth\-limit=\fR|\fB\-W\fR[\fIbandwidth_limit\fR]>
9 <\fB\-\-stats\-interval\fR=\fIinterval_in_sec\fR>
10 <\fImirrored_file\fR> [<\fImirrored_file2\fR>...]
12 This command resynchronizes out-of-sync mirrored file(s) specified by the path
13 name \fImirrored_file\fR.
15 If there is no stale mirror for the \fImirrored_file(s)\fR, then the command does
16 nothing. Otherwise, it will copy data from synced mirror to stale mirror(s), and
17 mark all successfully copied mirror(s) as SYNC.
19 If \fB\-\-only\fR option is not specified, the \fBnosync\fR mirror(s) (i.e.
20 components that have this flag set) will not be synced.
22 If \fB\-\-only\fR <\fImirror_id\fR[,...]> option is specified, then the
23 command will resynchronize the mirror(s) specified by the \fImirror_id\fR(s),
24 even nosync mirror(s) will be resynchronized as well.
25 This option cannot be used when multiple mirrored files are specified.
28 .BR \-\-only\fR\ <\fImirror_id\fR[,...]>
29 This option indicates which mirror(s) specified by \fImirror_id\fR(s) needs to
30 be resynchronized. The \fImirror_id\fR is the numerical unique identifier for
31 a mirror. Multiple \fImirror_id\fRs are separated by comma. This option cannot
32 be used when multiple mirrored files are specified.
35 This option enables progress updates every 5 seconds, in YAML format.
37 .BR \-\-stats-interval=\fIstats_interval
38 This option enables progress updates every \fIstats_interval\fR seconds, in YAML format.
40 .BR \-\-bandwidth\-limit\fR|\fB\-W\fR\fIbandwidth_limit\fR
41 This option enables throttling so that mirror extending writes no more than
42 \fIbandwidth_limit\fR bytes a second. An optional suffix can be used to
50 .B lfs mirror resync /mnt/lustre/file1 /mnt/lustre/file2
51 Resynchronize all of the stale and sync-able mirror(s) for /mnt/lustre/file1 and /mnt/lustre/file2.
53 .B lfs mirror resync --only 4,5 /mnt/lustre/file1
54 Resynchronize mirrors with mirror ID 4 and 5 for /mnt/lustre/file1 even if they
55 are not marked as STALE.
57 The \fBlfs mirror resync\fR command is part of the Lustre filesystem.
60 .BR lfs-setstripe (1),
61 .BR lfs-mirror-create (1),
62 .BR lfs-mirror-extend (1),
63 .BR lfs-mirror-split (1),
64 .BR lfs-mirror-verify (1)