HP-UX Reference (11i v2 07/12) - 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. Currently LVM supports a maximum 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 will force a volume group to be extended with a physical volume
which has alternate block(s) already allocated, (i.e. this physical volume was not
initialized using pvcreate -f.) This option should be used with extreme cau-
tion. 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 2: December 2007 Update − 1 − Hewlett-Packard Company 623