NAME

       vgsplit — split a volume group into two

SYNOPSIS

       vgsplit   [--alloc   AllocationPolicy]   [-A|--autobackup  {y|n}]  [-c|--clustered  {y|n}]
       [--commandprofile   ProfileName]    [-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)