unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 vgdisplay(1M)						       vgdisplay(1M)




 NAME
      vgdisplay - display information about LVM volume groups

 SYNOPSIS
      /usr/sbin/vgdisplay [-v] [vg_name ...]

 DESCRIPTION
      The vgdisplay command displays information about volume groups.  For
      each vg_name specified, vgdisplay displays information for that volume
      group only.  If no vg_name is specified, vgdisplay displays names and
      corresponding information for all defined volume groups.

      The volume group must be activated (see vgchange(1M)) before it can be
      displayed.

    Options and Arguments
      vgdisplay recognizes the following options and arguments:

	   vg_name
		The path name of the volume group, for example, /dev/vg00.

	   -v	For each volume group, display additional information about
		logical volumes, physical volumes, and physical volume
		groups.

    Display Without -v Option
      If you omit the -v option, only the following information is
      displayed:

      --- Volume groups ---

	   VG Name	       The path name of the volume group.

	   VG Write Access     Current access mode of the volume group.
			       Possible values are read/write and read-only.

	   VG Status	       State of the volume group: always available,
			       as after a vgchange -a y command, since
			       deactivated volume groups are not displayed.

	   Max LV	       Maximum number of logical volumes allowed in
			       the volume group.

	   Cur LV	       Current number of logical volumes in the
			       volume group.

	   Open LV	       Number of logical volumes currently open in
			       the volume group.

	   Max PV	       Maximum number of physical volumes allowed in
			       the volume group.



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 vgdisplay(1M)						       vgdisplay(1M)




	   Cur PV	       Current number of physical volumes in the
			       volume group.

	   Act PV	       Number of physical volumes that are currently
			       active.

	   Max PE per PV       Maximum number (limit) of physical extents
			       that can be allocated from any of the
			       physical volumes in the volume group.

	   VGDA		       Number of Volume Group Descriptor Areas
			       within the volume group.

	   PE Size	       Size of each physical extent.

	   Total PE	       Total number of physical extents within the
			       volume group: the sum of the number of
			       physical extents belonging to each available
			       physical volume in the volume group. (This
			       does not include physical extents belonging
			       to stand-by spare physical volumes; presence
			       of these is only possible if you are using
			       mirrored disks -- see below).

	   Alloc PE	       Number of physical extents currently
			       allocated to logical volumes.

	   Free PE	       Number of physical extents not allocated (not
			       including physical extents belonging to
			       stand-by spares).

	   Total PVG	       Total number of physical volume groups within
			       the volume group.

	   Total Spare PVs     Total number of physical volumes that are
			       designated as spares for this volume group.
			       This will include both stand-by and active
			       spares -- see below.

	   Total Spare PVs in use
			       Total number of spare physical volumes that
			       are active in place of (containing all data
			       from) a failed physical volume.

    Display With -v Option
      If you specify the -v option, vgdisplay lists the following additional
      information for each logical volume, for each physical volume, and for
      each physical volume group in the volume group:

      --- Logical volumes ---




 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 vgdisplay(1M)						       vgdisplay(1M)




	   Information about logical volumes belonging to vg_name:

	   LV Name	       The block device path name of a logical
			       volume in the volume group.

	   LV Status	       State of the logical volume:

			       available/stale		Logical volume
							available but
							contains physical
							extents that are not
							current.

			       available/syncd		Logical volume
							available and
							synchronized.

			       available		Logical volume
							available; stale/
							syncd state cannot
							be confidently
							determined because
							logical volumes have
							both the Mirror
							Write Cache and
							Mirror Consistency
							Recovery turned off.

			       unavailable		Logical volume is
							not available for
							use.

	   LV Size (Mbytes)    Size of the logical volume.

	   Current LE	       Number of logical extents in the logical
			       volume.

	   Allocated PE	       Number of physical extents used by the
			       logical volume.

	   Used PV	       Number of physical volumes used by the
			       logical volume.

      --- Physical volumes ---

	   Information about physical volumes belonging to vg_name:

	   PV Name	       The block device path name of a physical
			       volume in the group.  When an alternate link
			       to a physical volume has been added,
			       Alternate Link is displayed next to the



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 vgdisplay(1M)						       vgdisplay(1M)




			       device path name. (See vgextend(1M) for
			       definition.)

	   PV Status	       State of the physical volume: (NOTE: spare
			       physical volumes are only relevant if you
			       have installed HP MirrorDisk/UX software):

			       available		The physical volume
							is available and is
							not a spare physical
							volume.

			       available/data spared	The physical volume
							is available.
							However, it's data
							still resides on an
							active spare.

			       available/active spare	The physical volume
							is available and is
							an active spare
							physical volume.
							(An active spare is
							a spare that has
							taken over for a
							failed physical
							volume.)

			       available/standby spare	The physical volume
							is a spare "standing
							by" in case of a
							failure on any other
							physical volume in
							this volume group.
							It can only be used
							to capture data from
							a failed physical
							volume.

			       unavailable		The physical volume
							is unavailable and
							is not a spare
							physical volume.

			       unavailable/data spared	The physical volume
							is unavailable.
							However, it's data
							now resides on an
							active spare, and
							its data is
							available if the



 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000






 vgdisplay(1M)						       vgdisplay(1M)




							active spare is
							available.

			       unavailable/active spare The physical volume
							is unavailable and
							it's an active
							spare. Thus, the
							data on this
							physical volume is
							unavailable.

			       unavailable/standby spare
							The physical volume
							is a spare "standing
							by" that is not
							currently available
							to capture data from
							a failed physical
							volume.

	   Total PE	       Total number of physical extents on the
			       physical volume.

	   Free PE	       Number of free physical extents on the
			       physical volume.

	   Spared from PV      If the physical volume represents an active
			       spare, this field will show the name of the
			       failed physical volume whose data now resides
			       on this spare.  This information can be used
			       to manually move the data back to the
			       original physical volume once it has been
			       repaired (see pvmove(1M)).  If it cannot be
			       determined which physical volume that the
			       data came from, this field will instead
			       display Missing PV.  A missing PV would
			       indicate that when the volume group was last
			       activated or reactivated (see vgchange(1M)),
			       the "failed" physical volume was not able to
			       attach to the volume group.

	   Spared to PV	       If the physical volume represents a failed
			       physical volume, this field will show the
			       name of the active spare physical volume that
			       now contains the data that originally
			       residing on this volume. This information can
			       be used to manually move the data back to the
			       original physical volume (see pvmove(1M))
			       once it has been repaired.





 Hewlett-Packard Company	    - 5 -   HP-UX Release 11i: November 2000






 vgdisplay(1M)						       vgdisplay(1M)




	   Autoswitch	       For multiported devices accessed via multiple
			       paths, this field indicates the autoswitch
			       behavior for the physical volume (see
			       pvchange(1M)).

			       On			LVM will
							automatically switch
							from the path it is
							using whenever a
							better path to the
							physical volume is
							available.  LVM will
							switch paths when a
							better path recovers
							(after it had failed
							earlier), or if the
							current path fails
							and another path is
							available.  This is
							the default.

			       Off			LVM will
							automatically switch
							to using the best
							available path only
							when the path
							currently in use is
							unavailable.  LVM
							will continue using
							a specific path for
							the physical volume
							as long as it works,
							regardless of
							whether another
							better path recovers
							from a failure.

      --- Physical volume groups ---

	   Information about physical volume groups belonging to vg_name:

	   PVG Name	       Name of a physical volume group in the volume
			       group.

	   PV Name	       The block device path name of a physical
			       volume in the physical volume group.

 EXTERNAL INFLUENCES
    Environment Variables
      LANG determines the language in which messages are displayed.




 Hewlett-Packard Company	    - 6 -   HP-UX Release 11i: November 2000






 vgdisplay(1M)						       vgdisplay(1M)




      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
      Display information about all the volume groups within the system:

	   vgdisplay

      Display all of the information about one volume group, including the
      characteristics and status of both the logical and physical extents of
      the volume group:

	   vgdisplay -v /dev/vg02

 SEE ALSO
      lvdisplay(1M), pvdisplay(1M), vgchange(1M), vgcreate(1M).




































 Hewlett-Packard Company	    - 7 -   HP-UX Release 11i: November 2000