vgexport(1M)                                                   vgexport(1M)




 NAME    [Toc]    [Back]
      vgexport - export an LVM volume group and its associated logical
      volumes

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/vgexport [-m mapfile] [-p] [-v] [-f outfile] vg_name

      /usr/sbin/vgexport -m mapfile -s -p -v vg_name

 DESCRIPTION    [Toc]    [Back]
      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 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)).

    Sharable Option, Series 800 Only
      Using the format of the second command line of the SYNOPSIS above, the
      vgexport command generates 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    [Toc]    [Back]
      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 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 vgimport (see
                          vgimport(1M)).  When used with the -s option, the
                          volume group specified in the mapfile can be



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 vgexport(1M)                                                   vgexport(1M)




                          shared with other systems in the high availability
                          cluster.

           -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    [Toc]    [Back]
    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    [Toc]    [Back]
      Export the volume group /dev/vg01 into mapfile vg01.mymap.  The volume
      group will be removed from the exporting system.

           vgexport -m  vg01.mymap /dev/vg01

      Export the volume group /dev/vg01 and write the disk names into the
      file vg01.outfile.

           vgexport -v -f outfile /dev/vg01





 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 vgexport(1M)                                                   vgexport(1M)




      Create a mapfile to be copied to other systems in a high availability
      cluster to build the volume group information for the volume group,
      /dev/vg02.  Note that the volume group is not removed from the
      exporting system.  The importing systems will create the volume group
      with the vgimport command using the -s and -m options.

           vgexport -s -p -m -v  vg02.mymap /dev/vg02

 SEE ALSO    [Toc]    [Back]
      vgimport(1M), vgscan(1M).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003