works exactly as the -aoption (if n is greater than the

 

current number of active cores), or exactly as the -doption

 

(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. In a virtual partition environment, if

 

unused capacity is not available, this option will use the

 

value of n as the desired number of cores to be active in

 

the local virtual partition. If unused capacity is available,

 

icapmodify will first activate cores from unused capacity

 

before increasing the active cores. For further details of

 

using this option in an virtual partition environment, see

 

the Virtual Partition and Unused Capacity sections of

 

Chapter 4 of the HP Instant Capacity user's guide for Version

 

10.x located at /usr/share/doc/icapUserGuide.pdf.

 

The icapmodify command fails if it is unable to set the

 

value exactly as requested. However, a failed request can

 

still make a partial change to the number of intended active

 

cores.

-t

Authorize use of temporary capacity. This option,

 

combined with either the -aor the -soption, 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 -dor

 

-sto reduce or stop the use of temporary capacity. It is

 

not necessary to use the -toption when using the -d

 

option. If a previous activation via icapmodify 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.

desc

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 email.

user_name

Optional string identifying the person performing the core

 

activation or deactivation. This can be any ASCII string,

 

and becomes part of the Instant Capacity logfile (/var/

 

adm/icap.log) entry documenting the activation or

 

deactivation. The string specified here is also contained in

 

the configuration change notification email.

UPGRADES

The icapmodify command fails if the system is in a state where a software upgrade is incomplete (the software on the system has been upgraded from a version earlier than B.06.00, but an upgrade codeword issued by the HP Utility Pricing Solutions portal was not applied to the complex). The

177

Page 177
Image 177
HP Instant Capacity (iCAP) manual Works exactly as the -aoption if n is greater than, Cores, Notification email