VGCFGRESTORE(8)            System Manager's Manual           VGCFGRESTORE(8)

NAME         top

       vgcfgrestore — restore volume group descriptor area

SYNOPSIS         top

       vgcfgrestore [--commandprofile ProfileName] [-d|--debug] [-f|--file
       <filename>] [--force] [-l[l]|--list] [-h|--help] [-M|--metadatatype
       1|2] [-t|--test] [-v|--verbose] VolumeGroupName

DESCRIPTION         top

       vgcfgrestore allows you to restore the metadata of VolumeGroupName
       from a text backup file produced by vgcfgbackup.  You can specify a
       backup file with --file.  If no backup file is specified, the most
       recent one is used.  Use --list for a list of the available backup
       and archive files of VolumeGroupName.

OPTIONS         top

       See lvm(8) for common options.

       -l, --list
              List files pertaining to VolumeGroupName List metadata backup
              and archive files pertaining to VolumeGroupName.  May be used
              with the -f option.  Does not restore VolumeGroupName.

       -f, --file filename
              Name of LVM metadata backup file Specifies a metadata backup
              or archive file to be used for restoring VolumeGroupName.
              Often this file has been created with vgcfgbackup.

              Necessary to restore metadata with thin pool volumes.
              WARNING: Use with extreme caution.  Most changes to thin
              metadata cannot be reverted.  You may lose data if you restore
              metadata that does not match the thin pool kernel metadata


       vgdisplay --partial --verbose will show you the UUIDs and sizes of
       any PVs that are no longer present.  If a PV in the VG is lost and
       you wish to substitute another of the same size, use pvcreate
       --restorefile filename --uuid uuid (plus additional arguments as
       appropriate) to initialise it with the same UUID as the missing PV.
       Repeat for all other missing PVs in the VG.  Then use vgcfgrestore
       --file filename to restore the volume group's metadata.

SEE ALSO         top

       lvm(8), vgcreate(8)

COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this
       manual page, send it to  This page was obtained
       from the project's upstream Git repository 
       ⟨⟩ on 2017-03-13.  If you
       discover any rendering problems in this HTML version of the page, or
       you believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

Sistina Software UKLVM TOOLS 2.02.169(2)-git (2016-11-30)    VGCFGRESTORE(8)