1 .TH LFS-MIRROR-SPLIT 1 2017-07-25 "Lustre" "Lustre Utilities"
3 lfs mirror split \- split a specified mirror from an existing mirrored file
6 {\fB\-\-mirror\-id\fR <\fImirror_id\fR> | \fB\-\-component\-id\fR|\fB\-I\fR
8 [\fB\-\-destroy\fR|\fB\-d\fR]
9 [\fB\-f\fR <\fInew_file\fR>]
12 This command splits a mirror with mirror ID <\fImirror_id\fR> or containing
13 a component with <\fIcomp_id\fR> out of a mirrored
14 file specified by the path name \fImirrored_file\fR. By default, the layout of
15 the split mirror will be stored into a new file named
16 <\fImirrored_file\fR>.mirror~<\fImirror_id\fR>. If \fB\-\-destroy\fR|\fB\-d\fR
17 option is specified, then the split mirror will be destroyed.
18 If \fB\-f\fR <\fInew_file\fR> option is specified, then the layout of the split
19 mirror will be stored into the named file.
21 If \fImirrored_file\fR has only one mirror existing after split, it will be
22 converted to a regular non-mirrored file.
24 If the original \fImirrored_file\fR is not a mirrored file, then the command
28 .BR \-\-mirror\-id\fR\ <\fImirror_id\fR>
29 The numerical unique identifier for a mirror. The mirror ID is unique within a
30 mirrored file and is automatically assigned at file creation or extension time.
31 It can be fetched by \fBlfs getstripe\fR command (see \fBlfs(1)\fR).
33 .BR \-\-comp\-id\fR\ <\fIcomp_id\fR>
34 The numerical unique identifier for a component contained withiin a mirror.
36 .BR \-\-destroy\fR|\fB\-d\fR
37 This option indicates the split mirror will be destroyed.
39 .BR \-f\fR\ <\fInew_file\fR>
40 This option indicates the layout of the split mirror will be stored into
44 .B lfs mirror split --mirror-id 1 /mnt/lustre/file1
45 Split a mirror with ID 1 out of /mnt/lustre/file1 and store it into
46 /mnt/lustre/file1.mirror~1.
48 .B lfs mirror split --mirror-id 2 -d /mnt/lustre/file1
49 Split a mirror with ID 2 out of /mnt/lustre/file1 and destroy it.
51 .B lfs mirror split --mirror-id 3 -f /mnt/lustre/file2 /mnt/lustre/file1
52 Split a mirror with ID 3 out of /mnt/lustre/file1 and store it into
55 The \fBlfs mirror split\fR command is part of the Lustre filesystem.
58 .BR lfs-setstripe (1),
59 .BR lfs-mirror-create (1),
60 .BR lfs-mirror-extend (1),
61 .BR lfs-mirror-resync (1),
62 .BR lfs-mirror-verify (1)