vgextend(1M)vgextend(1M)NAMEvgextend - extend an LVM volume group by adding physical volumes
SYNOPSIS
autobackup] pvg_name] extensibility] sparepv] vg_name pv_path ...
DESCRIPTION
The 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 spec‐
ified 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 maximum 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, cre‐
ate the physical volume with the command (see pvcreate(1M)). Then,
create the volume group with the command, assigning at least one physi‐
cal 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 dif‐
ferent controller, this new path becomes an 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 physical volume unless the primary link becomes unavailable
in which case LVM automatically switches to the alternate link to
access the physical volume (see section). Currently LVM supports a
maximum of 8 paths to a physical volume (7 alternates and one primary).
Options and Arguments
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.
Set automatic backup for this invocation of this command.
autobackup can have one of the following
values:
Automatically back up configuration changes
made to the volume group.
This is the default.
After this command executes, the com‐
mand (see vgcfgbackup(1M)) is exe‐
cuted for the volume group.
Do not back up configuration changes this
time.
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 vol‐
ume which has alternate block(s) already
allocated, (in other words, this physical
volume was not initialized using 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.
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 cre‐
ated. Another way to extend or add a physi‐
cal volume group is to edit the file as
described in vgcreate(1M). See lvmpvg(4)
for format details.
Set allocation permission for additional physical extents
on the physical volume specified by pv_path.
extensibility can have one of the following
values:
Allow allocation of additional physical
extents on the physical volume.
Prohibit allocation of additional physical
extents on the physical volume.
Logical volumes residing on the phys‐
ical volume can still be accessed.
This option is only applicable on volume groups version 1.0.
Versions 2.0 or higher do not support spar‐
ing. This option requires the installation
of the optional HP MirrorDisk/UX software.
It allows you to mark the physical volume(s)
specified by pv_path to be either a spare
physical volume or a regular, non-spare
physical volume. (A spare physical volume
can be used to replace an existing physical
volume within a volume group when mirroring
is in effect, in the event the existing
physical volume fails.) sparepv can have
one of the following values:
The physical volume(s) will be used as
spare(s). No physical extents from
a spare physical volume will be
available as part of the "free" pool
of extents in the volume group. The
spare physical volume(s) will only be
used in the event of another physical
volume within this volume group
becomes unavailable (fails).
The physical volume(s) will be used as regu‐
lar, non-spare members of the volume
group. This is the default.
Alternate Links (PVLinks)
In this release of HP-UX, LVM continues to support Alternate Links to a
device to allow continued access to the device, if the primary link
fails. This multiple link or multipath solution increases data avail‐
ability, but does not allow the multiple paths to be used simultane‐
ously.
There is a new feature introduced in the Mass Storage Subsystem on this
version of HP-UX that also supports multiple paths to a device and
allows access to the multiple paths simultaneously. The Mass Storage
Subsystem will balance the I/O load across the valid paths. This new
multi-path behavior is enabled and disabled through the use of the
scsimgr command. See scsimgr(1M) for details.
It is no longer required or recommended to configure LVM with alternate
links. However, it is possible to maintain the traditional LVM behav‐
ior. To do so, both of the following criteria must be met:
· Only the legacy device special file naming convention is used
in the volume group configuration.
· The scsimgr command is used to disable the Mass Storage Sub‐
system multipath behavior.
Shared Volume Group Considerations
For volume group version 1.0 and 2.0, cannot be used if the volume
group is activated in shared mode. For volume groups version 2.1 (or
higher), can be performed when activated in either shared, exclusive,
or standalone mode.
Note that the daemon must be running on all the nodes sharing a volume
group activated in shared mode. See lvmpud(1M).
If the option is used, the file is changed only on the system where the
command is issued (the server).
can add alternate PV links only on the server node; alternate links
cannot be added on client nodes.
When a PV is added to the volume group, the PV path passed as the argu‐
ment is added into on the server. However, on the clients, it is
always the PV persistent device special file that is added into is
automatically updated on the nodes sharing the volume group.
When a node wants to share the volume group, the user must first exe‐
cute a if physical volumes were added at the time the volume group was
not activated on that node.
LVM shared mode is currently only available in Serviceguard clusters.
EXTERNAL INFLUENCES
Environment Variables
determines the language in which messages are displayed.
If is not specified or is null, it defaults to "C" (see lang(5)).
If any internationalization variable contains an invalid setting, all
internationalization variables default to "C" (see environ(5)).
EXAMPLES
Add physical volumes and to volume group
Extend physical volume group while adding physical volumes and to vol‐
ume group
Add an alternate link to one of the physical volumes in the volume
group where and refer to the same physical volume (referenced via dif‐
ferent controllers), and the volume group already contains remains the
primary link (in use) and becomes the alternate link.
Add a spare physical volume to a volume group:
WARNINGS
The new physical volume which has been added to the volume group could
potentially have a different block size compared to physical volumes
already in the volume group.
If a logical volume is created on two or more physical volumes which
have a different block size, it is not possible to use such logical
volume for file system purposes (see extendfs(1M)).
For example, when a logical volume contains physical volumes that all
have 1k block size, and then it is extended to contain a physical vol‐
ume with 2k block size, then the block size of the volume group is
increased to 2k.
SEE ALSOpvchange(1M), pvcreate(1M), vgchange(1M), vgcreate(1M), vgdisplay(1M),
lvmadm(1M), lvmpud(1M), intro(7), lvm(7).
vgextend(1M)