Provided by: lvm2_2.02.133-1ubuntu10_amd64 bug

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)