HP Instant Capacity User's Guide for Versions 8.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, e-mail
configuration change notification, or transmission of an asset report to HP.
iCAP 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 will fail
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. If you are adjusting
core assignments across virtual partitions in a single nPartition, you should 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.
Options and Arguments
icapmodify 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 e-mail address. This is the e-mail
address that will receive configuration change notification
and exception reports. Note that this can be an e-mail alias,
if multiple recipients of these reports are desired.
-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. See icapmanage(1M) for
details about GiCAP codewords.
-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. And if specified within a virtual
partition, it deassigns the specified number of cores from
the local vPar.
-D
Defers a core activation or deactivation until the next
reboot. This option modifies the default behavior of the
155