NAME

vgextend − extend a volume group by adding physical volumes to it

SYNOPSIS

/etc/vgextend [-x extensibility] [-g physical_vol_group_name] volume_group_name physical_volume_path ... 

DESCRIPTION

vgextend assigns physical volumes to volume_group_name. The volume group must be active.

Volume groups are extended by adding one or more physical volumes specified by physical_volume_path.

After the physical volumes have been successfully added to the volume group, they can be used. 

Before assigning a physical volume to a volume group, create the physical volume by use of the pvcreate command (see pvcreate(1M)).

If, for any reason, one of the remaining specified physical volumes cannot be installed into the volume group, an error message is printed.  However, the installation continues to the end of the list of physical volumes. 

Options

vgextend recognizes the following command-line options and arguments:

-x extensibility Set allocation permission for additional physical extents on the physical volume specified by physical_volume_path. extensibility can have either of the following values:

y Allow allocation of additional physical extents on the physical volume. 

n Prohibit allocation of additional physical extents on the physical volume.  logical volumes residing on the physical volume can still be accessed. 

-g physical_vol_group_name
This option is used to extend an existing physical volume group while the volume group is being extended by adding all the physical volumes in the physical_volume_path parameter to the physical volume group specified by physical_vol_group_name.

If the specified physical volume group does not exist, it is created, thus providing a means for creating new physical volume groups after the volume group has been created.  Another way to extend or add a physical volume group is to edit the /etc/lvmpvg file as is described in the vgcreate command (see lvmpvg(4) for format details).

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, vgextend behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Add physical volumes /dev/dsk/c1d0s2 and /dev/dsk/c2d0s2 to volume group /dev/vg03:

vgextend /dev/vg03 /dev/dsk/c1d0s2 /dev/dsk/c2d0s2

Extend physical volume group PVG0 while adding physical volumes /dev/dsk/c3d0s2 and /dev/dsk/c4d0s2 to volume group /dev/vg03:

vgextend -g PVG0 /dev/vg03 /dev/dsk/c3d0s2 /dev/dsk/c4d0s2

REMARKS

It is not possible to extend a volume group such that it contains both HP-IB devices and devices using another type of interface. 

SEE ALSO

pvchange(1M), pvcreate(1M), vgchange(1M), vgcreate(1M), vgdisplay(1M). 

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