NAME

vgimport − import a Volume Group onto the system

SYNOPSIS

/etc/vgimport [-p] [-v] [-m mapfile] volume_group_name physical_volume_path ... 

DESCRIPTION

vgimport adds the specified Volume Group to the system.  The specified Physical Volumes are scanned to obtain the Volume Group information and Logical Volume information.  This command works much like vgcreate by requiring that the Volume Group device directory and group special file be created before the command is executed (see vgcreate(1M)). The volume_group_name is added from the /etc/lvmtab file, and the associated logical volume device files are added to the system. 

vgimport assumes that the Volume Group information has already been created on the Physical Volumes.  This command is useful in conjunction with the vgexport command (see vgexport(1M)), to move volume groups from one system to another.

vgimport creates Logical Volume devices files under the volume_group_name directory using the naming convention given in the mapfile or using the default naming convention used by the lvcreate command (see lvcreate(1M)).

vgimport 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 vgchange command (see vgchange(1M)).

Options

vgimport recognizes the following options:

-p Preview actions taken but do not update file /etc/lvmtab or add the devices file.  This option is best used in conjunction with the -v option. 

-v Print verbose messages including names of the Logical Volumes. 

-mmapfile
Specify the name of the file from which Logical Volume names and numbers are to be read. If this option is not specified, Logical Volume names are created using the default naming convention lvolnn where nn is the Logical Volume minor number. 

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed. 

If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. 

If any internationalization variable contains an invalid setting, vgimport behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Import the Volume Group /dev/vg01 that is located on Physical Disks /dev/dsk/c1d0s2 and /dev/dsk/c3d0s2:

vgimport -v /dev/vg01 /dev/dsk/c1d0s2 /dev/dsk/c3d0s2

Activate the volume group following a successful import:

vgchange -a y vg01

SEE ALSO

vgexport(1M), vgscan(1M). 
 
 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994