icapmodify(1M)

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.

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.

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.

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.

Defers a core activation or deactivation until the next reboot. This option modifies the default behavior of the -d, -s, and -a options, which is to activate or deactivate cores instantly. This option is not supported within a virtual partition. NOTE: deferred operations are not cumulative. If there is a pending deferred operation, a subsequent activation or deactivation request (-s, -a, or -d), deferred or not, cancels the pending deferred request and resets the values for intended active and actual active based on the request and the current value for actual active.

Set Instant Capacity “from” e-mail address. Causes all Instant Capacity e-mail correspondence from this system to appear to be sent from from_email_address. Specifying an empty string ("") returns to default behavior, which is to send from the adm user on the local system. The address specified must be DNS resolvable by HP.

Set system identifier used during asset reporting. The default setting for the system identifier is the hostname of the Instant Capacity system. This value can be returned to the default setting by specifying an empty string (""). The system identifier is a string that users specify to help track and distinguish their systems.

Reconcile. Activate or deactivate cores (subject to compliance limits) to bring the system to a state where the intended active number of cores are active.

Set temporary capacity warning period to desired number of days. If not specified, the default warning period is 15 days. The Instant Capacity software calculates when the temporary capacity will expire based on the current consumption rate. When the temporary capacity balance is projected to be depleted within the warning period, a warning message is sent by e-mail to the system-contact if specified, and root. Note that if temporary capacity is depleted and you continue to have more active cores than core usage rights across the complex, on the next reboot of any partition in the complex the software will automatically deactivate one or more cores in order to bring the complex into a more compliant state. Instant Capacity software will deactivate as many cores as is necessary to either stop consumption of temporary capacity or to bring the partition to the minimum number of required active cores.

Sets the number of active cores and the number of intended active cores to n, as long as the end result does not take the complex out of compliance. Depending on the value of n, this option works exactly as the -a option (if n is greater than the current number of active cores), or exactly as the -d option (if n is less than the current number of active cores). Specifying a value of n less than the number of cells in a partition will fail.

icapmodify will fail if it is unable to set the value exactly as requested. However, a failed request may still make a partial change to the number of intended active cores.

Authorize use of temporary capacity. This option, in combination with either the -a or the -s option, specifies that a core activation is allowed to consume temporary capacity. Temporary capacity is consumed when the number of active cores exceeds the number of core usage rights. It is no longer used when the number of active cores is decreased to no more than the number of core usage rights available to the complex. Use icapmodify -d or -s to reduce or stop the use of temporary capacity. It is not necessary to use the -t option when using the -d option. If a previous activation via icapmodify has resulted in temporary capacity being consumed in a virtual partition environment, deactivating a core with a vparmodify command temporarily reduces the consumption of temporary capacity. A subsequent core activation using vparmodify increases consumption of temporary capacity if the activation results in more active cores than core usage rights.

Optional description to help customers identify this configuration change. This description becomes part of the Instant Capacity logfile (var/adm/icap.log) entry documenting the activation or deactivation. This description is also contained in the configuration change notification e-mail.

Optional string identifying the person performing the core activation or deactivation. This can be any ASCII string, and will become part of the Instant Capacity logfile (/var/adm/icap.log) entry documenting the activation or deactivation. The string specified here will also be contained in the configuration change notification e-mail.