external/gpl2/lvm2/dist/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 [ \-n | \-\-name
  19 .IR LogicalVolumeName ]
  20 .RB [ \-t | \-\-test ]
  21 .RB [ \-v | \-\-verbose ]
  22 SourceVolumeGroupName DestinationVolumeGroupName
  23 [ PhysicalVolumePath ...]
  24 .SH DESCRIPTION
  25 .B vgsplit
  26 moves one or more physical volumes from
  27 .I SourceVolumeGroupName
  28 into
  29 .I DestinationVolumeGroupName\fP.  The physical volumes moved can be
  30 specified either explicitly via \fIPhysicalVolumePath\fP, or implicitly by
  31 \fB-n\fP \fILogicalVolumeName\fP, in which case only physical volumes
  32 underlying the specified logical volume will be moved.
  33
  34 If
  35 .I DestinationVolumeGroupName
  36 does not exist, a new volume group will be created.  The default attributes
  37 for the new volume group can be specified with \fB\-\-alloc\fR,
  38 \fB\-\-clustered\fR, \fB\-\-maxlogicalvolumes\fR, \fB\-\-metadatatype\fR,
  39 and \fB\-\-maxphysicalvolumes\fR (see \fBvgcreate(8)\fR for a description
  40 of these options).  If any of these options are not given, default
  41 attribute(s) are taken from
  42 .I SourceVolumeGroupName\fP.  If a non-LVM2 metadata type (e.g. lvm1) is
  43 being used, you should use the -M option to specify the metadata type
  44 directly.
  45
  46 If
  47 .I DestinationVolumeGroupName
  48 does exist, it will be checked for compatibility with
  49 .I SourceVolumeGroupName
  50 before the physical volumes are moved. Specifying any of the above default
  51 volume group attributes with an existing destination volume group is an error,
  52 and no split will occur.
  53
  54 Logical volumes cannot be split between volume groups. \fBVgsplit(8)\fP only
  55 moves complete physical volumes: To move part of a physical volume, use
  56 \fBpvmove(8)\fP.  Each existing logical volume must be entirely on the physical
  57 volumes forming either the source or the destination volume group.  For this
  58 reason, \fBvgsplit(8)\fP may fail with an error if a split would result in a
  59 logical volume being split across volume groups.
  60
  61 .SH OPTIONS
  62 See \fBlvm\fP for common options.
  63 .SH SEE ALSO
  64 .BR lvm (8),
  65 .BR vgcreate (8),
  66 .BR vgextend (8),
  67 .BR vgreduce (8),
  68 .BR vgmerge (8)