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

v
vparcreate(1M) vparcreate(1M)
Table 1. Resource syntax summary
Resource Forms # times/command
CPU cpu:path Multiple
cpu::num Once
cpu:::[min][:[max]] Once
I/O io:path[:attr1[,attr2]] Multiple
Memory mem::size Once
mem:::base:range 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 vparcreate command exits with one of the following values:
0 Successful completion.
1 One or more error conditions occurred.
EXAMPLES
Create the virtual partition called Oslo in the virtual partition monitor database, but do not assign any
resources:
vparcreate -p Oslo
Create the virtual partition Bergen in the virtual partition monitor database, setting the autoboot attri-
bute and specifying five processors, two of which are bound, 2 Gb of physical memory, and a boot disk:
vparcreate -p Bergen -a cpu::5 -a cpu:::2:6 \
-a mem::2048 -a io:1/0/2/0.6.0:boot -B auto
Since the -b option was not specified, the default kernel path /stand/vmunix will be used at boot time.
Create a virtual partition
myvPar in the virtual partition monitor database, setting the autoboot and
autosearch attribute and specifying five processors, three of which are bound, 1 Gb of physical memory and
a boot disk:
vparcreate -p myvPar -a cpu::5 -a cpu:::3:8 \
-a mem::1024 -a io:1/0/2/0.6.0:boot -B search
ERRORS
vparcreate 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.
vp_name already exists in the monitor database or specified db_file. Use the vparmodify command
instead.
One or more options other than -a has been specified more than once or the same resource was allo-
cated more than once.
An unavailable resource (allocated to another virtual partition or exceeding the available resource
limit) was specified.
A value was omitted for an argument that requires one, or a value was supplied for an argument
which does not take one.
The vparcreate command and the virtual partition monitor are at different revision levels.
HP-UX 11i Version 1: September 2005 − 3 − Hewlett-Packard Company Section 1M−−1101