vgcfgbackup(1M)                                             vgcfgbackup(1M)




 NAME    [Toc]    [Back]
      vgcfgbackup - create or update LVM volume group configuration backup
      file

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/vgcfgbackup [-f vg_conf_path] [-u] vg_name

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
      vgcfgbackup exits with one of the following values:

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





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 vgcfgbackup(1M)                                             vgcfgbackup(1M)




 EXTERNAL INFLUENCES    [Toc]    [Back]
    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    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
      vgcfgbackup was developed by HP.

 SEE ALSO    [Toc]    [Back]
      vgcfgrestore(1M).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003