HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
v
vgexport(1M) vgexport(1M)
NAME
vgexport - export an LVM volume group and its associated logical volumes
SYNOPSIS
/usr/sbin/vgexport [-m mapfile][-p][-v][-f outfile] vg_name
/usr/sbin/vgexport -m mapfile -s -p -v vg_name
DESCRIPTION
Using the format of the first command line of the SYNOPSIS above, the vgexport command can be used
to remove a volume group from the system. The volume group will be removed without modifying the logi-
cal volume information found on the physical volumes.
The volume group identified by vg_name is removed from the /etc/lvmtab file, and the associated dev-
ice files including the vg_name directory and group file are removed from the system.
The volume group information and data is untouched on the physical volume. These disks can be imported
to other system with the vgimport command (see vgimport(1M)).
Sharable Option, Series 800 Only
Using the format of the second command line of the SYNOPSIS above, the
vgexport command gen-
erates a mapfile that can be copied to other systems that are part of a high availability cluster and the
vgimport command (see vgimport(1M)) can be used to recreate the volume group. See also
vgchange(1M). The mapfile contains a description of the volume group and its associated logical volume(s)
(if any). The logical volume information found on the physical volumes is not modified. Note that with this
option, the volume group is not removed from the system. (See the second example below).
The volume group specified in the mapfile can be shared with the importing systems. The volume group is
not removed from the exporting system.
Options and Arguments
vgexport recognizes the following options and arguments:
vg_name The path name of the volume group.
-m mapfile By default, a file named mapfile is created in the current directory. This file con-
tains a description of the volume group and its associated logical volume(s) (if any).
Use this option to specify a different name for the file, mapfile. This file can be used
as input to
vgimport (see vgimport(1M)). When used with the -s option, the
volume group specified in the mapfile can be shared with other systems in the high
availabilitycluster.
-p Preview the actions to be taken but do not update the
/etc/lvmtab file or remove
the devices file. This option is best used in conjunction with the
-v option.
-v Print verbose messages including the names of the physical volumes associated with
this volume group.
-s Sharable option, Series 800 only. When the -s option is specified, then the -p, -v,
and -m options must also be specified. A mapfile is created that can be used to create
volume group entries on other systems in the high availability cluster (with the
vgimport command).
-f outfile Write the current set of pv_paths for the volume group to the outfile. The outfile may
then be used as the infile for the
vgimport -f option. If used together with the
-
p
option the volume group is not exported but the list of pv_paths is still written to
the outfile. This may be useful to derive a list of pv_paths for the volume group or to
use on another system which is sharing the volume group and which has an identical
configuration.
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)).
Section 1M−−1022 − 1 − HP-UX Release 11i: December 2000
___
___