HP Instant Capacity User's Guide for Version 9.x

Intended Active
Changes to the number of intended active cores through the use of this command are
persistent (survive system reboot). The intended active number is the number of cores that
the Instant Capacity software attempts to activate at system boot time. It is adjusted by use of
the -a, -d, and -s options. The number of intended active cores for each partition is
displayed using the icapstatus command (see icapstatus(1M)).
Virtual Partitions
When activating or deactivating cores within virtual partitions, special considerations apply.
You can use either the icapmodify command or the vparmodify command, depending on
the type of adjustment needed and the level of logging or reporting desired. For example, core
assignment via the vparmodify command does not result in logging of the activation, email
configuration change notification, or transmission of an asset report to HP.
Instant Capacity has a minimum version dependency on vPars A.03.05. For versions of vPars
before A.03.05, the icapmodify command for activating or deactivating cores in a virtual
partition fails with an error message citing the vPar version dependency.
For vPars versions A.03.05 or greater, the icapmodify command must be used in a virtual
partition environment when you are making any adjustment to an nPartition. To adjust core
assignments across virtual partitions in a single nPartition, use the vparmodify command (-a
and -d options) for the best coordination and for optimized performance. The vparmodify
command does not affect the intended active number for the nPartition, and it therefore
cannot be used to migrate unused capacity either to or from other nPartitions. If vparmodify
is used to deactivate cores in a virtual partition, and they are not activated in another virtual
partition, the deactivation will not free usage rights and they are held as unused capacity by the
nPartition.
Options and Arguments
The icapmodify command recognizes the following options and arguments:
-a <n> Immediately activates n additional cores for this nPartition,
as long as the end result does not take the complex out of
compliance. This option also increases the number of
intended active cores by n for the nPartition. If
specified within a virtual partition, it also results in the
assignment of additional cores to the local vPar.
-c <contact_email_address>
Sets the system contact email address. This is the email
address that receives configuration change notification and
exception reports. If you want multiple recipients to receive
these reports, that this can be an email alias.
-C <codeword>
iCAP codeword application. This option allows the user
to apply an iCAP codeword received from the HP Utility
Pricing Solutions portal. Application of codewords only
provides usage rights for Instant Capacity components; it
does not activate any components. This option cannot be
used to apply GiCAP codewords. For details about GiCAP
codewords, see icapmanage(1M).
-d <n> Immediately deactivates n cores, if possible. Instant
Capacity software must leave at least one core active for
each configured cell in a partition — this is a firmware and
OS requirement. That is, in a partition of 4 cells, attempts
to reduce the active core count below 4 will fail. This option
also reduces the number of intended active cores by
n for the nPartition. If specified within a virtual partition,
167