unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 vgcfgrestore(1M)					    vgcfgrestore(1M)




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

 SYNOPSIS
      /usr/sbin/vgcfgrestore -n vg_name -l

      /usr/sbin/vgcfgrestore [-R] [-F] -n vg_name [-o old_pv_path] pv_path

      /usr/sbin/vgcfgrestore -f vg_conf_path -l

      /usr/sbin/vgcfgrestore [-R] [-F] -f vg_conf_path [-o old_pv_path]
      pv_path

    Remarks
      vgcfgrestore cannot be performed if the volume group is activated in
      shared mode.

 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.

	   -F		       This option will force restoring the LVM
			       configuration data even if the physical
			       volume has alternate block(s) allocated
			       inside the user data area.  This option
			       should be used with extreme caution.  User is
			       advised to fix the problem because potential
			       data corruption could occur.

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



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 vgcfgrestore(1M)					    vgcfgrestore(1M)




	   -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.

	   -R		       This option will force restoring the LVM
			       configuration data even if there is a
			       physical volume mismatch between the kernel
			       and the configuration backup file with the
			       volume group still active.  This option
			       should not be used unless the configuration
			       file is absolutely valid and up-to-date.
			       Restoring invalid configuration data can
			       result in data corruption later.

			       If there are alternate physical volume links
			       configured in the system, the following
			       message will appear when total number of
			       physical volumes in the kernel does not match
			       with the configuration backup file due to
			       missing alternate physical volume links:

		     Mismatch between the backup file and the running kernel:
		     Kernel indicates X disks for /dev/vgname; /etc/lvmconf/vgname
		     indicates Y disks.	 Cannot proceed with the restoration.
		     Deactivate the Volume Group and try again.



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 vgcfgrestore(1M)					    vgcfgrestore(1M)




			       In this case, the user is advised to
			       deactivate the volume group first, then use
			       the vgcfgrestore command to restore
			       configuration data when the volume group is
			       unavailable.  But if the volume group has to
			       stay available and the user is absolutely
			       sure the configuration file is correct, this
			       option will restore data from the
			       configuration file when the volume group
			       stays available.

 RETURN VALUE
      vgcfgrestore exits with one of the following values:

	    0	Successful completion.
	   >&gt&gt>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

      Force to restore the LVM configuration data when volume group is still
      active

	   vgcfgrestore -R -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

      Above command might display the following:





 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 vgcfgrestore(1M)					    vgcfgrestore(1M)




	   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).































 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000