vgsplit(8)

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)

---

Free and Open Source Software