NAME

vgcfgrestore − restore volume group configuration from a configuration file

SYNOPSIS

vgcfgrestore {-n vol_group_name| -f vg_conf_path} -l
vgcfgrestore {-n vol_group_name| -f vg_conf_path} [-o old_pv_path] pv_path

DESCRIPTION

vgcfgrestore restores LVM configuration from configuration file /etc/lvmconf/vol_group_name.conf or vg_conf_path to Physical Volume pv_path depending upon options chosen. 

vol_group_name is the directory name containing the volume group’s special files, and is extracted from vol_group_name (e.g., if vol_group_name specified is /dev/vg00, vol_group_name extracted is vg00). 

Use the -o option to restore configuration saved for old_pv_path to the disk specified by pv_path (e.g., when a Physical Volume’s name has changed since the backup was taken using vgcfgbackup(1M)).

The -l option lists the configuration information saved in the configuration file. 

If -o is not specified, pv_path must belong to the volume group corresponding to the configuration file.  Otherwise old_pv_path must belong to the volume group when vgcfgbackup was executed. 

Options

vgcfgrestore recognizes the following options and accompanying arguments:

-n vol_group_name
Identifies the configuration file ( /etc/lvmconf/vol_group_name.conf ) that contains the configuration information.  See above for description of vol_group_name.  -n cannot be used with the -f option. 

-f vg_conf_path
Identifies the configuration file (vg_conf_path) that contains the configuration information. The -f option cannot be used with the -n option. 

-l Lists configuration information saved in the configuration file. 

-o old_pv_path Used to restore configuration information saved for physical volume old_pv_path to pv_path.

RETURN VALUE

vgcfgrestore exits with one of the following values:

 0 LVM configuration was restored successfully. 

>0 vgcfgrestore aborted because 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 set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. 

If any internationalization variable contains an invalid setting, vgcfgrestore behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Restore the LVM configuration information for the physical volume /dev/rdsk/c7d0s2 that was saved in the default file /etc/lvmconf/vg00.conf:

vgcfgrestore -n /dev/vg00 /dev/rdsk/c7d0s2

Restore LVM configuration information to physical volume /dev/rdsk/c4d0s2 using configuration file /tmp/vg00.backup:

vgcfgrestore -f /tmp/vg00.backup /dev/rdsk/c4d0s2

List back up information saved in configuration file /etc/lvmconf/vg01.conf:

vgcfgrestore -n /dev/vg01 -l

Restore LVM configuration information stored for /dev/rdsk/c7d0s2 in configuration file /etc/lvmconf/vg01.conf to physical volume /dev/rdsk/c6d0s2:

vgcfgrestore -n /dev/vg01 -o /dev/rdsk/c7d0s2 /dev/rdsk/c6d0s2

WARNINGS

Volume group should preferably be made non-available before executing vgcfgrestore by using vgchange -a n vol_group_name.

AUTHOR

vgcfgrestore was developed by HP. 

SEE ALSO

vgcfgbackup(1M). 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992