external/gpl2/lvm2/dist/man/vgsplit.8

   1 .\"    $NetBSD$
   2 .\"
   3 .TH VGSPLIT 8 "LVM TOOLS 2.02.44-cvs (02-17-09)" "Sistina Software UK" \" -*- nroff -*-
   4 .SH NAME
   5 vgsplit \- split a volume group into two
   6 .SH SYNOPSIS
   7 .B vgsplit
   8 .RB [ \-\-alloc
   9 .IR AllocationPolicy ]
  10 .RB [ \-A | \-\-autobackup " {" y | n }]
  11 .RB [ \-c | \-\-clustered " {" 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 [ \-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 and \fB\-\-maxphysicalvolumes\fR (see \fBvgcreate(8)\fR for a description
  42 of these options).  If any of these options are not given, default
  43 attribute(s) are taken from
  44 .I SourceVolumeGroupName\fP.
  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)