HP Instant Capacity Version 10.x User Guide (762794-001, March 2014)

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 you activate or deactivate cores within virtual partitions, 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 make 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, therefore it 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,
if 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 four 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.
168