mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
79 lines
2.8 KiB
Groff
79 lines
2.8 KiB
Groff
.TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
vgsplit \- split a volume group into two
|
|
.SH SYNOPSIS
|
|
.B vgsplit
|
|
.RB [ \-\-alloc
|
|
.IR AllocationPolicy ]
|
|
.RB [ \-A | \-\-autobackup
|
|
.RI { y | n }]
|
|
.RB [ \-c | \-\-clustered
|
|
.RI { y | n }]
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-\-help ]
|
|
.RB [ \-l | \-\-maxlogicalvolumes
|
|
.IR MaxLogicalVolumes ]
|
|
.RB [ -M | \-\-metadatatype
|
|
.IR type ]
|
|
.RB [ -p | \-\-maxphysicalvolumes
|
|
.IR MaxPhysicalVolumes ]
|
|
.RB [ \-\- [ vg ] metadatacopies
|
|
.IR NumberOfCopies | unmanaged | all ]
|
|
.RB [ \-n | \-\-name
|
|
.IR LogicalVolumeName ]
|
|
.RB [ \-t | \-\-test ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.I SourceVolumeGroupName DestinationVolumeGroupName
|
|
.RI [ PhysicalVolumePath ...]
|
|
.SH DESCRIPTION
|
|
vgsplit moves one or more physical volumes from
|
|
\fISourceVolumeGroupName\fP into \fIDestinationVolumeGroupName\fP.
|
|
The physical volumes moved can be specified either explicitly via
|
|
\fIPhysicalVolumePath\fP, or implicitly by \fB\-n\fP
|
|
\fILogicalVolumeName\fP, in which case only physical volumes
|
|
underlying the specified logical volume will be moved.
|
|
|
|
If \fIDestinationVolumeGroupName\fP does not exist, a new volume
|
|
group will be created. The default attributes
|
|
for the new volume group can be specified with
|
|
.BR \-\-alloc ,
|
|
.BR \-\-clustered ,
|
|
.BR \-\-maxlogicalvolumes ,
|
|
.BR \-\-metadatatype ,
|
|
.B \-\-maxphysicalvolumes \fRand
|
|
.BR \-\- [ vg ] metadatacopies
|
|
(see \fBvgcreate\fP(8) for a description of these options). If any
|
|
of these options are not given, default attribute(s) are taken from
|
|
\fISourceVolumeGroupName\fP. If a non-LVM2 metadata type (e.g. lvm1) is
|
|
being used, you should use the \fB\-M\fP option to specify the metadata
|
|
type directly.
|
|
|
|
If
|
|
.I DestinationVolumeGroupName
|
|
does exist, it will be checked for compatibility with
|
|
.I SourceVolumeGroupName
|
|
before the physical volumes are moved. Specifying any of the above default
|
|
volume group attributes with an existing destination volume group is an error,
|
|
and no split will occur.
|
|
|
|
Logical volumes cannot be split between volume groups. \fBvgsplit\fP(8) only
|
|
moves complete physical volumes: To move part of a physical volume, use
|
|
\fBpvmove\fP(8). Each existing logical volume must be entirely on the physical
|
|
volumes forming either the source or the destination volume group. For this
|
|
reason, \fBvgsplit\fP(8) may fail with an error if a split would result in a
|
|
logical volume being split across volume groups.
|
|
|
|
A vgsplit into an existing volume group retains the existing volume group's
|
|
value of \fPvgmetadatacopies\fP (see \fBvgcreate\fP(8) and \fBlvm.conf\fP(5) for further
|
|
explanation of \fPvgmetadatacopies\fP). To change the value of
|
|
\fBvgmetadatacopies\fP, use \fBvgchange\fP(8).
|
|
|
|
.SH OPTIONS
|
|
See \fBlvm\fP(8) for common options.
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR vgcreate (8),
|
|
.BR vgextend (8),
|
|
.BR vgreduce (8),
|
|
.BR vgmerge (8)
|