NAME

vgexport − export an LVM volume group and its associated logical volumes

SYNOPSIS

/sbin/vgexport [-m mapfile] [-p] [-v] vg_name

/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 would be removed without modifying the logical volume information found on the physical volumes. 

The volume group identified by vg_name is removed from the /etc/lvmtab file, and the associated device 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)).

Shareable Option, Series 800 Only

In the second format of the command line, the vgexport command generates a mapfile that contains a description of the volume group and its associated logical volume (if any).  The logical volume information found on the physical volumes is not modified.  The volume group is not removed from the system.  (See the second example below). 

This mapfile is copied onto another system with the vgimport command (see vgimport(1M)) to recreate the volume group on another system that is part of a ServiceGuard cluster. See also vgchange(1M).

The volume group specified in the mapfile can be shared with the importing system.  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 Specify the name of the file to which logical volume names and numbers are to be written.  This file can be used as input to vgimport (see vgimport(1M)). If this option is not specified (as in the first command line format shown in the SYNOPSIS), a file named mapfile is created in the current directory.  When used with the -s option, the volume group specified in the mapfile can be shared with the importing system. 

-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 Shareable option, Series 800 only.  This option must be used with the -p, -v, and -m options.  A mapfile is created that can be used to create volume group entries on another system with the vgimport command. 

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)).

EXAMPLES

Export the volume group /dev/vg01 into mapfile vg01.mapfile.  The volume group will be removed from the exporting system when the importing system imports the volume group. 

vgexport -m  vg01.mapfile /dev/vg01

Create a mapfile to be copied onto another system to build the volume group information for the volume group, /dev/vg02.  Note that the volume group is not removed from the system.  The importing system will access the volume group with the vgimport command using the -s and -m options. 

vgexport -s -p -m  vg02.mapfile /dev/vg02

SEE ALSO

vgimport(1M), vgscan(1M). 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996