HP Instant Capacity Version 10.x User Guide (5900-1581, March 2011)

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, it
deassigns the specified number of cores from the local vPar.
141