HP-UX Reference (11i v2 07/12) - 1M System Administration Commands N-Z (vol 4)

v
vgimport(1M) vgimport(1M)
NAME
vgimport - import an LVM volume group onto the system
SYNOPSIS
/usr/sbin/vgimport
[-m mapfile][
-p][-v][-f infile] vg_name pv_path ...
/usr/sbin/vgimport -m
mapfile -s [-v
][-p] vg_name
DESCRIPTION
The
vgimport command adds the specified volume group to the system. The physical volumes, specified
as pv_path ... 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 the
group special file be created before the command is executed (see vgcreate(1M)). The vg_name is added to
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 other systems within a high availabilitycluster.
vgimport 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 lvcreate command (see
lvcreate(1M)).
The
vgimport command reconstructs the newly imported volume group entry in the /etc/lvmtab file.
The order of the disks belonging to the newly imported volume group could be different than it was before.
When a bootable volume group is imported, the boot information present in the boot disks might be
incorrect due to the change in the order of disks in the /etc/lvmtab file. This is because the boot infor-
mation on the boot disks assumes a certain order of disks in /etc/lvmtab and requires a resynchroniza-
tion of this information after the first activation of a newly imported bootable volume group. To resyn-
chronize the information on the boot disk after the first activation of a newly imported bootable volume
group, run the lvlnboot command in recovery mode (-R option).
Sharable Option, Series 800 Only
In the second format of the command line shown in the SYNOPSIS section, the volume group specified in
the mapfile is shared.
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 and Arguments
vgimport recognizes the following options and arguments:
pv_path The block device path names of a physical volume. This argument is not used with
the -s and related options.
vg_name The path name of the volume group.
-m mapfile 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 command line format of the
SYNOPSIS. 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.
When used with the -s option, the volume group specified in the mapfile can be
shared among the exporting system and the importing systems.
-s Sharable option, Series 800 only. Scan each of the physical volumes connected to the
system and update /etc/lvmtab file with physical volumes that have a matching
volume group information, as found in the mapfile. This option should always be used
in conjunction with the -m option. The specified mapfile is the file generated by run-
ning the vgexport command, also with -m and -s options.
-p Preview the actions to be taken but do not update the /etc/lvmtab file or add the
logical volume device file. This option is best used in conjunction with the -v option.
-v Print verbose messages including names of the logical volumes.
-f infile 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
626 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update