lvextend(1M) lvextend(1M)
NAME [Toc] [Back]
lvextend - increase space, increase mirrors for LVM logical volume
SYNOPSIS [Toc] [Back]
/usr/sbin/lvextend [-A autobackup]
{-l le_number | -L lv_size | -m mirror_copies} lv_path
[pv_path ... | pvg_name ...]
Remarks [Toc] [Back]
Mirrored disk operations require the installation of the optional HP
MirrorDisk/UX software, which is not included in the standard HP-UX
operating system.
lvextend cannot be performed if the volume group is activated in shared
mode.
DESCRIPTION [Toc] [Back]
The lvextend 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 lvchange
and lvreduce commands (see lvchang
).
To limit the allocation to specific physical volumes, specify the
physical volume names as pv_path arguments or specify the physical
volume group names as pvg_name arguments. Otherwise, all of the
physical volumes in a volume group are available for allocating new
physical extents. LVM always ensures that physical extent allocation
can satisfy 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.
LVM striped logical volumes are always allocated using a strict
allocation policy. Consequently, striped logical volumes may only be
extended by a number extents that is a multiple of disks the logical
volume is striped across. For example, for a logical volume striped
across 3 disks, the logical volume will be extended in increments of 3
extents, with each of the 3 extents allocated on a different disk in
the volume group.
The pvg_name argument is allowed only if one of the allocation
policies of the logical volume is PVG-strict.
Options and Arguments [Toc] [Back]
The -m option is only meaningful if the optional HP MirrorDisk/UX
software has been installed on the system.
lvextend recognizes the following options and arguments:
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
lvextend(1M) lvextend(1M)
lv_path The block device path name of a logical
volume.
pv_path The block device path name of a physical
volume.
pvg_name The name of a physical volume group (see
lvmpvg(4)).
-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 logical volume.
This is the default.
After this command executes, the
vgcfgbackup command (see
vgcfgbackup(1M)) is executed for
the volume group to which the
logical volume belongs.
n Do not back up configuration
changes this time.
-l le_number 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, in the range 1 to 65535
(the implementation limit).
One, and only one, -l, -L, or -m option
must be supplied.
-L lv_size Increase the space allocated to the
logical volume, specified in megabytes.
lv_size is a decimal value greater than
the current logical volume size, in the
range 1 to 16777216 (the implementation
limit). lv_size is rounded up to the
nearest multiple of the logical extent
size, equivalent to the physical extent
size defined for the volume group by the
vgcreate command (see vgcreate(1M)).
One, and only one, -l, -L, or -m option
must be specified.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
lvextend(1M) lvextend(1M)
-m mirror_copies Set the number of mirror copies
allocated for each logical extent. A
mirror copy contains the same data as
the original. mirror_copies can have
the value 1 or 2. It must be greater
than the current value.
Data in the new copies is synchronized.
The synchronization process can be time
consuming, depending on hardware
characteristics and the amount of data.
One, and only one, -l, -L, or -m option
must be specified.
EXTERNAL INFLUENCES [Toc] [Back]
Environment Variables
LANG determines the language in which messages are displayed.
If LANG 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 [Toc] [Back]
Increase the number of the logical extents of a logical volume to 100:
lvextend -l 100 /dev/vg01/lvol3
Increase the logical volume size to 400 MB:
lvextend -L 400 /dev/vg01/lvol4
Allocate two mirrors (that is, two copies of the original) for each
logical extent of a logical volume:
lvextend -m 2 /dev/vg01/lvol5
Mirror a logical volume onto a particular physical volume.
lvextend -m 1 /dev/vg00/lvol3 /dev/dsk/c0t3d0
Increase the size of a file system existing on a logical volume.
First, increase the size of the logical volume.
lvextend -L 400 /dev/vg06/lvol3
Unmount the file system.
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
lvextend(1M) lvextend(1M)
umount /dev/vg06/lvol3
Extend the file system to occupy the entire (larger) logical volume.
extendfs /dev/vg06/rlvol3
Remount the file system.
mount /dev/vg06/lvol3 /mnt
SEE ALSO [Toc] [Back]
lvchange(1M), lvcreate(1M), lvdisplay(1M), lvreduce(1M), pvchange(1M),
pvdisplay(1M).
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003 [ Back ] |