NAME

vgchange − set volume group availability

SYNOPSIS

/etc/vgchange -a availability [-q quorum] [-l] [-p] [-s] volume_group_name

DESCRIPTION

vgchange activates or deactivates one or more volume groups as specified by the -a option; namely y or n:

vgchange -a n
Deactivate volume_group_name and its associated logical volumes.  Close the logical volumes prior to executing vgchange -a n.  For example, if the logical volume contains a file system, the file system must be unmounted. 

vgchange -a y
Activate volume group volume_group_name and all associated physical and logical volumes.  When a volume group is activated, LVM performs the necessary mirror consistency recovery for each logical volume in the volume group based on the state of the Mirror Write Cache and Mirror Consistency Recovery (see Consistency Recovery section of lvdisplay(1M)). 

MWC Mirror consistency is recovered by using the Mirror Write Cache and Mirror Consistency Record.  This mode implies that the Mirror Write Cache is on. 

NOMWC Mirror consistency is recovered by searching all logical extents and copying data from a non-stale copy to the other mirror copies.  This mode implies that the Mirror Write Cache is off. 

NONE No mirror consistency recovery during volume group activation on this logical volume.  This mode implies that the Mirror Write Cache is off. 

The next step following mirror consistency recovery is mirror synchronization which refreshes stale mirror copies by copying data from a non-stale copy.  If the -s option is specifed on the command line, mirror synchronization does not occur.  However, for those logical volumes that have Mirror Write Cache turned off, mirror synchronization is done by a daemon (/etc/nomwcsyncd) independent of whether the -s option appears on the command line. 

If vgchange cannot access a physical volume, it lists the volume’s status as missing.  If too many physical volumes in the volume group are missing, vgchange complains that the group does not have a quorum and cannot be activated.  The -q n option is used to activate the volume group when disk quorum is not maintained because too many disks were lost.  The -p option is used to activate the volume group only if all of the physical volumes belonging to the volume group are available.  If the -l option is set, later attempts to open the logical volumes fail.  To make an open of these logical volumes succeed, execute lvchange -a y. 

vgchange -a y on a currently active Volume Group attempts to include any Physical Volumes that were previously listed as missing.  This is useful if a Physical Volume has come back online.  However, no automatic synchronization of any mirrored Logical Volumes is done.  If synchronization is required, execute the vgsync command (see vgsync(1M)).

Options

vgchange recognizes the following options and arguments:

-a availability
Set volume group availability. availability can have either of the following values:

y Make a volume group available. 

n Make a volume group temporarily unavailable. 

-q quorum
Set activation quorum requirement for the volume group. quorum can have either of the following values:

y (default) Enforce quorum requirement. 

n Ignore quorum requirement. 

-l Disable open of logical volumes that belong to the volume group. 

-p Activate volume group only if all of the physical volumes that belong to it are available. 

-s Disable synchronization of stale physical extents within the volume group specified by volume_group_name. This option only appropriate when used with the -a y option. 

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed. 

If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. 

If any internationalization variable contains an invalid setting, vgchange behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Activate a volume group:

vgchange -a y /dev/vg03

Deactivate a volume group:

vgchange -a n /dev/vg03

Activate a volume group without synchronizing extents that are not current on logical volumes that have Mirror Write Cache turned on:

vgchange -a y -s /dev/vg03

FILES

/etc/nomwcsyncd Mirror sychronization daemon for logical volumes that have Mirror Write Cache turned off. 

SEE ALSO

vgcreate(1M), vgextend(1M), vgreduce(1M), vgdisplay(1M), umount(1M). 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992