vgsplit

VGSPLIT(8)							   VGSPLIT(8)



NAME
       vgsplit - split a volume group into two

SYNOPSIS
       vgsplit [--alloc AllocationPolicy] [-A|--autobackup {y|n}] [-c|--clus-
       tered {y|n}] [-d|--debug] [-h|--help] [-l|--maxlogicalvolumes MaxLogi-
       calVolumes] [-M|--metadatatype type] [-p|--maxphysicalvolumes MaxPhys-
       icalVolumes] [-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,  --meta-
       datatype,  and --maxphysicalvolumes (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  DestinationVolumeGroupName does exist, it will be checked for com-
       patibility 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.


OPTIONS
       See lvm for common options.

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



Sistina Software UK		  LVM TOOLS			   VGSPLIT(8)