NAME

lvextend − increase number of physical extents allocated to a logical volume

SYNOPSIS

/etc/lvextend {-l logical_extents_number | -L logical_volume_size | -m mirror_copies} lv_path [physical_volume_path ... | physical_vol_group_name...]

DESCRIPTION

lvextend increases the number of mirrored copies or the size of the lv_path parameter.  The change is determined according to which command options are specified. 

To limit the allocation to specific physical volumes, use the names of one or more physical volumes in the physical_volume_path parameter or use the names of one or more physical volume groups in the physical_vol_group_name parameter; 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 the physical_volume_path parameter or indirectly in the physical_vol_group_name parameter. 

The physical_vol_group_name parameter is allowed only if one of the allocation policies of the logical volume is PVG -strict. 

Options

lvextend recognizes the following options and accompanying arguments:

-l logical_extents_number
Increases the number of logical extents allocated to lv_path. logical_extents_number must be greater than the number of logical extents previously allocated to lv_path and less than 65535 which is the implementation limit.

logical_extents_number represents the new total number of logical extents that can be allocated to lv_path. The change is accomplished by allocating the number of additional logical extents represented by the difference between logical_extents_number and the previous number of extents. 

The mirror policy and mirror copies number for the new logical extents is the same as previously established for lv_path.

One, and only one of the -l, -L, or -m must be supplied. 

-L logical_volume_size
Increases the size of logical volume to logical_volume_size, where logical_volume_size is specified in units of Mbytes.  The maximum value for logical_volume_size is 4096 Mbytes (4 Gbytes).  If logical_volume_size is not a multiple of extent size, the size is adjusted to the next multiple. 

The -L option is same as the -l option, where the logical_extents_number is equivalent to logical_volume_size divided by the extent size. 

See the description of -l above. 

-m mirror_copies
Sets the number of physical extents allocated for each logical extent.

mirror_copies (that is, mirrors) can be either 1 or 2.  This means that beyond the original copy, one or two mirror copies always contain the same data as the original copy. 

mirror_copies must be greater than the current number of mirrors for the logical volume. 

Data in the new copies is synchronized.  The synchronization process can be time consuming, depending on hardware characteristics and the amount of data. 

This option requires installation of optional LVM MIRRORING software (not included in the standard HP-UX operating system) before it can be used. 

One, and only one of the options -l, -L, or -m must be specified. 

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed. 

If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. 

If any internationalization variable contains an invalid setting, lvextend behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Increase the number of the logical extents of a logical volume to one hundred:

lvextend -l 100 /dev/vg01/lvol3

Increase the logical volume size to 400 Mbytes:

lvextend -L 400 /dev/vg01/lvol4

Allocate two mirrors (that is, three copies) for each logical extent of a logical volume:

lvextend -m 2 /dev/vg01/lvol5

WARNINGS

The -m option cannot be used on HP-IB devices. 

SEE ALSO

lvcreate(1M), lvdisplay(1M), lvreduce(1M), pvchange(1M), pvdisplay(1M). 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992