NAME

vgcfgbackup − create or update volume group configuration backup file

SYNOPSIS

vgcfgbackup [-u] [-f vg_conf_path] vol_group_name

DESCRIPTION

vgcfgbackup saves LVM configuration for volume group vol_group_name in vg_conf_path if provided, otherwise in /etc/lvmconf/vol_group_name.conf by default. 

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

The -u option updates the configuration file with the latest LVM configuration.  Note that all physical volumes for vol_group_name should be on-line to create a new configuration file.  This condition is not necessary for update (-u), in which case only those physical volumes added since the last backup was taken need to be on-line. 

Options

vgcfgbackup recognizes the following options and arguments:

-f vg_conf_path
Saves configuration in file specified by vg_conf_path.

-u Updates configuration file with latest LVM configuration. 

Note:  It is recommended that the back-up file be created in the root file system (as is the case with the default pathname) to facilitate easy volume group recovery during maintenance mode, such as after a system crash. 

RETURN VALUE

vgcfgbackup exits with one of the following values:

 0 LVM configuration was saved successfully. 

>0 vgcfgbackup aborted because errors occurred when accessing information from volume group. 

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, vgcfgbackup behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Back up LVM configuration information for volume group /dev/vg00 in the default file /etc/lvmconf/vg00.conf:

vgcfgbackup /dev/vg00

Update LVM configuration information corresponding to volume group /dev/vg00 in the default file /etc/lvmconf/vg00.conf:

vgcfgbackup -u /dev/vg00

Back up LVM configuration information for volume group /dev/vg00 in the file /tmp/vg00.backup:

vgcfgbackup -f /tmp/vg00.backup vg00

WARNINGS

All Physical Volumes must be on-line when creating a new configuration file. 

AUTHOR

vgcfgbackup was developed by HP. 

SEE ALSO

vgcfgrestore(1M). 

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995