man/vgsplit.8.in

   1 .TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 vgsplit \- split a volume group into two
   4 .SH SYNOPSIS
   5 .B vgsplit
   6 .RB [ \-\-alloc
   7 .IR AllocationPolicy ]
   8 .RB [ \-A | \-\-autobackup " {" y | n }]
   9 .RB [ \-c | \-\-clustered " {" y | n }]
  10 .RB [ \-d | \-\-debug ]
  11 .RB [ \-h | \-\-help ]
  12 .RB [ \-l | \-\-maxlogicalvolumes
  13 .IR MaxLogicalVolumes ]
  14 .RB [ -M | \-\-metadatatype
  15 .IR type ]
  16 .RB [ -p | \-\-maxphysicalvolumes
  17 .IR MaxPhysicalVolumes ]
  18 .RB [ \-\-[vg]metadatacopies ]
  19 .IR NumberOfCopies|unmanaged|all ]
  20 .RB [ \-n | \-\-name
  21 .IR LogicalVolumeName ]
  22 .RB [ \-t | \-\-test ]
  23 .RB [ \-v | \-\-verbose ]
  24 SourceVolumeGroupName DestinationVolumeGroupName
  25 [ PhysicalVolumePath ...]
  26 .SH DESCRIPTION
  27 .B vgsplit
  28 moves one or more physical volumes from
  29 .I SourceVolumeGroupName
  30 into
  31 .I DestinationVolumeGroupName\fP.  The physical volumes moved can be
  32 specified either explicitly via \fIPhysicalVolumePath\fP, or implicitly by
  33 \fB-n\fP \fILogicalVolumeName\fP, in which case only physical volumes
  34 underlying the specified logical volume will be moved.
  35
  36 If
  37 .I DestinationVolumeGroupName
  38 does not exist, a new volume group will be created.  The default attributes
  39 for the new volume group can be specified with \fB\-\-alloc\fR,
  40 \fB\-\-clustered\fR, \fB\-\-maxlogicalvolumes\fR, \fB\-\-metadatatype\fR,
  41 \fB\-\-maxphysicalvolumes\fR and \fB\-\-[vg]metadatacopies\fR,
  42 (see \fBvgcreate(8)\fR for a description of these options).  If any
  43 of these options are not given, default attribute(s) are taken from
  44 .I SourceVolumeGroupName\fP.  If a non-LVM2 metadata type (e.g. lvm1) is
  45 being used, you should use the -M option to specify the metadata type
  46 directly.
  47
  48 If
  49 .I DestinationVolumeGroupName
  50 does exist, it will be checked for compatibility with
  51 .I SourceVolumeGroupName
  52 before the physical volumes are moved. Specifying any of the above default
  53 volume group attributes with an existing destination volume group is an error,
  54 and no split will occur.
  55
  56 Logical volumes cannot be split between volume groups. \fBVgsplit(8)\fP only
  57 moves complete physical volumes: To move part of a physical volume, use
  58 \fBpvmove(8)\fP.  Each existing logical volume must be entirely on the physical
  59 volumes forming either the source or the destination volume group.  For this
  60 reason, \fBvgsplit(8)\fP may fail with an error if a split would result in a
  61 logical volume being split across volume groups.
  62
  63 A \fBvgsplit\fP into an existing volume group retains the existing volume group's
  64 value of \fPvgmetadatacopies\fP (see \fBvgcreate\fP and \fBlvm.conf\fP for further
  65 explanation of \fPvgmetadatacopies\fP).  To change the value of
  66 \fBvgmetadatacopies\fP, use \fBvgchange\fP.
  67
  68 .SH OPTIONS
  69 See \fBlvm\fP for common options.
  70 .SH SEE ALSO
  71 .BR lvm (8),
  72 .BR vgcreate (8),
  73 .BR vgextend (8),
  74 .BR vgreduce (8),
  75 .BR vgmerge (8)