vgcfgbackup.1m (2010 10)

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.
The default path to store LVM configuration backup file is configurable for volume group version 2.0 and
higher. See the Configuring Default Configuration Backup Path: VG Version 2.0 and Higher section
below for details.
The volume group must be activated when it is backed up using
vgcfgbackup. See vgchange (1M) for
volume group activation.
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.
Note that the default path,
/etc/lvmconf, can be changed for volume group
version 2.0 and higher. See Configuring Default Configuration Backup Path:
VG Version 2.0 and Higher below.
-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.
Configuring Default Configuration Backup Path: VG Version 2.0 and Higher
By default LVM volume group configuration files will be stored in the
/etc/lvmconf path for all ver-
sions of volume groups.
For volume group versions 2.0 and higher, because the size of the configuration backup file can be large, a
new configuration variable,
LVMP_CONF_PATH_NON_BOOT, is introduced in the /etc/lvmrc
file to
configure the default location for backing up volume group configuration. This is available from the HP-
UX 11i v3 March 2010 Update and forward. Once this change for the configuration backup information is
made, all future configuration backups (including those which occur as a result of the default
-A y set-
ting of other LVM commands) and restores will use this location, for volume group version 2.0 and higher.
• This configuration is applicable only for non-bootable volume groups with version 2.0 or higher. Non-
bootable volume group referred in this context is any volume group with no Physical Volume that was
set up as bootable using
pvcreate. Use the pvdisplay command with the -d or -lu option to
check whether a PV was set up as bootable.
• Edit the
/etc/lvmrc text file and change the LVMP_CONF_PATH_NON_BOOT variable definition to
configure a new path. Specify the absolute path of a valid directory. For example, to configure the
path as /usr/mylvmconf, change the variable definition as below:
LVMP_CONF_PATH_NON_BOOT="/usr/mylvmconf"
• After a new path is configured, the existing configuration files (if any) at the old path belonging to
non-bootable volume groups with version 2.0 or higher will not be moved to the new path automati-
cally. They can be moved manually or the -f option can be used in future configuration restore opera-
tions.
HP-UX 11i Version 3: October 2010 − 1 − Hewlett-Packard Company 1