icod_modify(1M) icod_modify(1M)
NAME [Toc] [Back]
icod_modify - Activate and deactivate processors. Specify system
contact e-mail address. Change iCOD configuration information.
Specify iCOD from e-mail address. Specify system identifier. Apply
codewords.
SYNOPSIS [Toc] [Back]
Path: /usr/sbin
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 -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 [Toc] [Back]
Use icod_modify to activate or deactivate processors, specify system
contact or iCOD "from" e-mail address, apply codewords, change the
system identifier, and change iCOD configuration information.
icod_modify does not allow the activation of unlicensed iCOD
components. Additional components are licensed after HP receives
payment of an enablement fee (for the component) and the application
of a codeword. A complex is in a compliant state when the number of
active components of a given type does not exceed the number of
licensed components of a given type (processors, cells, memory).
Changes to the intended number of active processors using this command
are persistent (survive system reboot). The intended number is the
number of active processors that iCOD attempts to satisfy at system
boot time, and is effected using the -a, -d and -s options. The
intended number of active processors for each partition is displayed
using the icod_stat command (see icod_stat(1M)).
For detailed information on the use of this command, activation and
deactivation of iCOD components, licensing, and temporary capacity,
see the iCOD User's Guide located at /usr/share/doc/icodUserGuide.pdf.
Options and Arguments [Toc] [Back]
icod_modify recognizes the following options and arguments:
Hewlett-Packard Company - 1 - iCOD version B.06.01: March 2004
icod_modify(1M) icod_modify(1M)
-a <n> Activates n additional processors for
this partition. This does not permit
the activation of processors if the
end result would take the complex out
of compliance.
-c <contact_email_address> 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.
-C <codeword> Codeword application. This option
allows the user to apply a codeword
they receive from the HP iCOD portal.
Application of codewords only
authorizes the use of iCOD components;
it does not activate any components.
-d <n> Deactivates n processors. This option
reduces the number of intended active
processors by n, for this partition.
-D Defers a processor 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 processors instantly. This
option is not supported within a
virtual partition. NOTE: the behavior
of the -d and -a options is modified
such that all invocations are
calculated based on the running
configuration, and NOT on any previous
icod_modify -D[asd] commands.
-f <from_email_address> Set iCOD "from" e-mail address.
Causes all iCOD 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.
-i <system_id> Set system identifier used during
asset reporting. The default setting
Hewlett-Packard Company - 2 - iCOD version B.06.01: March 2004
icod_modify(1M) icod_modify(1M)
for the system identifier is the
hostname of the iCOD system. This
value can be returned to the default
setting by specifying an empty string
(""). The system identifier is a
string that you specify to help track
your own systems.
-r Reconcile. Activate or deactivate
processors (subject to compliance
limits) to bring the system to a state
where the intended number of
processors are active.
-s <n> Sets the number of active processors
to n. This option does not permit the
activation of processors if the end
result causes the complex to be out of
compliance.
-t Authorize use of temporary capacity.
This option specifies that a processor
activation is allowed to consume
temporary capacity.
desc Optional description to help customers
identify this configuration change.
This description becomes part of the
iCOD logfile (/var/adm/icod.log) entry
documenting the activation or
deactivation. This description is
also contained in the configuration
change notification e-mail.
user_name Optional string identifying the person
performing the processor activation or
deactivation. This can be any ASCII
string, and will become part of the
iCOD logfile (/var/adm/icod.log) entry
documenting the activation or
deactivation. The string specified
here will also be contained in the
configuration change notification email.
UPGRADES [Toc] [Back]
The icod_modify command fails if the system is in a state where a
software upgrade is incomplete (the software on the system has been
upgraded from version B.05.00 or earlier, but an upgrade codeword
issued by the HP iCOD portal (http://www.hp.com/go/icod/portal) has
not been applied to the system). The only option that can be used
Hewlett-Packard Company - 3 - iCOD version B.06.01: March 2004
icod_modify(1M) icod_modify(1M)
when the complex is in this state is the -C option, which accepts the
upgrade codeword.
EXTERNAL INFLUENCES [Toc] [Back]
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 multibyte
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 setting,
icod_modify behaves as if all internationalization variables are
set to "C" (see environ(5)).
International Code Set Support [Toc] [Back]
Single- and multi-byte character code sets are supported. However,
input to the command must be entered using ASCII characters only.
RETURN VALUE [Toc] [Back]
icod_modify exits with one of these values:
0 Command succeeded.
>0 Command failed; error message sent to STDERR.
FILES [Toc] [Back]
/var/adm/icod.log
EXAMPLES [Toc] [Back]
Instantly activate one CPU with "Add horsepower now" as the
description and "Super User" as the user name:
icod_modify -a 1 "Add horsepower now:Super User"
Activate two CPUs (deferred until the next reboot) with "Add
horsepower after reboot" as the description and "Super User" as the
user name:
icod_modify -D -a 2 "Add horsepower after reboot:Super User"
Instantly activate one CPU using temporary capacity with "Temp use of
one CPU" as the description and "Super User" as the user name:
Hewlett-Packard Company - 4 - iCOD version B.06.01: March 2004
icod_modify(1M) icod_modify(1M)
icod_modify -t -a 1 "Temp use of one CPU:Super User"
Instantly activate or deactivate CPUs to specify 8 active CPUs with
"Set active CPUs to 8" as the description and "Super User" as the user
name.
icod_modify -s 8 "Set active CPUs to 8:Super User"
Deactivate one CPU at the next reboot with "Less horsepower after
reboot" as the description and "Super User" as the user name:
icod_modify -D -d 1 "Less horsepower after reboot:Super User"
Set the iCOD from_email_address to admin@research.corp.com:
icod_modify -f admin@research.corp.com
Set the system_id to Asset_Num_234:
icod_modify -i Asset_Num_234
Set the system contact e-mail address to super_user@corp.com:
icod_modify -c super_user@corp.com
AUTHOR [Toc] [Back]
icod_modify was developed by HP.
SEE ALSO [Toc] [Back]
icod_notify(1M), icod_stat(1M), icodd(1M), icod(5).
Hewlett-Packard Company - 5 - iCOD version B.06.01: March 2004 [ Back ] |