vparcreate.1m (2010 09)

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
cell:cell_id:cpu::num (CLP) Once per cell_id
I/O io:path[:attr1[,attr2]] Multiple
Memory mem::size (ILM) Once
mem:::base:range Multiple
cell:cell_id:mem::size (CLM) Once per cell_id
Cell Local Memory (CLM), as its name implies, refers to memory address ranges on a specific cell. Inter-
Leaved Memory (ILM) refers to memory address ranges whose adjacent addresses are on different cells.
size must be in units of granularity for the specified memory type. The
vparstatus command shows
memory granularities. Refer to the vparstatus (1M) manpage.
On PA-RISC platforms, a vPar whose memory consists entirely of CLM will not boot. The vPar needs
ILM in the first 2 GB of memory to load and launch its kernel. Refer to the section "Memory" and the
subsection "Recommendations for ILM and CLM granularity specifications" in the vparresources(5) man
page for details.
Certain tasks can affect the outcome of others. To avoid errors, see the detailed description of the depen-
dencies in the vparresources(5) manpage.
SECURITY RESTRICTIONS
This command is restricted to processes owned by superuser.
When virtual partition flexible administrative capability is enabled, a virtual partition can only be
created from within a Designated-Admin vPar.
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 monitor database, specifying 1 GB of ILM, 2 CPUs and a
boot disk:
vparcreate -p Oslo -a mem::1024 -a cpu::2 -a io:0/1/0/2/0.6.0:BOOT
Create the virtual partition Bergen in the monitor database, setting the autoboot attribute and specify-
ing five processors, 2 GB of ILM, and a boot disk:
vparcreate -p Bergen -a cpu::::6 -a cpu::5 \
-a mem::2048 -a io:0/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 the same vPar, this time in the specified database file
Norway. Norway does not exist and will
be created. Specify a CLM granularity of 128 megabytes, not written to firmware.
vparcreate -p Bergen -D Norway -a cpu::::6 -a cpu::5 -g clm:128 \
-a mem::2048 -a io:0/1/0/2/0.6.0:boot -B auto
Create a virtual partition my_vPar in the monitor database, setting the autoboot and autosearch attri-
bute and specifying five processors, two of which are CLP, 1 GB of ILM, 2 GB of CLM, and a boot disk:
vparcreate -p my_vPar -B search -a cpu::3 -a cell:0:cpu::2 \
-a cpu::::8 -a mem::1024 -a cell:1:mem::2048 \
-a io:1/0/2/0.6.0:boot
ERRORS
vparcreate displays error messages on standard error for any of the following conditions:
• An invalid option is specified.
4 Hewlett-Packard Company − 4 − HP-UX 11i Version 3: September 2010