vgexport(1M)vgexport(1M)NAMEvgexport - export an LVM volume group and its associated logical vol‐
umes
SYNOPSIS
mapfile] outfile] vg_name
mapfile vg_name
DESCRIPTION
Using the format of the first command line of the above, the command
can be used to remove a volume group from the system. The volume group
will be removed without modifying the logical volume information found
on the physical volumes.
The volume group identified by vg_name is removed from the or file, and
the associated device files including the vg_name directory and file
are removed from the system.
The volume group information and data is untouched on the physical vol‐
ume. These disks can be imported to another system with the command
(see vgimport(1M)).
Scan Option
Using the format of the second command line of the above, the command
generates a mapfile that can be copied to other systems that are part
of a high availability cluster (use the option if you do not want to
remove the volume group from the system the command is being run from)
and the 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 modi‐
fied.
Options and Arguments
recognizes the following options and arguments:
vg_name The path name of the volume group.
By default, a file named
is created in the current directory. This file
contains 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
(see vgimport(1M)). When used with the option,
the volume group specified in the mapfile can be
shared with other systems in the high availabil‐
ity cluster.
Preview the actions to be taken but do not update the
or file or remove the devices file. This option
is best used in conjunction with the option.
Print verbose messages
including the names of the physical volumes asso‐
ciated with this volume group.
Scan option. When the option is specified, then the 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 command).
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 option. If used together with the 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
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
Export the volume group into mapfile The volume group will be removed
from the exporting system.
Export the volume group and write the disk names into the file
Create a mapfile to be copied to other systems in a high availability
cluster to build the volume group information for the volume group,
Note that the volume group is not removed from the exporting system.
The importing systems will create the volume group with the command
using the and options.
SEE ALSOvgimport(1M), vgscan(1M).
vgexport(1M)