icapmodify(1M)icapmodify(1M)NAMEicapmodify - Activate and deactivate cores. Specify system contact
email address. Change Instant Capacity configuration information. Spec‐
ify Instant Capacity from email address. Specify system identifier.
Specify temporary capacity warning period. Apply codewords.
SYNOPSISicapmodify-c <contact_email_address>
icapmodify-C <codeword>
icapmodify-f <from_email_address>
icapmodify-i <system_id>
icapmodify-r
icapmodify-w <warning_days>
icapmodify-a <n> [-D] [-t] [desc[:user_name]]
icapmodify-d <n> [-D] [desc[:user_name]]
icapmodify-s <n> [-D] [-t] [desc[:user_name]]
Obsolescent:
icod_modify -c <contact_email_address>
icod_modify -C <codeword>
icod_modify -f <from_email_address>
icod_modify -i <system_id>
icod_modify -r
icod_modify -w <warning_days>
icod_modify -a <n> [-D] [-t] [desc[:user_name]]
icod_modify -d <n> [-D] [desc[:user_name]]
icod_modify -s <n> [-D] [-t] [desc[:user_name]]
DESCRIPTION
Use to activate or deactivate cores, specify system contact or Instant
Capacity "from" email address, apply iCAP codewords, change the system
identifier, specify a warning notification period before temporary
capacity expires, and change Instant Capacity configuration informa‐
tion.
Note that the deprecated command performs identical functions to the
command and is maintained for backward compatibility.
For detailed information on the use of this command, activation and
deactivation of Instant Capacity components, compliance, and temporary
capacity, see the located at /usr/share/doc/icapUserGuide.pdf.
Compliance
The command does not allow activation of cores beyond the number of
available core usage rights. Additional usage rights are granted
through the application of either an RTU codeword or a temporary capac‐
ity codeword. In general, a complex is in a compliant state when the
number of active components of a given type does not exceed the number
of usage rights associated with the type of component. The one excep‐
tion is that the number of active cores is allowed to exceed the number
of core usage rights as long as there is a sufficient positive balance
of temporary capacity.
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 command (see icapstatus(1M)).
Virtual Partitions
When activating or deactivating cores within virtual partitions, spe‐
cial considerations apply. You can use either the command or the com‐
mand, depending on the type of adjustment needed and the level of log‐
ging or reporting desired. For example, core assignment via the com‐
mand 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 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 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 command (and options) for the best coordina‐
tion and for optimized performance. The 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 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 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 parti‐
tion, 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 noti‐
fication 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 compo‐
nents. 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 num‐
ber 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.
-D Defers a core activation or deactivation until the
next reboot. This option modifies the default behav‐
ior of the -d, -s, and -a options, which is to acti‐
vate or deactivate cores instantly.
Note: This option is not supported within a virtual parti‐
tion.
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.
-f <from_email_address>
Set Instant Capacity "from" email address. Causes all
Instant Capacity email correspondence from this system
to appear to be sent from from_email_address. Speci‐
fying an empty string (" ") returns to default behav‐
ior, which is to send from the adm user on the local
system. The address specified must be DNS resolvable
by HP.
-i <system_id>
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 distin‐
guish their systems.
-r 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.
The -r option can also be used to undo a deferred (-D)
operation, causing an immediate activation or deacti‐
vation.
-w <warning days>
Set temporary capacity warning period to desired num‐
ber of days. If not specified, the default warning
period is 15 days. The Instant Capacity software cal‐
culates when the temporary capacity expires 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 email
to the system contact if specified, and root. If tem‐
porary 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 automatically deactivates one or
more cores in order to bring the complex into a more
compliant state. Instant Capacity software deacti‐
vates as many cores as is necessary to either stop
consumption of temporary capacity or to bring the par‐
tition to the minimum number of required active cores.
-s <n> 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. In an
nPartition environment, 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 cur‐
rent 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, will first activate cores from unused
capacity before increasing the active cores. For fur‐
ther details of using this option in an virtual parti‐
tion environment, see the Virtual Partition and Unused
Capacity sections of Chapter 4 of the located at
/usr/share/doc/icapUserGuide.pdf.
The 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 -a or the -s option, speci‐
fies that a core activation is allowed to consume tem‐
porary 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 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 resulted
in temporary capacity being consumed in a virtual par‐
tition environment, deactivating a core with a command
temporarily reduces the consumption of temporary
capacity. A subsequent core activation using
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 configura‐
tion 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 notifi‐
cation email.
UPGRADES
The 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 ver‐
sion earlier than B.06.00, but an upgrade codeword issued by the HP
Utility Pricing Solutions portal was not applied to the complex). The
only option that can be used when the complex is in this state is the
-C option, which accepts the upgrade codeword.
EXTERNAL INFLUENCES
Environment Variables
· LANG determines the locale to use for the locale categories
when both LC_ALL and the corresponding environment variable
(beginning with LC_) do not specify a locale. If LANG is not
set or is set to the empty string, a default of "C" is used
(see lang(5)).
· LC_CTYPE determines the interpretation of single- and multi‐
ple-byte characters.
· LC_TIME determines the date and time strings output.
· LC_MESSAGES determines the language in which messages are
displayed.
If any internationalization variable contains an invalid set‐
ting, icapmodify behaves as if all internationalization vari‐
ables are set to C (see environ(5)).
International Code Set Support
Single- and multiple-byte character code sets are supported. However,
input to the command must be entered using ASCII characters only.
RETURN VALUE
The command exits with one of these values:
0 Command succeeded.
>0 Command failed; error message sent to STDERR.
FILES
/var/adm/icap.log
EXAMPLES
Instantly activate one core with "Add horsepower now" as the descrip‐
tion and "Super User" as the user name:
icapmodify-a 1 "Add horsepower now:Super User"
Activate two cores (deferred until the next reboot) with "Add horse‐
power after reboot" as the description and "Super User" as the user
name:
icapmodify-D -a 2 "Add horsepower after reboot:Super User"
Instantly activate one core, using temporary capacity if necessary,
with "Temp use of one core" as the description and "Super User" as the
user name:
icapmodify-t -a 1 "Temp use of one core:Super User"
Instantly activate or deactivate cores to specify 8 active cores (and 8
intended active cores) with "Set active cores to 8" as the description
and "Super User" as the user name:
icapmodify-s 8 "Set active cores to 8:Super User"
Deactivate one core at the next reboot with "Less horsepower after
reboot" as the description and "Super User" as the user name:
icapmodify-D -d 1 "Less horsepower after reboot:Super User"
Apply an iCAP codeword:
icapmodify-C 7y5ejVS.P5CuwXu.XaTyDVP.7Tx0Mvc-J783H9b.yWT5Weu.69JPu$u.vVV685a5
Set the Instant Capacity from_email_address to admin@research.corp.com:
icapmodify-f admin@research.corp.com
Set the system_id to Asset_Num_234:
icapmodify-i Asset_Num_234
Set the system contact email address to super_user@corp.com:
icapmodify-c super_user@corp.com
AUTHOR
was developed by HP.
SEE ALSOicapnotify(1M), icapstatus(1M), icapmanage(1M), icapd(1M), icap(5),
vparmodify(1M).
icapmodify(1M)