lvextend(1M)															      lvextend(1M)

NAME

       lvextend - 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 commands (see lvchange(1M) and lvreduce(1M)).

       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.

       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 volume.

	      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 command (see vgcfgbackup(1M)) is executed 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 maximum; use the command to
				  determine the maximum number of logical extents for the volume group version.

				  One, and only one, or option must be supplied.

	      Increase the space allocated to the logical volume,
				  specified in megabytes.  lv_size is a decimal value greater than the current logical volume size.

				  lv_size must be at least 1 and no greater than a volume group version-dependent  maximum;  use  the  command	to
				  determine the maximum logical volume size for the volume group version.

				  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 command (see vgcreate(1M)).

				  One, and only one, or option must be specified.

	      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-dependent 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 synchronization process can be  time
				  consuming, depending on hardware characteristics and the amount of data.

				  One, and only one, or option must be specified.

	      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
       physical extents if the volume is not mirrored or to stripes * (mirror_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 volumes
       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  vol-
       umes 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 ALSO

       lvchange(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)