*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> icod_modify (1m)              
Title
Content
Arch
Section
 

Contents


 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 ]
      
      
 Similar pages
Name OS Title
bus_activate_resource FreeBSD activate or deactivate a resource
bus_deactivate_resource FreeBSD activate or deactivate a resource
configec0state IRIX activate or deactivate the primary interface
auth.adm HP-UX activate, deactivate, or query about HP-UX Integrated Login
psradm Tru64 Stops and starts processors in a multiprocessor system
offline Tru64 Stops and starts processors in a multiprocessor system
online Tru64 Stops and starts processors in a multiprocessor system
pmap_activate FreeBSD activate a physical map
vm_page_deactivate FreeBSD deactivate a page
processor_sets Tru64 Collections of processors
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service