NAME

       vgsplit - split a volume group into two

SYNOPSIS

       vgsplit   [--alloc   AllocationPolicy]   [-A|--autobackup  {y|n}]  [-c|--clustered  {y|n}]
       [-d|--debug]  [-h|--help]  [-l|--maxlogicalvolumes  MaxLogicalVolumes]  [-M|--metadatatype
       type]       [-p|--maxphysicalvolumes       MaxPhysicalVolumes]       [--[vg]metadatacopies
       NumberOfCopies|unmanaged|all]  [-n|--name  LogicalVolumeName]  [-t|--test]  [-v|--verbose]
       SourceVolumeGroupName DestinationVolumeGroupName [PhysicalVolumePath...]

DESCRIPTION

       vgsplit   moves   one   or   more   physical   volumes   from  SourceVolumeGroupName  into
       DestinationVolumeGroupName.  The physical volumes moved can be specified either explicitly
       via PhysicalVolumePath, or implicitly by -n LogicalVolumeName, in which case only physical
       volumes underlying the specified logical volume will be moved.

       If DestinationVolumeGroupName does not exist, a new volume group  will  be  created.   The
       default  attributes  for  the new volume group can be specified with --alloc, --clustered,
       --maxlogicalvolumes, --metadatatype, --maxphysicalvolumes  and  --[vg]metadatacopies  (see
       vgcreate(8)  for  a description of these options).  If any of these options are not given,
       default attribute(s) are taken from SourceVolumeGroupName. If  a  non-LVM2  metadata  type
       (e.g.  lvm1)  is  being  used,  you  should use the -M option to specify the metadata type
       directly.

       If DestinationVolumeGroupName does exist,  it  will  be  checked  for  compatibility  with
       SourceVolumeGroupName  before  the physical volumes are moved. Specifying any of the above
       default volume group attributes with an existing destination volume group is an error, and
       no split will occur.

       Logical  volumes  cannot  be  split  between volume groups. vgsplit(8) only moves complete
       physical volumes: To move part of a physical volume, use pvmove(8).  Each existing logical
       volume  must  be  entirely  on  the  physical  volumes  forming  either  the source or the
       destination volume group.  For this reason, vgsplit(8) may fail with an error if  a  split
       would result in a logical volume being split across volume groups.

       A  vgsplit  into  an  existing  volume  group retains the existing volume group's value of
       vgmetadatacopies  (see  vgcreate(8)   and   lvm.conf(5)   for   further   explanation   of
       vgmetadatacopies).  To change the value of vgmetadatacopies, use vgchange(8).

OPTIONS

       See lvm(8) for common options.

SEE ALSO

       lvm(8), vgcreate(8), vgextend(8), vgreduce(8), vgmerge(8)