1VGSPLIT(8) System Manager's Manual VGSPLIT(8)
2
3
4
6 vgsplit - split a volume group into two
7
9 vgsplit [--alloc AllocationPolicy] [-A|--autobackup {y|n}] [-c|--clus‐
10 tered {y|n}] [-d|--debug] [-h|--help] [-l|--maxlogicalvolumes MaxLogi‐
11 calVolumes] [-M|--metadatatype type] [-p|--maxphysicalvolumes MaxPhysi‐
12 calVolumes] [--[vg]metadatacopies] NumberOfCopies|unmanaged|all]
13 [-n|--name LogicalVolumeName] [-t|--test] [-v|--verbose] SourceVol‐
14 umeGroupName DestinationVolumeGroupName [ PhysicalVolumePath ...]
15
17 vgsplit moves one or more physical volumes from SourceVolumeGroupName
18 into DestinationVolumeGroupName. The physical volumes moved can be
19 specified either explicitly via PhysicalVolumePath, or implicitly by -n
20 LogicalVolumeName, in which case only physical volumes underlying the
21 specified logical volume will be moved.
22
23 If DestinationVolumeGroupName does not exist, a new volume group will
24 be created. The default attributes for the new volume group can be
25 specified with --alloc, --clustered, --maxlogicalvolumes, --meta‐
26 datatype, --maxphysicalvolumes and --[vg]metadatacopies, (see vgcre‐
27 ate(8) for a description of these options). If any of these options
28 are not given, default attribute(s) are taken from SourceVolumeGroup‐
29 Name. If a non-LVM2 metadata type (e.g. lvm1) is being used, you should
30 use the -M option to specify the metadata type directly.
31
32 If DestinationVolumeGroupName does exist, it will be checked for com‐
33 patibility with SourceVolumeGroupName before the physical volumes are
34 moved. Specifying any of the above default volume group attributes with
35 an existing destination volume group is an error, and no split will
36 occur.
37
38 Logical volumes cannot be split between volume groups. Vgsplit(8) only
39 moves complete physical volumes: To move part of a physical volume, use
40 pvmove(8). Each existing logical volume must be entirely on the physi‐
41 cal volumes forming either the source or the destination volume group.
42 For this reason, vgsplit(8) may fail with an error if a split would
43 result in a logical volume being split across volume groups.
44
45 A vgsplit into an existing volume group retains the existing volume
46 group's value of vgmetadatacopies (see vgcreate and lvm.conf for fur‐
47 ther explanation of vgmetadatacopies). To change the value of vgmeta‐
48 datacopies, use vgchange.
49
50
52 See lvm for common options.
53
55 lvm(8), vgcreate(8), vgextend(8), vgreduce(8), vgmerge(8)
56
57
58
59Sistina Software UK LVM TOOLS 2.02.84(2) (2011-02-09) VGSPLIT(8)