VGSPLIT(8)                 System Manager's Manual                VGSPLIT(8)

NAME         top

       vgsplit — split a volume group into two

SYNOPSIS         top

       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         top

       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

       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

       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         top

       See lvm(8) for common options.

SEE ALSO         top

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

COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this
       manual page, send it to  This page was obtained
       from the project's upstream Git repository 
       ⟨⟩ on 2017-03-13.  If you
       discover any rendering problems in this HTML version of the page, or
       you believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

Sistina Software UKLVM TOOLS 2.02.169(2)-git (2016-11-30)         VGSPLIT(8)