Manpages

Manpage of VGMERGE

VGMERGE

Section: Maintenance Commands (8)
Updated: LVM TOOLS
Index
Return to Main Contents
 

NAME

vgmerge - merge two volume groups  

SYNOPSIS

vgmerge [-A|--autobackup{y|n}] [-d|--debug] [-h|--help] [-l|--list] [-t|--test] [-v|--verbose] DestinationVolumeGroupName SourceVolumeGroupName  

DESCRIPTION

vgmerge merges two existing volume groups. The inactive SourceVolumeGroupName will be merged into the DestinationVolumeGroupName if physical extent sizes are equal and physical and logical volume summaries of both volume groups fit into DestinationVolumeGroupName's limits.  

OPTIONS

-A, --autobackup y/n
Controls automatic backup of VG metadata after the merge ( see vgcfgbackup(8) ). Default is yes.
-d, --debug
Enables additional debugging output (if compiled with DEBUG).
-h, --help
Print a usage message on standard output and exit successfully.
-l, --list
Display merged DestinationVolumeGroupName like "vgdisplay -v".
-t, --test
Do a test run WITHOUT making any real changes.
-v, --verbose
Display verbose runtime information about vgmerge's activities.
 

Examples

"vgmerge -v databases my_vg" merges the inactive volume group named "my_vg" into the active or inactive volume group named "databases" giving verbose runtime information.  

DIAGNOSTICS

vgmerge returns an exit code of 0 for success and > 0 for error:

1  2 volume group names must be entered on command line
2  volume group to merge from must be inactive
3  error reading VGDA of volume group to merge into
4  error reading VGDA of volume group to merge from
5  error setting up VGDA for merge
6  error extending VGDA by physical volume in kernel
7  error writing VGDA to physical volume(s)
8  error creating volume group special files
9  error removing volume group from lvmtab

95 driver/module not in kernel
96 invalid I/O protocol version
97 error locking logical volume manager
98 invalid lvmtab (run vgscan(8))
99 invalid command line
 

ENVIRONMENT VARIABLES

LVM_AUTOBACKUP
If this variable is set to "no" then the automatic backup of VG metadata is turned off.
LVM_VG_MAX_BACKUPS
This variable determines the backup history depth of kept VGDA copy files in /etc/lvmconf. It can be set to a positive number between 0 and 999. The higher this number is, the more changes you can restore using vgcfgrestore(8).

 

See also1

lvm(8), vgcreate(8), vgextend(8), vgreduce(8), vgsplit(8), pvmove(8)  

AUTHOR

Heinz Mauelshagen <Linux-LVM@Sistina.com>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Examples
DIAGNOSTICS
ENVIRONMENT VARIABLES
See also1
AUTHOR

This document was created by man2html, using the manual pages.
Time: 00:54:59 GMT, February 27, 2024