VGCFGRESTORE(8)                                                VGCFGRESTORE(8)

       vgcfgrestore - restore volume group descriptor area

       vgcfgrestore  [-b|--backup_number VolumeGroupBackupNumber] [-d|--debug]
       [-f|--file    VGConfPath]    [-l[l]|--list    [--list]]     [-h|--help]
       [-i|--ignore_size]  [-n|--name VolumeGroupName] [-o|--oldpath OldPhysi-
       calVolumePath] [-t|--test] [-v|--verbose] [PhysicalVolumePath]

       vgcfgrestore allows you to restore the  volume  group  descriptor  area
       from backup files in /etc/lvmconf or from VGConfPath to the given Phys-
       icalVolumePath.  The default backup file  is  /etc/lvmconf/VolumeGroup-
       Name.conf.   This  command  DOES  NOT restore data contained in logical
       volume(s), only the LVM configuration metadata!

       -b, --backup_numberVolumeGroupBackupNumber
              Restore from the specified  backup  number.  Use  together  with
              option -n which gives the name of the volume group. See examples

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

       -f, --file VGConfPath
              Restore from the specified path. Useful for  selection  of  spe-
              cific  backups in the backup history or for copies of VGDA back-

       -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 con-
              tained 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 activi-

              Output the version number and exit successfully.

       To display information like with "vgdisplay vg00" stored in the  backup
       file /etc/lvmconf/vg00.conf:

            vgcfgrestore -n vg00 -l

       To   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
       to physical volume
       /dev/sda5 :

            vgcfgrestore -n vg00 -b 5 /dev/sda5

       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

       lvm(8), vgcfgbackup(8), vgcreate(8)

       Heinz Mauelshagen <>

Heinz Mauelshagen                  LVM TOOLS                   VGCFGRESTORE(8)