]>
Commit | Line | Data |
---|---|---|
5951ef33 | 1 | .TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*- |
17823680 AK |
2 | .SH NAME |
3 | vgsplit \- split a volume group into two | |
4 | .SH SYNOPSIS | |
5 | .B vgsplit | |
b8daca85 DW |
6 | .RB [ \-\-alloc |
7 | .IR AllocationPolicy ] | |
c63b155d ZK |
8 | .RB [ \-A | \-\-autobackup |
9 | .RI { y | n }] | |
10 | .RB [ \-c | \-\-clustered | |
11 | .RI { y | n }] | |
b8daca85 DW |
12 | .RB [ \-d | \-\-debug ] |
13 | .RB [ \-h | \-\-help ] | |
6ab424ac | 14 | .RB [ \-l | \-\-maxlogicalvolumes |
b8daca85 DW |
15 | .IR MaxLogicalVolumes ] |
16 | .RB [ -M | \-\-metadatatype | |
17 | .IR type ] | |
18 | .RB [ -p | \-\-maxphysicalvolumes | |
19 | .IR MaxPhysicalVolumes ] | |
c63b155d ZK |
20 | .RB [ \-\- [ vg ] metadatacopies |
21 | .IR NumberOfCopies | unmanaged | all ] | |
22 | .RB [ \-n | \-\-name | |
5656911a | 23 | .IR LogicalVolumeName ] |
b8daca85 DW |
24 | .RB [ \-t | \-\-test ] |
25 | .RB [ \-v | \-\-verbose ] | |
c63b155d ZK |
26 | .I SourceVolumeGroupName DestinationVolumeGroupName |
27 | .RI [ PhysicalVolumePath ...] | |
17823680 | 28 | .SH DESCRIPTION |
c63b155d ZK |
29 | vgsplit moves one or more physical volumes from |
30 | \fISourceVolumeGroupName\fP into \fIDestinationVolumeGroupName\fP. | |
31 | The physical volumes moved can be specified either explicitly via | |
32 | \fIPhysicalVolumePath\fP, or implicitly by \fB\-n\fP | |
33 | \fILogicalVolumeName\fP, in which case only physical volumes | |
5656911a | 34 | underlying the specified logical volume will be moved. |
f43c6636 | 35 | |
c63b155d ZK |
36 | If \fIDestinationVolumeGroupName\fP does not exist, a new volume |
37 | group will be created. The default attributes | |
38 | for the new volume group can be specified with | |
39 | .BR \-\-alloc , | |
40 | .BR \-\-clustered , | |
41 | .BR \-\-maxlogicalvolumes , | |
42 | .BR \-\-metadatatype , | |
43 | .B \-\-maxphysicalvolumes \fRand | |
44 | .BR \-\- [ vg ] metadatacopies | |
45 | (see \fBvgcreate\fP(8) for a description of these options). If any | |
458a107e | 46 | of these options are not given, default attribute(s) are taken from |
c63b155d ZK |
47 | \fISourceVolumeGroupName\fP. If a non-LVM2 metadata type (e.g. lvm1) is |
48 | being used, you should use the \fB\-M\fP option to specify the metadata | |
49 | type directly. | |
f43c6636 DW |
50 | |
51 | If | |
52 | .I DestinationVolumeGroupName | |
53 | does exist, it will be checked for compatibility with | |
54 | .I SourceVolumeGroupName | |
1ce224d1 DW |
55 | before the physical volumes are moved. Specifying any of the above default |
56 | volume group attributes with an existing destination volume group is an error, | |
57 | and no split will occur. | |
f43c6636 | 58 | |
c63b155d | 59 | Logical volumes cannot be split between volume groups. \fBvgsplit\fP(8) only |
5656911a | 60 | moves complete physical volumes: To move part of a physical volume, use |
c63b155d | 61 | \fBpvmove\fP(8). Each existing logical volume must be entirely on the physical |
5656911a | 62 | volumes forming either the source or the destination volume group. For this |
c63b155d | 63 | reason, \fBvgsplit\fP(8) may fail with an error if a split would result in a |
5656911a DW |
64 | logical volume being split across volume groups. |
65 | ||
c63b155d ZK |
66 | A vgsplit into an existing volume group retains the existing volume group's |
67 | value of \fPvgmetadatacopies\fP (see \fBvgcreate\fP(8) and \fBlvm.conf\fP(5) for further | |
458a107e | 68 | explanation of \fPvgmetadatacopies\fP). To change the value of |
c63b155d | 69 | \fBvgmetadatacopies\fP, use \fBvgchange\fP(8). |
458a107e | 70 | |
17823680 | 71 | .SH OPTIONS |
c63b155d | 72 | See \fBlvm\fP(8) for common options. |
17823680 | 73 | .SH SEE ALSO |
5951ef33 AK |
74 | .BR lvm (8), |
75 | .BR vgcreate (8), | |
76 | .BR vgextend (8), | |
17823680 AK |
77 | .BR vgreduce (8), |
78 | .BR vgmerge (8) |