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