﻿                        HP Smart Update Manager CLI Help

   Copyright (c) 2009, 2012 Hewlett-Packard Development Company, L.P.

   The information contained herein is subject to change without notice. The
   only warranties for HP products and services are set forth in the express
   warranty statements accompanying such products and services. Nothing
   herein should be construed as constituting an additional warranty. HP
   shall not be liable for technical or editorial errors or omissions
   contained herein.

   Confidential computer software. Valid license from HP required for
   possession, use or copying. Consistent with FAR 12.211 and 12.212,
   Commercial Computer Software, Computer Software Documentation, and
   Technical Data for Commercial Items are licensed to the U.S. Government
   under vendor's standard commercial license.

   Acknowledgments

   Microsoft(R), Windows(R), Windows Vista(R), and Windows Server(R) are U.S.
   registered trademarks of Microsoft Corporation.

   May 2012

   Abstract

   This guide is intended for individuals familiar with the configuration and
   operation of Microsoft Windows, Windows Server, Linux, smart components,
   and deployment of firmware and software. Because of the risk of data loss,
   only individuals experienced with using firmware and software should
   implement the procedures.

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

  
Chapter 1 Scripted deployment


1.1 Command-line interface

   The HP SUM command-line interface enables you 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:

   hpsum [/h[elp]] [/?] [/f[orce]] [/f[orce]:bundle] [/f[orce]:rom]

   [/f[orce]:software] [/f[orce]:all ] [/g (/downgrade)] [/e (/rewrite)

   [/r[eboot]] [/reboot_message "reboot message"]

   [/reboot_delay timeout_in_seconds] [/reboot_always] [/s[ilent]]

   [/c[omponent] <component_to_install>] [/group "group_name"]

   [/b[undle] <bundle_to_install>] [/allow_update_to_bundle]

   [/allow_non_bundle_components] [/use_latest] [/use_location "file_share"]

   [/use_web] [/use_d[ownloaded]] [/tpmbypass] [/ignore_tpm] [/use_snmp]
   [/use_wmi] [/use_ams][/romonly] [/softwareonly] [/dryrun]
   [/continue_on_error <error>] [/override_existing_connection]
   [/express_install] [/user <username> or /username <username>] [/passwd
   <password>] [/current_credential] [/target "netAddress"] [/logdir "path"]
   [/v[erbose]] [/veryv[erbose]] [/report][/inventory_report]
   [/firmware_report] [/On_failed_dependency:<parameter>] [/oa_username
   <username>] [/oa_password <password>] [/use_proxy <proxy server>]
   [/proxy_script <proxy script>] [/proxy_user <username>] [/proxy_passwd
   <password>][/inputfile "filename"] [/c[omponent]
   <component_to_install>][<component1_to_install> <component2_to_install>
   ...][<bundle1_to_install> <bundle2_to_install>...]

   The following commands are only supported by Superdome 2 servers:

   [/update_type<type>] [/device_list <device[,device]...>] [/reboot_list
   <npar[,npar]...>]

   HP SUM with Onboard Administrator 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.

   [Note] Note:                                 
          All arguments and information enclosed in brackets are optional.
          The arguments may be prefixed with either a '-' or '/' character.
          These examples show only the '/'.     

   On Windows operating systems, use a slash (/) before each argument. On
   Linux operating systems, use a hyphen (-) before each argument.

   If the /s[ilent] argument is not included on the command line, the HP SUM
   GUI appears.

   [Note] Note:                                 
          Command line syntax does not support double-byte character sets.
          Any messages entered through the command line using 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.

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

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

   The following table shows what updates if SNMP switches are currently
   installed:

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

   The following table shows what updates if WBEM switches are currently
   installed:

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

   AMS already Installed - G7 and earlier servers do not support AMS

   +-----------------------------------------------------------------+
   |          Command          | G7 and earlier |        Gen8        |
   |---------------------------+----------------+--------------------|
   | no switches               | N/A            | AMS                |
   |---------------------------+----------------+--------------------|
   | /use_ams                  | N/A            | AMS                |
   |---------------------------+----------------+--------------------|
   | /use_snmp                 | N/A            | AMS and SNMP       |
   |---------------------------+----------------+--------------------|
   | /use_wmi                  | N/A            | AMS and WBEM       |
   |---------------------------+----------------+--------------------|
   | /use_ams/use_snmp         | N/A            | AMS and SNMP       |
   |---------------------------+----------------+--------------------|
   | /use_ams/use_wmi          | N/A            | AMS and WBEM       |
   |---------------------------+----------------+--------------------|
   | /use_wmi/use_snmp         | N/A            | AMS, SNMP and WBEM |
   |---------------------------+----------------+--------------------|
   | /use_ams/use_wmi/use_snmp | N/A            | AMS, SNMP and WBEM |
   +-----------------------------------------------------------------+

  1.1.2 Command-line arguments

   This version of HP SUM recognizes the following command-line arguments.
   These arguments can be used to pre-populate the GUI in the Source
   Selection and Review/Install Updates screens. If you specify the target
   and credentials, then the /s[ilent] parameter is required to proceed with
   the installation.

   You cannot use some arguments, such as /romonly and /softwareonly
   together.

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

   +------------------------------------------------------------------------+
   |         Installation options          |          Description           |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables you to   |
   |                                       | override or downgrade an       |
   | /f[orce]                              | existing component             |
   |                                       | installation. This argument    |
   |                                       | produces the same results as   |
   |                                       | /f:software.                   |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables you to   |
   |                                       | override or downgrade the      |
   | /f[orce]:bundle                       | existing installation of       |
   |                                       | components in the selected     |
   |                                       | bundle.                        |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables you to   |
   |                                       | override or downgrade the      |
   | /f[orce]:rom                          | existing installation of the   |
   |                                       | selected firmware components   |
   |                                       | (applies to firmware only).    |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables you to   |
   | /f[orce]:software                     | override or downgrade the      |
   |                                       | existing installation of the   |
   |                                       | selected software components.  |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables you to   |
   |                                       | override or downgrade the      |
   | /f[orce]:all                          | existing installation of the   |
   |                                       | selected software components,  |
   |                                       | firmware components, and       |
   |                                       | bundles.                       |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables you to   |
   |                                       | downgrade to an earlier        |
   |                                       | version of firmware for        |
   | /g or /downgrade                      | multi-target devices such as   |
   |                                       | hard drives and array          |
   |                                       | controllers (applies to        |
   |                                       | firmware only).                |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables you to   |
   |                                       | downgrade to an earlier        |
   |                                       | version of firmware for        |
   | /e or /rewrite                        | multi-target devices such as   |
   |                                       | hard drives and array          |
   |                                       | controllers (applies to        |
   |                                       | firmware only).                |
   |---------------------------------------+--------------------------------|
   |                                       | This argument causes the       |
   |                                       | installation to run silently   |
   |                                       | with no GUI or console output. |
   |                                       | All data writes to the log     |
   |                                       | file. Any generated prompts    |
   |                                       | use the default option and     |
   |                                       | continue the installation      |
   |                                       | without user input. If a       |
   |                                       | component requires input       |
   |                                       | before installation (such as   |
   |                                       | configuration information),    |
   | /s[ilent]                             | then the component             |
   |                                       | installation fails, and an     |
   |                                       | error message writes to the    |
   |                                       | log file.                      |
   |                                       |                                |
   |                                       | Failed dependencies are not    |
   |                                       | reported to the user when      |
   |                                       | using the /s[ilent] argument.  |
   |                                       | To check for failed            |
   |                                       | dependencies, remove the       |
   |                                       | /s[ilent] argument and reissue |
   |                                       | the command line. The HP SUM   |
   |                                       | GUI appears.                   |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies        |
   |                                       | components to install.         |
   |                                       | Components to install can be   |
   |                                       | specified with or without the  |
   |                                       | /c[omponent] argument.         |
   |                                       |                                |
   |                                       |   o If using the /c[omponent]  |
   |                                       |     argument, then only one    |
   |                                       |     component can specified    |
   |                                       |     with the argument.         |
   |                                       |     However, multiple /c       |
   |                                       |     arguments and components   |
   |                                       |     can be specified on the    |
   |                                       |     same line.                 |
   |                                       |                                |
   |                                       |   o If the /c[omponent]        |
   |                                       |     argument is not used, then |
   |                                       |     multiple components can be |
   |                                       |     specified at the same      |
   |                                       |     time, but the components   |
   |                                       |     must be separated by a     |
   |                                       |     blank and listed after all |
   | /c[omponent]<component_to_install> or |     the arguments on the       |
   | <component1_to_install>               |     command line.              |
   | <component2_to_install>               |                                |
   |                                       |   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 mixing components and |
   |                                       |     bundles on the command     |
   |                                       |     line, the filter switches  |
   |                                       |     control what components    |
   |                                       |     and bundles are installed. |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies an     |
   | /group "group_name"                   | already defined group name in  |
   |                                       | the HP SUM graphical user      |
   |                                       | interface.                     |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies        |
   |                                       | bundles to install. Bundles to |
   |                                       | install can be specified with  |
   |                                       | or without the /b[undle]       |
   |                                       | argument.                      |
   |                                       |                                |
   |                                       |   o If using the /b[undle]     |
   |                                       |     argument, then only one    |
   |                                       |     bundle can specified with  |
   |                                       |     the argument. However,     |
   |                                       |     multiple /b arguments and  |
   |                                       |     bundles can be specified   |
   |                                       |     on the same line.          |
   |                                       |                                |
   |                                       |   o If the /b[undle] argument  |
   |                                       |     is not used, multiple      |
   |                                       |     bundles can be specified   |
   |                                       |     at the same time, but the  |
   |                                       |     bundles need to be         |
   |                                       |     separated by a blank and   |
   |                                       |     listed after all the       |
   |                                       |     arguments on the command   |
   | /b[undle] <bundle_to_install> or      |     line.                      |
   | <bundle1_to_install>                  |                                |
   | <bu/use_latestndle2_to_install>       |     This argument specifies    |
   |                                       |     bundles to install.        |
   |                                       |     Bundles to install can be  |
   |                                       |     specified with or without  |
   |                                       |     the /b[undle] argument.    |
   |                                       |                                |
   |                                       |     If using the /b[undle]     |
   |                                       |     argument, then only one    |
   |                                       |     bundle can specified with  |
   |                                       |     the argument. However,     |
   |                                       |     multiple /b arguments and  |
   |                                       |     bundles can be specified   |
   |                                       |     on the same line.          |
   |                                       |                                |
   |                                       |     If the /b[undle] argument  |
   |                                       |     is not used, multiple      |
   |                                       |     bundles can be specified   |
   |                                       |     at the same time, but the  |
   |                                       |     bundles need to be         |
   |                                       |     separated by a blank and   |
   |                                       |     listed after all the       |
   |                                       |     arguments on the command   |
   |                                       |     line.                      |
   |---------------------------------------+--------------------------------|
   |                                       | This argument is a filter      |
   |                                       | switch and enables the user 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.      |
   |---------------------------------------+--------------------------------|
   |                                       | This argument is a filter      |
   |                                       | switch and enables the user to |
   | /allow_non_bundle_components          | install components which are   |
   |                                       | not included in the bundle but |
   |                                       | reside in the directory with   |
   |                                       | the components in the bundle.  |
   |---------------------------------------+--------------------------------|
   |                                       | 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 with the latest version |
   |                                       | for installation.              |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies a      |
   |                                       | directory or file share that   |
   |                                       | contains the PSP, ISP, and     |
   |                                       | components for use with HP     |
   |                                       | SUM. The file_share format     |
   |                                       | must be a mapped file share    |
   |                                       | and not in Universal Naming    |
   |                                       | Convention (UNC) format. If    |
   |                                       | this argument is not           |
   |                                       | specified, the directory       |
   | /use_location "file_share"            | containing hpsum.exe or HP SUM |
   |                                       | is used by default.            |
   |                                       |                                |
   |                                       | The logged-in account must     |
   |                                       | have access to this location.  |
   |                                       |                                |
   |                                       | The /user and /passwd          |
   |                                       | arguments do not have any      |
   |                                       | effect when attempting to      |
   |                                       | access the file share. Use     |
   |                                       | those arguments only when      |
   |                                       | connecting to a target system. |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies that   |
   |                                       | the checkbox for Check         |
   |                                       | ftp.hp.com on the Source       |
   | /use_web                              | Selection screen is selected.  |
   |                                       | This enables components to be  |
   |                                       | retrieved from ftp.hp.com and  |
   |                                       | used in the list of possible   |
   |                                       | updates.                       |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables the      |
   |                                       | inclusion of a proxy server    |
   |                                       | (and port number) to access    |
   | /use_proxy <Proxy server>             | ftp.hp.com. This parameter     |
   |                                       | must be used with /use_web.    |
   |                                       | For example, /use_web          |
   |                                       | /use_proxy <1.22.33.44:80>.    |
   |---------------------------------------+--------------------------------|
   |                                       | This argument enables the      |
   |                                       | inclusion of a proxy script to |
   |                                       | access ftp.hp.com. This        |
   | /proxy_script <Proxy script>          | parameter must be used with    |
   |                                       | /use_web. For example,         |
   |                                       | /use_web /proxy_script         |
   |                                       | <autoproxy.com>.               |
   |---------------------------------------+--------------------------------|
   |                                       | This argument sets the         |
   | /proxy_password<password>             | password to be used for an     |
   |                                       | authenticating proxy server.   |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies that   |
   |                                       | the checkbox for Use last      |
   |                                       | downloaded repository from     |
   |                                       | ftp.hp.com on the Source       |
   | /use_d[ownloaded]                     | Selection screen in the GUI is |
   |                                       | selected. This enables the     |
   |                                       | previously downloaded          |
   |                                       | components to be included in   |
   |                                       | the list of possible updates.  |
   |---------------------------------------+--------------------------------|
   |                                       | This argument 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.       |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies that   |
   |                                       | components that use WMI        |
   |                                       | protocol are available for     |
   |                                       | installation. These components |
   |                                       | are optional and are not       |
   |                                       | installed unless this argument |
   | /use_wmi                              | is used. When 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.             |
   |---------------------------------------+--------------------------------|
   |                                       | This argument specifies that   |
   |                                       | components which Agentless     |
   |                                       | Monitoring service (AMS)       |
   |                                       | components can be installed    |
   |                                       | along with SNMP components.    |
   | /use_ams                              | The AMS and SNMP components    |
   |                                       | are available to select by     |
   |                                       | default. When the /use_ams     |
   |                                       | argument is used, the SNMP     |
   |                                       | components are required, and   |
   |                                       | the WMI components are         |
   |                                       | optional.                      |
   |---------------------------------------+--------------------------------|
   |                                       | This argument is a filter      |
   |                                       | switch and allows the user to  |
   |                                       | only see the firmware          |
   |                                       | components needed for          |
   |                                       | installation. When using this  |
   |                                       | filter switch, you must exit   |
   | /romonly                              | and restart HP SUM if you wish |
   |                                       | to return to an unfiltered     |
   |                                       | state.                         |
   |                                       |                                |
   |                                       | Do not use the /romonly        |
   |                                       | argument with the              |
   |                                       | /softwareonly argument.        |
   |                                       | (Applies to firmware only.)    |
   |---------------------------------------+--------------------------------|
   |                                       | This argument is a filter      |
   |                                       | switch and allows the user to  |
   |                                       | only see the software          |
   |                                       | components needed for          |
   |                                       | installation. When using this  |
   |                                       | filter switch, you must exit   |
   | /softwareonly                         | and restart HP SUM if you wish |
   |                                       | to return to an unfiltered     |
   |                                       | state.                         |
   |                                       |                                |
   |                                       | Do not use the /softwareonly   |
   |                                       | argument with the /romonly     |
   |                                       | argument.                      |
   |---------------------------------------+--------------------------------|
   |                                       | This argument starts express   |
   |                                       | install (for local host only). |
   |                                       | The HP SUM performs discovery, |
   |                                       | install, or exit without user  |
   |                                       | interaction. The user can      |
   |                                       | cancel or terminate HP SUM. An |
   |                                       | express installation will      |
   |                                       | force install all components   |
   |                                       | in the default repository and  |
   | /express_install                      | may downgrade drivers and      |
   |                                       | firmware to the versions in    |
   |                                       | the default directory as part  |
   |                                       | of the installation operation. |
   |                                       | The express installation       |
   |                                       | feature is intended to allow   |
   |                                       | the user to set a baseline and |
   |                                       | enforce it regardless of the   |
   |                                       | currently installed version of |
   |                                       | drivers and firmware on the    |
   |                                       | local server.                  |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |       Overriding errors       |              Description               |
   |-------------------------------+----------------------------------------|
   |                               | These arguments specifies that if a    |
   |                               | Trusted Platform Module (TPM) is       |
   | /tpmbypass or /ignore_tpm     | enabled, the warning message should be |
   |                               | ignored and component installation     |
   |                               | will be allowed to continue. For more  |
   |                               | information about TPM, see ???.        |
   |-------------------------------+----------------------------------------|
   |                               | This argument allows the installation  |
   | /ignore_warnings              | to proceed on a Superdome 2 target     |
   |                               | even when warnings are returned during |
   |                               | analysis.                              |
   |-------------------------------+----------------------------------------|
   |                               | This argument causes the installation  |
   |                               | to continue and ignore errors. Valid   |
   |                               | values are :                           |
   |                               |                                        |
   |                               | * <error>=ServerNotFound and           |
   |                               |                                        |
   |                               | * <error>=BadPassword.                 |
   | /continue_on_error <error>    |                                        |
   |                               | * <error>=FailedDependencies           |
   |                               |                                        |
   |                               | 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.                      |
   |-------------------------------+----------------------------------------|
   |                               | This argument is used to define the    |
   |                               | behavior when a remote target has an   |
   | /override_existing_connection | existing HP SUM session in progress.   |
   |                               | It overrides the session in progress   |
   |                               | and re-initializes the installation    |
   |                               | framework on the remote host.          |
   |-------------------------------+----------------------------------------|
   |                               | This argument provides HP SUM          |
   |                               | <parameter> the information of how to  |
   |                               | proceed when a component has a failed  |
   |                               | dependency. The supported parameters   |
   |                               | for this argument are Omit_Host        |
   |                               | (default), Omit_Component and Force.   |
   | /On_failed_dependency:        | Omit_Host causes the host to be put    |
   | <parameter>                   | into a failure state and no            |
   |                               | installation is attempted.             |
   |                               | Omit_Component deselects the affected  |
   |                               | component(s) and proceeds with any     |
   |                               | updates that do not have dependency    |
   |                               | failures. Force attempts all updates,  |
   |                               | even if they have dependency failures. |
   |-------------------------------+----------------------------------------|
   | /partition_only               | Use this argument to select a          |
   |                               | partition to update.                   |
   |-------------------------------+----------------------------------------|
   |                               | Use these arguments if you do not use  |
   |                               | the /partition_only argument. If you   |
   | /oa_name and /oa_password     | do not enter the selections, then the  |
   |                               | update will display and error and      |
   |                               | exit.                                  |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |     Reboot options      |                 Description                  |
   |-------------------------+----------------------------------------------|
   |                         | If the following conditions are met, this    |
   |                         | argument causes the server (or host server   |
   |                         | in a remote installation) to reboot:         |
   |                         |                                              |
   |                         |   o The /reboot option is selected or given  |
   |                         |     as a command-line argument.              |
   | /r[eboot]               |                                              |
   |                         |   o All components selected for installation |
   |                         |     are successfully installed.              |
   |                         |                                              |
   |                         |   o At least one of the installed components |
   |                         |     requires a reboot to complete its        |
   |                         |     installation.                            |
   |-------------------------+----------------------------------------------|
   |                         | This argument displays the specified reboot  |
   | /reboot_message "reboot | message on remote consoles connected to the  |
   | message"                | server you want to reboot. You must use this |
   |                         | argument with the /reboot option or the      |
   |                         | argument is ignored.                         |
   |-------------------------+----------------------------------------------|
   |                         | This argument delays the reboot of the       |
   |                         | server for the length of time specified by   |
   |                         | the timeout_in_seconds variable. You must    |
   |                         | use this argument with the /reboot option,   |
   |                         | or the argument is ignored. Acceptable       |
   |                         | values are between 15 and 3600.              |
   |                         |                                              |
   | /reboot_delay           |   o The default timeout value is 15 seconds  |
   | timeout_in_secs         |     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.                                  |
   |-------------------------+----------------------------------------------|
   |                         |   o If the following conditions are met,     |
   |                         |     this argument forces the server to       |
   |                         |     reboot: The /reboot_always option is     |
   | /reboot_always          |     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.                    |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |       Targets        |                   Description                   |
   |----------------------+-------------------------------------------------|
   | /user<username> or   | This argument enables you to log in to the      |
   | /username <username> | remote targets with the user ID. For the OA     |
   |                      | target, see /oa_username argument.              |
   |----------------------+-------------------------------------------------|
   |                      | This argument enables you to use this password  |
   |                      | for the user ID specified in the /user          |
   | /psswd <password>    | parameter (except for the OA target). The       |
   |                      | password is used to log in to remote targets.   |
   |                      | For the OA target, see /oa_password argument.   |
   |----------------------+-------------------------------------------------|
   |                      | This argument is the IP address or the DNS name |
   |                      | of a remote host which can be remote server,    |
   |                      | remote iLO NIC port, Virtual Connect Ethernet   |
   |                      | or Fibre Channel Module for c-Class             |
   |                      | BladeSystem, or BladeSystem Onboard             |
   | /target "netAddress" | Administrator(OA).                              |
   |                      |                                                 |
   |                      | When two Onboard Administrators are in an       |
   |                      | enclosure, this argument should be the active   |
   |                      | Onboard Administrator.When specifying the IP    |
   |                      | address, use either the IPv4 or IPv6 format.    |
   |----------------------+-------------------------------------------------|
   |                      | This argument enables the credential of the     |
   |                      | local host to be used as the credential to      |
   |                      | access the targets instead of providing the     |
   | /current_credential  | username and password explicitly for each       |
   |                      | target. The assumption is that the current      |
   |                      | credential is valid for the targets being       |
   |                      | accessed. (Applies to Windows only)             |
   |----------------------+-------------------------------------------------|
   |                      | This argument provides the username credential  |
   |                      | for OA associated with VC specified with        |
   |                      | "target" command-line parameter. Only one set   |
   |                      | of OA credentials can be specified with         |
   |                      | command-line parameters. You can only add       |
   |                      | multiple VC targets to command-line parameters  |
   |                      | with "target" parameter if the credentials of   |
   |                      | OAs associated with specified VCs are the same. |
   | /oa_username         | The argument oa_username is not required if VC  |
   |                      | has the same credentials as the associated OA.  |
   |                      | You do not need to provide an OA network        |
   |                      | address associated with Virtual Connect. HP SUM |
   |                      | queries it from a specified VC target.          |
   |                      |                                                 |
   |                      | To update multiple VCs with different username  |
   |                      | and password or VCs with OAs which have         |
   |                      | different credentials, the corresponding input  |
   |                      | files OAUID and OAPWD must be used.             |
   |----------------------+-------------------------------------------------|
   |                      | This argument provides the password credential  |
   |                      | for associated with VC specified with "target"  |
   |                      | command-line parameter. Only one set of OA      |
   |                      | credentials can be specified with command-line  |
   |                      | parameters. You can only add multiple VC        |
   |                      | targets to command-line parameters with         |
   |                      | "target" parameter if the credentials of OAs    |
   |                      | associated with specified VCs are the same. The |
   | /_password           | argument oa_password is not required if VC has  |
   |                      | the same credentials as the associated OA. You  |
   |                      | do not need to provide an OA network address    |
   |                      | associated with Virtual Connect. HP SUM queries |
   |                      | it from a specified VC target.                  |
   |                      |                                                 |
   |                      | To update multiple VCs with different username  |
   |                      | and password or VCs with OAs which have         |
   |                      | different credentials, the corresponding input  |
   |                      | files OAUID and OAPWD must be used.             |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |   Log files    |                      Description                      |
   |----------------+-------------------------------------------------------|
   |                | This argument enables you to redirect the output from |
   |                | HP SUM or the HP BladeSystem c-Class Onboard          |
   |                | Administrator flash utility to a different directory  |
   |                | than the default location.                            |
   |                |                                                       |
   |                |   o For Windows components, the default location      |
   | /logdir "path" |     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>.           |
   |----------------+-------------------------------------------------------|
   |                | These arguments enable you to set the verbosity level |
   |                | for the HP SUM execution log file,                    |
   | /v[erbose] or  | hpsum_execution_log_<date>_<time>.log. Using one of   |
   | /veryv[erbose] | these arguments increases the level of detail that is |
   |                | retained in the log file. The default value is normal |
   |                | verbosity.                                            |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   | Generating reports |                    Description                    |
   |--------------------+---------------------------------------------------|
   |                    | This argument generates a report listing of the   |
   |                    | target summary and how the components in the      |
   |                    | repository affect the target. For example,        |
   |                    | whether each component applies to the target or   |
   |                    | not. The report is generated in HTML and XML with |
   |                    | file name formats                                 |
   | /report            | ofHPSUM_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 from. |
   |                    | If that location is write-protected, the files    |
   |                    | can be found in the same directory as the HP SUM  |
   |                    | log files.                                        |
   |--------------------+---------------------------------------------------|
   |                    | This argument 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 from where HP SUM is initiated. |
   |                    | If that location is write-protected, the report   |
   |                    | can be found in the same directory as the HP SUM  |
   |                    | log files.                                        |
   |--------------------+---------------------------------------------------|
   |                    | This argument generates a report listing of the   |
   |                    | firmware installed and details of the target. 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 from where HP SUM is initiated. |
   |                    | If that location is write-protected, the report   |
   |                    | can be found in the same directory as the HP SUM  |
   |                    | log files.                                        |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |   Using input files   |                  Description                   |
   |-----------------------+------------------------------------------------|
   |                       | This argument enables you to script the        |
   |                       | deployment of firmware and software to         |
   | /inputfile "filename" | multiple remote systems at one time. For       |
   |                       | details of the file format and commands, see   |
   |                       | "Input files".                                 |
   |-----------------------+------------------------------------------------|
   |                       | This argument enables you to instruct HP SUM   |
   | /deleteinputfile      | to delete the input file after it has been     |
   |                       | read in.                                       |
   +------------------------------------------------------------------------+

   +------------------------------------------------------------------------+
   |  Superdome 2 server  |                   Description                   |
   |       commands       |                                                 |
   |----------------------+-------------------------------------------------|
   |                      | This argument determines which Superdome 2      |
   |                      | firmware is updated. You can choose ALL,        |
   | /update_type<type>   | COMPLEX, or 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 blades to update    |
   |                      | when you do not want to update all partitions   |
   | /device_list         | or blades. Valid devices are: npar(number) and  |
   | <device[,device]...> | 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.                                  |
   |                      |                                                 |
   | /reboot_list         | This argument specifies specific partitions to  |
   | <npar[,npar]...>     | reboot after the partition firmware has been    |
   |                      | updated. Valid npar values are npar(number). Do |
   |                      | not put any spaces between parameters.          |
   |                      |                                                 |
   |                      | Example: /reboot_list npar1,npar2               |
   +------------------------------------------------------------------------+

  1.1.3 Component configuration for Windows components only

   To configure components without using the HP SUM GUI, issue the command,
   hpsum_config<component_to_configure>. This command presents the same
   configuration screens seen in the HP SUM GUI. Run this command from a
   writeable media source. Configuration for a given component only needs to
   be executed one time. The configuration is stored within the component and
   is propagated to all target servers when deployed through HP SUM GUI or
   command line. To change the configuration, rerun hpsum_config against the
   component and a new configuration writes out. If a component does not need
   configuration, the hpsum_config command returns to the console.

   To configure components to be deployed on all editions of the Windows
   Server 2008 with the Server Core option, you must access the system as a
   remote host using HP SUM running on a system with a supported Windows
   operating system, and then configure the components before deployment.

  1.1.4 Command-line examples

   The following command-line parameter examples can be executed within these
   environments:

     o Firmware:

          o System ROM

          o Smart Array controller

          o Hard drives

          o iLO

     o Software-later version of:

          o HP Insight Diagnostics Online Edition for Windows Server 2003
            (cp008097.exe)

          o HP System Management Homepage for Windows (cp008257.exe)

     o HP SUM

          o Defined groups: Management Servers-Three servers (Management
            Server1, Management Server2, Management Server3)

   Example 1:

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

   hpsum /use_latest /allow_non_bundle_components /silent

   Results: All software components and firmware components from the update
   bundle, which HP SUM determined are required to be installed, were
   installed.

   Example 2:

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

     o hpsum /f:bundle /softwareonly BP000315.xml

     o hpsum /b BP000315.xml /f:bundle /softwareonly

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

   Example 3:

   This command-line input deploys firmware:

   hpsum /romonly

   Results: All firmware components, which are required to 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

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

   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 PSP,
   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 "Management Server1" /target "Management Server2"
       /target "Management Server3" /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 "Management_Server_Files"

   Results: All software components and firmware components from the update
   bundle, cp008097.exe, and cp008257.exe were installed on Management
   Server1, Management Server2, and Management Server3.

  1.1.5 Return codes

   HP SUM has consolidated return codes from Linux and Windows smart
   components into a new, 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   | 255     | occurred. For     |
   |                          |       |       |         | details, see the  |
   |                          |       |       |         | error log.        |
   |--------------------------+-------+-------+---------+-------------------|
   |                          |       |       |         | A bad input       |
   | FAILURE_BAD_PARM         | -2    | 254   | 254     | parameter was     |
   |                          |       |       |         | encountered.      |
   |--------------------------+-------+-------+---------+-------------------|
   |                          |       |       |         | The installation  |
   | FAILURE_COMPONENT_FAILED | -3    | 253   | 253     | of the component  |
   |                          |       |       |         | failed.           |
   +------------------------------------------------------------------------+

  1.1.6 Windows smart component return codes

   +------------------------------------------------------------------------+
   | Error level |                         Meaning                          |
   |-------------+----------------------------------------------------------|
   | 0           | The smart component failed to install. For more details, |
   |             | see the log file.                                        |
   |-------------+----------------------------------------------------------|
   | 1           | The smart component installed successfully.              |
   |-------------+----------------------------------------------------------|
   | 2           | The smart component 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.7 Linux smart component return codes

   Single target servers:

   +------------------------------------------------------------------------+
   | Error level |                         Meaning                          |
   |-------------+----------------------------------------------------------|
   | 0           | The smart component installed successfully.              |
   |-------------+----------------------------------------------------------|
   | 1           | The smart component 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 failed to install. For more details, |
   |             | see the log file.                                        |
   +------------------------------------------------------------------------+

   Multi-target servers:

   +------------------------------------------------------------------------+
   | Error level |                         Meaning                          |
   |-------------+----------------------------------------------------------|
   | 0           | The installation of the deliverable is successful. No    |
   |             | reboot is required.                                      |
   |-------------+----------------------------------------------------------|
   | 1           | The installation of the deliverable is 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:                                               |
   |             |                                                          |
   |             |   o The version to be installed is older than the        |
   |             |     version already installed.                           |
   |             |                                                          |
   | 3           |   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 installing to a remote target, such  |
   | 4           | as Onboard Administrator or other network-based          |
   |             | deployment, this return code indicates that the target   |
   |             | cannot be found.                                         |
   |-------------+----------------------------------------------------------|
   | 5           | The installation was canceled by a user before anything  |
   |             | could be installed.                                      |
   |-------------+----------------------------------------------------------|
   | 6           | The installer cannot execute because of an unmet         |
   |             | dependency or installation tool failure.                 |
   |-------------+----------------------------------------------------------|
   | 7           | The actual installation operation (not the installation  |
   |             | tool) failed.                                            |
   +------------------------------------------------------------------------+

  1.1.8 Linux RPM return codes

   +----------------------------------------------------------+
   | Error level |                  Meaning                   |
   |-------------+--------------------------------------------|
   | 0           | The Linux RPM installation was successful. |
   |-------------+--------------------------------------------|
   | 1           | The Linux RPM installation failed.         |
   +----------------------------------------------------------+

1.2 Input files

   HP SUM provides the ability to script the update of multiple, individual
   targets or groups of targets (HP ProLiant and Integrity server 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 [END] must match. Failure to use the SILENT=YES option causes the
   GUI mode to be used, but the information provided enables you to skip
   screens where information has already been provided. The DRYRUN=YES option
   can be used to perform dry runs of installations to ensure the scripts are
   working without deploying the firmware updates that might be required on
   each target. Remove the DRYRUN=YES option to perform the updates.

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

   [Note] Note:                                  
          The credentials can be left out of the file for greater security
          and passed on the command line to HP SUM. The only limitation of
          this is that the userID and credentials must be the same on all.

   When the file has been created, to use it with HP SUM, add it as the
   inputfile <filename> parameter to a normal 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 it is not stored in the same location as the HP SUM
   executables. The <filename> field can be enclosed in double quotes to
   enable paths with spaces. Also, the input file itself might contain the
   same flags on the command line. The usual command-line flags can still be
   used with the -inputfile flag and takes precedence over any given input
   file.

  1.2.1 Command-line usage of input file

   The form for the HP SUM command line using an input file is hpsum
   -inputfile <filename>. The input file itself can contain the same flags on
   the command line. The usual command line flags can still be used with the
   -inputfile flag, and takes precedence over any given input file. The
   <filename> field can be enclosed in double quotes to enable paths with
   spaces.

  1.2.2 Input file format and rules

   The input file is divided into two sections:

     o Configuration

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

     o Target

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

       The section starts with a special header "TARGETS" enclosed in a pair
       of square brackets:

       [TARGETS]

       Targets section ends with the special string "END" enclosed in a pair
       of brackets:

       [END]

       The keyword TARGETS can be suffixed with an optional arbitrary string.
       This 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]

          o Credentials: The TARGETS section allows the targets 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 targets in that section. If you want to use the
            current host's login credentials to log into one or more remote
            targets, you can do so by setting the variable
            USECURRENTCREDENTIAL to YES. Login credentials for one or more
            hosts can be supplied using the variables UID and PWD. If given
            at the beginning of a TARGETS section, both variables must be
            used. If given in the middle of a TARGETS section, one or the
            other can be used to override the selected variable and continue
            using the active value for the remaining variable.

          o Remote Target: A remote target can be specified using the
            variable HOST. Possible values are a DNS Name or an IP address.

  1.2.3 File encoding

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

  1.2.4 Error reporting

   If errors are encountered 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.5 Input file parameters

+-------------------------------------------------------------------------------------------------------------------+
|        Parameter        |               Description                |               Possible values                |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter causes the installation to |                                              |
|                         |run silently without GUI or console       |                                              |
|                         |output. All data is written to the log    |                                              |
|                         |file. Any generated prompts use the       |                                              |
|                         |default option and continue the           |                                              |
|                         |installation without user input.          |                                              |
|SILENT                   |                                          |YES, NO                                       |
|                         |If a component requires input before      |                                              |
|                         |installation (such as configuration       |                                              |
|                         |information), then the component          |                                              |
|                         |installation fails (unless the            |                                              |
|                         |IGNOREERRORS = "FailedDependencies"       |                                              |
|                         |parameter is supplied), and an error      |                                              |
|                         |message is written to the log file.       |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|FORCEALL                 |This parameter forces both firmware and   |YES, NO                                       |
|                         |software components.                      |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|FORCEROM                 |This parameter forces updates to firmware |YES, NO                                       |
|                         |components.                               |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|FORCESOFTWARE            |This parameter forces updates to software |YES, NO                                       |
|                         |components.                               |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to override or |                                              |
|FORCEBUNDLE              |downgrade an existing installation of     |YES, NO                                       |
|                         |components in the selected bundle.        |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to downgrade to|                                              |
|                         |an earlier version of firmware for        |                                              |
|DOWNGRADE                |multi-target devices such as hard drives  |YES, NO                                       |
|                         |and array controllers. (Applies to        |                                              |
|                         |firmware only.)                           |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to rewrite the |                                              |
|                         |same version of firmware only for         |                                              |
|REWRITE                  |multi-target devices such as hard drives  |YES, NO                                       |
|                         |and array controllers. (Applies to        |                                              |
|                         |firmware only.)                           |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|REBOOTALLOWED            |This parameter enables you to reboot, if  |YES, NO                                       |
|                         |required.                                 |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to create a    |                                              |
|REBOOTMESSAGE            |message to be displayed prior to          |Any string (not exceeding 256 characters)     |
|                         |rebooting.                                |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|REBOOTDELAY              |This parameter enables you to delay before|Time in seconds                               |
|                         |rebooting.                                |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|COMPONENTSLIST           |This parameter enables you to limit the   |Component names with file extensions (.exe,   |
|                         |list of components to be updated.         |.rpm, or .scexe)                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|BUNDLESLIST              |This parameter enables you to limit the   |Bundle file names                             |
|                         |list of bundle xml files to be filtered.  |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is a filter switch and     |                                              |
|                         |enables you to install newer versions of  |                                              |
|                         |components defined in a PSP, ISP, or      |                                              |
|                         |bundle.                                   |                                              |
|ALLOWUPDATEBUNDLE        |                                          |YES, NO                                       |
|                         |This parameter enables these components to|                                              |
|                         |replace the older versions of the same    |                                              |
|                         |component that might have shipped with the|                                              |
|                         |bundles.                                  |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter defines the behavior when a|                                              |
|                         |remote target has an existing HP SUM      |                                              |
|                         |session in progress.                      |                                              |
|                         |                                          |                                              |
|SKIPTARGET               |This parameter enables you to skip the    |YES, NO                                       |
|                         |host if an existing HP SUM session already|                                              |
|                         |exists. A NO overrides the session in     |                                              |
|                         |progress and reinitializes the            |                                              |
|                         |installation framework on the remote host.|                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter causes the installation to |                                              |
|                         |continue and ignore errors.               |                                              |
|                         |                                          |                                              |
|                         |The ServerNotFound option can be used to  |                                              |
|                         |bypass inactive or unavailable remote     |ServerNotFound, BadPassword,                  |
|IGNOREERRORS             |hosts when deploying firmware or software |FailedDependencies                            |
|                         |to multiple remote hosts at the same time.|                                              |
|                         |                                          |                                              |
|                         |FailedDependencies can be used to ignore  |                                              |
|                         |any failed dependencies and proceed with  |                                              |
|                         |the ones that are ready to be installed.  |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter can be used to provide a   |                                              |
|SOURCEPATH               |single local repository path. This creates|Directory path                                |
|                         |an inventory from the given path instead  |                                              |
|                         |of the local or default repository.       |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter 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.                         |                                              |
|USELATEST                |                                          |YES, NO                                       |
|                         |If no bundles are specified on the command|                                              |
|                         |line, and multiple bundles are in the     |                                              |
|                         |directory, then this parameter enables HP |                                              |
|                         |SUM to use the bundle with the latest     |                                              |
|                         |version for installation.                 |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|DRYRUN                   |This parameter simulates the installation |YES, NO                                       |
|                         |for a test run. Nothing is installed.     |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter can be used to specify the |                                              |
|                         |HP SUM CLI options inside the input file, |                                              |
|                         |which overrides the configuration         |                                              |
|                         |settings. Parameters can be separated by a|                                              |
|OPTIONS                  |semi-colon, comma, or a space.            |One or more CLI switch                        |
|                         |                                          |                                              |
|                         |This parameter replaces the LSPOPTIONS    |                                              |
|                         |parameter that was previously supported   |                                              |
|                         |with LDU.                                 |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter specifies that components, |                                              |
|                         |which use SNMP protocol, are available to |                                              |
|                         |be selected for installation.             |                                              |
|                         |                                          |                                              |
|USESNMP                  |These components are available for        |YES, NO                                       |
|                         |selection by default. When the /usesnmp   |                                              |
|                         |parameter is used, and the /usewmi        |                                              |
|                         |parameter is not used, the WMI components |                                              |
|                         |are optional. This parameter does not     |                                              |
|                         |apply to HP Integrity Servers.            |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter specifies that components, |                                              |
|                         |which use WMI protocol, are available to  |                                              |
|                         |be selected for installation.             |                                              |
|                         |                                          |                                              |
|                         |These components are optional by default  |                                              |
|USEWMI                   |and are not installed unless this         |YES, NO                                       |
|                         |parameter is used. When the /usewmi       |                                              |
|                         |parameter is used, and the /usesnmp       |                                              |
|                         |parameter is not used, the SNMP components|                                              |
|                         |are optional. This parameter does not     |                                              |
|                         |apply to HP Integrity Servers.            |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is a filter switch and     |                                              |
|                         |allows the user to view only the firmware |                                              |
|ROMONLY                  |components required for installation.     |YES, NO                                       |
|                         |                                          |                                              |
|                         |Do not use the /romonly parameter with the|                                              |
|                         |/softwareonly parameter.                  |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is a filter switch and     |                                              |
|                         |allows the user to view only the software |                                              |
|SOFTWAREONLY             |components required for installation.     |YES, NO                                       |
|                         |                                          |                                              |
|                         |Do not use the /softwareonly parameter    |                                              |
|                         |with the /romonly parameter.              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables the credentials of |                                              |
|                         |the local host to be used as the          |                                              |
|                         |credentials to access the targets instead |                                              |
|                         |of providing the username and password    |                                              |
|USECURRENTCREDENTIAL     |explicitly for each target.               |YES, NO                                       |
|                         |                                          |                                              |
|                         |The assumption is that the current        |                                              |
|                         |credentials are valid for the targets     |                                              |
|                         |being accessed. (Applies to Windows       |                                              |
|                         |operating systems only.)                  |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to instruct HP |                                              |
|WEBUPDATENEEDED          |SUM to include the components from the HP |YES, NO                                       |
|                         |FTP site (ftp://ftp.hp.com) in the list of|                                              |
|                         |possible updates.                         |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables the inclusion of a |String value                                  |
|USEPROXYSERVER           |proxy server (and port number) to access  |                                              |
|                         |the HP FTP site (ftp://ftp.hp.com).       |For example, 11.22.33.44:80                   |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables the inclusion of a |                                              |
|USEPROXYSCRIPT           |proxy script to access the HP FTP site    |Web URL (for example, autoproxy.com)          |
|                         |(ftp://ftp.hp.com).                       |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to instruct HP |                                              |
|DELETEINPUTFILE          |SUM to delete the input file after it has |YES, NO (default)                             |
|                         |been read in.                             |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |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 install  |                                              |
|ONFAILEDDEPENDENCY       |is attempted on it.                       |OmitHost (default), OmitComponent, Force      |
|                         |                                          |                                              |
|                         |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.                 |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |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 Onboard       |                                              |
|                         |Administrator.                            |                                              |
|                         |                                          |                                              |
|HOST                     |When two Onboard Administrators are in an |IP address, DNS name                          |
|                         |enclosure, this parameter is the active   |                                              |
|                         |Onboard Administrator. When specifying 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.     |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|UID                      |This parameter enables you to log in to   |<username>                                    |
|                         |the target hosts with your user ID.       |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to use the     |                                              |
|                         |password for the user ID specified in the |                                              |
|PWD                      |UID.                                      |<password>                                    |
|                         |                                          |                                              |
|                         |The password is used to log in to target  |                                              |
|                         |hosts.                                    |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This argument enables you to redirect the |                                              |
|                         |output from HP SUM or the HP BladeSystem  |                                              |
|                         |c-Class Onboard Administrator flash       |                                              |
|                         |utility to a different directory than the |                                              |
|                         |default location.                         |                                              |
|                         |                                          |                                              |
|                         |* For Windows components, the default     |                                              |
|LOGFILENAME = "path"     |location is                               |Log file name                                 |
|                         |%SYSTEMDRIVE%\CPQSYSTEM\hp\log<netAddress>|                                              |
|                         |and the redirected location is            |                                              |
|                         |<path>\hp\log\<netAddress>                |                                              |
|                         |                                          |                                              |
|                         |* For Linux components, the default       |                                              |
|                         |location is /var/hp/log/<netAddress> and  |                                              |
|                         |the redirected location is                |                                              |
|                         |<path>/hp/log/<netAddress>.               |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify an  |                                              |
|CMALOCALHOSTRWCOMMSTR    |SNMP read/write community string for local|SNMP read/write community string              |
|                         |host access. (Applies to Linux PSP only.) |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify an  |                                              |
|CMALOCALHOSTROCOMMSTR    |SNMP read-only community string for local |SNMP read-only community string               |
|                         |host access. (Applies to Linux PSP only.) |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify the |                                              |
|                         |IP address or DNS host name of a system   |                                              |
|CMAMGMTSTATIONRWIPORDNS  |with read/write access to serve as a      |IP address, DNS name                          |
|                         |management station. You can specify       |                                              |
|                         |multiple locations separated by a space.  |                                              |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify an  |                                              |
|                         |SNMP read/write community string for a    |                                              |
|CMAMGMTSTATIONRWCOMMSTR  |system with read/write access that serves |SNMP read/write community string              |
|                         |as a management station. You can specify  |                                              |
|                         |multiple strings separated by a space.    |                                              |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify the |                                              |
|                         |IP address or DNS host name of a system   |                                              |
|CMAMGMTSTATIONROIPORDNS  |with read-only access to serve as a       |IP address, DNS name                          |
|                         |management station. You can specify       |                                              |
|                         |multiple locations separated by a space.  |                                              |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify an  |                                              |
|                         |SNMP read/write community string for a    |                                              |
|CMAMGMTSTATIONROCOMMSTR  |system with read-only access that serves  |SNMP read/write community string              |
|                         |as a management station. You can specify  |                                              |
|                         |multiple strings separated by a space.    |                                              |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to set a       |                                              |
|CMADEFTRAPCOMMSTR        |default SNMP community string for traps.  |SNMP community string                         |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify the |                                              |
|CMATRAPDESTINATIONCOMMSTR|SNMP destination trap community string.   |SNMP trap destination                         |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify the |                                              |
|                         |IP address or DNS host name of a server as|                                              |
|CMATRAPDESTINATIONIPORDNS|a destination for SNMP traps, such as     |IP address, DNS name                          |
|                         |Systems Insight Manager. (Applies to Linux|                                              |
|                         |PSP only.)                                |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to specify a   |                                              |
|CMASYSCONTACT            |person or phone number for administration |String value                                  |
|                         |of this system. (Applies to Linux PSP     |                                              |
|                         |only.)                                    |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables you to designate   |                                              |
|CMASYSLOCATION           |the location of this system. (Applies to  |String value                                  |
|                         |Linux PSP only.)                          |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter determines whether the HP  |  o YES (start the web agent)                 |
|CMASTARTWEBAGENT         |Insight Systems Manager Web Agent is      |                                              |
|                         |started when the health application loads.|  o NO (do not start the web agent)           |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter determines whether the HP  |  o YES (start the storage agent)             |
|CMASTARTSTORAGEAGENT     |Insight Systems Manager Storage Agent is  |                                              |
|                         |started when the health application loads.|  o NO (do not start the storage agent)       |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter determines whether the HP  |  o YES (start the web agent)                 |
|CMASTARTNICAGENT         |Insight Systems Manager NIC agent is      |                                              |
|                         |started. (Applies to Linux PSP only).     |  o NO (do not start the web agent)           |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter determines whether the HP  |  o YES (start the HP Lights-Out management   |
|                         |Lights-Out management driver is started   |    driver)                                   |
|CMANOTAINTEDKERNEL       |when the health application loads.        |                                              |
|                         |(Applies to Linux PSP only.)              |  o NO (do not start the HP Lights-Out        |
|                         |                                          |    management driver)                        |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter informs the VCA of the name|                                              |
|HPVCAVCRMSERVER          |of the VCRM to use as a software          |VCRM name                                     |
|                         |distribution repository. (Applies to Linux|                                              |
|                         |PSP only.)                                |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is the login ID that the   |                                              |
|HPVCAVCRMLOGINID         |VCA uses to communicate with the VCRM.    |VCA login ID                                  |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is the password for the    |                                              |
|HPVCAVCRMLOGINPASSWD     |login ID specified in the HPVCAVCRMLOGIN  |VCA login password                            |
|                         |parameter. (Applies to Linux PSP only.)   |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |                                              |
|FORCE-OVERWRITE          |Management Homepage (hpsmh) to force      |YES, NO (default)                             |
|                         |overwrite the SMH settings of an existing |                                              |
|                         |configuration file.                       |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |Up to five Linux groups, separated by spaces  |
|ADMIN-GROUP              |Management Homepage (hpsmh) to set up     |or semicolons, to enable administrative access|
|                         |security for the web server. (Applies to  |to the web services.                          |
|                         |Linux PSP only.)                          |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |Up to five Linux groups, separated by spaces  |
|USER-GROUP               |Management Homepage to set up security for|or semicolons, to enable user-level access to |
|                         |the web server. (Applies to Linux PSP     |the web servers.                              |
|                         |only.)                                    |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |Up to five Linux groups, separated by spaces  |
|OPERATOR-GROUP           |Management Homepage to set up security for|or semicolons, to enable operator-level access|
|                         |the web server. (Applies to Linux PSP     |to the web servers.                           |
|                         |only.)                                    |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter determines whether an      |                                              |
|ANONYMOUS-ACCESS         |anonymous user can access the HP Systems  |YES, NO (default)                             |
|                         |Management Homepage. (Applies to Linux PSP|                                              |
|                         |only.)                                    |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |                                              |
|                         |Management Homepage to determine whether  |                                              |
|IP-BINDING               |hpsmh can use all available NICs and      |YES, NO (default)                             |
|                         |detect subnets for its web services.      |                                              |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |                                              |
|                         |Management Homepage to restrict the NICs  |                                              |
|                         |and subnets to use for its web servers.   |IP address/NetMask pairs separated by         |
|IP-BINDING-LIST          |                                          |semicolons (for example,                      |
|                         |The IP-BINDING parameter must be set to   |10.1.1.1/255.255.255.0;10.2.2.2/255.255.255.0)|
|                         |yes for this parameter to be used during  |                                              |
|                         |installation. (Applies to Linux PSP only.)|                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |                                          |YES, NO (default)                             |
|                         |                                          |                                              |
|                         |This parameter is used by the HP Systems  |To enable restrictions on who can log in to   |
|IP-RESTRICTED-LOGINS     |Management Homepage to restrict login     |the web server, this parameter must be set to |
|                         |access. (Applies to Linux PSP only.)      |yes, and values must be provided to the       |
|                         |                                          |IP-RESTRICTED-EXCLUDE or IP-RESTRICTED-INCLUDE|
|                         |                                          |parameters.                                   |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |                                              |
|                         |Management Homepage to exclude specific IP|                                              |
|                         |address/NetMask pairs from logging into   |                                              |
|                         |the web services. (Applies to Linux PSP   |List of IP address ranges separated by        |
|IP-RESTRICTED-EXCLUDE    |only.)                                    |semicolons (for example,                      |
|                         |                                          |10.1.1.1-10.1.1.10;10.2.2.2-10.2.2.10)        |
|                         |This parameter is ignored unless the      |                                              |
|                         |IP-RESTRICTED-LOGINS parameter is set to  |                                              |
|                         |yes.                                      |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |                                              |
|                         |Management Homepage to enable login only  |                                              |
|                         |from the IP address/NetMask pairs         |List of IP address ranges separated by        |
|IP-RESTRICTED-INCLUDE    |specified. (Applies to Linux PSP only.)   |semicolons (for example,                      |
|                         |                                          |10.1.1.1-10.1.1.10;10.2.2.2-10.2.2.10)        |
|                         |This parameter is ignored unless the      |                                              |
|                         |IP-RESTRICTED-LOGINS parameter is set to  |                                              |
|                         |yes.                                      |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the HP Systems  |  o YES (default to include anonymous access) |
|LOCALACCESS-ENABLED      |Management Homepage to determine whether  |                                              |
|                         |to enable local anonymous access to the   |  o NO                                        |
|                         |web services. (Applies to Linux PSP only.)|                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |                                          |  o Anonymous (default)                       |
|                         |                                          |                                              |
|                         |This parameter is used by the HP Systems  |  o Administrator                             |
|                         |Management Homepage to determine the type |                                              |
|LOCALACCESS-TYPE         |of access granted to local users. (Applies|    CAUTION: Selecting local access with      |
|                         |to Linux PSP only.)                       |    administrator privileges as the login     |
|                         |                                          |    provides full access to any user with     |
|                         |                                          |    access to the local console, without      |
|                         |                                          |    prompting for a user name or password.    |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |                                          |  o TrustByCert-If this value is used, the    |
|                         |                                          |    CERTLIST parameter must be defined to     |
|                         |                                          |    enable access to the server.              |
|                         |                                          |                                              |
|                         |                                          |  o TrustByName-If this value is used, the    |
|                         |                                          |    XENAMELIST parameter must be defined.     |
|                         |                                          |                                              |
|                         |                                          |  o TrustByAll-HP does not recommend using    |
|                         |This parameter is used by the HP Systems  |    this value because of possible negative   |
|TRUSTMODE                |Management Homepage to set up the trust   |    security consequences.                    |
|                         |relationship mode. (Applies to Linux PSP  |                                              |
|                         |only.)                                    |    [Caution] 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.                         |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables a user to provide a|                                              |
|                         |list of certificate files or servers where|                                              |
|CERTLIST                 |certificates can be obtained for trust    |Certificate file name or Server DNS name      |
|                         |relationships for the HP Systems          |                                              |
|                         |Management Homepage. (Applies to Linux PSP|                                              |
|                         |only.)                                    |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter enables a user to provide a|                                              |
|                         |list of servers, separated by semicolons, |                                              |
|                         |for trust relationships for the HP Systems|                                              |
|                         |Management Homepage. (Applies to Linux PSP|                                              |
|XENAMELIST               |only.)                                    |Server DNS name                               |
|                         |                                          |                                              |
|                         |This parameter is only valid if the       |                                              |
|                         |TRUSTMODE parameter is set to TrustByName.|                                              |
|                         |(Applies to Linux PSP only.)              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |                                          |  o SinglePath                                |
|                         |This parameter is used by the hp_qla2x00  |                                              |
|                         |QLogic Fibre Channel Driver to determine  |  o SecurePath                                |
|HPQLA2X00FO              |the failover mode to use. (Applies to     |                                              |
|                         |Linux PSP only.)                          |  o QLogicFailure                             |
|                         |                                          |                                              |
|                         |                                          |    (No default value)                        |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter is used by the hp_qla2x00  |                                              |
|HPQLA2X00FORCE           |QLogic Fibre Channel Driver to determine  |"Y", "N" (default)                            |
|                         |whether to skip detection of third-party  |                                              |
|                         |storage. (Applies to Linux PSP only.)     |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter provides the username      |                                              |
|                         |credentials for OA associated with VC. You|                                              |
|                         |must define a value of these variables    |                                              |
|OAUID                    |before HOST variable in [TARGETS] section.|User can define OAUID variable multiple times |
|                         |This parameter only applies for VC        |before each HOST variable.                    |
|                         |firmware.                                 |                                              |
|                         |                                          |                                              |
|                         |You can also use OAUSER or OAUSERNAME.    |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This parameter provides the password      |                                              |
|                         |credentials for OA associated with VC. You|                                              |
|                         |must define a value of these variables    |                                              |
|OAPWD                    |before HOST variable in [TARGETS] section.|User can define OAPWD variable multiple times |
|                         |This parameter only applies for VC        |before each HOST variable.                    |
|                         |firmware.                                 |                                              |
|                         |                                          |                                              |
|                         |You can also use OAPASSWORD.              |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |This argument allows the installation to  |YES, NO                                       |
|IGNOREWARNINGS           |proceed on a Superdome 2 target even when |                                              |
|                         |warnings are returned during analysis.    |[Note] Note:                                  |
|                         |                                          |       Superdome 2 servers only               |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |                                          |ALL, COMPLEX, PARTITIONS                      |
|UPDATETYPE               |This argument determines which Superdome 2|                                              |
|                         |firmware is updated.                      |[Note] Note:                                  |
|                         |                                          |       Superdome 2 servers only               |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |Use this argument when the                |                                              |
|                         |UPDATETYPE=PARTITIONS. This argument      |For example: DEVICELIST = npar1, blade1/1     |
|DEVICELIST               |specifies the subset of partitions or     |                                              |
|                         |blades to update when you do not want to  |[Note] Note:                                  |
|                         |update all partitions. Valid devices are: |       Superdome 2 servers only               |
|                         |npar(number) and blade(enc)/(bay).        |                                              |
|-------------------------+------------------------------------------+----------------------------------------------|
|                         |Use this argument when the UPDATETYPE= ALL|                                              |
|                         |or UPDATETYPE= PARTITIONS. This argument  |For example: REBOOTLIST = npar1, npar2        |
|REBOOTLIST               |specifies specific partitions to reboot   |                                              |
|                         |after the partition firmware has been     |[Note] Note:                                  |
|                         |updated. Valid npar values are            |       Superdome 2 servers only               |
|                         |npar(number).                             |                                              |
+-------------------------------------------------------------------------------------------------------------------+

   Examples of the HP SUM input file include:

   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 targets are passed to be updated. The targets do not
   necessarily have to be OAs. They can be any target supported by HP SUM.

   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]

1.3 Reports

   HP SUM generates three types of reports about the specified system or
   repository. These reports are generated using the command-line arguments
   provided. If no additional arguments are specified on the command line,
   the local host and default repository locations (the directory where HP
   SUM was initiated) are used. You can specify a target with appropriate
   credentials and a repository using other command-line parameters to
   generate reports for other systems and repositories. For specific
   commands, see "Command-line interface".

   +--------------------------------------------------------------------------+
   |   Report type   |   Description   |       Report file information*       |
   |-----------------+-----------------+--------------------------------------|
   |                 |This argument    |                                      |
   |                 |generates a      |                                      |
   |                 |report listing, a|                                      |
   |                 |target summary,  |                                      |
   |                 |and how the      |                                      |
   |                 |components in the|The report files generated are:       |
   |                 |repository affect|                                      |
   |/report          |the target. For  |  o hpsum_Report_<date>.html          |
   |                 |example, whether |                                      |
   |                 |each component   |  o hpsum_Report_<date>.xml           |
   |                 |applies to the   |                                      |
   |                 |target.          |                                      |
   |                 |                 |                                      |
   |                 |Usage: hpsum     |                                      |
   |                 |/report          |                                      |
   |-----------------+-----------------+--------------------------------------|
   |                 |This argument    |                                      |
   |                 |generates a      |                                      |
   |                 |report listing of|The report files generated are:       |
   |                 |the components in|                                      |
   |/inventory_report|the specified    |  o hpsum_Inventory_Report_<date>.html|
   |                 |repository.      |                                      |
   |                 |                 |  o hpsum_Inventory_Report_<date>.xml |
   |                 |Usage: hpsum     |                                      |
   |                 |/inventory_report|                                      |
   |-----------------+-----------------+--------------------------------------|
   |                 |This argument    |                                      |
   |                 |generates a      |The report files generated are:       |
   |                 |report listing of|                                      |
   |                 |the firmware in  |  o hpsum_Report_<date>.html          |
   |/firmware_report |the specified    |                                      |
   |                 |repository.      |  o fwreport.xml is placed in a folder|
   |                 |                 |    named HPSUM_Firmware_Report_<date>|
   |                 |Usage: hpsum     |                                      |
   |                 |/firmware_report |                                      |
   +--------------------------------------------------------------------------+

   The reports are generated as an XML and HTML file which can be viewed in a
   JavaScript-enabled web browser. The supported browsers for viewing the
   report files are Microsoft Internet Explorer 6.0 and Mozilla Firefox 3.5
   and above. 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.

   The HP SUM log files are located in these folders:

     o On Windows operating systems: C:\cpqsystem\hp\log

     o On Linux operating systems: /var/hp/log

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