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

v
vparmodify(1M) vparmodify(1M)
assuming no virtual partition with that name already exists in the monitor database
or specified alternate database file. The name can consist of alpha-numeric characters
A-Z, a-z,
0-9, the underbar character (_), and period (.). The maximum length of
the name is 239 characters.
-a rsrc -a adds resources to a virtual partition.
-d rsrc -d deletes resources from a virtual partition.
-m rsrc -m modifies existing resources in a virtual partition. rsrc is a hardware resource
specification, as described in detail in the vparresources(5) manpage. A summary of
resource syntax forms is shown in Table 1. Multiple resource specifications in the
same command are allowed, but some syntax forms are restricted to specific options,
and some are only allowed once. Both are indicated in Table 1. In any case, resources
in multiple specifications must not repeat or conflict with each other.
Table 1. Resource syntax summary
Resource Forms Options # times/command
CPU cpu:path -a, -d Multiple
cpu::num -a, -m, -d Once
cpu:::[min]:[max] -m Once
I/O io:path[:attr1[,attr2]] -a, -m, -d Multiple
Memory mem::size -a, -m, -d Once
mem:::base:range -a, -d Multiple
Certain tasks can affect the outcome of others. To avoid errors, see the detailed description of the depen-
dencies in the vparresources(5) manpage.
Dynamically increasing or decreasing the number of floating CPUs in a running virtual partition results in
an asynchronous request to the OS. The OS requires an indeterminate time to complete the operation,
based on overall system load and (for CPU deletion) the time required to migrate all threads on that CPU
on to one or more of the remaining CPUs. During this time, the CPU is said to be undergoing migration
into or out of the vPar. The CPU is assigned to its vPar throughout the migration process. For migration
out, the CPU is not available for assignment to another vPar until the migration has completed.
The
vparstatus command shows migrating CPUs. Refer to the vparstatus(1M) manpage.
RETURN VALUE
The vparmodify command exits with one of the following values:
0 Successful completion.
1 One or more error conditions occurred.
EXAMPLES
Change the name of the virtual partition called Oslo to Bergen:
vparmodify -p Oslo -P Bergen
Turn on autosearch attribute for the virtual partition Bergen:
vparmodify -p Oslo -B search
Turn off the autoboot and autosearch attributes for the virtual partition Oslo:
vparmodify -p Oslo -B manual
Add two processors to the virtual partition Bergen in alternate database file /stand/Norway:
vparmodify -p Bergen -D /stand/Norway -a cpu::2
ERRORS
vparmodify displays error messages on stderr for any of the following conditions:
An invalid option is specified.
An invalid value is specified for an option or a value is omitted.
The specified db_file does not exist, cannot be accessed, or has been corrupted.
vp_name does not exist in the specified db_file or in the monitor database.
new_vp_name already exists in the monitor database or specified db_file.
Section 1M−−1108 Hewlett-Packard Company − 3 − HP-UX 11i Version 1: September 2005