vgcfgrestore(1M)

NAME

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

SYNOPSIS

/sbin/vgcfgrestore -n vg_name -l

/sbin/vgcfgrestore -n vg_name [-o old_pv_path] pv_path

/sbin/vgcfgrestore -f vg_conf_path -l

/sbin/vgcfgrestore -f vg_conf_path [-o old_pv_path] pv_path

DESCRIPTION

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:

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.

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

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

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 /etc/lvmconf/vg00.conf:

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

which 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

WARNINGS

Preferably, the volume group should be made unavailable before executing vgcfgrestore by executing the command

vgchange -a n vg_name

AUTHOR

vgcfgrestore was developed by HP.

Museum

Related Articles