VGCFGRESTORE(8)

NAME
vgcfgrestore - restore volume group descriptor area

SYNOPSIS
vgcfgrestore [-d/--debug] [-f/--file VGConfPath] [-l[l]/--list [--list]] [-h/-?/--help] [-n/--name VolumeGroupName] [-o/--oldpath OldPhysicalVolumePath] [-t/--test] [-v/--verbose] [PhysicalVolumePath]

DESCRIPTION
vgcfgrestore allows you to restore the volume group descriptor area from backup file in /etc/lvmconf or from VGConfPath to the given PhysicalVolumePath. Default backup file is "/etc/lvmconf/VolumeGroupName.conf". This command DOESN'T restore data contained in logical volume(s)!

  OPTIONS

-d, --debug
    Enables additional debugging output (if compiled with DEBUG).

-f, --file VGConfPath
    Restore from special path. Useful for selection of specific backups in the backup history or for copies of VGDA backups.

-l, --list
    Display volume group information contained in the backup file.

-ll, --list --list
    Display volume group, physical and logical volume information contained in the backup file.

-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
    In case 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.

Examples
"vgcfgrestore -n vg00 -l" displays information like "vgdisplay vg00" stored in the backup file /etc/lvmconf/vg00.conf. "vgcfgrestore -f /tmp/vg00-old -n vg00 /dev/sdn1" restores the VGDA of vg00 from the alternate backup file /tmp/vg00-old to physical volume /dev/sdn1.

DIAGNOSTICS
vgcfgrestore returns an exit state of 0 for success and > 0 for error:
1  no physical volume on command line
2  invalid physical volume name
3  volume grou is active
4  error doing restore to physical volume
5  backup is invalid for this volume group
6  volume group is inconsitent
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 inseting 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@ez-darmstadt.telekom.de>