.TH VGMERGE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
.SH NAME
vgmerge \- merge two volume groups
.SH SYNOPSIS
.B vgmerge
.RB [ \-A | \-\-autobackup
.RI { y | n }]
.RB [ \-\-commandprofile
.IR ProfileName ]
.RB [ \-d | \-\-debug ]
.RB [ \-h | \-? | \-\-help ]
.RB [ \-l | \-\-list ]
.RB [ \-t | \-\-test ]
.RB [ \-v | \-\-verbose ]
.I DestinationVolumeGroupName
.I SourceVolumeGroupName
.SH DESCRIPTION
vgmerge merges two existing volume groups. The inactive
\fISourceVolumeGroupName\fP will be merged into 
the \fIDestinationVolumeGroupName\fP if physical extent sizes
are equal and physical and logical volume summaries of both volume groups
fit into \fIDestinationVolumeGroupName\fP's limits.
.SH OPTIONS
See \fBlvm\fP(8) for common options.
.TP
.BR \-l ", " \-\-list
Display merged \fIDestinationVolumeGroupName\fP like \fBvgdisplay -v\fP.
.TP 
.BR \-t ", " \-\-test
Do a test run WITHOUT making any real changes.
.SH Examples
Merge the inactive volume group named "my_vg"
into the active or inactive volume group named "databases" giving verbose
runtime information:
.sp
.B vgmerge -v databases my_vg
.SH SEE ALSO
.BR lvm (8),
.BR vgcreate (8),
.BR vgextend (8),
.BR vgreduce (8)