HP-UX Reference (11i v2 07/12) - 1M System Administration Commands N-Z (vol 4)

v
vgmodify(1M) vgmodify(1M)
NAME
vgmodify - handle physical volume size changes and modify configuration parameters of an existing LVM
volume group
SYNOPSIS
Set Specified Parameters
/usr/sbin/vgmodify
[-B bootable][-e max_pe][
-l max_lv][-n][-p max_pv][-r][
-v]
vg_name [pv_path ... ]
Optimize the Volume Group Settings
/usr/sbin/vgmodify -o
[-B bootable][
-r][-v] vg_name [pv_path ... ]
Display a Table of Optimized Possible Volume Group Settings
/usr/sbin/vgmodify -t
[-B bootable][-n
][-v] vg_name [pv_path ... ]
Remarks
• If
vgmodify is interrupted while it is committing the configuration changes onto the disks, it may be
necessary to re-apply the configuration to all the physical volumes. The
/etc/lvmconf/VG_restore
script must used to accomplish this. To apply the new configuration,
enter the following:
/etc/lvmconf/VG_restore /etc/lvmconf/VG.conf
Or to apply the old/original configuration, enter the following:
/etc/lvmconf/VG_restore /etc/lvmconf/VG.conf.old
• The root/boot volume group must be booted into maintenance mode before making changes (see
boot(1M)).
• The volume group must be removed from membership in a high availability cluster before making
changes (see vgchange(1M)).
• To expand the LVM configuration data to its maximum size it may be necessary to reallocate the first
physical extent from each physical volume from user to LVM configuration data. This will only be possi-
ble if the first extent is made free (see pvmove (1M)) and PE renumbering is enabled via the
-n option.
• The LVM configuration data size is limited to the volume group extent size. Therefore, a maximum of
one physical extent from each physical volume can be reallocated from user data regardless of how many
times
vgmodify is used on the volume group.
• The attributes of an lvmconf file can be viewed using the -v option of
vgcfgrestore (see
vgcfgrestore(1M)).
• To take advantage of a physical volume size increase, it may be necessary to run
vgmodify to increase
the maximum number of physical extents for the volume group.
• In general, a smaller number of physical volumes allows a larger number of physical extents. Likewise,
a larger number of physical volumes constrains to a smaller number of physical extents.
• The detection of physical volume size changes (LUN size expansion or contraction) is automatic, with
the handling taking place unless the
-r or -t options have been used.
• The changing of physical volume type (boot to non-boot and vice versa) is selected via the -B option and
by specifying a list of physical volumes. Otherwise no physical volume type changes are performed.
DESCRIPTION
The vgmodify command allows the user to modify an existing volume group (vg_name). The following
changes can be performed:
• Detect and handle physical volume size changes.
• Modify the maximum number of physical extents that can be allocated per physical volume (max_pe
setting) (see vgcreate(1M) -e).
• Modify the maximum number of physical volumes that the volume group can contain (max_pv setting)
(see vgcreate(1M) -p).
• Modify the maximum number of logical volumes that the volume group can contain (max_lv setting)
(see vgcreate(1M) -l).
HP-UX 11i Version 2: December 2007 Update − 1 − Hewlett-Packard Company 629