Manpages
VGCFGRESTORE
Section: Maintenance Commands (8)Updated: LVM TOOLS
Index
Return to Main Contents
NAME
vgcfgrestore - restore volume group descriptor areaSYNOPSIS
vgcfgrestore [-b|--backup_number VolumeGroupBackupNumber] [-d|--debug] [-f|--file VGConfPath] [-l[l]|--list [--list]] [-h|--help] [-i|--ignore_size] [-n|--name VolumeGroupName] [-o|--oldpath OldPhysicalVolumePath] [-t|--test] [-v|--verbose] [PhysicalVolumePath]DESCRIPTION
vgcfgrestore restores the volume group descriptor area from backup files in /etc/lvmconf or from VGConfPath to the given initialized (see pvcreate(8) ) PhysicalVolumePath. The default backup file is /etc/lvmconf/VolumeGroupName.conf. This command DOES NOT restore data contained in logical volume(s), only the LVM configuration metadata!OPTIONS
- -b, --backup_numberVolumeGroupBackupNumber
- Restore from the specified backup number. Use together with option -n which gives the name of the volume group. See examples below.
- -d, --debug
- Enables additional debugging output (if compiled with DEBUG).
- -f, --file VGConfPath
- Restore from the specified path. Useful for selection of specific backups in the backup history or for copies of VGDA backups.
- -i, --ignore_size
- Restore though the size of the physical volume doesn't match the one in the backup.
- -l, --list
- Display volume group information contained in the backup file. If given twice, the physical and logical volume information contained in the backup file is also shown.
- -h, --help
- Print a usage message on standard output and exit successfully.
- -n, --name VolumeGroupName
- Do a restore for this volume group name.
- -o, --oldpath OldPhysicalVolumePath
- If the path to the physical volume has changed between backup time and restore time, this option enables you to choose the corresponding physical volume path in the backup file.
- -t, --test
- Do a test run reading the volume group backup WITHOUT trying to restore it
- -v, --verbose
- Give verbose runtime information about vgcfgrestore's activities.
- --version
- Output the version number and exit successfully.
Examples
To display information like with "vgdisplay vg00" stored in the backup file /etc/lvmconf/vg00.conf:vgcfgrestore -n vg00 -lTo restore the VGDA of vg00 from the alternative backup file /tmp/vg00-old to physical volume /dev/sdn1:
vgcfgrestore -f /tmp/vg00-old -n vg00 /dev/sdn1
To restore the VGDA of vg00 from the alternative backup file /etc/lvmconf/vg00.conf.5.old to physical volume /dev/sda5 : vgcfgrestore -n vg00 -b 5 /dev/sda5
DIAGNOSTICS
vgcfgrestore returns an exit code of 0 for success and > 0 for error:1 no physical volume on command line 2 invalid physical volume name 3 volume group is active 4 error doing restore to physical volume 5 backup is invalid for this volume group 6 volume group is inconsistent 7 physical volume doesn't belong to volume group backup 8 error reading physical volume 9 error getting size of physical volume 10 error writing VGDA to physical volume(s) 11 error removing special files of volume group 12 error setting volume group into lvmtab 13 error doing backup 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
SEE ALSO
lvm(8), vgcfgbackup(8), vgcreate(8)AUTHOR
Heinz Mauelshagen <Linux-LVM@Sistina.com>
Index
This document was created by man2html, using the manual pages.
Time: 07:35:40 GMT, April 19, 2024