hpux 10.20 - vgcfgrestore (1)

 NAME
      vgcfgrestore - display or restore LVM volume group configuration from
      backup file

 SYNOPSIS
      /sbin/vgcfgrestore -n vg_name -l

      /sbin/vgcfgrestore -n vg_name [-o old_pv_path] pv_path

      /sbin/vgcfgrestore -f vg_conf_path -l

      /sbin/vgcfgrestore -f vg_conf_path [-o old_pv_path] pv_path

 DESCRIPTION
      The vgcfgrestore command restores the LVM configuration data from a
      default (-n option) or alternate (-f option) configuration backup file
      to the physical volume named by pv_path.  Or it displays the
      configuration data on standard output (-l option).

      The configuration stored for one physical volume, old_pv_path, can be
      copied to another physical volume pv_path (-o option).

    Options and Arguments
      vgcfgrestore recognizes the following options and arguments:

           pv_path             The raw (character) device path name of a
                               physical volume that is currently online.

                               If the -o option is omitted, pv_path must
                               specify a physical volume whose configuration
                               is stored in the configuration backup file.

           -f vg_conf_path     Get configuration information from the
                               alternate configuration backup file
                               vg_conf_path.

           -l                  List the configuration information saved in
                               the specified configuration backup file.

           -n vg_name          Get configuration information from the
                               default configuration backup file:

                                    /etc/lvmconf/base_vg_name.conf

                               vg_name is the path name of the volume group.

                               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.



           -o old_pv_path      Restore the configuration information saved
                               for physical volume old_pv_path to physical
                               volume pv_path.

                               This option is useful when a physical
                               volume's name has changed since the
                               configuration backup file was created or
                               updated.

                               old_pv_path must be the path name of a
                               physical volume whose configuration is stored
                               in the configuration backup file.  It need
                               not be currently online.

                               pv_path must be the path name of a physical
                               volume that is currently online.  Its
                               configuration need not be stored in the
                               configuration backup file.

 RETURN VALUE
      vgcfgrestore exits with one of the following values:

            0   Successful completion.
           >0   Failure.  Errors occurred during the restore operation.

 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
      Restore the LVM configuration information for the physical volume
      /dev/rdsk/c0t7d0 that was saved in the default file
      /etc/lvmconf/vg00.conf:

           vgcfgrestore -n /dev/vg00 /dev/rdsk/c0t7d0

      Restore the LVM configuration information to physical volume
      /dev/rdsk/c0t4d0 using alternate configuration file /tmp/vg00.backup:

           vgcfgrestore -f /tmp/vg00.backup /dev/rdsk/c0t4d0

      List backup information saved in default configuration file
      /etc/lvmconf/vg00.conf:

           vgcfgrestore -n /dev/vg00 -l


      which might display the following:

           Volume Group Configuration information in "/etc/lvmconf/vg00.conf"
           VG Name /dev/vg00
            ---- Physical volumes : 2 ----
               /dev/rdsk/c0t6d0 (Bootable)
               /dev/rdsk/c0t5d0 (Non-bootable)

      Restore LVM configuration information stored for /dev/rdsk/c0t7d0 in
      default configuration file /etc/lvmconf/vg01.conf to physical volume
      /dev/rdsk/c0t6d0:

           vgcfgrestore -n /dev/vg01 -o /dev/rdsk/c0t7d0 /dev/rdsk/c0t6d0

 WARNINGS
      Preferably, the volume group should be made unavailable before
      executing vgcfgrestore by executing the command

           vgchange -a n vg_name

 AUTHOR
      vgcfgrestore was developed by HP.

 SEE ALSO
      vgcfgbackup(1M).