vgimport(1M)															      vgimport(1M)

NAME

       vgimport - import an LVM volume group onto the system

SYNOPSIS

       mapfile] vg_name pv_path ...

       mapfile] infile] vg_name

       mapfile vg_name

DESCRIPTION

       The  command adds the specified volume group to the system.  The physical volumes, specified as pv_path ..., are scanned to obtain the vol-
       ume group information and logical volume information.  This command works much like A user may explicitly create the vg_name directory  and
       the  file  before  importing  the volume group.	If absent, the command will automatically create the directory and the file, assigning the
       minor number as explained in the command man page  (see vgcreate(1M)).  The vg_name is added to the or file,  and  the  associated  logical
       volume device files are added to the system.

       assumes that the volume group information has already been created on the physical volumes.

       This  command is useful in conjunction with the command (see vgexport(1M)), to move volume groups from one system to other systems within a
       high availability cluster.

       creates logical volume device files under the vg_name directory using the naming convention given in mapfile or using  the  default  naming
       convention used by the command (see lvcreate(1M)).

       The command reconstructs the newly imported volume group entry in the or file.  The order of the disks belonging to the newly imported vol-
       ume group could be different than it was before.

       When a bootable volume group is imported (volume groups version 1.0 only), the boot information present in the boot disks might	be  incor-
       rect  due  to the change in the order of disks in the file.  This is because the boot information on the boot disks assumes a certain order
       of disks in and requires a resynchronization of this information after the first activation of a newly imported bootable volume group.	To
       resynchronize  the  information	on  the boot disk after the first activation of a newly imported bootable volume group, run the command in
       recovery mode option).

       does not activate the imported volume group due to the many possible options at volume group activation time.  To activate the volume group
       once it has been successfully imported, use the command (see vgchange(1M)).

   Options and Arguments
       recognizes the following options and arguments:

	      pv_path	     The block device path names of a physical volume.	This argument is not used with the and related options.

	      vg_name	     The path name of the volume group.

	      Specify the name of the file
			     from  which  logical volume names and numbers are to be read.  This option is optional when used as in the first com-
			     mand line format of the If this option is not specified, logical volume names are created using  the  default  naming
			     convention where is the decimal representation of logical volume minor number.  When used with the option, the volume
			     group specified in the mapfile can be shared among the exporting system and the importing systems.

	      Configure the volume group by populating persistent device special
			     files in the or file, corresponding to the volume group, vg_name.	(See intro(7) for information about device special
			     files.)   This option can only be used with option.  If is invoked without a option, legacy device special files will
			     be used to populate the or file.

			     This option may become obsolete in future releases.

	      Scan option.  Scan each of the disks connected to the
			     system and update the or file with the physical volumes that have matching volume group information, as found in  the
			     mapfile.  This option should always be used in conjunction with the option.  The specified mapfile is the file gener-
			     ated by running the command, also with and options.

	      Preview the actions to be taken but do not update the
			     or file or add the logical volume device files.  This option is best used in conjunction with the option.

	      Print verbose messages including names of the logical volumes.

	      Import the set of
			     pv_paths held in the infile into the volume group.  This option is used as an alternative to specifying the  pv_paths
			     on  the  command  line.   Each pv_path must appear on a new line in the infile.  This option may not be used together
			     with the option.

WARNINGS

       The option may become obsolete in future releases.

       No more than eight paths to any physical volume will be added to the or file.  All other paths wll be omitted.

       The following warnings apply to the option, when importing disks with alternate paths:

       The command does not preserve the path ordering, when a volume group is exported and then imported.  This may cause the primary and  alter-
       nate paths to be different on an importing system, from that of an exported system.  Also, additional alternate paths that were not config-
       ured on the exported system may get discovered and configured on the importing system.

       If the original primary path of a disk gets configured as an alternate path after the volume group is imported, the  order  can	easily	be
       reverted by using to remove the primary path and then reconfiguring the same path again as an alternate, using

       If  additional  alternate  paths  were  added to the newly imported volume group, use to reduce any alternate paths that were added but not
       required.

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

       Import the volume group that is located on physical disks and

       Activate the volume group following a successful import:

       Import the volume group using the mapfile, was previously specified by the command on another system.  The volume group,  is  specified	in
       and will be used by the importing system only:

       Import  the  volume  group using the mapfile, was previously specified by the command on another system.  The volume group, is specified in
       and will be shared among the exporting system, this system, and other systems importing the volume group as shared:

       Import the volume group using the infile, was previously specified by the command on another system, and it assumes that  pv_paths  in  the
       are identical on both systems.

SEE ALSO

       vgexport(1M), vgscan(1M), intro(7), lvm(7).

																      vgimport(1M)