HP-UX 11i v3 vgmodify.1m (2011 09) Manpage

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

vgmodify(1M) vgmodify(1M)

NAME

vgmodify - handle physical volume size changes and modify conﬁguration parameters of an existing LVM

volume group

SYNOPSIS

vgmodify Options for Volume Groups Version 1.0

Set Speciﬁed Parameters and Account for Dynamic LUN Expansion

/usr/sbin/vgmodify

[-a][-e max_pe ][

-l max_lv ][-n][-p max_pv][-r][-v] vg_name

/usr/sbin/vgmodify -B

bootable [-a][-e

max_pe ][-l max_lv ][-n][-p max_pv ][-r][

-v]

vg_name pv_path ...

/usr/sbin/vgmodify -E -a

[-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

[-a][-r][

-v] vg_name

/usr/sbin/vgmodify -o -B

bootable [-a][

-r][-v] vg_name pv_path ...

/usr/sbin/vgmodify -o -E -a

[-r][

-v] vg_name [pv_path ...]

Prepare a Physical Volume for Dynamic LUN Contraction

/usr/sbin/vgmodify

[-a][-r] -C dlc_size vg_name pv_path

Display a Table of Optimized Possible Volume Group Settings

/usr/sbin/vgmodify -t

[-n][-v] vg_name

/usr/sbin/vgmodify -t -B

bootable [-n][-v] vg_name pv_path ...

Recover a Physical Volume from a Previous vgmodify Failure

/usr/sbin/vgmodify -R

vg_conf_path vg_name pv_path ...

vgmodify Options for Activated Volume Groups Version 2.0 and Higher

Reconﬁgure a Volume Group to Account for Dynamic LUN Expansion

/usr/sbin/vgmodify

[-r] -a -E vg_name [pv_path ...]

Prepare a Physical Volume for Dynamic LUN Contraction

/usr/sbin/vgmodify

[-r] -a -C dlc_size vg_name pv_path

Reconﬁgure a Volume Group to a New Maximum Volume Group Size

/usr/sbin/vgmodify [-r][-E] -a -S vg_size vg_name

DESCRIPTION

The

vgmodify command allows the user to modify an existing volume group (vg_name).

The modiﬁcations that

vgmodify can perform depend on the version of the volume group and whether

or not the volume group is activated.

The following changes can be performed for volume groups version 1.0:

• Detect and handle physical volume size changes.

If the volume group is activated, the

-E option of vgmodify must be speciﬁed to take advantage of

increased physical volume sizes.

If the volume group is deactivated,

vgmodify will implicitly handle increased physical volume sizes.

• Prepare a physical volume for a LUN contraction (dlc_size setting).

• 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).

HP-UX 11i Version 3: September 2011 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
vgmodify(1M) vgmodify(1M) NAME vgmodify - handle physical volume size changes and modify configuration parameters of an existing LVM volume group SYNOPSIS vgmodify Options for Volume Groups Version 1.0 Set Specified Parameters and Account for Dynamic LUN Expansion /usr/sbin/vgmodify [-a] [-e max_pe ] [-l max_lv ] [-n] [-p max_pv ] [-r] [-v] vg_name /usr/sbin/vgmodify -B bootable [-a] [-e max_pe ] [-l max_lv ] [-n] [-p max_pv ] [-r] [-v] vg_name pv_path ...
PAGE 2
vgmodify(1M) vgmodify(1M) • Modify the maximum number of logical volumes that the volume group can contain (max_lv setting) (see vgcreate (1M) -l). • Change a physical volume type from boot to non-boot or vice versa (see pvcreate (1M) -B). Note that making a physical volume non-bootable will increase the space available on that device for LVM configuration data. However, even a single bootable physical volume in the volume group will restrict the max_pv and max_pe settings available.
PAGE 3
vgmodify(1M) vgmodify(1M) The size should be at least 1 megabyte, and no greater than a volume group version dependent maximum; use the lvmadm command to determine the maximum size for a physical volume. -E Reconfigure an activated volume group to take advantage of physical volume size increase. This option must be used with the -a option. The -E option cannot be used in conjunction with the -C and -B options.
PAGE 4
vgmodify(1M) -p max_pv vgmodify(1M) Applicable to volume groups version 1.0 only. Set the maximum number of physical volumes that the volume group is allowed to contain (see vgcreate (1M) -p). The maximum number of physical volumes can range from the current number of physical volumes in the volume group to 255. The -t option displays a table of possible max_pv values for vg_name . -R vg_conf_file Applicable to volume groups version 1.0 only.
PAGE 5
vgmodify(1M) vgmodify(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 possible 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.
PAGE 6
vgmodify(1M) • vgmodify(1M) When used with the -r option, the -S option reports if the volume can be reconfigured to the specified volume group size. If not, it displays the number of extents that need to be freed up on each physical volume before the volume group size can be reconfigured. In addition it reports the largest volume group size possible for each physical volume, and the largest volume group size possible when removing free extents.
PAGE 7
vgmodify(1M) vgmodify(1M) Apply the LUN contraction setting that was just reviewed: vgmodify -a -C 4000 /dev/vg02 /dev/rdsk/c2t2d0 Examples For a Volume Group Version 2.0 or Higher The volume group version 2.0 /dev/vg03 is activated in the following examples.
PAGE 8
(Notes) A (Notes) vA 8 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2011