Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > V


HP-UX 11i Version 3: February 2007

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index


vgcfgrestore — display or restore LVM volume group configuration from backup file


/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


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)).


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

vgcfgrestore recognizes the following options and arguments:


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.


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.


List the configuration information saved in the specified configuration backup file.

-n vg_name

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 /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.


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 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.

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.


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


vgcfgrestore exits with one of the following values:


Successful completion.


Failure. Errors occurred during the restore operation.


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)).


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:

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


vgcfgrestore was developed by HP.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.