HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

v
vparmodify(1M) vparmodify(1M)
NAME
vparmodify - rename a virtual partition or modify the attributes of a virtual partition
SYNOPSIS
vparmodify -p vp_name [-B boot_attr][
-D db_file][-S static_attr][-b kernel_path]
[
-o boot_opts][-P new_vp_name][
-a rsrc]... [-m rsrc]... [-d rsrc]...
DESCRIPTION
The
vparmodify command modifies attributes and resources of the specified virtual partition (vPar).
The command can also rename the virtual partition. vp_name is a symbolic name for an existing virtual
partition and must be used in all references to it.
vparmodify cannot create a virtual partition. Use the
vparcreate command for that purpose.
Some CPU resources have special requirements when being added to a virtual partition. These special
CPU resource requirements are described below Table 1.
Only a superuser can execute the vparmodify
command. In a secure virtual partition environment only
a
Primary-Admin
vPar can modify resources on other virtual partitions.
Options
• If the
-D option is specified, vp_name in db_file is modified; otherwise vp_name in the virtual partition
monitor database is modified.
• If the
static attribute has been configured in vp_name, none of its resources may be added, modified,
or deleted. Attributes (all options except -a, -m, and -d) may be modified. Refer to the
-S option
description.
• Only the
-S, -a, -m,and/or
-d options may be specified more than once in a command.
• If any of the following options are specified:
-B, -P,
-S, -b,or-o, the virtual partition to be modified
must be in the Up, Down, or Hung state. Refer to the vparstatus(1M) manpage for a complete list of
vPar states and their definitions.
• Resources allocated with the
-a option must be available, that is, not already allocated to a virtual par-
tition, and they must NOT exceed the overall limits of the resources.
• Resources to be modified (-m) or deleted (-d) must be owned by vp_name.
Violation of any condition is a command error.
vparmodify recognizes the following command line options and arguments. The options are processed
from left to right.
-p vp_name Specifies the symbolic name of the existing virtual partition which is to be modified.
Required.
-B boot_attr Specifies the autoboot and autosearch attribute of the virtual partition. boot_attr can
have the following case-insensitive values:
auto sets the autoboot attribute.
manual clears the autoboot and autosearch attributes.
search sets the autosearch attribute.
nosearch clears the autosearch attribute.
If the autoboot attribute is set to auto, the virtual partition is rebooted after a suc-
cessful vparreset command or when the virtual partition monitor is first loaded, if
appropriate monitor options have been specified.
If the attribute is set to manual, the virtual partition halts after a vparreset and
does not boot when the monitor is loaded. It must then be booted manually with the
vparboot command.
If the autosearch attribute is set to search, then the combination of autoboot(auto)
and autosearch(search) decides the boot action to be taken. The interpretation of auto-
boot and autosearch has changed for systems that support hardware partitions. Refer
to setboot(1M) for details.
On hard partitioned systems with vpars the boot action corresponds to the autoboot
and autosearch flags in the following manner:
Section 1M−−1106 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005