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

v
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.
For volume groups version 1.0, all the physical volumes associated with the volume group must be avail-
able for the
vgmodify command to succeed. Also, if the command is interrupted before it completes,
recovery steps might be required. See the Remarks section for details.
The following changes can be performed for volume groups version 2.0 and higher:
• Detect and handle physical volume size changes.
The
-E option must be specified to take advantage of increased physical volume size.
• Prepare a physical volume for a LUN contraction (dlc_size setting).
• Modify the maximum volume group size (vg_size setting) (see vgcreate (1M)
-S).
For volume groups version 2.0 and higher,
vgmodify is allowed only when the volume group is in an
activated state.
Options and Arguments
The
vgmodify command recognizes the following arguments and options:
vg_name The path name of a volume group.
pv_path The character (raw) device path name of a physical volume. Refer to the
-B
,
-E, -C, and -R options for the physical volume list usage.
-a Perform volume group reconfiguration when the volume group is activated.
This option is required if the volume group is activated. The command will
fail if this option is used on a deactivated volume group. For version 1.0
volume groups, this option is ignored when used with the -t, -r, and
-R
options.
-B bootable Applicable to volume groups version 1.0 only. Make the physical volumes
specified in the pv_path s list bootable or non-bootable. The
-B option is mutu-
ally exclusive with the
-E and -C options.
bootable can have one of the following values:
y Change pv_path list from non-bootable to bootable.
n Change pv_path list from bootable to non-bootable.
See the description of the
-B option in pvcreate (1M).
Making a physical volume non-bootable will increase the space available on
that device for LVM configuration data. However to fully use that space all
the physical volumes in the volume group should be non-bootable. A single
bootable physical volume in the volume group will restrict the available
configuration settings.
A physical volume can only be made bootable if either all extents on it are
unused or it was previously converted from a bootable device and the space is
still unused.
If a physical volume is being made bootable then use lvlnboot and mkboot
to complete the process (see lvlnboot (1M) and mkboot(1M)).
-C dlc_size Prepare the physical volume for LUN contraction to dlc_size. Exactly one
pv_path must be specified with the -C option. The -C option cannot be used
in conjunction with any other option except for -a and -r.
The unit for dlc_size is specified as a suffix. The recognized values for the
suffix are
m (megabytes), g (gigabytes), t (terabytes), and p (petabytes). If no
suffix is supplied, then m (megabytes) is assumed. A dlc_size of 512 terabytes
would be specified as 512t. Only whole numbers are accepted.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2011