mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
437 lines
8.2 KiB
Plaintext
437 lines
8.2 KiB
Plaintext
.TH VGCFGRESTORE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
|
|
.SH NAME
|
|
vgcfgrestore - Restore volume group configuration
|
|
.
|
|
.SH SYNOPSIS
|
|
\fBvgcfgrestore\fP \fIoption_args\fP \fIposition_args\fP
|
|
.br
|
|
[ \fIoption_args\fP ]
|
|
.br
|
|
[ \fIposition_args\fP ]
|
|
.br
|
|
.P
|
|
.ad l
|
|
\fB--commandprofile\fP \fIString\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB--config\fP \fIString\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-d\fP|\fB--debug\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB--driverloaded\fP \fBy\fP|\fBn\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-f\fP|\fB--file\fP \fIString\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB--force\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-h\fP|\fB--help\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-l\fP|\fB--list\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB--lockopt\fP \fIString\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB--longhelp\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB--profile\fP \fIString\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-q\fP|\fB--quiet\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-t\fP|\fB--test\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-v\fP|\fB--verbose\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB--version\fP
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
\fB-y\fP|\fB--yes\fP
|
|
.ad b
|
|
.SH DESCRIPTION
|
|
vgcfgrestore restores the metadata of a VG from a text back up file
|
|
produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices
|
|
specifed in back up file.
|
|
|
|
A back up file can be specified with \fB--file\fP. If no backup file is
|
|
specified, the most recent one is used. Use \fB--list\fP for a list of
|
|
the available back up and archive files of a VG.
|
|
|
|
WARNING: When a VG contains thin pools, changes to thin metadata cannot be
|
|
reverted, and data loss may occur if thin metadata has changed. The force
|
|
option is required to restore in this case.
|
|
.SH USAGE
|
|
Restore VG metadata from last backup.
|
|
.br
|
|
.P
|
|
\fBvgcfgrestore\fP \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
[ COMMON_OPTIONS ]
|
|
.RE
|
|
.br
|
|
-
|
|
|
|
Restore VG metadata from specified file.
|
|
.br
|
|
.P
|
|
\fBvgcfgrestore\fP \fB-f\fP|\fB--file\fP \fIString\fP \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
[ COMMON_OPTIONS ]
|
|
.RE
|
|
.br
|
|
-
|
|
|
|
List all VG metadata backups.
|
|
.br
|
|
.P
|
|
\fBvgcfgrestore\fP \fB-l\fP|\fB--list\fP \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
[ COMMON_OPTIONS ]
|
|
.RE
|
|
.br
|
|
-
|
|
|
|
List one VG metadata backup file.
|
|
.br
|
|
.P
|
|
\fBvgcfgrestore\fP \fB-l\fP|\fB--list\fP \fB-f\fP|\fB--file\fP \fIString\fP
|
|
.br
|
|
.RS 4
|
|
[ COMMON_OPTIONS ]
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
[ \fIVG\fP ]
|
|
.RE
|
|
-
|
|
|
|
Common options for command:
|
|
.
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--force\fP ]
|
|
.ad b
|
|
.RE
|
|
|
|
Common options for lvm:
|
|
.
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-d\fP|\fB--debug\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB-h\fP|\fB--help\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB-q\fP|\fB--quiet\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB-t\fP|\fB--test\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB-v\fP|\fB--verbose\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB-y\fP|\fB--yes\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--commandprofile\fP \fIString\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--config\fP \fIString\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--lockopt\fP \fIString\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--longhelp\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--profile\fP \fIString\fP ]
|
|
.ad b
|
|
.br
|
|
.ad l
|
|
[ \fB--version\fP ]
|
|
.ad b
|
|
.RE
|
|
.SH OPTIONS
|
|
.HP
|
|
.ad l
|
|
\fB--commandprofile\fP \fIString\fP
|
|
.br
|
|
The command profile to use for command configuration.
|
|
See \fBlvm.conf\fP(5) for more information about profiles.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB--config\fP \fIString\fP
|
|
.br
|
|
Config settings for the command. These override lvm.conf settings.
|
|
The String arg uses the same format as lvm.conf,
|
|
or may use section/field syntax.
|
|
See \fBlvm.conf\fP(5) for more information about config.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-d\fP|\fB--debug\fP ...
|
|
.br
|
|
Set debug level. Repeat from 1 to 6 times to increase the detail of
|
|
messages sent to the log file and/or syslog (if configured).
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB--driverloaded\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
If set to no, the command will not attempt to use device-mapper.
|
|
For testing and debugging.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-f\fP|\fB--file\fP \fIString\fP
|
|
.br
|
|
Read metadata backup from the named file.
|
|
Usually this file was created by vgcfgbackup.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB--force\fP ...
|
|
.br
|
|
Force metadata restore even with thin pool LVs.
|
|
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.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-h\fP|\fB--help\fP
|
|
.br
|
|
Display help text.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-l\fP|\fB--list\fP
|
|
.br
|
|
List metadata backup and archive files pertaining to the VG.
|
|
May be used with --file. Does not restore the VG.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB--lockopt\fP \fIString\fP
|
|
.br
|
|
Used to pass options for special cases to lvmlockd.
|
|
See \fBlvmlockd\fP(8) for more information.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB--longhelp\fP
|
|
.br
|
|
Display long help text.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
|
|
.br
|
|
Specifies the type of on-disk metadata to use.
|
|
\fBlvm2\fP (or just \fB2\fP) is the current, standard format.
|
|
\fBlvm1\fP (or just \fB1\fP) is a historical format that
|
|
can be used for accessing old data.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB--profile\fP \fIString\fP
|
|
.br
|
|
An alias for --commandprofile or --metadataprofile, depending
|
|
on the command.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-q\fP|\fB--quiet\fP ...
|
|
.br
|
|
Suppress output and log messages. Overrides --debug and --verbose.
|
|
Repeat once to also suppress any prompts with answer 'no'.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-t\fP|\fB--test\fP
|
|
.br
|
|
Run in test mode. Commands will not update metadata.
|
|
This is implemented by disabling all metadata writing but nevertheless
|
|
returning success to the calling function. This may lead to unusual
|
|
error messages in multi-stage operations if a tool relies on reading
|
|
back metadata it believes has changed but hasn't.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-v\fP|\fB--verbose\fP ...
|
|
.br
|
|
Set verbose level. Repeat from 1 to 4 times to increase the detail
|
|
of messages sent to stdout and stderr.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB--version\fP
|
|
.br
|
|
Display version information.
|
|
.ad b
|
|
.HP
|
|
.ad l
|
|
\fB-y\fP|\fB--yes\fP
|
|
.br
|
|
Do not prompt for confirmation interactively but always assume the
|
|
answer yes. Use with extreme caution.
|
|
(For automatic no, see -qq.)
|
|
.ad b
|
|
.SH VARIABLES
|
|
.HP
|
|
\fIVG\fP
|
|
.br
|
|
Volume Group name. See \fBlvm\fP(8) for valid names.
|
|
.HP
|
|
\fIString\fP
|
|
.br
|
|
See the option description for information about the string content.
|
|
.HP
|
|
\fISize\fP[UNIT]
|
|
.br
|
|
Size is an input number that accepts an optional unit.
|
|
Input units are always treated as base two values, regardless of
|
|
capitalization, e.g. 'k' and 'K' both refer to 1024.
|
|
The default input unit is specified by letter, followed by |UNIT.
|
|
UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
|
|
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
|
|
m|M is megabytes, g|G is gigabytes, t|T is terabytes,
|
|
p|P is petabytes, e|E is exabytes.
|
|
(This should not be confused with the output control --units, where
|
|
capital letters mean multiple of 1000.)
|
|
.SH ENVIRONMENT VARIABLES
|
|
See \fBlvm\fP(8) for information about environment variables used by lvm.
|
|
For example, LVM_VG_NAME can generally be substituted for a required VG parameter.
|
|
.SH NOTES
|
|
|
|
To replace PVs, \fBvgdisplay --partial --verbose\fP will show 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
|
|
\fBpvcreate --restorefile filename --uuid uuid\fP (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
|
|
\fBvgcfgrestore --file filename\fP to restore the VG's metadata.
|
|
.SH SEE ALSO
|
|
|
|
.BR lvm (8)
|
|
.BR lvm.conf (5)
|
|
.BR lvmconfig (8)
|
|
|
|
.BR pvchange (8)
|
|
.BR pvck (8)
|
|
.BR pvcreate (8)
|
|
.BR pvdisplay (8)
|
|
.BR pvmove (8)
|
|
.BR pvremove (8)
|
|
.BR pvresize (8)
|
|
.BR pvs (8)
|
|
.BR pvscan (8)
|
|
|
|
.BR vgcfgbackup (8)
|
|
.BR vgcfgrestore (8)
|
|
.BR vgchange (8)
|
|
.BR vgck (8)
|
|
.BR vgcreate (8)
|
|
.BR vgconvert (8)
|
|
.BR vgdisplay (8)
|
|
.BR vgexport (8)
|
|
.BR vgextend (8)
|
|
.BR vgimport (8)
|
|
.BR vgimportclone (8)
|
|
.BR vgmerge (8)
|
|
.BR vgmknodes (8)
|
|
.BR vgreduce (8)
|
|
.BR vgremove (8)
|
|
.BR vgrename (8)
|
|
.BR vgs (8)
|
|
.BR vgscan (8)
|
|
.BR vgsplit (8)
|
|
|
|
.BR lvcreate (8)
|
|
.BR lvchange (8)
|
|
.BR lvconvert (8)
|
|
.BR lvdisplay (8)
|
|
.BR lvextend (8)
|
|
.BR lvreduce (8)
|
|
.BR lvremove (8)
|
|
.BR lvrename (8)
|
|
.BR lvresize (8)
|
|
.BR lvs (8)
|
|
.BR lvscan (8)
|
|
|
|
.BR lvm-fullreport (8)
|
|
.BR lvm-lvpoll (8)
|
|
.BR lvm2-activation-generator (8)
|
|
.BR blkdeactivate (8)
|
|
.BR lvmdump (8)
|
|
|
|
.BR dmeventd (8)
|
|
.BR lvmetad (8)
|
|
.BR lvmpolld (8)
|
|
.BR lvmlockd (8)
|
|
.BR lvmlockctl (8)
|
|
.BR clvmd (8)
|
|
.BR cmirrord (8)
|
|
.BR lvmdbusd (8)
|
|
|
|
.BR lvmsystemid (7)
|
|
.BR lvmreport (7)
|
|
.BR lvmraid (7)
|
|
.BR lvmthin (7)
|
|
.BR lvmcache (7)
|