man vgrename () - rename a volume group
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
AUTHOR
Heinz Mauelshagen <Linux-LVM@Sistina.com>