HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)

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 ...
Remarks
vgextend cannot be performed if the volume group is activated in shared mode.
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 ...
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 message
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 Forcibly extend the volume group with a physical volume which has alternate
block(s) already allocated, (in other words, this physical volume was not initial-
ized 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
corruption 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.
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 described in vgcreate(1M). See lvmpvg(4) for format
details.
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 635