vparmodify.1m (2010 09)

v
vparmodify(1M) vparmodify(1M)
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
cell:cell_id:cpu::num (CLP) -a, -m, -d Once per cell_id
I/O io:path[:attr1[,attr2]] -a, -m, -d Multiple
Memory mem::size (ILM) -a, -m, -d Once
mem:::base:range -a, -d Multiple
cell:cell_id:mem::size (CLM) -a, -m, -d 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.
NOTE: Online memory addition/deletion is not supported for the default (base) memory type. In order to
delete floating memory (ILM or CLM) the keyword "floating", "float" or "f" should be explicitly specified on
the command line. Refer to the vparresources(5) man page for syntax details.
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. You should always retain sufficient ILM in
your vPar to accommodate this requirement. Refer to the section "Memory" and the subsection "Recom-
mendations for ILM and CLM granularity specifications" in the vparresources(5) man page for details.
A vp_name in the monitor database must be in the
Down state to add or delete resources, with one excep-
tion: CPU resources can be added to or deleted from a running virtual partition. This restriction may be
relaxed for other types of resource management in a future release.
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 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.
SECURITY RESTRICTIONS
This command is restricted to processes owned by superuser.
When virtual partition flexible administrative capability is enabled, only a Designated-Admin vPar can
rename, modify resources and attributes on other virtual partitions.
RETURN VALUE
The
vparmodify command exits with one of the following values:
0 Successful completion.
1 One or more error conditions occurred.
2 A warning condition occurred.
EXAMPLES
Change the name of the virtual partition called
Oslo to Bergen:
vparmodify -p Oslo -P Bergen
Turn on the 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:
4 Hewlett-Packard Company − 4 − HP-UX 11i Version 3: September 2010