vgcfgbackup(1M)

NAME

vgcfgbackup — create or update LVM volume group configuration backup file

SYNOPSIS

/usr/sbin/vgcfgbackup [-f vg_conf_path] [-u] vg_name

DESCRIPTION

The vgcfgbackup command saves the LVM configuration for a volume group in a default or alternate configuration backup file (see the -f option).

By default, vgcfgbackup runs automatically each time an LVM command changes the LVM configuration. In this case, it always uses the default configuration backup file. An existing default configuration backup file is renamed with an extension of .old.

Options and Arguments

vgcfgbackup recognizes the following options and arguments:

vg_name

The path name of a volume group.

-f vg_conf_path

Save the configuration using an alternate file name specified by vg_conf_path.

If -f is omitted, the default file name is in the form:

/etc/lvmconf/base_vg_name.conf

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.

-u

Update the configuration backup file with the latest LVM configuration. Only those physical volumes added since the configuration backup file was last modified need to be online.

If -u is omitted, all physical volumes for vg_name must be online.

RETURN VALUE

vgcfgbackup exits with one of the following values:

0: Successful completion.
>0: Failure. Errors occurred when information from the volume group was being accessed.

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

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

vgcfgbackup /dev/vg00 

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

vgcfgbackup -u /dev/vg00 

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

vgcfgbackup -f /tmp/vg00.backup vg00 

WARNINGS

It is recommended that any alternate configuration backup file be created in the root file system (as is the case with the default path name). This facilitates easy volume group recovery during maintenance mode, such as after a system crash.

AUTHOR

vgcfgbackup was developed by HP.