vgcfgrestore(1M)vgcfgrestore(1M)NAMEvgcfgrestore - display or restore LVM volume group configuration from
backup file or kernel memory
SYNOPSIS
vg_name
vg_name old_pv_path] pv_path
vg_conf_path
vg_conf_path old_pv_path] pv_path
pv_path
Remarks
cannot be performed if the volume group is activated in shared mode.
cannot be performed on devices attached to activated volume groups.
Prior to restoring a backup configuration to a disk, detach the physi‐
cal volume from the volume group using the command (see pvchange(1M)),
or deactivate the volume group using the command (see vgchange(1M)).
will refuse to restore a configuration to a physical volume with a
block size different than the block size stored in the configuration
backup file for that physical volume.
DESCRIPTION
The command restores the LVM configuration data from a default option)
or alternate option) configuration backup file, or from kernel memory
option), to the physical volume named by pv_path. Or, it displays the
configuration data on standard output option).
The configuration stored for one physical volume, old_pv_path, can be
copied to another physical volume pv_path option).
Options and Arguments
recognizes the following options and arguments:
pv_path The raw (character) device path name of a
physical volume that is currently online.
If the option is omitted, pv_path must spec‐
ify a physical volume whose configuration is
stored in the configuration backup file.
Get configuration information from the alternate configuration
backup file
vg_conf_path.
This option is applicable to input arguments belonging to volume
groups version 1.0.
Forcibly restore the LVM configuration data
even if the physical volume has alternate
block(s) allocated inside the user data
area. This option should be used with
extreme caution. User is advised to fix the
problem because potential data corruption
could occur.
Get configuration information from LVM data structures in kernel
memory.
The volume group containing pv_path must be
activated in order to use this option.
List the configuration information
saved in the specified configuration backup
file.
Get configuration information from the default configuration
backup file:
vg_name is the path name of the volume
group.
base_vg_name is the base name of vg_name.
For example, if vg_name is specified as
base_vg_name is
Restore the configuration information saved for physical volume
old_pv_path to physical volume pv_path.
This option is useful when a physical vol‐
ume's name has changed since the configura‐
tion backup file was created or updated.
old_pv_path must be the path name of a phys‐
ical volume whose configuration is stored in
the configuration backup file. It needs not
be currently online.
pv_path must be the path name of a physical
volume that is currently online. Its con‐
figuration needs not be stored in the con‐
figuration backup file.
Forcibly restore the LVM configuration data even if there is a
physical
volume mismatch between the kernel and the
configuration backup file with the volume
group still active. This option should not
be used unless the configuration file is
absolutely valid and up-to-date. Restoring
invalid configuration data can result in
data corruption later.
If there are alternate physical volume links
configured in the system, the following mes‐
sage will appear when total number of physi‐
cal volumes in the kernel does not match
with the configuration backup file due to
missing alternate physical volume links:
Mismatch between the backup file and the
running kernel: Kernel indicates X disks for
/dev/vgname; /etc/lvmconf/vgname indicates Y
disks. Cannot proceed with the restoration.
Deactivate the Volume Group and try again.
In this case, the user is advised to deacti‐
vate the volume group first, then use the
command to restore configuration data when
the volume group is unavailable. But if the
volume group has to stay available and the
user is absolutely sure the configuration
file is correct, this option will restore
data from the configuration file when the
volume group stays available.
Provide additional information when invoked together with
option.
· Additional values displayed for each path:
· Disk size in kilobytes
· Starting block number (kb) of the user
data.
· The PVkey (see Note that paths with the
same key are links to the same device.
Additional values displayed for each volume
group:
· max_pv
· max_pe
· max_lv
· vg_version
· vg_size (only volume groups version 2.0 or
higher, see vgcreate(1M))
RETURN VALUE
exits with one of the following values:
Successful completion.
Failure.
Errors occurred during the restore operation.
EXTERNAL INFLUENCES
Environment Variables
determines the language in which messages are displayed.
If is not specified or is null, it defaults to "C" (see lang(5)).
If any internationalization variable contains an invalid setting, all
internationalization variables default to "C" (see environ(5)).
EXAMPLES
Restore the LVM configuration information for the physical volume that
was saved in the default file
Force to restore the LVM configuration data when volume group is still
active:
Restore the LVM configuration information to physical volume using
alternate configuration file
List backup information saved in default configuration file
Above command might display the following:
Restore LVM configuration information stored for in default configura‐
tion file to physical volume
Restore LVM configuration information to physical volume using LVM data
structures in kernel memory. The volume group containing must be acti‐
vated:
AUTHOR
was developed by HP.
SEE ALSOpvchange(1M), vgcfgbackup(1M), vgchange(1M), intro(7), lvm(7).
vgcfgrestore(1M)