1VGSPLIT(8)                  System Manager's Manual                 VGSPLIT(8)
2
3
4

NAME

6       vgsplit - split a volume group into two
7

SYNOPSIS

9       vgsplit  [--alloc AllocationPolicy] [-A|--autobackup {y|n}] [-c|--clus‐
10       tered {y|n}] [-d|--debug] [-h|--help] [-l|--maxlogicalvolumes  MaxLogi‐
11       calVolumes] [-M|--metadatatype type] [-p|--maxphysicalvolumes MaxPhysi‐
12       calVolumes]    [--[vg]metadatacopies]     NumberOfCopies|unmanaged|all]
13       [-n|--name  LogicalVolumeName]  [-t|--test]  [-v|--verbose]  SourceVol‐
14       umeGroupName DestinationVolumeGroupName [ PhysicalVolumePath ...]
15

DESCRIPTION

17       vgsplit moves one or more physical volumes  from  SourceVolumeGroupName
18       into  DestinationVolumeGroupName.  The  physical  volumes  moved can be
19       specified either explicitly via PhysicalVolumePath, or implicitly by -n
20       LogicalVolumeName,  in  which case only physical volumes underlying the
21       specified logical volume will be moved.
22
23       If DestinationVolumeGroupName does not exist, a new volume  group  will
24       be  created.   The  default  attributes for the new volume group can be
25       specified  with  --alloc,  --clustered,  --maxlogicalvolumes,   --meta‐
26       datatype,  --maxphysicalvolumes  and  --[vg]metadatacopies, (see vgcre‐
27       ate(8) for a description of these options).  If any  of  these  options
28       are  not  given, default attribute(s) are taken from SourceVolumeGroup‐
29       Name. If a non-LVM2 metadata type (e.g. lvm1) is being used, you should
30       use the -M option to specify the metadata type directly.
31
32       If  DestinationVolumeGroupName  does exist, it will be checked for com‐
33       patibility with SourceVolumeGroupName before the physical  volumes  are
34       moved. Specifying any of the above default volume group attributes with
35       an existing destination volume group is an error,  and  no  split  will
36       occur.
37
38       Logical  volumes cannot be split between volume groups. Vgsplit(8) only
39       moves complete physical volumes: To move part of a physical volume, use
40       pvmove(8).  Each existing logical volume must be entirely on the physi‐
41       cal volumes forming either the source or the destination volume  group.
42       For  this  reason,  vgsplit(8)  may fail with an error if a split would
43       result in a logical volume being split across volume groups.
44
45       A vgsplit into an existing volume group  retains  the  existing  volume
46       group's  value  of vgmetadatacopies (see vgcreate and lvm.conf for fur‐
47       ther explanation of vgmetadatacopies).  To change the value of  vgmeta‐
48       datacopies, use vgchange.
49
50

OPTIONS

52       See lvm for common options.
53

SEE ALSO

55       lvm(8), vgcreate(8), vgextend(8), vgreduce(8), vgmerge(8)
56
57
58
59Sistina Software UK    LVM TOOLS 2.02.84(2) (2011-02-09)            VGSPLIT(8)
Impressum