HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)
v
vgcfgrestore(1M) vgcfgrestore(1M)
NAME
vgcfgrestore - display or restore LVM volume group configuration from backup file
SYNOPSIS
/usr/sbin/vgcfgrestore -n
vg_name -l
/usr/sbin/vgcfgrestore [-R] [-F] -n
vg_name [-o old_pv_path] pv_path
/usr/sbin/vgcfgrestore -f
vg_conf_path -l
/usr/sbin/vgcfgrestore [-R] [-F] -f
vg_conf_path [-o old_pv_path] pv_path
Remarks
vgcfgrestore cannot be performed if the volume group is activated in shared mode.
vgcfgrestore cannot be performed on devices attached to activated volume groups. Prior to restoring a
backup configuration to a disk, detach the PV from the volume group using the pvchange(1M) command, or
deactivate the volume group using the vgchange(1M) command.
DESCRIPTION
The
vgcfgrestore command restores the LVM configuration data from a default (-n
option) or alter-
nate (
-f option) configuration backup file to the physical volume named by pv_path. Or, it displays the
configuration data on standard output (
-l option).
The configuration stored for one physical volume, old_pv_path, can be copied to another physical volume
pv_path (-o option).
Options and Arguments
vgcfgrestore recognizes the following options and arguments:
pv_path The raw (character) device path name of a physical volume that is currently
online.
If the -o option is omitted, pv_path must specify a physical volume whose
configuration is stored in the configuration backup file.
-f vg_conf_path Get configuration information from the alternate configuration backup file
vg_conf_path.
-F This option will force restoring 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.
-l List the configuration information saved in the specified configuration backup
file.
-n vg_name Get configuration information from the default configuration backup file:
/etc/lvmconf/ base_vg_name.conf
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 /dev/vg00, base_vg_name is vg00.
-o old_pv_path Restore the configuration information saved for physical volume old_pv_path to
physical volume pv_path.
This option is useful when a physical volume’s name has changed since the
configuration backup file was created or updated.
old_pv_path must be the path name of a physical volume whose configuration is
stored in the configuration backup file. It need not be currently online.
pv_path must be the path name of a physical volume that is currently online. Its
configuration need not be stored in the configuration backup file.
-R This option will force restoring 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
Section 1M−−1060 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005