Manpages

Manpage of VGRENAME

VGRENAME

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

NAME

vgrename - rename a volume group  

SYNOPSIS

vgrename [-A|--autobackup{y|n}] [-d|--debug] [-h|--help] [-v|--verbose] { OldVolumeGroupPath NewVolumeGroupPath | OldVolumeName NewVolumeGroupName }  

DESCRIPTION

vgrename renames an existing (see vgcreate(8) ) volume group.  

OPTIONS

-A, --autobackup y/n
Controls automatic backup of VG metadata after the change ( 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.
-v, --verbose
Gives verbose information about vgrename's activities.
 

Examples

"vgrename /dev/vg02 /dev/my_volume_group" renames existing volume group "vg02" to "my_volume_group".
"vgrename vg02 my_volume_group" does the same.
 

DIAGNOSTICS

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

1  new volume group directory for device special files already exists
2  old volume group directory for device special files doesn't exist
3  new volume group name is invalid
4  old volume group name is invalid
5  error checking existence of old volume group
7  volume group names are identical
8  new volume group already exists
9  error reading VGDA
10 error removing old VGDA from kernel
11 error removing old VGDA from lvmtab
12 error removing device special files for old volume group
13 error creating device special files for new volume group
14 error inserting new volume group name into lvmtab
15 error backinp up VGDA
16 error writing VGDA to lvmtab
17 error renaming volume group in kernel

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 also

lvm(8), vgchange(8), vgcreate(8), lvrename(8)  

AUTHOR

Heinz Mauelshagen <Linux-LVM@Sistina.com>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Examples
DIAGNOSTICS
ENVIRONMENT VARIABLES
See also
AUTHOR

This document was created by man2html, using the manual pages.
Time: 08:40:40 GMT, March 29, 2024