lvextend(1M)lvextend(1M)NAMElvextend - increase space, increase mirrors for LVM logical volume
SYNOPSIS
autobackup] le_number | lv_size | mirror_copies lv_path [pv_path ... |
pvg_name ...]
Remarks
Mirrored disk operations require the installation of the optional HP
MirrorDisk/UX software, which is not included in the standard HP-UX
operating system.
DESCRIPTION
The command can increase a logical volume's allocated extents, or
increase its number of mirrored copies.
Other logical volume characteristics can be modified with the and com‐
mands (see lvchange(1M) and lvreduce(1M)).
To limit the allocation to specific physical volumes, specify the phys‐
ical volume names as pv_path arguments or specify the physical volume
group names as pvg_name arguments. Otherwise, all of the physical vol‐
umes in a volume group are available for allocating new physical
extents. LVM always ensures that physical extent allocation can sat‐
isfy the current allocation policy or policies. If a physical volume
is not suitable for use with a certain allocation policy, it is not
used during physical extent allocation, even it is specified in a
pv_path argument or indirectly in a pvg_name argument.
The pvg_name argument is allowed only if one of the allocation policies
of the logical volume is PVG-strict.
Options and Arguments
The option is only meaningful if the optional HP MirrorDisk/UX software
has been installed.
recognizes the following options and arguments:
lv_path The block device path name of a logical vol‐
ume.
pv_path The block device path name of a physical
volume.
pvg_name The name of a physical volume group (see
lvmpvg(4)).
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 logical volume.
This is the default.
After this command executes, the com‐
mand (see vgcfgbackup(1M)) is exe‐
cuted for the volume group to which
the logical volume belongs.
Do not back up configuration changes this
time.
Increase the space allocated to the logical volume,
specified in logical extents. le_number is
a decimal value greater than the current
number of logical extents.
le_number must be at least 1 and no greater
than a volume group version-dependent maxi‐
mum; use the command to determine the maxi‐
mum number of logical extents for the volume
group version.
One, and only one, or option must be sup‐
plied.
Increase the space allocated to the logical volume,
specified in megabytes. lv_size is a deci‐
mal value greater than the current logical
volume size.
lv_size must be at least 1 and no greater
than a volume group version-dependent maxi‐
mum; use the command to determine the maxi‐
mum logical volume size for the volume group
version.
lv_size is rounded up to the nearest multi‐
ple of the logical extent size, equivalent
to the physical extent size defined for the
volume group by the command (see vgcre‐
ate(1M)).
One, and only one, or option must be speci‐
fied.
Set the number of mirror copies allocated for each logical
extent.
A mirror copy contains the same data as the
original.
mirror_copies must be at least 1 and no
greater than a volume group version-depen‐
dent maximum; use the command to determine
the maximum number of mirror copies for the
volume group version. mirror_copies must be
greater than the current value.
Data in the new copies is synchronized
unless the option is specified. The syn‐
chronization process can be time consuming,
depending on hardware characteristics and
the amount of data.
One, and only one, or option must be speci‐
fied.
Do not synchronize the new mirror copies.
This may affect data high availability so
use or to synchronize the mirrors.
The option must be specified along with this
option.
Striped Logical Volume considerations
Striped and mirrored logical volumes are supported.
An increase in size of a striped logical volume is done by increments
of stripes logical extents. One increment corresponds to stripes phys‐
ical extents if the volume is not mirrored or to stripes * (mir‐
ror_copies + 1) physical extents if the volume is mirrored.
stripes is the number of disks the logical volume is striped across.
It is set with the option stripes of the command.
mirror_copies is the number of mirror copies allocated for each extent.
It is set with the option of the and commands.
LVM striped logical volumes are always allocated using the strict or
PVG-strict allocation policies. Each physical extent of an increment
is allocated on a different physical volume in the volume group.
A size increase of a striped volume requires at least stripes (or
stripes * (mirror_copies + 1) if the volume is mirrored) physical vol‐
umes with adequate free space and meeting the allocation policy.
An increase of the number of mirror copies of a striped volume requires
at least (stripes times the number of copies to add) physical volumes
with adequate free space and meeting the allocation policy.
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 physical volume groups are passed as arguments, uses the physical
volume group file of the system where the command is issued (the
server).
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
Increase the number of the logical extents of a logical volume to 100:
Increase the logical volume size to 400 MB:
Allocate two mirrors (that is, two copies of the original) for each
logical extent of a logical volume:
Mirror a logical volume onto a particular physical volume.
Allocate one mirror and do not synchronize the new mirror copy:
Increase the size of a file system existing on a logical volume.
First, increase the size of the logical volume.
Unmount the file system.
Extend the file system to occupy the entire (larger) logical
volume.
Remount the file system.
WARNINGS
The creation of striped and mirrored logical volume(s) may prevent the
import and activation of the volume group on an earlier HP-UX release.
See lvcreate(1M) on the earlier release to see if it explicitly states
that striping and mirroring is supported. If the striped and mirrored
logical volumes of the volume group are removed or un-mirrored, the
volume group becomes again compatible with the older HP-UX releases.
SEE ALSOlvchange(1M), lvcreate(1M), lvdisplay(1M), lvmadm(1M), lvmpud(1M),
lvreduce(1M), lvsync(1M), pvchange(1M), pvdisplay(1M), vgsync(1M),
intro(7), lvm(7).
lvextend(1M)