HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

v
vgcfgbackup(1M) 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.
Section 1M−−848 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003