vgcfgrestor.1m (2010 09)

v
vgcfgrestore(1M) vgcfgrestore(1M)
NAME
vgcfgrestore - display or restore LVM volume group configuration from backup file or kernel memory
SYNOPSIS
/usr/sbin/vgcfgrestore -n
vg_name -l
[-v]
/usr/sbin/vgcfgrestore
[-R
][-F] -n vg_name [-o old_pv_path ] pv_path
/usr/sbin/vgcfgrestore -f
vg_conf_path -l
[-v]
/usr/sbin/vgcfgrestore [-R] [-F] -f
vg_conf_path [-o old_pv_path ] pv_path
/usr/sbin/vgcfgrestore -k
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 physical volume from the volume group using the
pvchange
command (see pvchange (1M)), or deactivate the volume group using the
vgchange command (see
vgchange (1M)).
vgcfgrestore 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
vgcfgrestore command restores the LVM configuration data from a default (
-n option) or alter-
nate (
-f option) configuration backup file, or from kernel memory (-k option), 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 is applicable to input arguments belonging to volume groups ver-
sion 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.
-k 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.
-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.
For volume group version 2.0 and higher, if the configuration backup file is not
found at the default path
/etc/lvmconf, then it is also searched in the path
configured using the LVMP_CONF_PATH_NON_BOOT variable in the
/etc/lvmrc file. See vgcfgbackup (1M) for more details about this variable.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1