vgcfgrestor.1m (2010 09)

v
vgcfgrestore(1M) vgcfgrestore(1M)
-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 needs not be currently online.
pv_path must be the path name of a physical volume that is currently online.
Its configuration needs not be stored in the configuration backup file.
-R 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 fol-
lowing message will appear when total number of physical volumes in the ker-
nel 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; the configuration file vgname.conf
indicates Y disks. Cannot proceed with the restoration. Deactivate
the Volume Group and try again.
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.
-v Provide additional information when invoked together with -l option.
Additional values displayed for each path:
Disk size in kilobytes
Starting block number (kb) of the user data.
The PVkey (see
lvdisplay -k). 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
vgcfgrestore exits with one of the following values:
0 Successful completion.
>0 Failure. Errors occurred during the restore operation.
EXTERNAL INFLUENCES
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
Restore the LVM configuration information for the physical volume /dev/rdsk/c0t7d0 that was saved
in the default file vg00.conf in the path /etc/lvmconf, or the configured path if the volume group
2 Hewlett-Packard Company 2 HP-UX 11i Version 3: September 2010