vgcfgrestore(1M)														  vgcfgrestore(1M)

NAME

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

SYNOPSIS

       vg_name

       vg_name old_pv_path] pv_path

       vg_conf_path

       vg_conf_path old_pv_path] pv_path

       pv_path

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

       cannot be performed on devices attached to activated volume groups.  Prior to restoring a backup configuration to a disk, detach the physi-
       cal volume from the volume group using the command (see pvchange(1M)), or deactivate the volume group using the command (see vgchange(1M)).

       will refuse to restore a configuration to a physical volume with a block size different than the block size  stored  in	the  configuration
       backup file for that physical volume.

DESCRIPTION

       The  command restores the LVM configuration data from a default option) or alternate option) configuration backup file, or from kernel mem-
       ory option), to the physical volume named by pv_path.  Or, it displays the configuration data on standard output option).

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

   Options and Arguments
       recognizes the following options and arguments:

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

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

	      Get configuration information from the alternate configuration backup file
				  vg_conf_path.

	      This option is applicable to input arguments belonging to volume groups version 1.0.
				  Forcibly  restore 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.

	      Get configuration information from LVM data structures in kernel memory.
				  The volume group containing pv_path must be activated in order to use this option.

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

	      Get configuration information from the default configuration backup file:

				  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 base_vg_name is

	      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 needs not be currently online.

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

	      Forcibly restore 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/lvm-
				  conf/vgname indicates Y disks.  Cannot proceed with the restoration.	Deactivate the Volume Group and try again.

				  In this case, the user is advised to deactivate the volume group first, then use the command to restore configu-
				  ration 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.

	      Provide additional information when invoked together with
				  option.

				  o Additional values displayed for each path:

				  o Disk size in kilobytes

				  o Starting block number (kb) of the user data.

				  o The PVkey (see Note that paths with the same key are links to the same device.

				  Additional values displayed for each volume group:

				  o max_pv
				  o max_pe
				  o max_lv
				  o vg_version
				  o vg_size (only volume groups version 2.0 or higher, see vgcreate(1M))

RETURN VALUE

       exits with one of the following values:

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

EXTERNAL INFLUENCES

   Environment Variables
       determines the language in which messages are displayed.

       If 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 that was saved in the default file

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

       Restore the LVM configuration information to physical volume using alternate configuration file

       List backup information saved in default configuration file

       Above command might display the following:

       Restore LVM configuration information stored for in default configuration file to physical volume

       Restore LVM configuration information to physical volume using LVM data structures in kernel memory. The volume group  containing  must	be
       activated:

AUTHOR

       was developed by HP.

SEE ALSO

       pvchange(1M), vgcfgbackup(1M), vgchange(1M), intro(7), lvm(7).

																  vgcfgrestore(1M)