1VGSPLIT(8)                  System Manager's Manual                 VGSPLIT(8)
2
3
4

NAME

6       vgsplit — split a volume group into two
7

SYNOPSIS

9       vgsplit  [--alloc AllocationPolicy] [-A|--autobackup {y|n}] [-c|--clus‐
10       tered {y|n}] [--commandprofile  ProfileName]  [-d|--debug]  [-h|--help]
11       [-l|--maxlogicalvolumes   MaxLogicalVolumes]  [-M|--metadatatype  type]
12       [-p|--maxphysicalvolumes MaxPhysicalVolumes] [--[vg]metadatacopies Num‐
13       berOfCopies|unmanaged|all]  [-n|--name  LogicalVolumeName]  [-t|--test]
14       [-v|--verbose] SourceVolumeGroupName DestinationVolumeGroupName [Physi‐
15       calVolumePath...]
16

DESCRIPTION

18       vgsplit  moves  one or more physical volumes from SourceVolumeGroupName
19       into DestinationVolumeGroupName.  The physical  volumes  moved  can  be
20       specified either explicitly via PhysicalVolumePath, or implicitly by -n
21       LogicalVolumeName, in which case only physical volumes  underlying  the
22       specified logical volume will be moved.
23
24       If  DestinationVolumeGroupName  does not exist, a new volume group will
25       be created.  The default attributes for the new  volume  group  can  be
26       specified   with  --alloc,  --clustered,  --maxlogicalvolumes,  --meta‐
27       datatype, --maxphysicalvolumes  and  --[vg]metadatacopies  (see  vgcre‐
28       ate(8)  for  a  description of these options).  If any of these options
29       are not given, default attribute(s) are taken  from  SourceVolumeGroup‐
30       Name. If a non-LVM2 metadata type (e.g. lvm1) is being used, you should
31       use the -M option to specify the metadata type directly.
32
33       If DestinationVolumeGroupName does exist, it will be checked  for  com‐
34       patibility  with  SourceVolumeGroupName before the physical volumes are
35       moved. Specifying any of the above default volume group attributes with
36       an  existing  destination  volume  group is an error, and no split will
37       occur.
38
39       Logical volumes cannot be split between volume groups. vgsplit(8)  only
40       moves complete physical volumes: To move part of a physical volume, use
41       pvmove(8).  Each existing logical volume must be entirely on the physi‐
42       cal  volumes forming either the source or the destination volume group.
43       For this reason, vgsplit(8) may fail with an error  if  a  split  would
44       result in a logical volume being split across volume groups.
45
46       A  vgsplit  into  an  existing volume group retains the existing volume
47       group's value of vgmetadatacopies (see vgcreate(8) and lvm.conf(5)  for
48       further  explanation  of  vgmetadatacopies).   To  change  the value of
49       vgmetadatacopies, use vgchange(8).
50
51

OPTIONS

53       See lvm(8) for common options.
54

SEE ALSO

56       lvm(8), vgcreate(8), vgextend(8), vgreduce(8), vgmerge(8)
57
58
59
60Sistina Software UKLVM TOOLS 2.02.143(2)-RHEL6 (2016-12-13)         VGSPLIT(8)