HP Smart Update Manager CLI Help

Version 7.1.0

     ----------------------------------------------------------------------

Chapter 1 Using the command line interface (CLI) to deploy updates

   To view this file use a text browser, for example Notepad or Vi.

1.1 Command-line interface

   You can use the HP SUM CLI to script custom installations.

   For more information on using HP SUM, see the HP Smart Update Manager
   User's Guide HP SUM documentation website at
   http://www.hp.com/go/hpsum/documentation.

  1.1.1 Command-line syntax

   The general command-line syntax for HP SUM is as follows:

   hpsum [/s] [/h] [/f]:bundle] [/r[eboot]

   [NOTE] :                                   
          On Windows, use a slash before each argument. On Linux, use a
          hyphen before each argument. For example:
                                                  
          hpsum /s /h (Windows)                   
                                                  
          hpsum -s -h (Linux)                     

   HP SUM with OA requires a user ID and password to log in. The user ID must
   be an administrator equivalent ID and not an operator or user equivalent
   level ID.

   Use the /s[ilent] argument for all commands, except when you use
   /express_install.

   [NOTE] :                                  
          Command-line syntax does not support double-byte character sets.
          Any messages entered through the command line via a double-byte
          character set will not be displayed correctly.

    1.1.1.1 Switch update commands

   G7 and earlier servers do not support AMS agents. The following tables
   show what updates occur when you use the switch agent commands.

   [NOTE] :                                   
          To find out if you have any switches installed, use HP SUM to
          create the Firmware Details Report.     

   The following table shows what updates occur if no switches are currently
   installed.

   +------------------------------------------------------------------------+
   |          Command          |    G7 and earlier    |    Gen8 servers     |
   |                           |       servers        |                     |
   |---------------------------+----------------------+---------------------|
   | no switches               | SNMP                 | AMS                 |
   |---------------------------+----------------------+---------------------|
   | /no_mgmt                  | Nothing              | Nothing             |
   |---------------------------+----------------------+---------------------|
   | /use_ams                  | SNMP                 | AMS                 |
   |---------------------------+----------------------+---------------------|
   | /use_snmp                 | SNMP                 | SNMP                |
   |---------------------------+----------------------+---------------------|
   | /use_wmi                  | WBEM                 | WBEM                |
   |---------------------------+----------------------+---------------------|
   | /use_ams /use_snmp        | SNMP                 | AMS and SNMP        |
   |---------------------------+----------------------+---------------------|
   | /use_ams /use_wmi         | SNMP and WBEM        | AMS and WBEM        |
   |---------------------------+----------------------+---------------------|
   | /use_wmi /use_snmp        | WBEM and SNMP        | WBEM and SNMP       |
   |---------------------------+----------------------+---------------------|
   | /use_ams /use_wmi         | WBEM and SNMP        | AMS, SNMP, and WBEM |
   | /use_snmp                 |                      |                     |
   +------------------------------------------------------------------------+

   [NOTE] :                   
          G7 and earlier servers do not support AMS.

  1.1.2 Command-line arguments

   HP SUM recognizes the following command-line arguments:

   [NOTE] :                                 
          You cannot use some arguments, such as /romonly and /softwareonly,
          together.                             

   +---------------------------------------------------------+
   |     Help      |               Description               |
   |---------------+-----------------------------------------|
   | /h[elp] or /? | Displays command line help information. |
   +---------------------------------------------------------+

   +------------------------------------------------------------------------+
   |         Installation options          |          Description           |
   |---------------------------------------+--------------------------------|
   |                                       | Overrides or downgrades an     |
   |                                       | existing component             |
   | /f[orce]                              | installation. This produces    |
   |                                       | the same results as            |
   |                                       | /f:software.                   |
   |---------------------------------------+--------------------------------|
   |                                       | Overrides or downgrades the    |
   | /f[orce]:bundle                       | existing installation of       |
   |                                       | components in the selected     |
   |                                       | bundle.                        |
   |---------------------------------------+--------------------------------|
   |                                       | Overrides or downgrades the    |
   | /f[orce]:rom                          | existing installation of the   |
   |                                       | selected firmware components   |
   |                                       | (applies to firmware only).    |
   |---------------------------------------+--------------------------------|
   |                                       | Overrides or downgrades the    |
   | /f[orce]:software                     | existing installation of the   |
   |                                       | selected software components.  |
   |---------------------------------------+--------------------------------|
   |                                       | Overrides or downgrades the    |
   |                                       | existing installation of the   |
   | /f[orce]:all                          | selected software components,  |
   |                                       | firmware components, and       |
   |                                       | bundles.                       |
   |---------------------------------------+--------------------------------|
   | /g or /downgrade                      | Downgrades to an earlier       |
   |                                       | version of components.         |
   |---------------------------------------+--------------------------------|
   | /e or /rewrite                        | Rewrites the current version   |
   |                                       | of components.                 |
   |---------------------------------------+--------------------------------|
   |                                       | Changes the port HP SUM uses   |
   | /port <n>                             | for the internal HTTP server   |
   |                                       | from 63001 to the selected     |
   |                                       | port.                          |
   |---------------------------------------+--------------------------------|
   |                                       | Changes the port HP SUM uses   |
   | /ssl_port <n>                         | for the internal HTTPS server  |
   |                                       | from 63002 to the selected     |
   |                                       | port.                          |
   |---------------------------------------+--------------------------------|
   |                                       | HP SUM uses the                |
   |                                       | command to open the HTTP and   |
   |                                       | HTTPS ports used by HP SUM for |
   | /open_firewall                        | external access. Open the      |
   |                                       | ports for remote node          |
   |                                       | functionality and for remote   |
   |                                       | browser access.                |
   |---------------------------------------+--------------------------------|
   | /offline_automatic                    | Runs an HP SUM update          |
   |                                       | automatically in offline mode. |
   |---------------------------------------+--------------------------------|
   | /offline_interactive                  | Runs an HP SUM update in       |
   |                                       | interactive (GUI) mode.        |
   |---------------------------------------+--------------------------------|
   |                                       | Causes the installation to run |
   | /s[ilent]                             | silently with no GUI or        |
   |                                       | interactive CLI output. All    |
   |                                       | data writes to the log file.   |
   |                                       | HP SUM 6.0.0 and requires      | 
   |                                       | silent mode for CLI commands.  | 
   |---------------------------------------+--------------------------------|
   |                                       | Specifies which components to  |
   |                                       | install. Components to install |
   |                                       | can be specified with or       |
   |                                       | without the /c[omponent]       |
   |                                       | argument.                      |
   |                                       |                                |
   |                                       |   o If you are using the       |
   |                                       |     /c[omponent] argument,     |
   | /c[omponent]<component_to_install> or |     then only one component    |
   | <component1_to_install>               |     can specified with the     |
   | <component2_to_install>               |     argument. However,         |
   |                                       |     multiple /c arguments and  |
   |                                       |     components can be          |
   |                                       |     specified on the same      |
   |                                       |     line.                      |
   |                                       |                                |
   |                                       |   o If you do not use the      |
   |                                       |     /c[omponent] argument,     |
   |                                       |     multiple components can be |
   |                                       |     specified at the same      |
   |                                       |     time, but the components   |
   |                                       |     must be separated by a     |
   |                                       |     blank and listed after all |
   |                                       |     the arguments on the       |
   |                                       |     command line.              |
   |                                       |                                |
   |                                       |   o The components are         |
   |                                       |     installed in the order     |
   |                                       |     provided unless            |
   |                                       |     dependencies between       |
   |                                       |     components require         |
   |                                       |     installation in a          |
   |                                       |     different order. If so,    |
   |                                       |     the utility changes the    |
   |                                       |     installation order based   |
   |                                       |     on the component           |
   |                                       |     dependencies to ensure the |
   |                                       |     successful installation of |
   |                                       |     as many components as      |
   |                                       |     possible.                  |
   |                                       |                                |
   |                                       |   o Multiple components and    |
   |                                       |     bundles can be specified   |
   |                                       |     on the same command line.  |
   |                                       |     When you are mixing        |
   |                                       |     components and bundles on  |
   |                                       |     the command line, the      |
   |                                       |     filter switches control    |
   |                                       |     what components and        |
   |                                       |     bundles are installed.     |
   |                                       |                                |
   |                                       |   o HP SUM only uses the       |
   |                                       |     component name. If you     |
   |                                       |     type the entire directory  |
   |                                       |     path, HP SUM will ignore   |
   |                                       |     the path. If you use       |
   |                                       |     /use_location and /c, HP   |
   |                                       |     SUM checks both the        |
   |                                       |     default repository and the |
   |                                       |     directory provided.        |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies an     |
   | /group "group_name"                   | already defined group name in  |
   |                                       | the HP SUM GUI.                |
   |---------------------------------------+--------------------------------|
   |                                       |   o If you are using the       | 
   | /b[undle] <bundle_name>               |     /b[undle] argument, only   |
   |                  			   | 	 one bundle can specified   |
   | 			                   |     with the argument.         ||
   |---------------------------------------+--------------------------------|
   |                                       | This argument is a filter      |
   |                                       | switch. It enables you to      |
   |                                       | install newer versions of      |
   |                                       | components defined in a PSP,   |
   |                                       | ISP, or firmware bundle.       |
   | /allow_update_to_bundle               |                                |
   |                                       | This argument enables these    |
   |                                       | components to replace the      |
   |                                       | older versions of the same     |
   |                                       | component that might have      |
   |                                       | shipped with the bundles.      |
   |                                       | By default this is set to true.|
   |---------------------------------------+--------------------------------|
   |                                       | This argument is a filter      |
   |                                       | switch. It enables you to      |
   | /allow_non_bundle_components          | install components that are    |
   |                                       | not included in the bundle but |
   |                                       | reside in the directory with   |
   |                                       | the components in the bundle.  |
   |                                       | By default this is set to true.|
   |---------------------------------------+--------------------------------|
   |                                       | This argument is a filter      |
   |                                       | switch for use with bundles.   |
   |                                       | The argument enables the       |
   |                                       | latest version of the bundle   |
   |                                       | to be used when multiple       |
   |                                       | versions of bundles are listed |
   | /use_latest                           | on the command line. If there  |
   |                                       | are no bundles specified on    |
   |                                       | the command line, and multiple |
   |                                       | bundles are in the directory,  |
   |                                       | the /use_latest argument       |
   |                                       | allows HP SUM to use the       |
   |                                       | bundle that has the latest     |
   |                                       | version for installation.      |
   |---------------------------------------+--------------------------------|
   |                                       | Specifies a directory or file  |
   |                                       | share that contains the SPP,   |
   |                                       | HP Integrity Smart Update      |
   |                                       | Firmware Bundles, and          |
   |                                       | components for use with HP     |
   |                                       | SUM. The file_share format     |
   |                                       | must be a mapped file share or |
   |                                       | UNC format. If this argument   |
   |                                       | is not specified, the          |
   |                                       | directory that contains        |
   |                                       | hpsum.exe or HP SUM is used by |
   |                                       | default.                       |
   | /use_location "file_share"            |                                |
   |                                       | Make sure the logged-in        |
   |                                       | account has access to this     |
   |                                       | location. If the location is a |
   |                                       | UNC file share, credentials to |
   |                                       | the file share must be         |
   |                                       | provided using the             |
   |                                       | /unc_username and              |
   |                                       | /unc_password options. If you  |
   |                                       | do not provide these argument  |
   |                                       | HP SUM uses the current        |
   |                                       | credentials to access the      |
   |                                       | share.                         |
   |---------------------------------------+--------------------------------|
   |                                       | Specifies the username         |
   | /unc_username                         | credentials to access the file |
   |                                       | share.                         |
   |---------------------------------------+--------------------------------|
   |                                       | Specifies the password         |
   | /unc_password                         | credentials to access the file |
   |                                       | share.                         |
   |---------------------------------------+--------------------------------|
   |                                       | Specifies that AMS, SNMP, and  |
   |                                       | WBEM Providers management      |
   |                                       | components are optional on the |
   | /no_mgmt                              | Components Selection screen.   |
   |                                       | In silent mode, HP SUM will    |
   |                                       | not update any management      |
   |                                       | components.                    |
   |---------------------------------------+--------------------------------|
   |                                       | Specifies that components that |
   |                                       | use SNMP protocol and the AMS  |
   |                                       | components are available for   |
   | /use_snmp                             | installation by default. When  |
   |                                       | the /use_snmp argument is      |
   |                                       | used, the AMS components are   |
   |                                       | required, but the WMI          |
   |                                       | components are optional.       |
   |---------------------------------------+--------------------------------|
   |                                       | Specifies that components that |
   |                                       | use the WMI protocol are       |
   |                                       | available for installation.    |
   |                                       | These components are optional  |
   |                                       | and are not installed unless   |
   |                                       | this argument is used. When    |
   | /use_wmi                              | the /use_wmi argument is used, |
   |                                       | and the /use_snmp & /use_ams   |
   |                                       | arguments are not, the SNMP    |
   |                                       | and AMS components are         |
   |                                       | optional. This argument does   |
   |                                       | not apply to HP Integrity      |
   |                                       | servers.                       |
   |---------------------------------------+--------------------------------|
   |                                       | Specifies which AMS components |
   |                                       | can be installed along with    |
   |                                       | SNMP components. The AMS and   |
   |                                       | SNMP components are available  |
   | /use_ams                              | to select by default. When the |
   |                                       | /use_ams argument is used, the |
   |                                       | SNMP components are required,  |
   |                                       | and the WMI components are     |
   |                                       | optional.                      |
   |---------------------------------------+--------------------------------|
   |                                       | This filter switch allows you  |
   |                                       | to see only the firmware       |
   |                                       | components needed for          |
   |                                       | installation. When you are     |
   |                                       | using this filter switch, you  |
   |                                       | must exit and restart HP SUM   |
   | /romonly                              | if you want to return to an    |
   |                                       | unfiltered state.              |
   |                                       |                                |
   |                                       | Do not use the /romonly        |
   |                                       | argument with the              |
   |                                       | /softwareonly argument.        |
   |                                       | (Applies to firmware only.)    |
   |---------------------------------------+--------------------------------|
   |                                       | This filter switch allows you  |
   |                                       | to see only the software       |
   |                                       | components needed for          |
   |                                       | installation. When you are     |
   |                                       | using this filter switch, you  |
   | /softwareonly                         | must exit and restart HP SUM   |
   |                                       | if you want to return to an    |
   |                                       | unfiltered state.              |
   |                                       |                                |
   |                                       | Do not use the /softwareonly   |
   |                                       | argument with the /romonly     |
   |                                       | argument.                      |
   |---------------------------------------+--------------------------------|
   |                                       | If you run scripts that        |
   |                                       | contain this command, HP SUM   |
   |                                       | will execute this command the  |
   | /express_install                      | same way it runs /silent. HP   |
   |                                       | SUM shuts down ten seconds     |
   |                                       | after the script finishes      |
   |                                       | running.                       |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |       Overriding errors       |              Description               |
   |-------------------------------+----------------------------------------|
   |                               | Specifies that if a TPM is enabled,    |
   |                               | the warning message should be ignored  |
   | /tpmbypass or /ignore_tpm     | and component installation can         |
   |                               | continue. For more information about   |
   |                               | TPM, see the HP Smart Update Manager   |
   |                               | User Guide.                            |
   |-------------------------------+----------------------------------------|
   |                               | Allows the installation to proceed on  |
   |                               | a Linux of HP-UX node which is an      |
   |                               | active menber of a Serviceguard        |
   | /ignore_warnings              | cluster. If you do not specify this    |
   |                               | option and the node is an active       |
   |                               | member of a Serviceguard cluster, the  |
   |                               | node does not enter the installation   |
   |                               | or deploy phases.                      |
   |-------------------------------+----------------------------------------|
   |                               | Causes the installation to continue    |
   |                               | and ignore errors. Valid values are as |
   |                               | follows:                               |
   |                               |                                        |
   |                               | * <error>=ServerNotFound and           |
   |                               |                                        |
   |                               | * <error>=BadPassword.                 |
   | /continue_on_error <error>    |                                        |
   |                               | * <error>=FailedDependencies           |
   |                               |                                        |
   |                               | You can use the ServerNotFound option  |
   |                               | to bypass inactive or unavailable      |
   |                               | remote hosts when you are deploying    |
   |                               | firmware or software to multiple       |
   |                               | remote hosts at the same time.         |
   |-------------------------------+----------------------------------------|
   |                               | Defines the behavior when a remote     |
   |                               | node has an existing HP SUM session in |
   | /override_existing_connection | progress. It overrides the session in  |
   |                               | progress and re-initializes the        |
   |                               | installation framework on the remote   |
   |                               | host.                                  |
   |-------------------------------+----------------------------------------|
   |                               | Provides HP SUM <parameter> the        |
   |                               | information on how to proceed when a   |
   |                               | component has a failed dependency. The |
   |                               | supported parameters for this argument |
   |                               | are OmitHost (default), OmitComponent  |
   | /On_failed_dependency:        | , and Force. OmitHost causes the host  |
   | <parameter>                   | to be put into a failure state, and no |
   |                               | installation is attempted.             |
   |                               | OmitComponent deselects the affected   |
   |                               | components and proceeds with any       |
   |                               | updates that do not have dependency    |
   |                               | failures. Force attempts all updates,  |
   |                               | even if they have dependency failures. |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |     Reboot options      |                 Description                  |
   |-------------------------+----------------------------------------------|
   |                         | If the following conditions are met, this    |
   |                         | argument causes the server (or host server   |
   |                         | in a remote installation) to reboot:         |
   |                         |                                              |
   | /r[eboot]               |                                              |
   |                         |   o The /reboot option is selected or given  |
   |                         |     as a command-line argument.              |
   |                         |                                              |
   |                         |   o All components selected for installation |
   |                         |     are successfully installed.              |
   |                         |                                              |
   |                         |   o At least one of the installed components |
   |                         |     requires a reboot to complete its        |
   |                         |     installation.                            |
   |-------------------------+----------------------------------------------|
   |                         | Displays the specified reboot message on     |
   | /reboot_message "reboot | remote consoles connected to the server that |
   | message"                | you want to reboot. You must use this        |
   |                         | argument with the /reboot option, or the     |
   |                         | argument is ignored.                         |
   |-------------------------+----------------------------------------------|
   |                         | Delays the reboot of the server for the      |
   |                         | length of time that the timeout_in_seconds   |
   |                         | variable specifies. You must use this        |
   |                         | argument with the /reboot option, or the     |
   |                         | argument is ignored. Acceptable values are   |
   |                         | between 15 and 3600.                         |
   |                         |                                              |
   | /reboot_delay           | 					            |
   | timeout_in_secs         |  					    |
   |                         |   o The default timeout value is 15 seconds  |
   |                         |     for Microsoft Windows operating systems  |
   |                         |     and 60 seconds for Linux.                |
   |                         |                                              |
   |                         |   o For Linux, the reboot delay time is      |
   |                         |     converted from seconds to minutes, and   |
   |                         |     any value under a full minute (59        |
   |                         |     seconds or less) rounds to the next      |
   |                         |     minute.                                  |
   |-------------------------+----------------------------------------------|
   |                         |                                              |
   | /reboot_always          | If the following conditions are met, this    |
   |                         | argument forces the server to reboot:        |
   |                         |                                              |
   |                         |   o The /reboot_always option is selected or |
   |                         |     given as a command-line argument.        |
   |                         |                                              |
   |                         |   o All components selected for installation |
   |                         |     are successfully installed.              |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   | Simulating HP SUM |                    Description                     |
   |-------------------+----------------------------------------------------|
   | /dryrun           | This argument simulates the installation for a     |
   |                   | test run. Nothing is installed.                    |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |        Nodes         |                   Description                   |
   |----------------------+-------------------------------------------------|
   |                      | Use this argument to log in to the remote nodes |
   | /user<username> or   | by using the user ID.                           |
   | /username <username> |                                                 |
   |                      | The user name needs to belong to the root or    |
   |                      | administrator group.                            |
   |----------------------+-------------------------------------------------|
   | /password <password> | Use this argument to use this password for the  |
   |                      | user ID specified in the /user parameter        |
   | HP SUM also supports | (except for the OA node). The password is used  |
   | passwd and pwd       | to log in to remote nodes.                      |
   |----------------------+-------------------------------------------------|
   |                      | Use root (super user) username to start a       |
   |                      | session, and inventory and update components    |
   |                      | when the credentials specified in /username and |
   |                      | /passwd do not have root privileges to update   |
   |                      | components.                                     |
   |                      |                                                 |
   | /su_username         | /su_username cannot be used with /use_sudo      |
   |                      | access level.                                   |
   |                      |                                                 |
   |                      | [NOTE] :                                    |
   |                      |        Specifying /targettype linux reduces     |
   |                      |        inventory time for deployments. This is  |
   |                      |        an optional command line argument.       |
   |----------------------+-------------------------------------------------|
   |                      | Use root (super user) password to start a       |
   |                      | session, and inventory and update components    |
   |                      | when the credentials specified in /username and |
   |                      | /passwd do not have root privileges to update   |
   |                      | components.                                     |
   |                      |                                                 |
   | /su_password         | /su_password cannot be used with /use_sudo      |
   |                      | access level.                                   |
   |                      |                                                 |
   |                      | [NOTE] :                                    |
   |                      |        Specifying /targettype linux reduces     |
   |                      |        inventory time for deployments. This is  |
   |                      |        an optional command line argument.       |
   |----------------------+-------------------------------------------------|
   |                      | Specifies that username and passwd are sudo     |
   |                      | user credentials.                               |
   |                      |                                                 |
   |                      | When you specify /use_sudo in the CLI along     |
   |                      | with username and passwd, then username and     |
   |                      | passwd are considered as sudo credentials.      |
   | /use_sudo            |                                                 |
   |                      | /use_sudo cannot be used with /su_username and  |
   |                      | /su_password access level.                      |
   |                      |                                                 |
   |                      | [NOTE] :                                    |
   |                      |        Specifying /targettype linux reduces     |
   |                      |        inventory time for deployments. This is  |
   |                      |        an optional command line argument.       |
   |----------------------+-------------------------------------------------|
   |                      | This is the IP address or the DNS name of a     |
   |                      | remote host, which can be a remote server,      |
   |                      | remote iLO NIC port, Virtual Connect Ethernet   |
   |                      | or Fibre Channel Module for c-Class             |
   | /target "netAddress" | BladeSystem, or BladeSystem OA.                 |
   |                      |                                                 |
   |                      | When two OAs are in an enclosure, this argument |
   |                      | should be the active OA. When specifying the IP |
   |                      | address, use either the IPv4 or IPv6 format.    |
   |----------------------+-------------------------------------------------|
   |                      | Reduces inventory time for scripted             |
   |                      | deployments. This is an optional command line   |
   |                      | argument.                                       |
   |                      |                                                 |
   |                      | The following are valid node types:             |
   |                      |                                                 |
   |                      |   o Server                                      |
   |                      |                                                 |
   |                      |   o Windows                                     |
   |                      |                                                 |
   |                      |   o Linux                                       |
   |                      |                                                 |
   |                      |   o HPUX                                        |
   |                      |                                                 |
   |                      |   o EVA or Command View for EVA                 |
   |                      |                                                 |
   |                      |   o FC Switch or Fibre Channel Switch           |
   |                      |                                                 |
   |                      |   o OA or Onboard Administrator                 |
   | /targettype "type"   |                                                 |
   |                      |   o SUPERDOME 2 or SUPERDOME2 or Superdome 2    |
   |                      |     Onboard Administrator                       |
   |                      |                                                 |
   |                      |   o iLO                                         |
   |                      |                                                 |
   |                      |   o iLOFederation                               |
   |                      |                                                 |
   |                      |   o VC or Virtual Connect                       |
   |                      |                                                 |
   |                      |   o HP SAS or HP SAS B/L Interconnect Switch    |
   |                      |                                                 |
   |                      |   o VMware or VMware Host                       |
   |                      |                                                 |
   |                      |   o iPDU or Intelligent Power Distribution Unit |
   |                      |     (iPDU)                                      |
   |                      |                                                 |
   |                      |   o Moonshot                                    |
   |                      |                                                 |
   |                      | Use /targettype with /target parameter. You can |
   |                      | interchange the sequence of /targettype and     |
   |                      | /target. If the node name includes spaces, make |
   |                      | sure you enclose the name in quotation marks, " |
   |                      | ".                                              |
   |                      |                                                 |
   |                      | [NOTE] :                                    |
   |                      |        /targettype is an optional command line  |
   |                      |        argument. Use /targettype and /target    |
   |                      |        together.                                |
   |----------------------+-------------------------------------------------|
   |                      | Enables the credential of the local host to be  |
   |                      | used as the credential to access the nodes      |
   | /current_credential  | instead of providing the user name and password |
   |                      | explicitly for each node. The assumption is     |
   |                      | that the current credential is valid for the    |
   |                      | nodes being accessed. (Applies to Windows only) |
   |----------------------+-------------------------------------------------|
   |                      | This argument provides the user name credential |
   |                      | for OA associated with VC specified with the    |
   |                      | target command-line parameter. Only one set of  |
   |                      | OA credentials can be specified with            |
   |                      | command-line parameters. You can add multiple   |
   |                      | VC nodes to command-line parameters with the    |
   |                      | target parameter only if the credentials of OAs |
   | /oa_username         | associated with specified VCs are the same. You |
   |                      | do not need to provide an OA network address    |
   |                      | associated with VC. HP SUM queries it from a    |
   |                      | specified VC node.                              |
   |                      |                                                 |
   |                      | To update multiple VCs with different user      |
   |                      | names and passwords, or VCs with OAs that have  |
   |                      | different credentials, use the corresponding    |
   |                      | input files OAUID and OAPWD.                    |
   |----------------------+-------------------------------------------------|
   |                      | Provides the password credential for OA         |
   |                      | associated with VC specified with the "node"    |
   |                      | command-line parameter. Only one set of OA      |
   |                      | credentials can be specified with command-line  |
   |                      | parameters. You can add multiple VC nodes to    |
   |                      | command-line parameters with the "node"         |
   |                      | parameter only if the credentials of OAs        |
   | /oa_password         | associated with specified VCs are the same. You |
   |                      | do not need to provide an OA network address    |
   |                      | associated with VC. HP SUM queries it from a    |
   |                      | specified VC node.                              |
   |                      |                                                 |
   |                      | To update multiple VCs with different user      |
   |                      | names and passwords, or VCs with OAs that have  |
   |                      | different credentials, use the corresponding    |
   |                      | input files OAUID and OAPWD .                   |
   |----------------------+-------------------------------------------------|
   | /switch_username     | Use this command to specify Moonshot switch     |
   |                      | credentials.                                    |
   |----------------------+-------------------------------------------------|
   | /switch_password     | Use this command to specify Moonshot switch     |
   |                      | passwords.                                      |
   |----------------------+-------------------------------------------------|
   | /switch_enable       | Use this command to enable a Moonshot node.     |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |   Log files    |                      Description                      |
   |----------------+-------------------------------------------------------|
   |                | Redirects the output from HP SUM or the HP            |
   |                | BladeSystem c-Class OA flash utility to a different   |
   |                | directory than the default location.                  |
   |                |                                                       |
   | /logdir "path" | 							    |
   |                |         			                            |
   |                |   o For Windows components, the default location is   |
   |                |     %SYSTEMDRIVE%\CPQSYSTEM\hp\log<netAddress> and    |
   |                |     the redirected location is                        |
   |                |     <path>\hp\log\<netAddress>.                       |
   |                |                                                       |
   |                |   o For Linux components, the default location is     |
   |                |     /var/hp/log/<netAddress> and the redirected       |
   |                |     location is <path>/hp/log/<netAddress>.           |
   |----------------+-------------------------------------------------------|
   |                | Sets the verbosity level for the HP SUM execution log |
   | /v[erbose] or  | file, hpsum_execution_log_<date>_<time>.log. It       |
   | /veryv[erbose] | increases the level of detail that is retained in the |
   |                | log file. The default value is normal verbosity.      |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   | Generating reports |                    Description                    |
   |--------------------+---------------------------------------------------|
   |                    | Generates a report listing of the node summary    |
   |                    | and describes how the components in the           |
   |                    | repository affect the node; for example, whether  |
   |                    | each component applies to the node. The report is |
   |                    | generated in HTML and XML with file name formats  |
   |                    | of HPSUM_Report_<date>_<time>.html and            |
   | /report            | HPSUM_Report_<date>_<time>.xml.                   |
   |                    |                                                   |
   |                    | By default, the files are located in the present  |
   |                    | working directory where HP SUM is initiated. If   |
   |                    | that location is write-protected, you can find    |
   |                    | the files in the same directory as the HP SUM log |
   |                    | files.                                            |
   |--------------------+---------------------------------------------------|
   |                    | Generates a report listing of the components in   |
   |                    | the specified repository. The report is generated |
   |                    | in HTML and XML with file name formats of         |
   |                    | HPSUM_Inventory_Report_<date>_<time>.html and     |
   |                    | HPSUM_Inventory_Report_<date>_<time>.xml.         |
   | /inventory_report  |                                                   |
   |                    | By default, the report is located in the present  |
   |                    | working directory where HP SUM is initiated. If   |
   |                    | that location is write-protected, you can find    |
   |                    | the report in the same directory as the HP SUM    |
   |                    | log files.                                        |
   |--------------------+---------------------------------------------------|
   |                    | Generates a report listing of the firmware        |
   |                    | installed and details of the node. The report is  |
   |                    | generated in HTML and XML with file names of      |
   |                    | HPSUM_Firmware_Report.html and fwreport.xml in    |
   |                    | the directory named                               |
   | /firmware_report   | HPSUM_Firmware_Report_<date>_<time>.              |
   |                    |                                                   |
   |                    | By default, the report is located in the present  |
   |                    | working directory where HP SUM is initiated. If   |
   |                    | that location is write-protected, you can find    |
   |                    | the report in the same directory as the HP SUM    |
   |                    | log files.                                        |
   |--------------------+---------------------------------------------------|
   | /dependency_report | Generates a report listing of the failed          |
   |                    | dependencies for all nodes.                       |
   |--------------------+---------------------------------------------------|
   |                    | Generates a report that lists all installed       |
   | /installed_report  | firmware, software, and driver versions installed |
   |                    | on all nodes.                                     |
   |--------------------+---------------------------------------------------|
   | /combined_report   | This report generates all report types in one     |
   |                    | file.                                             |
   +------------------------------------------------------------------------+

   [NOTE] :                              
          HP SUM does not install any updates when you generate a report.

   HP SUM generates reports about the specified system or repository. HP SUM
   generates these reports by using the command-line arguments. If no
   additional arguments are specified on the command line, HP SUM uses the
   local host and default repository locations (the directory where HP SUM
   was initiated). You can specify a node if you provide the appropriate
   credentials. You can specific a repository by using other command-line
   parameters to generate reports. For specific commands, see "Command-line
   interface" (page ).

   HP SUM generates the reports as XML or HTML files that you can view in a
   JavaScript-enabled web browser. By default, the reports are located in the
   current working directory from where HP SUM was initiated. If that current
   location is write-protected, the reports are located in the same directory
   as the HP SUM log files.

   HP SUM generates reports in CSV format that you can open in any
   application that supports CSV format.

   The HP SUM log files are located in these folders:

   On Windows operating systems: C:\cpqsystem\hp\logOn Linux: /var/hp/log
     o On Windows operating systems: C:\cpqsystem\hp\log

     o On Linux: /var/hp/log

   When HP SUM generates the report, the HP SUM GUI does not appear. When the
   report is generated, HP SUM displays the report file location.

   +------------------------------------------------------------------------+
   |   Using input files   |                  Description                   |
   |-----------------------+------------------------------------------------|
   |                       | Enables you to script the deployment of        |
   | /inputfile "filename" | firmware and software to multiple remote       |
   |                       | systems at one time. For more information, see |
   |                       | the HP Smart Update Manager User Guide.        |
   |-----------------------+------------------------------------------------|
   | /deleteinputfile      | Enables you to instruct HP SUM to delete the   |
   |                       | input file after it has been read.             |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |  Superdome 2 server  |                   Description                   |
   |       commands       |                                                 |
   |----------------------+-------------------------------------------------|
   |                      | Determines which Superdome 2 firmware is        |
   |                      | updated. You can choose ALL, COMPLEX, or        |
   | /update_type <type>  | PARTITIONS. The default selection is ALL.       |
   |                      |                                                 |
   |                      | Example: /update_type PARTITIONS                |
   |----------------------+-------------------------------------------------|
   |                      | Use this argument when the /update_type         |
   |                      | argument is PARTITIONS. This argument specifies |
   |                      | the subset of partitions or unassigned blades   |
   |                      | to update when you do not want to update all    |
   | /device_list         | partitions or unassigned blades. Valid devices  |
   | <device[,device]...> | are: npar(number) and blade(enc)/(bay). Do not  |
   |                      | put any spaces between the parameters.          |
   |                      |                                                 |
   |                      | Example: /device_list                           |
   |                      | npar1,npar2,blade1/1,blade1/2                   |
   |----------------------+-------------------------------------------------|
   |                      | Use this argument when the /update_type is ALL  |
   |                      | or PARTITIONS. This argument specifies specific |
   |                      | partitions to reboot after the partition        |
   | /reboot_list         | firmware has been updated. Valid npar values    |
   | <npar[,npar]...>     | are npar(number). Do not put any spaces between |
   |                      | parameters.                                     |
   |                      |                                                 |
   |                      | Example: /reboot_list npar1,npar2               |
   +------------------------------------------------------------------------+

  1.1.3 Command-line examples

   Example 1:

   This command-line input deploys the latest SPP and firmware components:

   hpsum /use_latest /allow_non_bundle_components /silent

   Results: All software components and firmware components from the update
   bundle in the current directory, which HP SUM determined must be
   installed, were installed.

   Example 2:

   The following command-line inputs can deploy the previous version of the
   SPP only and force all the components to be installed:

   o hpsum /f:bundle /softwareonly /use_location c:\downloads\previousSPP
       /s

   Results: All software components from the update bundle, which HP SUM
   determined must be installed, were installed. No firmware was installed.

   Example 3:

   This command-line input deploys firmware only, from the bundle found in
   the current directory where HP SUM is located:

   hpsum /romonly /s

   Results: All firmware components that must be installed, were installed.
   No software was installed.

   Example 4:

   Either of the following command-line inputs can deploy two software
   components:

     o hpsum /f:software cp008097.exe cp008257.exe /s

     o hpsum /c cp008097.exe /c cp008257.exe /f:software /s

   Results: The two components were installed. No firmware or other software
   was installed.

   Example 5:

   Either of the following command-line inputs can deploy the latest SPP in
   the directory with HP SUM, later versions of components in the bundle, and
   firmware to three remote hosts and force all components to be installed:

     o hpsum /group "Management Servers" /current_credential /use_latest
       /allow_update_to_bundle /allow_non_bundle_components /force:all
       /override_existing_connection /continue_on_error ServerNotFound
       /silent /logdir "Management_Server_Files"

     o hpsum /target server1.mydomain.com /target server2.mydomain.com
       /target 10.15.25.101 /user administrator /passwd letmein /use_latest
       /allow_update_to_bundle /allow_non_bundle_components /force:all
       /override_existing_connection /continue_on_error ServerNotFound
       /silent /logdir c:\documents\management_server_files

   Results: All software components and firmware components from the update
   bundle were installed on the three target nodes.

   Example 6:

   To use sudo to update components:

   /hpsum / target 10.0.1.7 /targetype linux /username userid /passwd
   password /use_sudo /silent

   To use super user to update components:

   /hpsum /target 10.0.1.7 /targetype linux /username userid /passwd password
   /silent /su_username root /su_password rootpwd

   Results: All components were installed on server 10.0.1.7.

  1.1.4 Return codes

   HP SUM has consolidated return codes from Linux and Windows smart
   components into an, enhanced return-code mapping. These return codes
   determine the status of the component installation. You can also use
   return codes in a script to control the execution of the script and
   determine any required branching.

   In Linux, the negative return codes are reported. These return codes are
   determined by subtracting the negative value from 256.

   +------------------------------------------------------------------------+
   |       Return code        | Value | Linux | Windows |       Text        |
   |--------------------------+-------+-------+---------+-------------------|
   | SUCCESS_NO_REBOOT        | 0     | 0     | 0       | The installation  |
   |                          |       |       |         | was successful.   |
   |--------------------------+-------+-------+---------+-------------------|
   |                          |       |       |         | The installation  |
   | SUCCESS_REBOOT           | 1     | 1     | 1       | was successful,   |
   |                          |       |       |         | but a reboot is   |
   |                          |       |       |         | required.         |
   |--------------------------+-------+-------+---------+-------------------|
   |                          |       |       |         | The component was |
   | SUCCESS_NOT_REQUIRED     | 3     | 3     | 3       | current or not    |
   |                          |       |       |         | required.         |
   |--------------------------+-------+-------+---------+-------------------|
   |                          |       |       |         | A general failure |
   | FAILURE_GENERAL          | -1    | 255   | -1      | occurred. For     |
   |                          |       |       |         | details, see the  |
   |                          |       |       |         | error log.        |
   |--------------------------+-------+-------+---------+-------------------|
   |                          |       |       |         | A bad input       |
   | FAILURE_BAD_PARM         | -2    | 254   | -2      | parameter was     |
   |                          |       |       |         | encountered.      |
   |--------------------------+-------+-------+---------+-------------------|
   |                          |       |       |         | The installation  |
   | FAILURE_COMPONENT_FAILED | -3    | 253   | -3      | of the component  |
   |                          |       |       |         | failed.           |
   +------------------------------------------------------------------------+

  1.1.5 Windows smart-component return codes

   +------------------------------------------------------------------------+
   | Return code |                         Meaning                          |
   |-------------+----------------------------------------------------------|
   | 0           | The smart component was not installed. For more          |
   |             | information, see the log file.                           |
   |-------------+----------------------------------------------------------|
   | 1           | The smart component was installed successfully.          |
   |-------------+----------------------------------------------------------|
   | 2           | The smart component was installed successfully, but the  |
   |             | system must be restarted.                                |
   |-------------+----------------------------------------------------------|
   |             | The installation was not attempted because the required  |
   | 3           | hardware is not present, the software is current, or     |
   |             | there is nothing to install.                             |
   +------------------------------------------------------------------------+

  1.1.6 Linux smart-component return codes

   Single-node servers:

   +------------------------------------------------------------------------+
   | Return code |                         Meaning                          |
   |-------------+----------------------------------------------------------|
   | 0           | The smart component was installed successfully.          |
   |-------------+----------------------------------------------------------|
   | 1           | The smart component was installed successfully, but the  |
   |             | system must be restarted.                                |
   |-------------+----------------------------------------------------------|
   |             | The installation was not attempted because the required  |
   | 2           | hardware is not present, the software is current, or     |
   |             | there is nothing to install.                             |
   |-------------+----------------------------------------------------------|
   | 3           | The smart component was not installed. For more          |
   |             | information, see the log file.                           |
   +------------------------------------------------------------------------+

   Multi-node servers:

   +------------------------------------------------------------------------+
   | Return code |                         Meaning                          |
   |-------------+----------------------------------------------------------|
   | 0           | The installation of the deliverable was successful. No   |
   |             | reboot is required.                                      |
   |-------------+----------------------------------------------------------|
   | 1           | The installation of the deliverable was successful.      |
   |             | Reboot is required for the deliverable to be enabled.    |
   |-------------+----------------------------------------------------------|
   | 2           | The installation was not attempted because the version   |
   |             | to be installed matches the version already installed.   |
   |-------------+----------------------------------------------------------|
   |             | The installation was not attempted because of one of the |
   |             | following:                                               |
   |             |                                                          |
   |             | 	                                                    |
   | 3           |   o The version to be installed is older than the        |
   |             |     version already installed.                           |
   |             |                                                          |
   |             |   o The supported hardware is not present, not enabled,  |
   |             |     or in a state that an installation could not be      |
   |             |     attempted.                                           |
   |             |                                                          |
   |             |   o The smart component does not support the             |
   |             |     environment.                                         |
   |             |                                                          |
   |             |   o There is nothing for the component to accomplish.    |
   |-------------+----------------------------------------------------------|
   |             | If the component is being installed to a remote node,    |
   | 4           | such as an OA or other network-based deployment, this    |
   |             | return code indicates that the node cannot be found.     |
   |-------------+----------------------------------------------------------|
   | 5           | A user canceled the installation before anything could   |
   |             | be installed.                                            |
   |-------------+----------------------------------------------------------|
   | 6           | The installer cannot run because of an un-met dependency |
   |             | or installation tool failure.                            |
   |-------------+----------------------------------------------------------|
   | 7           | The actual installation operation (not the installation  |
   |             | tool) failed.                                            |
   +------------------------------------------------------------------------+

  1.1.7 Linux RPM return codes

   +----------------------------------------------------------+
   | Return code |                  Meaning                   |
   |-------------+--------------------------------------------|
   | 0           | The Linux RPM installation was successful. |
   |-------------+--------------------------------------------|
   | 1           | The Linux RPM installation failed.         |
   +----------------------------------------------------------+

  1.1.8 VMware ESXi smart-component return codes

   +------------------------------------------------------------------------+
   | Return code |                         Meaning                          |
   |-------------+----------------------------------------------------------|
   | 0           | The installation of the deliverable was successful. No   |
   |             | reboot is required.                                      |
   |-------------+----------------------------------------------------------|
   | 1           | The installation of the deliverable was successful.      |
   |             | Reboot is required for the deliverable to be enabled.    |
   |-------------+----------------------------------------------------------|
   | 2           | The installation was not attempted because the version   |
   |             | to be installed matches the version already installed.   |
   |-------------+----------------------------------------------------------|
   |             | The installation was not attempted because of one of the |
   |             | following:                                               |
   |             |                                                          |
   | 3           |   o The version to be installed is older than the        |
   |             |     version already installed.                           |
   |             |                                                          |
   |             |   o The supported hardware is not present, not enabled,  |
   |             |     or in a state that an installation could not be      |
   |             |     attempted.                                           |
   |             |                                                          |
   |             |   o The smart component does not support the             |
   |             |     environment.                                         |
   |             |                                                          |
   |             |   o There is nothing for the component to accomplish.    |
   |-------------+----------------------------------------------------------|
   |             | If the component is being installed to a remote node,    |
   | 4           | such as an OA or other network-based deployment, this    |
   |             | return code indicates that the node cannot be found.     |
   |-------------+----------------------------------------------------------|
   | 5           | A user canceled the installation before anything could   |
   |             | be installed.                                            |
   |-------------+----------------------------------------------------------|
   | 6           | The installer cannot run because of an un-met dependency |
   |             | or installation tool failure.                            |
   |-------------+----------------------------------------------------------|
   | 7           | The actual installation operation (not the installation  |
   |             | tool) failed.                                            |
   +------------------------------------------------------------------------+

1.2 Input files

   HP SUM provides the ability to script the update of multiple, individual
   nodes or groups of nodes (HP ProLiant and Integrity servers and options)
   within a single operation through the input file functionality. To protect
   your credentials, use a secure server or a management console.

   To create an input file, use a text editor. All section headers and
   trailers must match. You can use the DRYRUN=YES option to perform dry runs
   of installations to ensure the scripts are working without deploying the
   firmware updates that might be required on each node. Remove the
   DRYRUN=YES option to perform the updates.

   For parameters that can take list values, list separators can be commas,
   semicolons, or spaces.

   [NOTE] :                                 
          The credentials can be omitted from the file for greater security
          and passed on the command line to HP SUM. The only limitation that
          the user ID and credentials must be the same on all nodes.

   When the file has been created, to use it with HP SUM, add it as the
   inputfile <filename> parameter to a HP SUM command line. For example, if
   the name of the input file is hpsum.in, the command-line syntax is hpsum
   -inputfile hpsum.in. Full paths can be added to the input file location if
   the file is not stored in the same location as the HP SUM executable
   files. The <filename> field can be enclosed in double quotes to enable
   paths with spaces. Also, the input file itself might contain the same
   options on the command line. The usual command-line options can still be
   used with the -inputfile option and they take precedence over any given
   input file.

  1.2.1 Input file format and rules

   The input file is divided into multiple sections:

     o Configuration

       The configuration section starts from the beginning of the file and
       proceeds until the first node section is encountered. This section
       consists of a number of settings and their values. Each configuration
       setting must appear on a fresh line in the file, along with its value.
       Comments start with a pound (#) character at the beginning of the
       line. Only one pound character is allowed on any line.

     o Target

       You can provide remote hosts to HP SUM. This section can repeat any
       number of times in the input file, providing a way to organize nodes
       in related sets.

       The section starts with the following special header enclosed in
       brackets:

       [TARGETS]

       The section ends with the following special string enclosed brackets:

       [END]

       The keyword TARGETS can be suffixed with an optional arbitrary string.
       This string enables you to tag the purpose of the TARGETS section.
       Other than the visible difference in the header, the contents of such
       a section are not treated any differently. For example:

       [TARGETS_WIN2003]

       ...

       [END]

       Credentials: The TARGETS section allows the nodes to be grouped
       according to the credentials needed for logging in remotely. Each
       TARGETS section must have a set of login credentials, which applies to
       all nodes in that section. If you want to use the current host's login
       credentials to log in to one or more remote nodes, you can do so by
       setting the variable USECURRENTCREDENTIAL to YES. You can supply login
       credentials for one or more hosts by using the variables UID and PWD.
       If you want to provide the variables at the beginning of a TARGETS
       section, use both of them. If you want to provide the variables in the
       middle of a TARGETS section, use one or the other to override the
       selected variable and continue using the active value for the
       remaining variable.Remote node: You can specify a remote node by using
       the variable HOST. Possible values are a DNS name or an IP address.
          o Credentials: The TARGETS section allows the nodes to be grouped
            according to the credentials needed for logging in remotely. Each
            TARGETS section must have a set of login credentials, which
            applies to all nodes in that section. If you want to use the
            current host's login credentials to log in to one or more remote
            nodes, you can do so by setting the variable USECURRENTCREDENTIAL
            to YES. You can supply login credentials for one or more hosts by
            using the variables UID and PWD. If you want to provide the
            variables at the beginning of a TARGETS section, use both of
            them. If you want to provide the variables in the middle of a
            TARGETS section, use one or the other to override the selected
            variable and continue using the active value for the remaining
            variable.

          o Remote node: You can specify a remote node by using the variable
            HOST. Possible values are a DNS name or an IP address.

     o Component-specific configuration

       You can specify component-specific configuration settings by using the
       component short names as shown in the table below. Use the component
       short name instead of the component file name changes in different SPP
       releases.

+----------------------------------------------------------------------------------------------------+
|Component                                    |Package name    |Component short name                 |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP System       |                                     |
|cp021995.exe                                 |Management      |hpsmh-windows-x86                    |
|                                             |Homepage for    |                                     |
|                                             |Windows x86     |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP System       |                                     |
|cp021996.exe                                 |Management      |hpsmh-windows-x64                    |
|                                             |Homepage for    |                                     |
|                                             |Windows x64     |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP Insight      |                                     |
|cp022423.exe                                 |Management WBEM |hpinsightmgmtwbemprovider-windows-x86|
|                                             |Providers for   |                                     |
|                                             |Windows Server  |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP Insight      |                                     |
|                                             |Management WBEM |                                     |
|cp022424.exe                                 |Providers for   |hpinsightmgmtwbemprovider-windows-x64|
|                                             |Windows Server  |                                     |
|                                             |x64 Editions    |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP Insight      |                                     |
|cp022558.exe                                 |Management      |hpinsightmgmtagent-windows-x86       |
|                                             |Agents for      |                                     |
|                                             |Windows Server  |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP Insight      |                                     |
|                                             |Management      |                                     |
|cp022559.exe                                 |Agents for      |hpinsightmgmtagent-windows-x64       |
|                                             |Windows Server  |                                     |
|                                             |x64 Editions    |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP iLO          |                                     |
|hpmouse-1.2.1-1.noarch.rpm                   |High-Performance|hpmouse-linux                        |
|                                             |Mouse for Linux |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP System       |                                     |
|hpsmh-7.3.1-4.i386.rpm                       |Management      |hpsmh-linux-x86                      |
|                                             |Homepage for    |                                     |
|                                             |Linux (x86)     |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP System       |                                     |
|                                             |Management      |                                     |
|hpsmh-7.3.1-4.x86_64.rpm                     |Homepage for    |hpsmh-linux-x64                      |
|                                             |Linux           |                                     |
|                                             |(AMD64/EM64T)   |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP SNMP Agents  |                                     |
|hp-snmp-agents-10.00-2577.2.rhel6.i686.rpm   |for Red Hat     |hpsnmpagent-rhel6-x86                |
|                                             |Enterprise Linux|                                     |
|                                             |6 (x86)         |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP SNMP Agents  |                                     |
|hp-snmp-agents-10.00-2577.2.rhel6.x86_64.rpm |for Red Hat     |hpsnmpagent-rhel6-x64                |
|                                             |Enterprise Linux|                                     |
|                                             |6 (AMD64/EM64T) |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP SNMP Agents  |                                     |
|hp-snmp-agents-10.00-2577.3.sles11.i586.rpm  |for SUSE LINUX  |hpsnmpagent-sles11-x86               |
|                                             |Enterprise      |                                     |
|                                             |Server 11 (x86) |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP SNMP Agents  |                                     |
|                                             |for SUSE LINUX  |                                     |
|hp-snmp-agents-10.00-2577.3.sles11.x86_64.rpm|Enterprise      |hpsnmpagent-sles11-x64               |
|                                             |Server 11       |                                     |
|                                             |(AMD64/EM64T)   |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP SNMP Agents  |                                     |
|hp-snmp-agents-9.60-2573.11.rhel5.i386.rpm   |for Red Hat     |hpsnmpagent-rhel5-x86                |
|                                             |Enterprise Linux|                                     |
|                                             |5 (x86)         |                                     |
|---------------------------------------------+----------------+-------------------------------------|
|                                             |HP SNMP Agents  |                                     |
|hp-snmp-agents-9.60-2573.11.rhel5.x86_64.rpm |for Red Hat     |hpsnmpagent-rhel5-x64                |
|                                             |Enterprise Linux|                                     |
|                                             |5 (AMD64/EM64T) |                                     |
+----------------------------------------------------------------------------------------------------+

       The following is the syntax to use when you configure components with
       an inputfile:

       [COMPONENT_CONFIG=<component short name>]

       [<PARAM_NAME1>]

       Value1-line1

       Value1-line2

       [<PARAM_NAME1>]

       Value1-line1

       Value1-line2

       [END_COMPONENT_CONFIG]

       The following is an example of how to configure component
       cp021995.exe, HP System Management Homepage for Windows x86.

       SOURCEPATH = E:\HPSUM\Enhancement\Component Configuration\RPM

       [COMPONENT_CONFIG=hpsmh-windows-x86]

       [<force-overwrite>]

       YES

       [<admin-group>]

       ADMINGRP1 ADMINGRP2

       [<CERTNAME_2>]

       PRAMS2

       [<CERTVALUE_2>]

       -----BEGIN PGP PUBLIC KEY BLOCK-----

       Version: GnuPG v1.4.9 (Darwin)

       mQENBErJM6oBCAC7NG5NZ5kiJg+KTTaIDjX9BU8bc7FI5a2zCYc3p9eikJfyyZYM

       lflfhsl20242309482048039482080(*)(*)(*)(*)(*)(

       sWbckvcIjJRcAtRliKbAf+KjplbcEIzt+kxmweE5XeKvDFtzAD041FGAphIkKcuu

       IAzL+XcMWzc3DA==

       =+ojz

       -----END PGP PUBLIC KEY BLOCK-----

       [<OPERATOR-GROUP>]

       OPTGRP1 OPTGRP2

       [<ANONYMOUS-ACCESS>]

       YES

       [END_COMPONENT_CONFIG]

       [TARGETS]

       HOST = LocalHost

       UID = hpsumadmin

       PWD = ********

       [END]

  1.2.2 File encoding

   To allow for the inclusion of double-byte characters, the input file is in
   UTF-8 format.

  1.2.3 Error reporting

   If errors occur in the input file, HP SUM exits with a return value of -2
   (bad parameter). The details of the location and nature of the error are
   recorded in hpsum_execution_log_<date>_<time>.raw.

  1.2.4 Input file parameters

   +------------------------------------------------------------------------+
   |        Parameter        |                 Description                  |
   |-------------------------+----------------------------------------------|
   |                         | This parameter causes the installation to    |
   |                         | run silently without GUI or interactive CLI  |
   |                         | output. All data is written to the log file. |
   |                         | Any generated prompts use the default option |
   |                         | and continue the installation without user   |
   |                         | input.                                       |
   |                         |                                              |
   |                         | If a component requires input before         |
   | SILENT                  | installation (such as configuration          |
   |                         | information), the component installation     |
   |                         | fails (unless the IGNOREERRORS =             |
   |                         | "FailedDependencies" parameter is supplied), |
   |                         | and an error message is written to the log   |
   |                         | file.                                        |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | This parameter specifies the node type and   |
   |                         | can shorten the inventory process.           |
   |                         |                                              |
   |                         | /targettype Windows                          |
   |                         |                                              |
   |                         | The following are valid node types:          |
   |                         |                                              |
   |                         |   o Windows                                  |
   |                         |                                              |
   |                         |   o Linux                                    |
   |                         |                                              |
   |                         |   o HPUX                                     |
   |                         |                                              |
   |                         |   o FC Switch or Fibre Channel Switch        |
   | TARGETTYPE              |                                              |
   |                         |   o OA or Onboard Administrator              |
   |                         |                                              |
   |                         |   o SUPERDOME 2 or SUPERDOME2 or Superdome 2 |
   |                         |     Onboard Administrator                    |
   |                         |                                              |
   |                         |   o iLO                                      |
   |                         |                                              |
   |                         |   o VC or Virtual Connect                    |
   |                         |                                              |
   |                         |   o HP SAS or HP SAS B/L Interconnect Switch |
   |                         |                                              |
   |                         |   o VMware or VMware Host                    |
   |                         |                                              |
   |                         |   o iPDU or Intelligent Power Distribution   |
   |                         |     Unit (iPDU)                              |
   |                         |                                              |
   |                         |   o Moonshot                                 |
   |                         |                                              |
   |                         | If you use the command with a group, the HP  |
   |                         | SUM assumes all nodes in the group are the   |
   |                         | same node type.                              |
   |-------------------------+----------------------------------------------|
   |                         | Forces updates to both firmware and software |
   |                         | components.                                  |
   | FORCEALL                |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Forces updates to firmware components.       |
   |                         |                                              |
   | FORCEROM                | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Forces updates to software components.       |
   |                         |                                              |
   | FORCESOFTWARE           | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Enables you to override or downgrade an      |
   |                         | existing installation of components in the   |
   |                         | selected bundle.                             |
   | FORCEBUNDLE             |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, Default = NO                            |
   |-------------------------+----------------------------------------------|
   |                         | Downgrade to an earlier version of           |
   |                         | components.                                  |
   | DOWNGRADE               |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Rewrite the same version of components.      |
   |                         |                                              |
   | REWRITE                 | Possible values:                             |
   |                         |                                              |
   |                         | YES, Default = NO                            |
   |-------------------------+----------------------------------------------|
   |                         | Enables you to reboot, if required.          |
   |                         |                                              |
   | REBOOTALLOWED           | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Create a message to be displayed prior to    |
   |                         | rebooting.                                   |
   | REBOOTMESSAGE           |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Any string (not exceeding 256 characters)    |
   |-------------------------+----------------------------------------------|
   |                         | Delay before rebooting.                      |
   |                         |                                              |
   | REBOOTDELAY             | Possible values                              |
   |                         |                                              |
   |                         | Time in seconds                              |
   |-------------------------+----------------------------------------------|
   |                         | Limit the list of components to be updated.  |
   |                         |                                              |
   | COMPONENTSLIST          | Possible values:                             |
   |                         |                                              |
   |                         | Component names with file extensions (.exe,  |
   |                         | .rpm, or .scexe)                             |
   |-------------------------+----------------------------------------------|
   |                         | Limit the list of bundle xml files to be     |
   |                         | filtered.                                    |
   | BUNDLESLIST             |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Bundle file names                            |
   |-------------------------+----------------------------------------------|
   |                         | This is a filter switch and enables you to   |
   |                         | install newer versions of components defined |
   |                         | in a PSP, ISP, or bundle.                    |
   |                         |                                              |
   |                         | This parameter enables these components to   |
   | ALLOWUPDATEBUNDLE       | replace the older versions of the same       |
   |                         | component that might have shipped with the   |
   |                         | bundles.                                     |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Defines the behavior when a remote node has  |
   |                         | an existing HP SUM session in progress.      |
   |                         |                                              |
   |                         | Use this parameter to skip the host if an    |
   |                         | existing HP SUM session already exists. A    |
   |                         | value of NO overrides the session in         |
   |                         | progress and reinitializes the installation  |
   |                         | framework on the remote host.                |
   |                         |                                              |
   | SKIPTARGET              | [NOTE] :                                 |
   |                         |        If an HP SUM session discovers a      |
   |                         |        remote node is running HP SUM         |
   |                         |        locally, HP SUM ignores the           |
   |                         |        SKIPTARGET command and skips the      |
   |                         |        remote node.                          |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Causes the installation to continue and      |
   |                         | ignore errors.                               |
   |                         |                                              |
   |                         | The ServerNotFound option can be used to     |
   |                         | bypass inactive or unavailable remote hosts  |
   |                         | when deploying firmware or software to       |
   |                         | multiple remote hosts at the same time.      |
   | IGNOREERRORS            |                                              |
   |                         | Use FailedDependencies to ignore any failed  |
   |                         | dependencies and proceed with the ones that  |
   |                         | are ready to be installed.                   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | ServerNotFound, BadPassword,                 |
   |                         | FailedDependencies                           |
   |-------------------------+----------------------------------------------|
   |                         | Provide a single local baseline path or a    |
   |                         | UNC file share. This action creates an       |
   |                         | inventory from the given path instead of the |
   | SOURCEPATH              | local or default baseline.                   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Directory path, UNC location                 |
   |-------------------------+----------------------------------------------|
   |                         | Provides the user name credentials for the   |
   |                         | UNC location provided in the SOURCEPATH.     |
   | UNC_USERNAME            |                                              |
   |                         | Possible Values:                             |
   |                         |                                              |
   |                         | <username>                                   |
   |-------------------------+----------------------------------------------|
   |                         | Provides the password to access the UNC      |
   |                         | location.                                    |
   | UNC_PASSWORD            |                                              |
   |                         | Possible Values:                             |
   |                         |                                              |
   |                         | <password>                                   |
   |-------------------------+----------------------------------------------|
   |                         | Provides the username to access the Moonshot |
   |                         | switch.                                      |
   | SWITCH_USERNAME         |                                              |
   |                         | Possible Values:                             |
   |                         |                                              |
   |                         | <username>                                   |
   |-------------------------+----------------------------------------------|
   |                         | Provides the password to access the Moonshot |
   |                         | switch.                                      |
   | SWITCH_PASSWORD         |                                              |
   |                         | Possible Values:                             |
   |                         |                                              |
   |                         | <password>                                   |
   |-------------------------+----------------------------------------------|
   |                         | Provides the access to the Moonshot switch.  |
   |                         |                                              |
   | SWITCH_ENABLE           | Possible Values:                             |
   |                         |                                              |
   |                         | <enable>                                     |
   |-------------------------+----------------------------------------------|
   |                         | Provides the username to access the B        |
   |                         | Moonshot switch.                             |
   | SWITCHB_USERNAME        |                                              |
   |                         | Possible Values:                             |
   |                         |                                              |
   |                         | <username>                                   |
   |-------------------------+----------------------------------------------|
   |                         | Provides the password to access the B        |
   |                         | Moonshot switch.                             |
   | SWITCHB_PASSWORD        |                                              |
   |                         | Possible Values:                             |
   |                         |                                              |
   |                         | <password>                                   |
   |-------------------------+----------------------------------------------|
   |                         | This is a filter switch for use with         |
   |                         | bundles. The parameter enables you to use    |
   |                         | the latest version of the bundle when        |
   |                         | multiple versions of bundles are listed on   |
   |                         | the command line.                            |
   |                         |                                              |
   |                         | If no bundles are specified on the command   |
   | USELATEST               | line, and multiple bundles are in the        |
   |                         | directory, this parameter enables HP SUM to  |
   |                         | use the bundle that has the latest version   |
   |                         | for installation.                            |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Simulates the installation for a test run.   |
   |                         | Nothing is installed.                        |
   | DRYRUN                  |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Specify the HP SUM CLI options inside the    |
   |                         | input file, which overrides the              |
   |                         | configuration settings. Parameters can be    |
   |                         | separated by a semi-colon, comma, or a       |
   |                         | space.                                       |
   |                         |                                              |
   | OPTIONS                 | This parameter replaces the LSPOPTIONS       |
   |                         | parameter that was previously supported with |
   |                         | LDU.                                         |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | One or more CLI switch                       |
   |-------------------------+----------------------------------------------|
   |                         | Specifies that components that use AMS and   |
   |                         | WBEM Providers listed as optional updates on |
   |                         | the Components Selection screen.             |
   |                         |                                              |
   |                         | In silent mode, HP SUM does not update AMS   |
   |                         | or WBEM Providers.                           |
   | NOMGMT                  |                                              |
   |                         | [NOTE] :                                 |
   |                         |        You can only configure SNMP in HP SUM |
   |                         |        GUI mode.                             |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Specifies that components that use WMI       |
   |                         | protocol are available to be selected for    |
   |                         | installation.                                |
   |                         |                                              |
   |                         | These components are optional by default and |
   |                         | are not installed unless this parameter is   |
   | USEWMI                  | used. When the /usewmi parameter is used.    |
   |                         | This parameter does not apply to HP          |
   |                         | Integrity servers.                           |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Specifies that AMS agentless management      |
   |                         | service components are available to be       |
   |                         | selected for installation.                   |
   |                         |                                              |
   |                         | This option will only apply to Gen8 and      |
   |                         | later servers. If this parameter is set for  |
   |                         | a ProLiant G7 and earlier server model, it   |
   |                         | will be ignored.                             |
   | USEAMS                  |                                              |
   |                         | These components are only installed by       |
   |                         | default on Gen8 and later servers. This      |
   |                         | parameter does not apply to HP Integrity     |
   |                         | servers.                                     |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | This is a filter switch that allows you to   |
   |                         | view only the firmware components required   |
   |                         | for installation.                            |
   |                         |                                              |
   | ROMONLY                 | Do not use the /romonly parameter with the   |
   |                         | /softwareonly parameter.                     |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | This is a filter switch that allows you to   |
   |                         | view only the software components required   |
   |                         | for installation.                            |
   |                         |                                              |
   | SOFTWAREONLY            | Do not use the /softwareonly parameter with  |
   |                         | the /romonly parameter.                      |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Enables the credentials of the local host to |
   |                         | be used as the credentials to access the     |
   |                         | nodes instead of providing the user name and |
   |                         | password explicitly for each node.           |
   |                         |                                              |
   | USECURRENTCREDENTIAL    | The assumption is that the current           |
   |                         | credentials are valid for the nodes that are |
   |                         | being accessed. (Applies to Windows only.)   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |-------------------------+----------------------------------------------|
   |                         | Instructs HP SUM to delete the input file    |
   |                         | after it has been read.                      |
   | DELETEINPUTFILE         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO (default)                            |
   |-------------------------+----------------------------------------------|
   |                         | This parameter instructs HP SUM how to       |
   |                         | proceed when a component has a failed        |
   |                         | dependency.                                  |
   |                         |                                              |
   |                         | The default of OmitHost causes the host to   |
   |                         | be put in a failure state, and no            |
   |                         | installation is attempted on it.             |
   |                         |                                              |
   | ONFAILEDDEPENDENCY      | OmitComponent clears the affected components |
   |                         | and proceeds with any updates that do not    |
   |                         | have dependency failures. Force attempts all |
   |                         | updates, even if they have dependency        |
   |                         | failures.                                    |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | OmitHost (default), OmitComponent, Force     |
   |-------------------------+----------------------------------------------|
   |                         | This parameter is the IP address or the DNS  |
   |                         | name of a remote server, remote iLO NIC      |
   |                         | port, Virtual Connect Ethernet or Fibre      |
   |                         | Channel Module for c-Class BladeSystem, or   |
   |                         | BladeSystem OA.                              |
   |                         |                                              |
   |                         | When two OAs are in an enclosure, this       |
   |                         | parameter is the active OA. When specifying  |
   | HOST                    | the IP address, you can use either the IPv4  |
   |                         | or IPv6 format.                              |
   |                         |                                              |
   |                         | This parameter specifies an already defined  |
   |                         | group name in the HP SUM GUI.                |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | IP address, DNS name                         |
   |-------------------------+----------------------------------------------|
   |                         | Logs in to the nodes with your user ID.      |
   |                         |                                              |
   | UID                     | Possible values:                             |
   |                         |                                              |
   |                         | <username>                                   |
   |-------------------------+----------------------------------------------|
   |                         | Uses the password for the user ID specified  |
   |                         | in the UID.                                  |
   |                         |                                              |
   | PWD                     | The password is used to log in to nodes.     |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | <password>                                   |
   |-------------------------+----------------------------------------------|
   |                         | Redirects the output from HP SUM or the HP   |
   |                         | BladeSystem c-Class OA flash utility to a    |
   |                         | different directory than the default         |
   |                         | location.                                    |
   |                         |                                              |
   |                         | * For Windows components, the default        |
   |                         | location is                                  |
   |                         | %SYSTEMDRIVE%\CPQSYSTEM\hp\log<netAddress>   |
   |                         | and the redirected location is               |
   | LOGFILENAME = "path"    | <path>\hp\log\<netAddress>.                  |
   |                         |                                              |
   |                         | * For Linux components, the default location |
   |                         | is /var/hp/log/<netAddress> and the          |
   |                         | redirected location is                       |
   |                         | <path>/hp/log/<netAddress>.                  |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Log file name                                |
   |-------------------------+----------------------------------------------|
   |                         | Specifies the IP address or DNS host name of |
   |                         | a system with read/write access to serve as  |
   |                         | a management station. You can specify        |
   |                         | multiple locations separated by a space.     |
   | CMAMGMTSTATIONRWIPORDNS | (Applies to Linux SPP only.)                 |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | IP address, DNS name                         |
   |-------------------------+----------------------------------------------|
   |                         | Specifies the IP address or DNS host name of |
   |                         | a system with read-only access to serve as a |
   |                         | management station. You can specify multiple |
   |                         | locations separated by a space. (Applies to  |
   | CMAMGMTSTATIONROIPORDNS | Linux SPP only.)                             |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | IP address, DNS name                         |
   |-------------------------+----------------------------------------------|
   |                         | Specifies a person or phone number for       |
   |                         | administration of this system. (Applies to   |
   |                         | Linux SPP only.)                             |
   | CMASYSCONTACT           |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | String value                                 |
   |-------------------------+----------------------------------------------|
   |                         | Designates the location of this system.      |
   |                         | (Applies to Linux SPP only.)                 |
   | CMASYSLOCATION          |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | String value                                 |
   |-------------------------+----------------------------------------------|
   |                         | Determines whether the HP Systems Insight    |
   |                         | Manager Web Agent is started when the health |
   |                         | application loads. (Applies to Linux SPP     |
   |                         | only.)                                       |
   |                         |                                              |
   | CMASTARTWEBAGENT        | Possible values:                             |
   |                         |                                              |
   |                         |   o YES (start the web agent)                |
   |                         |                                              |
   |                         |   o NO (do not start the web agent)          |
   |-------------------------+----------------------------------------------|
   |                         | Determines whether the HP Systems Insight    |
   |                         | Manager Storage Agent is started when the    |
   |                         | health application loads. (Applies to Linux  |
   |                         | SPP only.)                                   |
   |                         |                                              |
   | CMASTARTSTORAGEAGENT    | Possible values:                             |
   |                         |                                              |
   |                         |   o YES (start the storage agent)            |
   |                         |                                              |
   |                         |   o NO (do not start the storage agent)      |
   |-------------------------+----------------------------------------------|
   |                         | Determines whether the HP Systems Insight    |
   |                         | Manager NIC agent is started. (Applies to    |
   |                         | Linux SPP only).                             |
   |                         |                                              |
   |                         | Possible values:                             |
   | CMASTARTNICAGENT        |                                              |
   |                         |   o YES (start the web agent)                |
   |                         |                                              |
   |                         |   o NO (do not start the web agent)          |
   |-------------------------+----------------------------------------------|
   |                         | Determines whether the HP Lights-Out         |
   |                         | management driver is started when the health |
   |                         | application loads. (Applies to Linux SPP     |
   |                         | only.)                                       |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   | CMANOTAINTEDKERNEL      |   o YES (start the HP Lights-Out management  |
   |                         |     driver)                                  |
   |                         |                                              |
   |                         |   o NO (do not start the HP Lights-Out       |
   |                         |     management driver)                       |
   |-------------------------+----------------------------------------------|
   |                         | Informs the VCA of the name of the VCRM to   |
   |                         | use as a software distribution baseline.     |
   |                         | (Applies to Linux SPP only.)                 |
   | HPVCAVCRMSERVER         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | VCRM name                                    |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage (hpsmh) uses  |
   |                         | this parameter to force overwrite the SMH    |
   |                         | settings of an existing configuration file.  |
   | FORCE-OVERWRITE         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO (default)                            |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage (hpsmh) uses  |
   |                         | this parameter to set up security for the    |
   |                         | web server. (Applies to Linux SPP only.)     |
   |                         |                                              |
   | ADMIN-GROUP             | Possible values:                             |
   |                         |                                              |
   |                         | Up to five Linux groups, separated by spaces |
   |                         | or semicolons, to enable administrative      |
   |                         | access to the web services.                  |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to set up security for the web     |
   |                         | server. (Applies to Linux SPP only.)         |
   |                         |                                              |
   | USER-GROUP              | Possible values:                             |
   |                         |                                              |
   |                         | Up to five Linux groups, separated by spaces |
   |                         | or semicolons, to enable user-level access   |
   |                         | to the web servers.                          |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to set up security for the web     |
   |                         | server. (Applies to Linux SPP only.)         |
   |                         |                                              |
   | OPERATOR-GROUP          | Possible values:                             |
   |                         |                                              |
   |                         | Up to five Linux groups, separated by spaces |
   |                         | or semicolons, to enable operator-level      |
   |                         | access to the web servers.                   |
   |-------------------------+----------------------------------------------|
   |                         | Determines whether an anonymous user can     |
   |                         | access HP Systems Management Homepage.       |
   |                         | (Applies to Linux SPP only.)                 |
   | ANONYMOUS-ACCESS        |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO (default)                            |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to determine whether HP SMH can    |
   |                         | use all available NICs and detect subnets    |
   |                         | for its web services. (Applies to Linux SPP  |
   | IP-BINDING              | only.)                                       |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO (default)                            |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to restrict the NICs and subnets   |
   |                         | to use for its web servers.                  |
   |                         |                                              |
   |                         | The IP-BINDING parameter must be set to yes  |
   |                         | for this parameter to be used during         |
   | IP-BINDING-LIST         | installation. (Applies to Linux SPP only.)   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | IP address pairs separated by semicolons     |
   |                         | (for example, 10.1.1.1/255.255.255.0;        |
   |                         |                                              |
   |                         | 10.2.2.2/255.255.255.0)                      |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to restrict login access. (Applies |
   |                         | to Linux SPP only.)                          |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   | IP-RESTRICTED-LOGINS    | YES, NO (default)                            |
   |                         |                                              |
   |                         | To enable restrictions on who can log in to  |
   |                         | the web server, this parameter must be set   |
   |                         | to yes, and values must be provided to the   |
   |                         | IP-RESTRICTED-EXCLUDE or                     |
   |                         | IP-RESTRICTED-INCLUDE parameters.            |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to exclude specific IP             |
   |                         | address/netmask pairs from logging into the  |
   |                         | web services. (Applies to Linux PSP only.)   |
   |                         |                                              |
   |                         | This parameter is ignored unless the         |
   |                         | IP-RESTRICTED-LOGINS parameter is set to     |
   | IP-RESTRICTED-EXCLUDE   | yes.                                         |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | List of IP address ranges separated by       |
   |                         | semicolons (for example, 10.1.1.1-10.1.1.10; |
   |                         |                                              |
   |                         | 10.2.2.2-10.2.2.10)                          |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to enable login only from the IP   |
   |                         | address/netmask pairs specified. (Applies to |
   |                         | Linux SPP only.)                             |
   |                         |                                              |
   |                         | This parameter is ignored unless the         |
   |                         | IP-RESTRICTED-LOGINS parameter is set to     |
   | IP-RESTRICTED-INCLUDE   | yes.                                         |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | List of IP address ranges separated by       |
   |                         | semicolons (for example, 10.1.1.1-10.1.1.10; |
   |                         |                                              |
   |                         | 10.2.2.2-10.2.2.10)                          |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to determine whether to enable     |
   |                         | local anonymous access to the web services.  |
   |                         | (Applies to Linux SPP only.)                 |
   |                         |                                              |
   | LOCALACCESS-ENABLED     | Possible values:                             |
   |                         |                                              |
   |                         |   o YES (default to include anonymous        |
   |                         |     access)                                  |
   |                         |                                              |
   |                         |   o NO                                       |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to determine the type of access    |
   |                         | granted to local users. (Applies to Linux    |
   |                         | SPP only.)                                   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   | LOCALACCESS-TYPE        |   o Anonymous (default)                      |
   |                         |                                              |
   |                         |   o Administrator                            |
   |                         |                                              |
   |                         |     CAUTION: Selecting local access with     |
   |                         |     administrator privileges as the login    |
   |                         |     provides full access to any user who has |
   |                         |     access to the local console, without     |
   |                         |     prompting for a user name or password.   |
   |-------------------------+----------------------------------------------|
   |                         | HP Systems Management Homepage uses this     |
   |                         | parameter to set up the trust relationship   |
   |                         | mode. (Applies to Linux SPP only.)           |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   | TRUSTMODE               |   o TrustByCert-If you use this value, you   |
   |                         |     must define the CERTLIST parameter to    |
   |                         |     enable access to the server.             |
   |                         |                                              |
   |                         |   o TrustByName-If you use this value, you   |
   |                         |     must define the XENAMELIST.              |
   |                         |                                              |
   |                         |   o TrustByAll-HP does not recommend using   |
   |                         |     this value because of possible negative  |
   |                         |     security consequences.                   |
   |                         |                                              |
   |                         |     [CAUTION] :                       |
   |                         |               The accepted values are        |
   |                         |               case-sensitive and must be     |
   |                         |               capitalized as shown. Failure  |
   |                         |               to do so prevents the trust    |
   |                         |               relationship from being set up |
   |                         |               properly during installation   |
   |                         |               and might affect access to the |
   |                         |               web server.                    |
   |-------------------------+----------------------------------------------|
   |                         | Enables you to provide a list of certificate |
   |                         | files or servers where certificates can be   |
   |                         | obtained for trust relationships for the HP  |
   |                         | Systems Management Homepage. (Applies to     |
   | CERTLIST                | Linux SPP only.)                             |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Certificate file name or Server DNS name     |
   |-------------------------+----------------------------------------------|
   |                         | Enables you to provide a list of servers,    |
   |                         | separated by semicolons, for trust           |
   |                         | relationships for the HP Systems Management  |
   |                         | Homepage. (Applies to Linux SPP only.)       |
   |                         |                                              |
   | XENAMELIST              | This parameter is valid only if the          |
   |                         | TRUSTMODE parameter is set to TrustByName.   |
   |                         | (Applies to Linux SPP only.)                 |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Server DNS name                              |
   |-------------------------+----------------------------------------------|
   |                         | The hp_qla2x00 QLogic Fibre Channel Driver   |
   |                         | uses this parameter to determine the         |
   |                         | failover mode to use. (Applies to Linux SPP  |
   |                         | only.)                                       |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |   o SinglePath                               |
   |                         |                                              |
   |                         |   o SecurePath                               |
   | HPQLA2X00FO             |                                              |
   |                         |   o QLogicFailure                            |
   |                         |                                              |
   |                         |     [NOTE] :                             |
   |                         |            No default value                  |
   |-------------------------+----------------------------------------------|
   |                         | The hp_qla2x00 QLogic Fibre Channel Driver   |
   |                         | uses this parameter to determine whether to  |
   |                         | skip detection of third-party storage.       |
   | HPQLA2X00FORCE          | (Applies to Linux SPP only.)                 |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Y, N (default)                               |
   |-------------------------+----------------------------------------------|
   |                         | Provides the user name credentials for the   |
   |                         | OA associated with VC. You must define a     |
   |                         | value of these variables before the HOST     |
   |                         | variable in the [TARGETS] section. This      |
   |                         | parameter applies only for VC firmware.      |
   | OAUID                   |                                              |
   |                         | You can also use OAUSER or OAUSERNAME.       |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | User can define the OAUID variable multiple  |
   |                         | times before each HOST variable.             |
   |-------------------------+----------------------------------------------|
   |                         | Provides the password credentials for the OA |
   |                         | associated with VC. You must define a value  |
   |                         | of these variables before the HOST variable  |
   |                         | in the [TARGETS] section. This parameter     |
   |                         | applies only for VC firmware.                |
   | OAPWD                   |                                              |
   |                         | You can also use OAPASSWORD.                 |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | User can define OAPWD variable multiple      |
   |                         | times before each HOST variable.             |
   |-------------------------+----------------------------------------------|
   |                         | Allows the installation to proceed on Linux  |
   |                         | or HP-UX node which is part of a             |
   |                         | Serviceguard cluster. If you do not specify  |
   |                         | the node, the node does not enter the        |
   |                         | installation or deploy phases.               |
   | IGNOREWARNINGS          |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | YES, NO                                      |
   |                         |                                              |
   |                         | On Linux or HP-UX nodes.                     |
   |-------------------------+----------------------------------------------|
   |                         | This argument determines which Superdome 2   |
   |                         | firmware is updated.                         |
   |                         |                                              |
   | UPDATETYPE              | Possible values:                             |
   |                         |                                              |
   |                         | ALL, COMPLEX, PARTITIONS                     |
   |                         |                                              |
   |                         | Superdome 2 servers only                     |
   |-------------------------+----------------------------------------------|
   |                         | Use this argument when the                   |
   |                         | UPDATETYPE=PARTITIONS. This argument         |
   |                         | specifies the subset of partitions or blades |
   |                         | to update when you do not want to update all |
   |                         | partitions. Valid devices are: npar(number)  |
   |                         | and blade(enc)/(bay).                        |
   | DEVICELIST              |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | For example: DEVICELIST=npar1,blade1/1       |
   |                         |                                              |
   |                         | Do not put spaces between the parameters     |
   |                         |                                              |
   |                         | Superdome 2 servers only                     |
   |-------------------------+----------------------------------------------|
   |                         | Use this argument when the UPDATETYPE= ALL   |
   |                         | or UPDATETYPE= PARTITIONS. This argument     |
   |                         | specifies specific partitions to reboot      |
   |                         | after the partition firmware has been        |
   |                         | updated. Valid npar values are npar(number). |
   |                         |                                              |
   | REBOOTLIST              | Possible values:                             |
   |                         |                                              |
   |                         | For example: REBOOTLIST=npar1,npar2          |
   |                         |                                              |
   |                         | Do not put spaces between the parameters     |
   |                         |                                              |
   |                         | Superdome 2 servers only                     |
   |-------------------------+----------------------------------------------|
   |                         | Use this argument to provide a superuser     |
   |                         | username.                                    |
   |                         |                                              |
   |                         | SUUSERNAME cannot be used with USESUDO       |
   |                         | access level.                                |
   |                         |                                              |
   | SUUSERNAME              | [NOTE] :                                 |
   |                         |        Specifying TARGETTYPE = linux reduces |
   |                         |        inventory time for deployments. This  |
   |                         |        is an optional input file argument.   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | <superusername>                              |
   |-------------------------+----------------------------------------------|
   |                         | Use this argument to provide a superuser     |
   |                         | password.                                    |
   |                         |                                              |
   |                         | SUPASSWORD cannot be used with USESUDO       |
   |                         | access level.                                |
   |                         |                                              |
   | SUPASSWORD              | [NOTE] :                                 |
   |                         |        Specifying TARGETTYPE = linux reduces |
   |                         |        inventory time for deployments. This  |
   |                         |        is an optional input file argument.   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | <superuserpassword>                          |
   |-------------------------+----------------------------------------------|
   |                         | Use this argument to use the sudo command.   |
   |                         |                                              |
   |                         | When you specify USESUDO = YES in the input  |
   |                         | file, along with UID and PWD, UID and PWD    |
   |                         | are considered sudo users.                   |
   |                         |                                              |
   |                         | USESUDO cannot be used with SUUSERNAME and   |
   |                         | SUPASSWORD access level.                     |
   | USESUDO                 |                                              |
   |                         | [NOTE] :                                 |
   |                         |        Specifying TARGETTYPE = linux reduces |
   |                         |        inventory time for deployments. This  |
   |                         |        is an optional input file argument.   |
   |                         |                                              |
   |                         | Possible values:                             |
   |                         |                                              |
   |                         | Yes, No                                      |
   |-------------------------+----------------------------------------------|
   |                         | Generates a report listing of the node       |
   |                         | summary and describes how the components in  |
   |                         | the repository affect the node; for example, |
   |                         | whether each component applies to the node.  |
   |                         | The report is generated in HTML and XML with |
   |                         | file name formats of                         |
   | REPORT                  | HPSUM_Report_<date>_<time>.html and          |
   |                         | HPSUM_Report_<date>_<time>.xml.              |
   |                         |                                              |
   |                         | By default, the files are located in the     |
   |                         | present working directory where HP SUM is    |
   |                         | initiated. If that location is               |
   |                         | write-protected, you can find the files in   |
   |                         | the same directory as the HP SUM log files.  |
   |-------------------------+----------------------------------------------|
   |                         | Generates a report listing of the components |
   |                         | in the specified repository. The report is   |
   |                         | generated in HTML and XML with file name     |
   |                         | formats of                                   |
   |                         | HPSUM_Inventory_Report_<date>_<time>.html    |
   |                         | and                                          |
   | INVENTORY_REPORT        | HPSUM_Inventory_Report_<date>_<time>.xml.    |
   |                         |                                              |
   |                         | By default, the report is located in the     |
   |                         | present working directory where HP SUM is    |
   |                         | initiated. If that location is               |
   |                         | write-protected, you can find the report in  |
   |                         | the same directory as the HP SUM log files.  |
   |-------------------------+----------------------------------------------|
   |                         | Generates a report listing of the firmware   |
   |                         | installed and details of the node. The       |
   |                         | report is generated in HTML and XML with     |
   |                         | file names of HPSUM_Firmware_Report.html and |
   |                         | fwreport.xml in the directory named          |
   | FIRMWARE_REPORT         | HPSUM_Firmware_Report_<date>_<time>.         |
   |                         |                                              |
   |                         | By default, the report is located in the     |
   |                         | present working directory where HP SUM is    |
   |                         | initiated. If that location is               |
   |                         | write-protected, you can find the report in  |
   |                         | the same directory as the HP SUM log files.  |
   |-------------------------+----------------------------------------------|
   | DEPENDENCY_REPORT       | Generates a report listing of the failed     |
   |                         | dependencies for all nodes.                  |
   |-------------------------+----------------------------------------------|
   |                         | Generates a report that lists all installed  |
   | INSTALLED_REPORT        | firmware, software, and driver versions      |
   |                         | installed on all nodes.                      |
   |-------------------------+----------------------------------------------|
   | COMBINED_REPORT         | This report generates all report types in    |
   |                         | one file.                                    |
   +------------------------------------------------------------------------+

   Examples of the HP SUM input file include the following:

   REBOOTALLOWED = YES

   REBOOTREQUIRED = NO

   REBOOTMESSAGE = "Server is going down for a reboot"

   REBOOTDELAY = 15

   COMPONENTSLIST = cp001234.exe, cp001235.exe

   BUNDLESLIST = bp001234.xml

   ALLOWUPDATEBUNDLE = YES

   SKIPTARGET = NO

   IGNOREERRORS = ServerNotFound, FailedDependencies

   SOURCEPATH = c:\pkgsource1

   USELATEST = YES

   SILENT = YES

   OPTIONS = /f:rom

   [TARGETS]

   HOST = schinta1

   HOST = schinta2

   UID = root

   PWD = root123

   HOST = 234.567.765.432

   [END]

   USAGE: hpsum /inputfile <path:\inputfile.txt>

   Examples of inputfile.txt file:

   Example: The two nodes are passed to be updated. The nodes do not
   necessarily have to be OAs. They can be any node that HP SUM supports.

   DRYRUN = YES

   SILENT = YES

   [TARGETS]

   HOST = BL465C-01

   HOST = 192.168.1.2

   [END]

   Example A host DNS is passed along with the user ID and password to use
   for the hosts in the group.

   DRYRUN = YES

   SILENT = YES

   [TARGETS]

   HOST = BL685cG6

   UID = Bigboss2

   PWD = password

   [END]

   Example

   SILENT = YES

   IGNOREERRORS = ServerNotFound,BadPassword, FailedDepedencies

   SKIPTARGET = NO

   SOURCEPATH = C:\fwcd\firmware-8.70-0\hp\swpackages

   [GROUPS]

   HOST=winserver

   UID=Userid

   PWD=password

   [END]

   Example

   SILENT = YES

   IGNOREERRORS = ServerNotFound,BadPassword, FailedDepedencies

   SKIPTARGET = NO

   SOURCEPATH = C:\ fwcd\firmware-8.70-0\hp\swpackages

   FORCEALL = YES

   REBOOTALLOWED = YES

   REBOOTDELAY = 30

   REBOOTMESSAGE = "Install complete, server will reboot in 30 seconds"

   [TARGETS]

   HOST=16.83.62.141

   UID=Userid

   PWD=password

   [END]

   [TARGETS]

   HOST=16.83.61.48

   UID=Userid

   PWD=password

   [END]

   [TARGETS]

   HOST=16.83.62.196

   UID=Userid

   PWD=password

   [END]

   [TARGETS]

   HOST=16.83.61.24

   UID=Userid

   PWD=password

   [END]

   Example: Superdome 2 input files:

   IGNOREWARNINGS = TRUE

   [TARGET] HOST = 10.0.0.206

   UID = Userid

   PWD = password

   UPDATETYPE = PARTITIONS

   DEVICELIST=npar1,npar2,blade1/4,blade 1/5

   REBOOTLIST=npar1,npar2

   [END]

   Usage example of access level.

   USAGE: hpsum /inputfile <path:\inputfile.txt>

   Example: Using sudo to update components on Linux:

   SILENT = YES

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   [END]

   Example: To update multiple targets using sudo in an input file:

   SILENT = YES

   USESUDO = YES

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   [END]

   [TARGETS]

   HOST = 10.0.1.73

   UID = Userid

   PWD = password

   [END]

   Example: Using super user to update Linux components:

   SILENT = YES

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   SUUSERNAME = root

   SUPASSWORD = rootpwd

   [END]

   Example: To update multiple targets using super user in an input file when
   all targets have the same super user credentials:

   SILENT = YES

   SUUSERNAME = root

   SUPASSWORD = rootpwd

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   [END]

   [TARGETS]

   HOST = 10.0.1.73

   UID = Userid

   PWD = password

   [END]

1.3 Downloading HP SUM and components from the SDR

   If you are using a Linux system, you can download HP SUM as an RPM from
   the HP SDR. This allows you to download and install HP SUM and components
   from the SDR using common YUM commands. For more information about
   downloading and installing HP SUM as an RPM, see the document Linux best
   practices using HP Service Pack for ProLiant (SPP) and Software Delivery
   Repository (SDR) at
   http://h20564.www2.hp.com/portal/site/hpsc/public/kb/docDisplay/?docId=c03479393.

   For information on using the SDR, go to http://www.hp.com/go/sdr.