vgextend.1m (2010 09)

v
vgextend(1M) vgextend(1M)
NAME
vgextend - extend an LVM volume group by adding physical volumes
SYNOPSIS
/usr/sbin/vgextend
[-f][-A autobackup ][
-g pvg_name ][-x extensibility][
-z sparepv ]
vg_name pv_path ...
DESCRIPTION
The vgextend command assigns additional physical volumes to volume group vg_name . The volume
group must be active.
Volume groups are extended by adding one or more physical volumes specified by pv_path ...
For a volume groups version 2.0 or higher, adding a physical volume to a volume group may cause the
maximum volume group size to be exceeded (see vgcreate (1M)). If the maximum size has already been
added to the volume group, then an attempt to add another physical volume will be rejected. If the max-
imum size has not been allocated, but the physical volume being added is larger than the remaining space
in the volume group, then the usable space on the physical volume will be limited to the remaining
volume group space.
After the physical volumes have been successfully added to the volume group, the disk space they contain
can be allocated to logical volumes.
Before assigning an additional physical volume to a volume group, create the physical volume with the
pvcreate command (see pvcreate (1M)). Then, create the volume group with the vgcreate command,
assigning at least one physical volume (see vgcreate (1M)).
If, for any reason, a specified physical volume cannot be installed into the volume group, an error mes-
sage is displayed. However, the installation continues to the end of the list of physical volumes.
When a pv_path refers to one of the physical volumes already in the volume group by a different pv_path
name to indicate the use of a different controller, this new path becomes an
alternate link
to the
physical volume. When two paths that reference the same disk are provided in the pv_path list, the order
of the paths is important. The first path becomes the "primary link" to the physical volume, the second
becomes an "alternate link" to the physical volume. The primary link is the path used to access the physi-
cal volume unless the primary link becomes unavailable in which case LVM automatically switches to the
alternate link to access the physical volume (see WARNINGS section). Currently LVM supports a max-
imum of 8 paths to a physical volume (7 alternates and one primary).
Options and Arguments
vgextend recognizes the following options and arguments:
pv_path The block device path name of a physical volume.
vg_name The path name of the volume group.
-A autobackup Set automatic backup for this invocation of this command. autobackup can
have one of the following values:
y Automatically back up configuration changes made to the volume group.
This is the default.
After this command executes, the
vgcfgbackup command (see
vgcfgbackup (1M)) is executed for the volume group.
n Do not back up configuration changes this time.
-f This option is only applicable for volume groups version 1.0. Relocated blocks
are not supported on volume groups version 2.0 or higher. Forcibly extend the
volume group with a physical volume which has alternate block(s) already
allocated, (in other words, this physical volume was not initialized using
pvcreate -f.) This option should be used with extreme caution. If the
disk is being extended to a volume group with a different physical extent size,
the alternate block(s) might be inside the user data area. Potential data corr-
uption could occur.
-g pvg_name Extend an existing physical volume group while the volume group is being
extended by adding all the physical volumes in the pv_path parameter to the
physical volume group specified by pvg_name .
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1