HP Instant Capacity (iCAP) manual Intended Active, Options and Arguments

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 -soptions. 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 (-aand -doptions) 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,

175