vgcfgrestore(1M) vgcfgrestore(1M)
NAME [Toc] [Back]
vgcfgrestore - display or restore LVM volume group configuration from
backup file
SYNOPSIS [Toc] [Back]
/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 [Toc] [Back]
vgcfgrestore cannot be performed if the volume group is activated in
shared mode.
DESCRIPTION [Toc] [Back]
The vgcfgrestore command restores the LVM configuration data from a
default (-n option) or alternate (-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 [Toc] [Back]
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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
vgcfgrestore(1M) vgcfgrestore(1M)
-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 configuration data can
result in data corruption later.
If there are alternate physical volume links
configured in the system, the following
message will appear when total number of
physical 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.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
vgcfgrestore(1M) vgcfgrestore(1M)
In this case, the user is advised to
deactivate the volume group first, then use
the vgcfgrestore 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.
RETURN VALUE [Toc] [Back]
vgcfgrestore exits with one of the following values:
0 Successful completion.
>0 Failure. Errors occurred during the restore operation.
EXTERNAL INFLUENCES [Toc] [Back]
Environment Variables
LANG determines the language in which messages are displayed.
If LANG 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 [Toc] [Back]
Restore the LVM configuration information for the physical volume
/dev/rdsk/c0t7d0 that was saved in the default file
/etc/lvmconf/vg00.conf:
vgcfgrestore -n /dev/vg00 /dev/rdsk/c0t7d0
Force to restore the LVM configuration data when volume group is still
active
vgcfgrestore -R -n /dev/vg00 /dev/rdsk/c0t7d0
Restore the LVM configuration information to physical volume
/dev/rdsk/c0t4d0 using alternate configuration file /tmp/vg00.backup:
vgcfgrestore -f /tmp/vg00.backup /dev/rdsk/c0t4d0
List backup information saved in default configuration file
/etc/lvmconf/vg00.conf:
vgcfgrestore -n /dev/vg00 -l
Above command might display the following:
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
vgcfgrestore(1M) vgcfgrestore(1M)
Volume Group Configuration information in "/etc/lvmconf/vg00.conf"
VG Name /dev/vg00
---- Physical volumes : 2 ----
/dev/rdsk/c0t6d0 (Bootable)
/dev/rdsk/c0t5d0 (Non-bootable)
Restore LVM configuration information stored for /dev/rdsk/c0t7d0 in
default configuration file /etc/lvmconf/vg01.conf to physical volume
/dev/rdsk/c0t6d0:
vgcfgrestore -n /dev/vg01 -o /dev/rdsk/c0t7d0 /dev/rdsk/c0t6d0
WARNINGS [Toc] [Back]
Preferably, the volume group should be made unavailable before
executing vgcfgrestore by executing the command
vgchange -a n vg_name
AUTHOR [Toc] [Back]
vgcfgrestore was developed by HP.
SEE ALSO [Toc] [Back]
vgcfgbackup(1M).
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003 [ Back ] |
