vgcfgrestore man page

vgcfgrestore — restore volume group descriptor area

Synopsis

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

Description

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

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.

--force

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 precisely.

Replacing Physical Volumes

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

lvm(8), vgcreate(8)

Referenced By

lvm(8), pvcreate(8), vgcfgbackup(8), vgconvert(8), vgcreate(8), vgextend(8).

LVM TOOLS 2.02.168(2) (2016-11-30) Sistina Software UK