﻿                        HP Smart Update Manager CLI Help

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

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

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

Chapter 1 Running commands outside the GUI

   HP SUM provides three ways to run system commands outside the GUI. These
   include CLI, CLI with Input Files, and interactive CLI. The HP SUM CLI
   allows you to add all parameters in one command line, and then use the
   silent switch to execute the entire sequence on multiple nodes without any
   user interaction. This method requires the use of the silent switch and
   requires no user interaction. You can update one or more nodes using this
   method.

   Using the HP SUM CLI with Input Files allows you to add all parameters to
   a text file, and then call HP SUM using the inputfile command with the
   text filename as the parameter. This method requires the use of the silent
   switch and requires no user interaction. Using the input file method
   allows you to provide a larger number of nodes to update.

   The HP SUM iCLI provides an interactive method for each step of a process.
   You can run each command individually to add a baseline, add a node, start
   inventory, and so on. This method is similar to using the GUI but you
   provide individual commands instead. HP SUM iCLI takes a single command at
   a time. Using this method allows you to have nodes a different stages of
   update. For example, you can have one node in the inventory phase, one
   node in the deployment phase, and another node that you are just adding.

   The HP SUM binary executable maintains state information as needed on a
   per-session basis. HP SUM saves this information in the hpsum.ini file.
   This file is in the %tmp%\HPSUM\ location in Windows and /tmp/HPSUM/ in
   Linux. HP SUM stores the user, session ID, host, and port information.
   This information enables you to log in and run HP SUM using different
   credentials.

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

1.1 Scheduling CLI or input file updates

   You can use standard operating system tools to schedule HP SUM to run an
   input file or CLI command. On a Windows system, use the Task Scheduler
   application and on a Linux system you can use the cron function. When you
   create the scheduled tasks, be sure to include hpsum /s <commands> on a
   Windows system, or hpsum --s <commands> on a Linux system.

   See the documentation for these applications for more information.

1.2 Using the command line interface (CLI) to deploy updates

   The HP SUM CLI allows you to add all parameters in one command line, and
   requires use of the silent switch to execute the entire sequence on
   multiple nodes without any user interaction.

  1.2.1 Command-line syntax

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

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

   On Windows, use a slash before each argument. On Linux, use a two hyphens
   before each argument. For example:

   hpsum /s /h (Windows)

   hpsum --s --h (Linux)

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

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

      ---------------------------------------------------------------------   
    IMPORTANT: Command-line syntax does not support double-byte character     
    sets. Any messages entered through the command line using a double-byte   
    character set do not display correctly.                                   
      ---------------------------------------------------------------------   

    1.2.1.1 Switch update commands

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

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

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

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

  1.2.2 Command-line arguments

   HP SUM recognizes the command-line arguments listed in the table below.
   You cannot use some arguments, such as --romonly and --softwareonly,
   together.

    1.2.2.1 Help commands

   You can view the help for the CLI by typing hpsum --s --h.

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

    1.2.2.2 Installation commands

   The following table lists attributes you can use while installing updates.

   +------------------------------------------------------------------------+
   |       Installation options        |            Description             |
   |-----------------------------------+------------------------------------|
   |--f[orce] (Linux)                  |Overrides or downgrades an existing |
   |                                   |component installation. This        |
   |/f[orce] (Windows)                 |produces the same results as        |
   |                                   |f:software.                         |
   |-----------------------------------+------------------------------------|
   |--f[orce]:bundle (Linux)           |Overrides or downgrades the existing|
   |                                   |installation of components in the   |
   |/f[orce]:bundle (Windows)          |selected bundle.                    |
   |-----------------------------------+------------------------------------|
   |--f[orce]:rom (Linux)              |Overrides or downgrades the existing|
   |                                   |installation of the selected        |
   |/f[orce]:rom (Windows)             |firmware components (applies to     |
   |                                   |firmware only).                     |
   |-----------------------------------+------------------------------------|
   |--f[orce]:software (Linux)         |Overrides or downgrades the existing|
   |                                   |installation of the selected        |
   |/f[orce]:software (Windows)        |software components.                |
   |-----------------------------------+------------------------------------|
   |--f[orce]:all (Linux)              |Overrides or downgrades the existing|
   |                                   |installation of the selected        |
   |/f[orce]:all (Windows)             |software components, firmware       |
   |                                   |components, and bundles.            |
   |-----------------------------------+------------------------------------|
   |                                   |Selects components for installation |
   |--g or --downgrade (Linux)         |that have an available version below|
   |                                   |the currently installed             |
   |/g or /downgrade (Windows)         |version. This is in addition to     |
   |                                   |upgrades.  Can be combined with     |
   |                                   |rewrite.                            |
   |-----------------------------------+------------------------------------|
   |                                   |Selects components for installation |
   |--e or --rewrite (Linux)           |that have an available version below|
   |                                   |the same as the installed           |
   |/e or /rewrite (Windows)           |version. This is in addition to     |
   |                                   |upgrades.  Can be combined with     |
   |                                   |downgrade.                          |
   |-----------------------------------+------------------------------------|
   |                                   |Limits components considered for    |
   |                                   |installation to only firmware       |
   |--romonly (Linux)                  |components. Cannot be used with     |
   |                                   |softwareonly. If neither            |
   |/romonly (Windows)                 |softwareonly or romonly are used,   |
   |                                   |all components are considered for   |
   |                                   |possible installation.              |
   |-----------------------------------+------------------------------------|
   |                                   |Limits components considered for    |
   |--softwareonly (Linux)             |installation to only software       |
   |                                   |components. Cannot be used with     |
   |/softwareonly (Windows)            |romonly. If neither softwareonly or |
   |                                   |romonly are used, all components are|
   |                                   |considered for installation.        |
   |-----------------------------------+------------------------------------|
   |--port <n> (Linux)                 |Changes the port HP SUM uses for the|
   |                                   |internal HTTP server from 63001 to  |
   |/port <n> (Windows)                |the selected port.                  |
   |-----------------------------------+------------------------------------|
   |--ssl_port <n> (Linux)             |Changes the port HP SUM uses for the|
   |                                   |internal HTTPS server from 63002 to |
   |/ssl_port <n> (Windows)            |the selected port.                  |
   |-----------------------------------+------------------------------------|
   |                                   |Allows HP SUM to open the HTTP and  |
   |                                   |HTTPS ports used by HP SUM for      |
   |                                   |external access. Also used to open  |
   |                                   |the ports for remote node           |
   |--open_firewall (Linux)            |functionality and for remote browser|
   |                                   |access.                             |
   |/open_firewall (Windows)           |                                    |
   |                                   |HP SUM deploys updates to nodes even|
   |                                   |when ip_tables include DROP         |
   |                                   |commands. Use open_firewall to      |
   |                                   |bypass the DROP rules.              |
   |-----------------------------------+------------------------------------|
   |                                   |Causes the installation to run      |
   |                                   |silently with no GUI or interactive |
   |                                   |CLI output. All data writes to the  |
   |                                   |log file. Do not use the            |
   |--s[ilent] (Linux)                 |express_install parameter with the  |
   |                                   |silent parameter.                   |
   |/s[ilent] (Windows)                |                                    |
   |                                   |   -------------------------------  |
   |                                   | IMPORTANT: HP SUM requires the     |
   |                                   | silent parameter for CLI commands. |
   |                                   |   -------------------------------  |
   |-----------------------------------+------------------------------------|
   |                                   |Specifies which components to       |
   |                                   |install. You can specify components |
   |                                   |to install with or without the      |
   |                                   |c[omponent] argument.               |
   |                                   |                                    |
   |                                   |If you use the c[omponent] argument,|
   |                                   |you can specify only one component. |
   |                                   |per argument, but you can specify   |
   |                                   |multiple c arguments with individual|
   |                                   |components on the same command line.|
   |                                   |                                    |
   |                                   |If you do not use the --c[omponent] |
   |                                   |argument, you can specify multiple  |
   |                                   |components separated by a blank     |
   |                                   |space, and listed after all other   |
   |                                   |arguments on the command line.      |
   |                                   |                                    |
   |                                   |The utility installs components in  |
   |--c[omponent]<component_to_install>|the order provided unless           |
   |or <component1_to_install>         |dependencies between components     |
   |<component2_to_install> (Linux)    |require installation in a different |
   |                                   |order. If so, the utility changes   |
   |/c[omponent]<component_to_install> |the installation order based on the |
   |or <component1_to_install>         |component dependencies to ensure the|
   |<component2_to_install> (Windows)  |successful installation of as many  |
   |                                   |components as possible.             |
   |                                   |                                    |
   |                                   |You can specify multiple components |
   |                                   |(see                                |
   |                                   |--c[omponent]<component_to_install>)|
   |                                   |and bundles on the same command     |
   |                                   |line. When you mix components and   |
   |                                   |bundles on the command line, the    |
   |                                   |filter switches control what        |
   |                                   |components and bundles are          |
   |                                   |installed.                          |
   |                                   |                                    |
   |                                   |HP SUM only uses the component name.|
   |                                   |If you type the entire directory    |
   |                                   |path, HP SUM ignores the path. If   |
   |                                   |you use --use_location and c, HP SUM|
   |                                   |checks both the default repository  |
   |                                   |and the directory provided.         |
   |-----------------------------------+------------------------------------|
   |--group "group_name" (Linux)       |This argument specifies an already  |
   |                                   |defined group name in the HP SUM    |
   |/group "group_name" (Windows)      |GUI.                                |
   |-----------------------------------+------------------------------------|
   |                                   |This argument specifies bundles to  |
   |                                   |install. You can specify bundles to |
   |                                   |install with or without the b[undle]|
   |                                   |argument.                           |
   |                                   |                                    |
   |--b[undle] <bundlename> (Linux)    |You can specify multiple components |
   |                                   |and bundles (see b[undle]           |
   |/b[undle] <bundlename> (Windows)   |<bundlename>) on the same command   |
   |                                   |line. When you mix components and   |
   |                                   |bundles on the command line, the    |
   |                                   |filter switches control which       |
   |                                   |components and bundles are          |
   |                                   |installed.                          |
   |-----------------------------------+------------------------------------|
   |                                   |This argument is a filter switch.   |
   |                                   |Installs newer versions of          |
   |                                   |components defined in a PSP, ISP, or|
   |--allow_update_to_bundle (Linux)   |firmware bundle, and replaces the   |
   |                                   |older versions of the same component|
   |/allow_update_to_bundle (Windows)  |that might have shipped with the    |
   |                                   |bundles.                            |
   |                                   |                                    |
   |                                   |Defaults to TRUE.                   |
   |-----------------------------------+------------------------------------|
   |                                   |This argument is a filter switch.   |
   |--allow_non_bundle_components      |Installs components that are not    |
   |(Linux)                            |included in the bundle but reside in|
   |                                   |the directory with the components in|
   |/allow_non_bundle_components       |the bundle.                         |
   |(Windows)                          |                                    |
   |                                   |Defaults to TRUE.                   |
   |-----------------------------------+------------------------------------|
   |                                   |This argument is a filter switch for|
   |                                   |use with bundles. Uses the latest   |
   |                                   |version of the bundle when you list |
   |--use_latest (Linux)               |multiple versions of bundles on the |
   |                                   |command line. When using this       |
   |/use_latest (Windows)              |command with no bundles specified,  |
   |                                   |and multiple bundles in the         |
   |                                   |directory, HP SUM installs the      |
   |                                   |latest available version of the     |
   |                                   |bundle.                             |
   |-----------------------------------+------------------------------------|
   |                                   |Specifies a directory or file share |
   |                                   |that contains the SPP, HP Integrity |
   |                                   |Smart Update Firmware Bundles, and  |
   |                                   |components for use with HP SUM. HP  |
   |                                   |SUM expects that the targeted       |
   |                                   |file_share is a mapped file share or|
   |                                   |UNC format.                         |
   |                                   |                                    |
   |--use_location "file_share" (Linux)|Without this argument, HP SUM       |
   |                                   |defaults to the directory that      |
   |/use_location "file_share"         |contains hpsum.exe or HP SUM.       |
   |(Windows)                          |                                    |
   |                                   |Make sure the logged-in account has |
   |                                   |access to this location. If the     |
   |                                   |location is a UNC file share, you   |
   |                                   |must provide credentials to the file|
   |                                   |share using the unc_username and    |
   |                                   |unc_password. If you do not provide |
   |                                   |these credentials, HP SUM uses the  |
   |                                   |current credentials to access the   |
   |                                   |share.                              |
   |-----------------------------------+------------------------------------|
   |                                   |This specifies directory that       |
   |--import_configuration             |contains component configuration    |
   |<directory_path> (Linux)           |settings for components in the      |
   |                                   |specified baseline. Imported        |
   |/import_configuration              |component configurations override   |
   |<directory_path> (Windows)         |components configurations in the    |
   |                                   |baseline.                           |
   |-----------------------------------+------------------------------------|
   |--export_configuration             |This specifies directory where HP   |
   |<directory_path> (Linux)           |SUM saves the component             |
   |                                   |configuration settings for          |
   |/export_configuration              |components in the specified         |
   |<directory_path> (Windows)         |baseline.                           |
   |-----------------------------------+------------------------------------|
   |--unc_username (Linux)             |Username credentials for accessing  |
   |                                   |the file share.                     |
   |/unc_username (Windows)            |                                    |
   |-----------------------------------+------------------------------------|
   |--unc_password (Linux)             |Password credentials for accessing  |
   |                                   |the file share.                     |
   |/unc_password (Windows)            |                                    |
   |-----------------------------------+------------------------------------|
   |                                   |Indicates that management components|
   |--no_mgmt (Linux)                  |for AMS, SNMP, and WBEM Providers   |
   |                                   |are optional on the Components      |
   |/no_mgmt (Windows)                 |Selection screen. In silent mode, HP|
   |                                   |SUM does not update any management  |
   |                                   |components.                         |
   |-----------------------------------+------------------------------------|
   |                                   |Specifies that components using the |
   |                                   |SNMP protocol and the AMS components|
   |--use_snmp (Linux)                 |are available for installation by   |
   |                                   |default. Using the --use_snmp       |
   |/use_snmp (Windows)                |argument means that the AMS         |
   |                                   |components are required, but the WMI|
   |                                   |components are optional.            |
   |-----------------------------------+------------------------------------|
   |                                   |Specifies that components using the |
   |                                   |WMI protocol are available for      |
   |                                   |installation. These components are  |
   |                                   |optional and are not installed      |
   |--use_wmi (Linux)                  |unless you use this argument. When  |
   |                                   |you use the use_wmi argument without|
   |/use_wmi (Windows)                 |using the use_snmp and use_ams      |
   |                                   |arguments, the SNMP and AMS         |
   |                                   |components are optional. This       |
   |                                   |argument does not apply to HP       |
   |                                   |Integrity servers.                  |
   |-----------------------------------+------------------------------------|
   |                                   |Specifies which AMS components to   |
   |                                   |install along with SNMP components. |
   |--use_ams (Linux)                  |Default selections include AMS and  |
   |                                   |SNMP components. Using the --use_ams|
   |/use_ams (Windows)                 |argument means that the SNMP        |
   |                                   |components are required, and the WMI|
   |                                   |components are optional.            |
   |-----------------------------------+------------------------------------|
   |--express_install (Linux)          |Do not use the silent parameter when|
   |                                   |you use express_install.            |
   |/express_install (Windows)         |                                    |
   +------------------------------------------------------------------------+

    1.2.2.3 Override error commands

   The following table lists attributes you can use to override errors HP SUM
   encounters.

   +------------------------------------------------------------------------+
   |           Overriding errors            |          Description          |
   |----------------------------------------+-------------------------------|
   |                                        | If you have enabled TPM, you  |
   |                                        | can ignore the warning        |
   | --tpmbypass or --ignore_tpm (Linux)    | message and continue with     |
   |                                        | component installation. For   |
   | /tpmbypass or /ignore_tpm (Windows)    | more information about TPM,   |
   |                                        | see the HP Smart Update       |
   |                                        | Manager User Guide.           |
   |----------------------------------------+-------------------------------|
   |                                        | Allows the installation to    |
   |                                        | proceed on a Linux or HP-UX   |
   |                                        | node that is an active member |
   |                                        | of a Serviceguard cluster. If |
   |                                        | you do not specify this       |
   |                                        | option and the node is an     |
   |                                        | active member of a            |
   |                                        | Serviceguard cluster, the     |
   |                                        | node does not enter the       |
   |                                        | installation or deploy        |
   | --ignore_warnings (Linux)              | phases.                       |
   |                                        |                               |
   | /ignore_warnings (Windows)             | Allows installation to        |
   |                                        | proceed after HP SUM receives |
   |                                        | warnings on nodes. Some       |
   |                                        | warnings include:             |
   |                                        |                               |
   |                                        | Active member of a            |
   |                                        | Serviceguard cluster          |
   |                                        |                               |
   |                                        | HP-UX boot disk               |
   |                                        |                               |
   |                                        | Superdome 2/X OA              |
   |----------------------------------------+-------------------------------|
   |                                        | Causes the installation to    |
   |                                        | continue and ignore errors.   |
   |                                        | Valid values are as follows:  |
   |                                        |                               |
   |                                        | * <error>=ServerNotFound and  |
   |                                        |                               |
   |                                        | * <error>=BadPassword.        |
   |                                        |                               |
   |                                        | * <error>=FailedDependencies  |
   |                                        |                               |
   |                                        | Use the ServerNotFound option |
   |                                        | to bypass inactive or         |
   |                                        | unavailable remote hosts when |
   |                                        | you deploy firmware or        |
   | --continue_on_error <error> (Linux)    | software to multiple remote   |
   |                                        | hosts at the same time.       |
   | /continue_on_error <error> (Windows)   |                               |
   |                                        | Use the BadPassword option to |
   |                                        | bypass remote nodes that      |
   |                                        | report incorrect credentials  |
   |                                        | provided and continue with    |
   |                                        | other nodes. Use the          |
   |                                        | FailedDependencies option to  |
   |                                        | bypass remote nodes with      |
   |                                        | failed dependencies and       |
   |                                        | continue with other nodes     |
   |                                        | that are ready to be          |
   |                                        | installed. This can be        |
   |                                        | overridden by using           |
   |                                        | on_failed_dependency:Force or |
   |                                        | :OmitComponent.               |
   |----------------------------------------+-------------------------------|
   |                                        | Defines the behavior when a   |
   | --override_existing_connection (Linux) | remote node has an existing   |
   |                                        | HP SUM session in progress.   |
   | /override_existing_connection          | Overrides the session in      |
   | (Windows)                              | progress and re-initializes   |
   |                                        | the installation framework on |
   |                                        | the remote host.              |
   |----------------------------------------+-------------------------------|
   |                                        | The default is OmitHost. This |
   | --on_failed_dependency (Linux)         | parameter puts the host into  |
   |                                        | a failure state, and HP SUM   |
   | /on_failed_dependency (Windows)        | does not attempt an           |
   |                                        | installation.                 |
   |----------------------------------------+-------------------------------|
   | --on_failed_dependency:OmitHost        |                               |
   | (Linux)                                | Puts the host into a failure  |
   |                                        | state, and no installation is |
   | /on_failed_dependency:OmitHost         | attempted.                    |
   | (Windows)                              |                               |
   |----------------------------------------+-------------------------------|
   | --on_failed_dependency:OmitComponent   | Deselects the affected        |
   | (Linux)                                | components and proceeds with  |
   |                                        | any updates that do not have  |
   | /on_failed_dependency:OmitComponent    | dependency failures.          |
   | (Windows)                              |                               |
   |----------------------------------------+-------------------------------|
   | --on_failed_dependency:Force (Linux)   | Attempts all updates, even    |
   |                                        | with dependency failures.     |
   | /on_failed_dependency:Force (Windows)  |                               |
   +------------------------------------------------------------------------+

    1.2.2.4 Reboot commands

   The following table lists attributes you can use for rebooting the nodes.

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

    1.2.2.5 Test run commands

   Use this attribute along with other attributes in order to have HP SUM run
   through all processes in the command, except the actual deployment. Use
   this to verify connections and configurations for remote nodes and to see
   what HP SUM will update.

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

    1.2.2.6 Node commands

   The following table lists attributes for nodes you update. These
   attributes are related to each node, and can be used multiple times in a
   CLI command.

   +------------------------------------------------------------------------+
   |           Nodes           |                Description                 |
   |---------------------------+--------------------------------------------|
   | --user<username> or       |                                            |
   | --username <username>     | Use this argument to log in to the remote  |
   | (Linux)                   | nodes with the user ID.                    |
   |                           |                                            |
   | /user<username> or        | Make sure the user name belongs to the     |
   | /username <username>      | root or administrator group.               |
   | (Windows)                 |                                            |
   |---------------------------+--------------------------------------------|
   | --password <password>     |                                            |
   | (Linux)                   | Password for the user ID specified in the  |
   |                           | user parameter (except for the OA node).   |
   | /password <password>      | The system uses the password to log in to  |
   |                           | remote nodes.                              |
   | HP SUM also supports      |                                            |
   | passwd and pwd (Windows)  |                                            |
   |---------------------------+--------------------------------------------|
   | --su_username (Linux)     | You cannot use su_username with use_sudo   |
   |                           | access level.                              |
   | /su_username (Windows)    |                                            |
   |                           | Do not use this command on the local host. |
   |---------------------------+--------------------------------------------|
   |                           | You cannot use su_password with use_sudo   |
   |                           | access level.                              |
   |                           |                                            |
   | --su_password (Linux)     | Do not use this command on the local host. |
   |                           | To launch HP SUM on the local host using   |
   | /su_password (Windows)    | su, use the following example:             |
   |                           |                                            |
   |                           | su root                                    |
   |                           |                                            |
   |                           | hpsum --s --f --use_location /mnt/spp      |
   |---------------------------+--------------------------------------------|
   |                           | When used with username and passwd,        |
   | --use_sudo (Linux)        | indicates that both are sudo user          |
   |                           | credentials.                               |
   | /use_sudo (Windows)       |                                            |
   |                           | You cannot use use_sudo with su_username   |
   |                           | and su_password.                           |
   |---------------------------+--------------------------------------------|
   |                           | This is the IP address or the DNS name of  |
   |                           | a remote host, which can be a remote       |
   |                           | server, remote iLO NIC port, Virtual       |
   |                           | Connect Ethernet or Fibre Channel Module   |
   | --target "netAddress"     | for c-Class BladeSystem, or BladeSystem    |
   | (Linux)                   | OA.                                        |
   |                           |                                            |
   | /target "netAddress"      | When two OAs are in an enclosure, use the  |
   | (Windows)                 | active OA as the argument. When specifying |
   |                           | the IP address, use either the IPv4 or     |
   |                           | IPv6 format.                               |
   |                           |                                            |
   |                           | If you are adding a VC node, use the IP    |
   |                           | address of the primary Enet module.        |
   |---------------------------+--------------------------------------------|
   |                           | Reduces inventory time for scripted        |
   |                           | deployments. This is an optional command   |
   |                           | line argument.                             |
   |                           |                                            |
   |                           | Valid node types                           |
   |                           |                                            |
   |                           | Server                                     |
   |                           |                                            |
   |                           | Windows                                    |
   |                           |                                            |
   |                           | Linux                                      |
   |                           |                                            |
   |                           | HPUX                                       |
   |                           |                                            |
   |                           |                                            |
   |                           | fc_switch                                  |
   |                           |                                            |
   | --targettype "type"       | OA                                         |
   | (Linux)                   |                                            |
   |                           | SD2                                        |
   | /targettype "type"        |                                            |
   | (Windows)                 |                                            |
   |                           | iLO                                        |
   |                           |                                            |
   |                           | virtual_connect                            |
   |                           |                                            |
   |                           | Use the IP address of the primary VC Enet  |
   |                           | module.                                    |
   |                           |                                            |
   |                           | sas_switch                                 |
   |                           |                                            |
   |                           | VMware                                     |
   |                           |                                            |
   |                           | Moonshot                                   |
   |                           |                                            |
   |                           | Use targettype with the target parameter.  |
   |                           | You can interchange the sequence of        |
   |                           | targettype and target. If the node name    |
   |                           | includes spaces, make sure you enclose the |
   |                           | name in quotation marks, " ".              |
   |---------------------------+--------------------------------------------|
   |                           | Enables the use of the local host          |
   | --current_credential      | credential to access the nodes instead of  |
   | (Linux)                   | providing the user name and password       |
   |                           | explicitly for each node. Assumes that the |
   | /current_credential       | current credential is valid for the nodes  |
   | (Windows)                 | you are processing. (Applies to Windows    |
   |                           | only.)                                     |
   |---------------------------+--------------------------------------------|
   |                           | Provides the user name credential for the  |
   |                           | VC target specified using the target       |
   |                           | command. You can specify only one set of   |
   |                           | OA credentials using command-line          |
   |                           | parameters, so if you need to add multiple |
   |                           | VC nodes using the target parameter, make  |
   | --oa_username (Linux)     | sure that the OA credentials for each      |
   |                           | specified VC are the same. You do not need |
   | /oa_username (Windows)    | to provide an OA network address           |
   |                           | associated with the VC. HP SUM queries it  |
   |                           | from a specified VC node.                  |
   |                           |                                            |
   |                           | To update multiple VCs with different user |
   |                           | names and passwords, or VCs with OAs that  |
   |                           | have different credentials, use the        |
   |                           | corresponding input files OAUID and OAPWD. |
   |---------------------------+--------------------------------------------|
   |                           | Provides the password credential for OA    |
   |                           | associated with VC specified with the      |
   |                           | "node" command-line parameter. Only one    |
   |                           | set of OA credentials can be specified     |
   |                           | with command-line parameters. You can add  |
   |                           | multiple VC nodes to command-line          |
   |                           | parameters with the "node" parameter only  |
   | --oa_password (Linux)     | if the credentials of OAs associated with  |
   |                           | specified VCs are the same. You do not     |
   | /oa_password (Windows)    | need to provide an OA network address      |
   |                           | associated with VC. HP SUM queries it from |
   |                           | a specified VC node.                       |
   |                           |                                            |
   |                           | To update multiple VCs with different user |
   |                           | names and passwords, or VCs with OAs that  |
   |                           | have different credentials, use the        |
   |                           | corresponding input files OAUID and OAPWD  |
   |                           | .                                          |
   |---------------------------+--------------------------------------------|
   | --switch_username (Linux) |                                            |
   |                           | Use this command to specify Moonshot       |
   | /switch_username          | switch credentials.                        |
   | (Windows)                 |                                            |
   |---------------------------+--------------------------------------------|
   | --switch_password (Linux) |                                            |
   |                           | Use this command to specify Moonshot       |
   | /switch_password          | switch passwords.                          |
   | (Windows)                 |                                            |
   |---------------------------+--------------------------------------------|
   | --switch_enable (Linux)   | Use this command to enable a Moonshot      |
   |                           | node.                                      |
   | /switch_enable (Windows)  |                                            |
   |---------------------------+--------------------------------------------|
   |                           | This command is required to enable VC in   |
   | --encryption_key (Linux)  | FIPS mode.                                 |
   |                           |                                            |
   | /encryption_key (Windows) | Possible value:                            |
   |                           |                                            |
   |                           | String of a minimum 8 characters.          |
   |---------------------------+--------------------------------------------|
   |                           | Use this command to determine VC-Enet      |
   |                           | module activation order.                   |
   | --ethactorder (Linux)     |                                            |
   |                           | Possible value:                            |
   | /ethactorder (Windows)    |                                            |
   |                           | ODDEVEN/PARALLEL/SERIAL/MANUAL, the        |
   |                           | default is ODDEVEN.                        |
   |---------------------------+--------------------------------------------|
   |                           | Use this command to determine VC-FC        |
   |                           | activation order.                          |
   | --fcactorder (Linux)      |                                            |
   |                           | Possible value:                            |
   | /fcactorder (Windows)     |                                            |
   |                           | ODDEVEN/PARALLEL/SERIAL/MANUAL, the        |
   |                           | default is ODDEVEN.                        |
   |---------------------------+--------------------------------------------|
   |                           | Use this command to determine the time, in |
   |                           | minutes, between activating or rebooting   |
   | --ethactdelay (Linux)     | VC-Enet modules                            |
   |                           |                                            |
   | /ethactdelay (Windows)    | Possible value:                            |
   |                           |                                            |
   |                           | Max 60 minutes, the default is 0 minutes.  |
   |---------------------------+--------------------------------------------|
   |                           | Use this command to determine the time to  |
   |                           | wait between activating or rebooting VC-FC |
   | --fcactdelay (Linux)      | modules.                                   |
   |                           |                                            |
   | /fcactdelay (Windows)     | Possible value:                            |
   |                           |                                            |
   |                           | Max 60 minutes, the default is 0 minutes.  |
   +------------------------------------------------------------------------+

    1.2.2.7 Log file commands

   The following table lists attributes for logging details.

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

    1.2.2.8 Report commands

      ---------------------------------------------------------------------   
    IMPORTANT: Always run report command separately. When you use a command   
    to generate a report, HP SUM ignores all other commands and only runs the 
    report. If you use other parameters in your command line, HP SUM performs 
    an inventory to populate the report, but does not deploy any updates.     
      ---------------------------------------------------------------------   

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

   HP SUM generates the reports as XML or HTML files that you can view in a
   JavaScript-enabled web browser. The location defaults to the present
   working directory where HP SUM is initiated. If that location is
   write-protected, you can find the files in the same directory as the HP
   SUM log files.

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

   You can find the HP SUM log files in these folders:

   Windows operating systems-C:\cpqsystem\hp\log

   Linux-/var/hp/log

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

      ---------------------------------------------------------------------   
    NOTE: HP SUM does not install any updates when you generate the inventory 
    report, firmware report, software report, or dependency report. HP SUM    
    deploys updates before it generates the installed report.                 
      ---------------------------------------------------------------------   

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

    1.2.2.9 Input file commands

   Use the following commands to script the update of multiple or individual
   nodes, or groups of nodes. For details, see

   +------------------------------------------------------------------------+
   |       Using input files        |              Description              |
   |--------------------------------+---------------------------------------|
   | --inputfile "filename" (Linux) | Create scripts for the deployment of  |
   |                                | firmware and software to multiple     |
   | /inputfile "filename"          | remote systems at one time. For       |
   | (Windows)                      | details, see the HP Smart Update      |
   |                                | Manager User Guide.                   |
   |--------------------------------+---------------------------------------|
   | --deleteinputfile (Linux)      | Instruct HP SUM to delete the input   |
   |                                | file after it has been read.          |
   | /deleteinputfile (Windows)     |                                       |
   +------------------------------------------------------------------------+

    1.2.2.10 Superdome 2/X server commands

   The following table provides parameters for Superdome 2/X servers.

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

  1.2.3 HP SUM CLI examples

   The following CLI examples use a Linux format. If you want to run CLI
   commands on a Windows system, use a slash / instead of two hyphens --. For
   example, hpsum /use_latest /silent.

    1.2.3.1 Example: Deploy the latest SPP and firmware components

      Syntax

   hpsum --use_latest --allow_non_bundle_components --silent

      Result

   HP SUM determines which software and firmware components from the update
   bundle in the current directory must be installed and installs them.

    1.2.3.2 Example: Deploy the previous version of the SPP only and force
    installation of all the software components

      Syntax

   hpsum --f:bundle --softwareonly --use_location /usr/john/spp/hp/swpackages
   --s

      Result

   HP SUM determines which software components in the specified location must
   be installed and installs them. HP SUM does not install firmware in this
   example.

    1.2.3.3 Example: Deploy firmware only, from the bundle found in the current
    HP SUM directory

      Syntax

   hpsum --romonly --s

      Result

   HP SUM determines which firmware components from the current directory
   must be installed and installs them. HP SUM does not install software in
   this example.

    1.2.3.4 Example: Deploy two software components

      Syntax

   Either of the following commands deploy two software components:

   hpsum --f:software cp008097.exe cp008257.exe --s

   hpsum --c cp008097.exe --c cp008257.exe --f:software --s

      Result

   HP SUM logs into the remote Linux node first as userid and then uses su to
   root user and performs operations. It installs the two components and
   forces rewrite or install of either component if it is software.

    1.2.3.5 Example: Force deployment to three remote hosts of the latest SPP
    available in the directory with HP SUM and later versions of components in
    the bundle

      Syntax

   Either of the following commands- force deployment of the latest SPP
   available in the directory with HP SUM, as well as later versions of
   components in the bundle, including firmware, to three remote hosts:

   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"

   hpsum --target server1.mydomain.com --target server2.mydomain.com --target
   10.15.25.101 --user administrator --passwd letmein --use_latest
   --allow_update_to_bundle --allow_non_bundle_components --force:all
   --override_existing_connection --continue_on_error ServerNotFound --silent
   --logdir usr/john/hpsum/management_server_files

      Result

   On the three target nodes, HP SUM installs all software and firmware
   components from the update bundle.

    1.2.3.6 Example: Using sudo to update components

      Syntax

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

      Result

   On the remote Linux server, HP SUM logs in as userid and executes commands
   using sudo to perform operations.

    1.2.3.7  Example: Using super user to update components

      Syntax

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

      Result

   HP SUM installs all components on server 10.0.1.7.

  1.2.4 HP SUM application return codes

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

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

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

  1.2.5 Windows smart-component return codes

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

  1.2.6 Linux smart-component and firmware RPM return codes

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

  1.2.7 Linux software RPM return codes

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

  1.2.8 VMware ESXi smart-component return codes

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

1.3 Using the command line interface (CLI) with Input files

   HP SUM CLI with Input files allow you to create scripts for updating
   multiple nodes, individual nodes, or groups of nodes (HP ProLiant and
   Integrity servers and options) within a single operation. To protect your
   credentials, HP recommends using a secure server or a management console.

   Use a text editor to create an input file. All section headers and
   trailers must match. You can use the DRYRUN=YES option to perform dry runs
   of installations. Dry run installation help you verify that the scripts
   are working without actually deploying the firmware updates that might be
   required on each node. Remove the DRYRUN=YES option when you are ready
   perform the actual updates.

   Use commas, semicolons, or spaces as list separators for parameters that
   can take list values.

      ---------------------------------------------------------------------   
    IMPORTANT: For greater security, omit the credentials from the file and   
    pass them to HP SUM using the command line. This requires that all nodes  
    use the same user ID and password.                                        
      ---------------------------------------------------------------------   

   After creating your script file, add it as the inputfile <filename>
   parameter to an 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
   (Linux) or hpsum /inputfile hpsum.in (Windows). You can add full paths to
   the input file location if the file is not stored in the same location as
   the HP SUM executable files. The <filename> field can be enclosed in
   double quotes to enable paths with spaces.

   In addition, you can use all of the command line options along with the
   input file, and the command line options take precedence over the commands
   in the input file. This is useful if you need to customize an input file
   for a particular configuration.

  1.3.1 Input file format and rules

   The input file contains both configuration details and target node
   information. You can also add credentials and remote host information for
   updates.

    1.3.1.1 Configuration details

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

   To view the configuration settings you can change in a selected baseline,
   use the interactive CLI command 
   --hpsum configure --show baseline=<baselinename> [component=<componentname>]
   (Linux)
   /hpsum configure /show baseline=<baselinename> [component=<componentname>]
   (Windows)

   REBOOTALLOWED = YES

   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 = usr/john/pkgsource1

   USELATEST = YES

   SILENT = YES

   OPTIONS = --f:rom

    1.3.1.2 Target nodes

   Use the Targets section to identify one or more remote hosts for HP SUM to
   update using the commands provided in the preceding configuration details.
   You can repeat this section any number of times in the input file, which
   makes it useful for organizing nodes and updates in related sets.

   Begin a Target section with the following special header enclosed in
   brackets:

   [TARGETS]

   End a Target section with the following special string enclosed in
   brackets:

   [END]

   Adding a Target section to the previous example looks like the following:

   REBOOTALLOWED = YES

   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 = usr/john/pkgsource1

   USELATEST = YES

   SILENT = YES

   OPTIONS = --f:rom

   [TARGETS]

   HOST = schinta1

   HOST = schinta2

   UID = root

   PWD = root123

   HOST = 234.567.765.432

   [END]

   You can append a title to the TARGETS header to identify the purpose of a
   given section. For example:

   [TARGETS_WIN2012]

   ...

   [END]

    1.3.1.3 Credentials

   The TARGETS section allows you to group nodes according to the login
   credentials needed for remote access. Each TARGETS section requires a set
   of login credentials that applies to all nodes in that section. If you
   want to use the login credentials of the current host to log in to one or
   more remote nodes, set the variable USECURRENTCREDENTIAL to YES. You can
   supply login credentials for one or more hosts by using the user ID
   variable UID and the password variable PWD. If you want to provide the
   variables at the beginning of a TARGETS section, use both of them.

    1.3.1.4 Remote node

   You can specify a remote node using the variable HOST. Possible values are
   a DNS name or an IP address. Both methods indicate the node is a remote
   node.

    1.3.1.5 Component-specific configuration

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

   To get a list of available configuration parameters for components in a
   baseline, use the following interactive CLI command:

   hpsum configure --show (Linux) or hpsum configure /show (Windows).

   To view the component configuration parameters for one component, use the
   following command:

   hpsum configure --show baseline=<baselinename> [component=<componentname>]
   (Linux)

   hpsum configure /show baseline=<baselinename> [component=<componentname>]
   (Windows)

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

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

   [COMPONENT_CONFIG=<component short name>]

   [<PARAM_NAME1>]

   Value1-line1

   Value1-line2

   [<PARAM_NAME1>]

   Value1-line1

   Value1-line2

   [END_COMPONENT_CONFIG]

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

   SOURCEPATH = usr/john/hpsum/Component Configuration/RPM

   [COMPONENT_CONFIG=hpsmh-windows-x86]

   [<force-overwrite>]

   YES

   [<admin-group>]

   ADMINGRP1 ADMINGRP2

   [<CERTNAME_2>]

   PRAMS2

   [<CERTNAME_2>]

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

   Version: GnuPG v1.4.9 (Darwin)

   mQENBErJM6oBCAC7NG5NZ5kiJg+KTTaIDjX9BU8bc7FI5a2zCYc3p9eikJfyyZYM

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

   sWbckvcIjJRcAtRliKbAf+KjplbcEIzt+kxmweE5XeKvDFtzAD041FGAphIkKcuu

   IAzL+XcMWzc3DA==

   =+ojz

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

   [<OPERATOR-GROUP>]

   OPTGRP1 OPTGRP2

   [<ANONYMOUS-ACCESS>]

   YES

   [END_COMPONENT_CONFIG]

   [TARGETS]

   HOST = LocalHost

   UID = hpsumadmin

   PWD = ********

   [END]

   The following is an example of how to configure component cp020718.exe.

   SILENT = YES

   FORCEALL = YES

   SOURCEPATH = usr/john/SPPGen8Snap6.2013_1119.56/hp/swpackages

   COMPONENTSLIST = cp020718.exe

   [COMPONENT_CONFIG= hpinsightmgmtagent-windows-x64]

   [<pollinterval>]

   15 seconds

   [<snmpsetsenabled>]

   Y

   [<remoterebootenabled>]

   Y

   [END_COMPONENT_CONFIG]

   [TARGETS]

   HOST = LocalHost

   UID = Administrator

   PWD = 12iso*help

   [END]

   The following is an example of how to configure component cp020347.exe.

   SILENT = YES

   FORCEALL = YES

   SOURCEPATH = usr/john/SPPGen8Snap6.2013_1119.56/hp/swpackages

   COMPONENTSLIST = cp020347.exe

   [COMPONENT_CONFIG= hpinsightmgmtwbemprovider-windows-x64]

   [<config:rwmiuser>]

   Useradmin

   [END_COMPONENT_CONFIG]

   [TARGETS]

   HOST = LocalHost

   UID = Administrator

   PWD = 12iso*help

   [END]

   The following is an example of how to configure component hpsmh-linux-x86.

   SILENT = YES

   FORCEALL = YES

   SOURCEPATH = /usr/john/SPP/58/hpsum

   COMPONENTSLIST = hpsmh-7.4.0-11.i386.rpm

   [COMPONENT_CONFIG= hpsmh-linux-x86]

   [<FORCE-OVERWRITE>]

   YES

   [<ADMIN-GROUP>]

   ADMINGRP1

   [<OPERATOR-GROUP>]

   OPTGRP1

   [<USER-GROUP>]

   USGRP1

   [<ANONYMOUS-ACCESSED>]

   YES

   [<LOCAL-ACCESS-ENABLED>]

   YES

   [<LOCAL-ACCESS-TYPE>]

   Administrator

   [<XENAMELIST>]

   HPSUM_123

   [<PORT-2301-ENABLED>]

   YES

   [<IP-BINDING>]

   YES

   [<IP-BINDING-LIST>]

   99.99.99.3/255.255.255.0

   [<IP-RESTRICTED-LOGINS>]

   YES

   [<IP-RESTRICTED-EXCLUDE>]

   99.99.99.187

   [<IP-RESTRICTED-INCLUDE>]

   99.99.99.157

   [<TRUSTMODE>]

   TrustByAll

   [END_COMPONENT_CONFIG]

   [TARGETS]

   HOST = 15.154.112.81

   UID = root

   PWD = iso*help

   [END]

   The following is an example of how to configure component
   hpsnmagent-rhel5-x86.

   SILENT = YES

   FORCEALL = YES

   COMPONENTSTLIST = <snmp-linux-component>

   [COMPONENT_CONFIG= hpsnmpagent-rhel5-x86]

   [<CMASTARTWEBAGENT>]

   YES

   [<CMASTARTSTORAGEAGENT>]

   YES

   [<CMASTARTNICAGENT>]

   YES

   [<CMANOTAINTEDKERNEL>]

   YES

   [<CMALOCALHOSTRWCOMMSTR>]

   localhost_rw_com_string

   [<CMALOCALHOSTROCOMMSTR>]

   localhost_ron_com_string

   [<CMAMGMTSTATIONRWIPORDNS>]

   15.154.123.123

   [<CMAMGMTSTATIONRWCOMMSTR>]

   SNMP_rw_authmgmtstncomm

   [<CMAMGMTSTATIONROIPORDNS>]

   15.154.112.234

   [<CMAMGMTSTATIONROCOMMSTR>]

   SNMP_ro_authmgmtstncomm

   [<CMADEFTRAPCOMMSTR>]

   def_snmp_trap_strng

   [<CMATRAPDESTINATIONIPORDNS>]

   15.156.23.45

   [<CMATRAPDESTINATIONCOMMSTR>]

   snmptrap_abovestring

   [<CMASYSCONTACT>]

   HPSUMind

   [<CMASYSLOCATION>]

   HPSTSD123

   [END_COMPONENT_CONFIG]

   [TARGETS]

   HOST = LocalHost

   UID = root

   PWD = iso*help

   [END]

  1.3.2 File encoding

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

  1.3.3 Error reporting

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

  1.3.4 Input file parameters

    Session attributes

   The following attributes are related to the session, and you can only use
   these once.

   +------------------------------------------------------------------------+
   |         Parameter         |                Description                 |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Causes the installation to run silently with|
   |                           |no GUI or interactive CLI output. All data  |
   |                           |writes to the log file. Any generated       |
   |                           |prompts use the default option and continue |
   |                           |the installation without user input.        |
   |SILENT                     |                                            |
   |                           |If a component requires input before        |
   |                           |installation (such as configuration         |
   |                           |information), the component installation    |
   |                           |fails and writes an error message to the log|
   |                           |file. You can avoid this by including the   |
   |                           |IGNOREERRORS = "FailedDependencies"         |
   |                           |parameter to ignore the entire node or the  |
   |                           |ONFAILEDDEPENDENCY =                        |
   |                           |"OmitComopnent"parameter to ignore just the |
   |                           |components.                                 |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |FORCEALL                   |YES, NO                                     |
   |                           |                                            |
   |                           |Forces updates to both firmware and software|
   |                           |components.                                 |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |FORCEROM                   |YES, NO                                     |
   |                           |                                            |
   |                           |Forces updates to firmware components.      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |FORCESOFTWARE              |YES, NO                                     |
   |                           |                                            |
   |                           |Forces updates to software components.      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, Default = NO                           |
   |FORCEBUNDLE                |                                            |
   |                           |Overrides or downgrades an existing         |
   |                           |installation of components in the selected  |
   |                           |bundle.                                     |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |DOWNGRADE                  |Selects components for installation that    |
   |                           |have an available version below the         |
   |                           |currently installed version. This is in     |
   |                           |addition to upgrades. Can be combined with  |
   |                           |rewrite.                                    |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, Default = NO                           |
   |                           |                                            |
   |REWRITE                    |Selects components for installation that    |
   |                           |have an available version that is the same  |
   |                           |as the installed version. This is in        |
   |                           |addition to upgrades. Can be combined with  |
   |                           |downgrade.                                  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |REBOOTALLOWED              |YES, NO                                     |
   |                           |                                            |
   |                           |Enables you to reboot, if required.         |
   |---------------------------+--------------------------------------------|
   |                           |Forces the server to reboot under the       |
   |                           |following conditions:                       |
   |                           |                                            |
   |REBOOTALWAYS               |You select the REBOOTALWAYS option or       |
   |                           |provide it as an input file argument.       |
   |                           |                                            |
   |                           |All components selected for installation are|
   |                           |successfully installed.                     |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |REBOOTMESSAGE              |Any string (not exceeding 256 characters)   |
   |                           |                                            |
   |                           |Create a message to be displayed prior to   |
   |                           |rebooting.                                  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |REBOOTDELAY                |Time in seconds                             |
   |                           |                                            |
   |                           |Wait time before rebooting.                 |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |COMPONENTSLIST             |Component names with file extensions (.exe, |
   |                           |.rpm, or .scexe)                            |
   |                           |                                            |
   |                           |Limits the list of components to be updated.|
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |BUNDLESLIST                |Bundle file names                           |
   |                           |                                            |
   |                           |Limits the list of bundle xml files to be   |
   |                           |filtered.                                   |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Filter switch that enables you to install   |
   |ALLOWUPDATEBUNDLE          |newer versions of components defined in a   |
   |                           |PSP, ISP, or bundle.                        |
   |                           |                                            |
   |                           |Allows these components to replace the older|
   |                           |versions of the same component that might   |
   |                           |have shipped with the bundles.              |
   |---------------------------+--------------------------------------------|
   |                           |This specifies directory that contains      |
   |                           |component configuration settings for        |
   |IMPORT_CONFIGURATION=<path>|components in the specified baseline.       |
   |                           |Imported component configurations override  |
   |                           |components configurations in the baseline.  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Defines the behavior when a remote node has |
   |                           |an existing HP SUM session in progress.     |
   |                           |                                            |
   |                           |Use this parameter to skip the host if an   |
   |                           |existing HP SUM session already exists. A   |
   |SKIPTARGET                 |value of NO overrides the session in        |
   |                           |progress and reinitializes the installation |
   |                           |framework on the remote host.               |
   |                           |                                            |
   |                           |   ---------------------------------------  |
   |                           | IMPORTANT: If an HP SUM session discovers a|
   |                           | remote node running HP SUM locally, HP SUM |
   |                           | ignores the SKIPTARGET command and skips   |
   |                           | the remote node.                           |
   |                           |   ---------------------------------------  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |ServerNotFound, BadPassword,                |
   |                           |FailedDependencies                          |
   |                           |                                            |
   |                           |Causes the installation to continue and     |
   |                           |ignore errors.                              |
   |                           |                                            |
   |                           |Use the ServerNotFound option to bypass     |
   |                           |inactive or unavailable remote hosts when   |
   |                           |deploying firmware or software to multiple  |
   |IGNOREERRORS               |remote hosts at the same time.              |
   |                           |                                            |
   |                           |Use the BadPassword option to bypass remote |
   |                           |nodes that report incorrect credentials     |
   |                           |provided and continue with other nodes.     |
   |                           |                                            |
   |                           |Use FailedDependencies to ignore any nodes  |
   |                           |with failed dependencies and proceed with   |
   |                           |nodes that are ready to be installed.       |
   |                           |                                            |
   |                           |This can be overridden by using             |
   |                           |ONFAILEDDEPENDENCY = OmitComponent or       |
   |                           |Force.s                                     |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Filter switch for use with bundles. Allows  |
   |                           |you to use the latest version of the bundle |
   |USELATEST                  |when the command line lists multiple        |
   |                           |versions of bundles.                        |
   |                           |                                            |
   |                           |With no bundles specified on the command    |
   |                           |line, and multiple bundles available in the |
   |                           |directory, this parameter directs HP SUM to |
   |                           |use the bundle that has the latest version. |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |DRYRUN                     |YES, NO                                     |
   |                           |                                            |
   |                           |Simulates the installation for a test run.  |
   |                           |Nothing is installed.                       |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |One or more CLI switches                    |
   |                           |                                            |
   |                           |Specify the HP SUM CLI options inside the   |
   |OPTIONS                    |input file, which overrides the             |
   |                           |configuration settings. Separate parameters |
   |                           |using a semi-colon, comma, or a space.      |
   |                           |                                            |
   |                           |This parameter replaces the LSPOPTIONS      |
   |                           |parameter that was previously supported with|
   |                           |LDU.                                        |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Specifies listing components using AMS and  |
   |                           |WBEM Providers as optional updates on the   |
   |                           |Components Selection screen.                |
   |NOMGMT                     |                                            |
   |                           |In silent mode, HP SUM does not update AMS  |
   |                           |or WBEM Providers.                          |
   |                           |                                            |
   |                           |   ---------------------------------------  |
   |                           | IMPORTANT: You can only configure SNMP in  |
   |                           | HP SUM GUI mode.                           |
   |                           |   ---------------------------------------  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Specifies availability of components using  |
   |USEWMI                     |WMI protocol so HP SUM can select them for  |
   |                           |installation.                               |
   |                           |                                            |
   |                           |These components are optional by default and|
   |                           |are not installed unless you use this       |
   |                           |parameter. This parameter does not apply to |
   |                           |HP Integrity servers.                       |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Specifies availability of AMS agentless     |
   |                           |management service components so HP SUM can |
   |                           |select them for installation.               |
   |                           |                                            |
   |USEAMS                     |This option applies to Gen8 and later       |
   |                           |servers. If you set this parameter for a    |
   |                           |ProLiant G7 and earlier server, HP SUM      |
   |                           |ignores the parameter.                      |
   |                           |                                            |
   |                           |These components are only installed by      |
   |                           |default on Gen8 and later servers. This     |
   |                           |parameter does not apply to HP Integrity    |
   |                           |servers.                                    |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |ROMONLY                    |Limits components considered for            |
   |                           |installation to only firmware               |
   |                           |components. Cannot be used with             |
   |                           |softwareonly. If neither softwareonly or    |
   |                           |romonly are used, all components are        |
   |                           |considered for possible installation.       |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |SOFTWAREONLY               |Limits components considered for            |
   |                           |installation to only software               |
   |                           |components. Cannot be used with romonly. If |
   |                           |neither softwareonly or romonly are used,   |
   |                           |all components are considered for possible  |
   |                           |installation.                               |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |                           |                                            |
   |                           |Allows you to use the credentials of the    |
   |USECURRENTCREDENTIAL       |local host to access the nodes instead of   |
   |                           |providing the user name and password        |
   |                           |explicitly for each node.                   |
   |                           |                                            |
   |                           |Assumes that the current credentials are    |
   |                           |valid for the nodes that are being accessed.|
   |                           |(Applies to Windows only.)                  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |DELETEINPUTFILE            |YES, NO (default)                           |
   |                           |                                            |
   |                           |Instructs HP SUM to delete the input file   |
   |                           |after it has been read.                     |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |OmitHost (default), OmitComponent, Force    |
   |                           |                                            |
   |                           |Tells HP SUM how to proceed when a component|
   |                           |has a failed dependency.                    |
   |                           |                                            |
   |ONFAILEDDEPENDENCY         |OmitHost-Puts the host in a failure state,  |
   |                           |and HP SUM does not attempt installation.   |
   |                           |                                            |
   |                           |OmitComponent-Clears the affected components|
   |                           |and proceeds with any updates that do not   |
   |                           |have dependency failures.                   |
   |                           |                                            |
   |                           |Force-Attempts all updates, even if they    |
   |                           |have dependency failures.                   |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |IP address, DNS name                        |
   |                           |                                            |
   |                           |The IP address or the DNS name of a remote  |
   |                           |server, remote iLO NIC port, Virtual Connect|
   |                           |Ethernet, or Fibre Channel Module for       |
   |HOST                       |c-Class BladeSystem or BladeSystem OA.      |
   |                           |                                            |
   |                           |With two OAs in an enclosure, this parameter|
   |                           |is the active OA. 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.               |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Log file name                               |
   |                           |                                            |
   |                           |Redirects the output from HP SUM or the HP  |
   |                           |BladeSystem c-Class OA flash utility to a   |
   |                           |directory other than the default location.  |
   |                           |                                            |
   |LOGFILENAME = "path"       |For Windows components, the default location|
   |                           |is                                          |
   |                           |%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>.                 |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |IP address, DNS name                        |
   |                           |                                            |
   |CMAMGMTSTATIONRWIPORDNS    |Specifies the IP address or DNS host name of|
   |                           |a system with read/write access to serve as |
   |                           |a management station. You can specify       |
   |                           |multiple locations separated by a space.    |
   |                           |(Applies to Linux SPP only.)                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |IP address, DNS name                        |
   |                           |                                            |
   |CMAMGMTSTATIONROIPORDNS    |Specifies the IP address or DNS host name of|
   |                           |a system with read-only access to serve as a|
   |                           |management station. You can specify multiple|
   |                           |locations separated by a space. (Applies to |
   |                           |Linux SPP only.)                            |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |String value                                |
   |CMASYSCONTACT              |                                            |
   |                           |Specifies a person or phone number for      |
   |                           |administration of this system. (Applies to  |
   |                           |Linux SPP only.)                            |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |CMASYSLOCATION             |String value                                |
   |                           |                                            |
   |                           |Designates the location of this system.     |
   |                           |(Applies to Linux SPP only.)                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES (start the web agent)                   |
   |                           |                                            |
   |CMASTARTWEBAGENT           |NO (do not start the web agent)             |
   |                           |                                            |
   |                           |Determines whether to start the HP Systems  |
   |                           |Insight Manager Web Agent when the health   |
   |                           |application loads. (Applies to Linux SPP    |
   |                           |only.)                                      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES (start the storage agent)               |
   |                           |                                            |
   |CMASTARTSTORAGEAGENT       |NO (do not start the storage agent)         |
   |                           |                                            |
   |                           |Determines whether to start the HP Systems  |
   |                           |Insight Manager Storage Agent when the      |
   |                           |health application loads. (Applies to Linux |
   |                           |SPP only.)                                  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES (start the web agent)                   |
   |                           |                                            |
   |CMASTARTNICAGENT           |NO (do not start the web agent)             |
   |                           |                                            |
   |                           |Determines whether to start the HP Systems  |
   |                           |Insight Manager NIC agent. (Applies to Linux|
   |                           |SPP only).                                  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES (start the HP Lights-Out management     |
   |                           |driver)                                     |
   |                           |                                            |
   |CMANOTAINTEDKERNEL         |NO (do not start the HP Lights-Out          |
   |                           |management driver)                          |
   |                           |                                            |
   |                           |Determines whether to start the HP          |
   |                           |Lights-Out management driver when the health|
   |                           |application loads. (Applies to Linux SPP    |
   |                           |only.)                                      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |VCRM name                                   |
   |HPVCAVCRMSERVER            |                                            |
   |                           |Informs the VCA of the name of the VCRM to  |
   |                           |use as a software distribution baseline.    |
   |                           |(Applies to Linux SPP only.)                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO (default)                           |
   |FORCE-OVERWRITE            |                                            |
   |                           |HP Systems Management Homepage (hpsmh) uses |
   |                           |this parameter to force overwrite the SMH   |
   |                           |settings of an existing configuration file. |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Up to five Linux groups, separated by spaces|
   |                           |or semicolons, to enable administrative     |
   |ADMIN-GROUP                |access to the web services.                 |
   |                           |                                            |
   |                           |HP Systems Management Homepage (hpsmh) uses |
   |                           |this parameter to set up security for the   |
   |                           |web server. (Applies to Linux SPP only.)    |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Up to five Linux groups, separated by spaces|
   |                           |or semicolons, to enable user-level access  |
   |USER-GROUP                 |to the web servers.                         |
   |                           |                                            |
   |                           |HP Systems Management Homepage uses this    |
   |                           |parameter to set up security for the web    |
   |                           |server. (Applies to Linux SPP only.)        |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Up to five Linux groups, separated by spaces|
   |                           |or semicolons, to enable operator-level     |
   |OPERATOR-GROUP             |access to the web servers.                  |
   |                           |                                            |
   |                           |HP Systems Management Homepage uses this    |
   |                           |parameter to set up security for the web    |
   |                           |server. (Applies to Linux SPP only.)        |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO (default)                           |
   |ANONYMOUS-ACCESS           |                                            |
   |                           |Determines whether an anonymous user can    |
   |                           |access HP Systems Management Homepage.      |
   |                           |(Applies to Linux SPP only.)                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO (default)                           |
   |                           |                                            |
   |IP-BINDING                 |HP Systems Management Homepage uses this    |
   |                           |parameter to determine whether HP SMH can   |
   |                           |use all available NICs and detect subnets   |
   |                           |for its web services. (Applies to Linux SPP |
   |                           |only.)                                      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |IP address pairs separated by semicolons    |
   |                           |(for example, 10.1.1.1/255.255.255.0;       |
   |                           |                                            |
   |                           |10.2.2.2/255.255.255.0)                     |
   |IP-BINDING-LIST            |                                            |
   |                           |HP Systems Management Homepage uses this    |
   |                           |parameter to restrict the NICs and subnets  |
   |                           |to use for its web servers.                 |
   |                           |                                            |
   |                           |The IP-BINDING parameter must be set to yes |
   |                           |for this parameter to be used during        |
   |                           |installation. (Applies to Linux SPP only.)  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO (default)                           |
   |                           |                                            |
   |                           |To enable restrictions on who can log in to |
   |                           |the web server, set this parameter to yes,  |
   |IP-RESTRICTED-LOGINS       |and then provide values to the              |
   |                           |IP-RESTRICTED-EXCLUDE or                    |
   |                           |IP-RESTRICTED-INCLUDE parameters.           |
   |                           |                                            |
   |                           |HP Systems Management Homepage uses this    |
   |                           |parameter to restrict login access. (Applies|
   |                           |to Linux SPP only.)                         |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |List of IP address ranges separated by      |
   |                           |semicolons (for example, 10.1.1.1-10.1.1.10;|
   |                           |                                            |
   |                           |10.2.2.2-10.2.2.10)                         |
   |                           |                                            |
   |IP-RESTRICTED-EXCLUDE      |HP Systems Management Homepage uses this    |
   |                           |parameter to exclude specific IP            |
   |                           |address/netmask pairs from logging into the |
   |                           |web services. (Applies to Linux PSP only.)  |
   |                           |                                            |
   |                           |HP Systems Management Homepage ignores this |
   |                           |parameter unless you set the                |
   |                           |IP-RESTRICTED-LOGINS parameter to yes.      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |List of IP address ranges separated by      |
   |                           |semicolons (for example, 10.1.1.1-10.1.1.10;|
   |                           |                                            |
   |                           |10.2.2.2-10.2.2.10)                         |
   |                           |                                            |
   |IP-RESTRICTED-INCLUDE      |HP Systems Management Homepage uses this    |
   |                           |parameter to enable login only from the IP  |
   |                           |address/netmask pairs specified. (Applies to|
   |                           |Linux SPP only.)                            |
   |                           |                                            |
   |                           |HP Systems Management Homepage ignores this |
   |                           |parameter unless you set the                |
   |                           |IP-RESTRICTED-LOGINS parameter to yes.      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES (default to include anonymous access),  |
   |                           |NO                                          |
   |LOCAL-ACCESS-ENABLED        |                                            |
   |                           |HP Systems Management Homepage uses this    |
   |                           |parameter to determine whether to enable    |
   |                           |local anonymous access to the web services. |
   |                           |(Applies to Linux SPP only.)                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Anonymous (default), Administrator          |
   |                           |                                            |
   |                           |   ---------------------------------------  |
   |                           | CAUTION: Selecting local access with       |
   |                           | administrator privileges as the login      |
   |LOCAL-ACCESS-TYPE           | provides full access to any user who has   |
   |                           | access to the local console, without       |
   |                           | prompting for a user name or password.     |
   |                           |   ---------------------------------------  |
   |                           |                                            |
   |                           |HP Systems Management Homepage uses this    |
   |                           |parameter to determine the type of access   |
   |                           |granted to local users. (Applies to Linux   |
   |                           |SPP only)                                   |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |TrustByCert-If you use this value, you must |
   |                           |define the CERTLIST parameter to enable     |
   |                           |access to the server.                       |
   |                           |                                            |
   |                           |TrustByName-If you use this value, you must |
   |                           |define the XENAMELIST.                      |
   |                           |                                            |
   |                           |TrustByAll-HP does not recommend using this |
   |                           |value because of possible negative security |
   |                           |consequences.                               |
   |TRUSTMODE                  |                                            |
   |                           |   ---------------------------------------  |
   |                           | 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 can affect access  |
   |                           | to the web server.                         |
   |                           |   ---------------------------------------  |
   |                           |                                            |
   |                           |HP Systems Management Homepage uses this    |
   |                           |parameter to set up the trust relationship  |
   |                           |mode. (Applies to Linux SPP only.)          |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Certificate file name or Server DNS name    |
   |                           |                                            |
   |CERTLIST                   |You can provide a list of certificate files |
   |                           |or servers where HP SUM can obtain          |
   |                           |certificates for trust relationships for the|
   |                           |HP Systems Management Homepage. (Applies to |
   |                           |Linux SPP only.)                            |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Server DNS name                             |
   |                           |                                            |
   |                           |Enables you to provide a list of servers,   |
   |XENAMELIST                 |separated by semicolons, for trust          |
   |                           |relationships for the HP Systems Management |
   |                           |Homepage. (Applies to Linux SPP only.)      |
   |                           |                                            |
   |                           |This parameter is valid only if the         |
   |                           |TRUSTMODE parameter is set to TrustByName.  |
   |                           |(Applies to Linux SPP only.)                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |SinglePath, SecurePath, QLogicFailure       |
   |                           |                                            |
   |HPQLA2X00FO                |No default value                            |
   |                           |                                            |
   |                           |The hp_qla2x00 QLogic Fibre Channel Driver  |
   |                           |uses this parameter to determine the        |
   |                           |failover mode to use. (Applies to Linux SPP |
   |                           |only.)                                      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |Y, N (default)                              |
   |HPQLA2X00FORCE             |                                            |
   |                           |The hp_qla2x00 QLogic Fibre Channel Driver  |
   |                           |uses this parameter to determine whether to |
   |                           |skip detection of third-party storage.      |
   |                           |(Applies to Linux SPP only.)                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |User can define the OAUID variable multiple |
   |                           |times before each HOST variable.            |
   |                           |                                            |
   |OAUID                      |Provides the user name credentials for the  |
   |                           |OA associated with VC. You must define a    |
   |                           |value for these variables before the HOST   |
   |                           |variable in the [TARGETS] section. This     |
   |                           |parameter applies only to VC firmware.      |
   |                           |                                            |
   |                           |You can also use OAUSER or OAUSERNAME.      |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |User can define OAPWD variable multiple     |
   |                           |times before each HOST variable.            |
   |                           |                                            |
   |OAPWD                      |Provides the password credentials for the OA|
   |                           |associated with VC. You must define a value |
   |                           |for these variables before the HOST variable|
   |                           |in the [TARGETS] section. This parameter    |
   |                           |applies only to VC firmware.                |
   |                           |                                            |
   |                           |You can also use OAPASSWORD.                |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |TRUE, FALSE                                 |
   |                           |                                            |
   |                           |Allows installation to proceed after HP SUM |
   |                           |receives warnings on nodes. Some warnings   |
   |IGNOREWARNINGS             |include:                                    |
   |                           |                                            |
   |                           |Active member of a Serviceguard cluster     |
   |                           |                                            |
   |                           |HP-UX boot disk                             |
   |                           |                                            |
   |                           |Superdome 2/X OA                            |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |ALL, COMPLEX, PARTITIONS                    |
   |UPDATETYPE                 |                                            |
   |                           |Superdome 2/X servers only                  |
   |                           |                                            |
   |                           |This argument determines which Superdome 2/X|
   |                           |firmware is updated.                        |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |For example: DEVICELIST=npar1,blade1/1      |
   |                           |                                            |
   |                           |Do not put spaces between the parameters    |
   |                           |                                            |
   |DEVICELIST                 |Superdome 2/X servers only                  |
   |                           |                                            |
   |                           |Use this argument when the UPDATETYPE is set|
   |                           |to PARTITIONS. This argument specifies the  |
   |                           |subset of partitions or blades to update    |
   |                           |when you do not want to update all          |
   |                           |partitions. Valid devices are: npar(number) |
   |                           |and blade(enc)/(bay).                       |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |For example: REBOOTLIST=npar1,npar2         |
   |                           |                                            |
   |                           |Do not put spaces between the parameters    |
   |                           |                                            |
   |REBOOTLIST                 |Superdome 2/X servers only                  |
   |                           |                                            |
   |                           |Use this argument with the UPDATETYPE= ALL  |
   |                           |or UPDATETYPE= PARTITIONS argument.         |
   |                           |Specifies the partitions to reboot after    |
   |                           |updating the partition firmware. Valid npar |
   |                           |values are npar(number).                    |
   |---------------------------+--------------------------------------------|
   |                           |Generates a report listing of the node      |
   |                           |summary and describes how the components in |
   |                           |the repository affect the node; for example,|
   |                           |whether each component applies to the node. |
   |                           |HP SUM generates the report in HTML and XML |
   |                           |with file name formats of                   |
   |                           |HPSUM_Report_<date>_<time>.html and         |
   |                           |HPSUM_Report_<date>_<time>.xml.             |
   |REPORT                     |                                            |
   |                           |By default, HP SUM saves the files to the   |
   |                           |working directory where HP SUM is initiated.|
   |                           |If that location is write-protected, you can|
   |                           |find the files in the same directory as the |
   |                           |HP SUM log files.                           |
   |                           |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |---------------------------+--------------------------------------------|
   |                           |Generates a report listing of the components|
   |                           |in the specified repository. The report is  |
   |                           |generated in HTML and XML with file name    |
   |                           |formats of                                  |
   |                           |HPSUM_Inventory_Report_<date>_<time>.html   |
   |                           |and                                         |
   |                           |HPSUM_Inventory_Report_<date>_<time>.xml.   |
   |                           |                                            |
   |INVENTORY_REPORT           |By default, the report is located in the    |
   |                           |present working directory where HP SUM is   |
   |                           |initiated. If that location is              |
   |                           |write-protected, you can find the report in |
   |                           |the same directory as the HP SUM log files. |
   |                           |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |---------------------------+--------------------------------------------|
   |                           |Generates a report listing of the firmware  |
   |                           |installed and details of the node. The      |
   |                           |report is generated in HTML and XML with    |
   |                           |file names of HPSUM_Firmware_Report.html and|
   |                           |fwreport.xml in the directory named         |
   |                           |HPSUM_Firmware_Report_<date>_<time>.        |
   |                           |                                            |
   |FIRMWARE_REPORT            |By default, the report is located in the    |
   |                           |present working directory where HP SUM is   |
   |                           |initiated. If that location is              |
   |                           |write-protected, you can find the report in |
   |                           |the same directory as the HP SUM log files. |
   |                           |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |---------------------------+--------------------------------------------|
   |                           |Generates a report listing of the failed    |
   |                           |dependencies for all nodes.                 |
   |DEPENDENCY_REPORT          |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |---------------------------+--------------------------------------------|
   |                           |Generates a report that lists all installed |
   |                           |firmware, software, and driver versions     |
   |                           |installed on all nodes.                     |
   |INSTALLED_REPORT           |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |---------------------------+--------------------------------------------|
   |                           |This report generates all report types in   |
   |                           |one file.                                   |
   |COMBINED_REPORT            |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |YES, NO                                     |
   |---------------------------+--------------------------------------------|
   |                           |Use this parameter with all report commands |
   |REPORTDIR                  |to specify a directory where you want HP SUM|
   |                           |to save reports.                            |
   +------------------------------------------------------------------------+

    Node attributes

   The following attributes are related to nodes and baselines, you can use
   these attributes for each node or baseline.

   +------------------------------------------------------------------------+
   | Parameter        | Description                                         |
   |------------------+-----------------------------------------------------|
   |                  | Specifies the type of node (--targettype Linux      |
   |                  | (Linux) /targettype Windows) (Windows) ), and can   |
   |                  | shorten the inventory process.                      |
   |                  |                                                     |
   |                  | Valid node types are:                               |
   |                  |                                                     |
   |                  | Windows                                             |
   |                  |                                                     |
   |                  | Linux                                               |
   |                  |                                                     |
   |                  | HPUX                                                |
   |                  |                                                     |
   |                  | FC Switch or Fibre Channel Switch                   |
   |                  |                                                     |
   |                  | OA or Onboard Administrator                         |
   |                  |                                                     |
   | TARGETTYPE       | SUPERDOME 2 or SUPERDOME2 or Superdome 2 Onboard    |
   |                  | Administrator                                       |
   |                  |                                                     |
   |                  | iLO                                                 |
   |                  |                                                     |
   |                  | VC or Virtual Connect                               |
   |                  |                                                     |
   |                  | Use the IP address of the primary VC Enet module.   |
   |                  |                                                     |
   |                  | HP SAS or HP SAS B/L Interconnect Switch            |
   |                  |                                                     |
   |                  | VMware or VMware Host                               |
   |                  |                                                     |
   |                  | Moonshot                                            |
   |                  |                                                     |
   |                  | If you use the command with a group, HP SUM assumes |
   |                  | all nodes in the group are the same node type.      |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   |                  |                                                     |
   |                  | Directory path, UNC location                        |
   | SOURCEPATH       |                                                     |
   |                  | Provides a single local baseline path or a UNC file |
   |                  | share. This action creates an inventory from the    |
   |                  | given path instead of the local or default          |
   |                  | baseline.                                           |
   |------------------+-----------------------------------------------------|
   |                  | Possible Values:                                    |
   |                  |                                                     |
   | UNC_USERNAME     | <username>                                          |
   |                  |                                                     |
   |                  | Provides the user name credentials for the UNC      |
   |                  | location provided in the SOURCEPATH.                |
   |------------------+-----------------------------------------------------|
   |                  | Possible Values:                                    |
   |                  |                                                     |
   | UNC_PASSWORD     | <password>                                          |
   |                  |                                                     |
   |                  | Provides the password to access the UNC location.   |
   |------------------+-----------------------------------------------------|
   |                  | Possible Values:                                    |
   |                  |                                                     |
   | SWITCH_USERNAME  | <username>                                          |
   |                  |                                                     |
   |                  | Provides the username to access the Moonshot        |
   |                  | switch.                                             |
   |------------------+-----------------------------------------------------|
   |                  | Possible Values:                                    |
   |                  |                                                     |
   | SWITCH_PASSWORD  | <password>                                          |
   |                  |                                                     |
   |                  | Provides the password to access the Moonshot        |
   |                  | switch.                                             |
   |------------------+-----------------------------------------------------|
   |                  | Possible Values:                                    |
   |                  |                                                     |
   | SWITCH_ENABLE    | <enable>                                            |
   |                  |                                                     |
   |                  | Provides access to the Moonshot switch.             |
   |------------------+-----------------------------------------------------|
   |                  | Possible Values:                                    |
   |                  |                                                     |
   | SWITCHB_USERNAME | <username>                                          |
   |                  |                                                     |
   |                  | Provides the username to access the B Moonshot      |
   |                  | switch.                                             |
   |------------------+-----------------------------------------------------|
   |                  | Possible Values:                                    |
   |                  |                                                     |
   | SWITCHB_PASSWORD | <password>                                          |
   |                  |                                                     |
   |                  | Provides the password to access the B Moonshot      |
   |                  | switch.                                             |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   |                  |                                                     |
   | UID              | <username>                                          |
   |                  |                                                     |
   |                  | Specifies the user ID for logging into the nodes.   |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   |                  |                                                     |
   |                  | <password>                                          |
   | PWD              |                                                     |
   |                  | Uses the password for the user ID specified in the  |
   |                  | UID.                                                |
   |                  |                                                     |
   |                  | Specifies the password for logging into the nodes.  |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   |                  |                                                     |
   | SUUSERNAME       | <superusername>                                     |
   |                  |                                                     |
   |                  | Use this argument to provide a superuser username.  |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   | SUPASSWORD       |                                                     |
   |                  | <superuserpassword>                                 |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   |                  |                                                     |
   |                  | Yes, No                                             |
   |                  |                                                     |
   |                  | Allows use of the sudo command.                     |
   | USESUDO          |                                                     |
   |                  | Specifies that username and pasword for a remote    |
   |                  | node are sudo user credentials. When you specify    |
   |                  | USESUDO in the input file along with username and   |
   |                  | password, then the username and password are        |
   |                  | considered a sudo credentials.                      |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine VC-Enet module        |
   |                  | activation order.                                   |
   |                  |                                                     |
   | /ETHACTORDER     | Possible value:                                     |
   |                  |                                                     |
   |                  | ODDEVEN/PARALLEL/SERIAL/MANUAL, the default is      |
   |                  | ODDEVEN.                                            |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine VC-FC activation      |
   |                  | order.                                              |
   |                  |                                                     |
   | /FCACTORDER      | Possible value:                                     |
   |                  |                                                     |
   |                  | ODDEVEN/PARALLEL/SERIAL/MANUAL, the default is      |
   |                  | ODDEVEN.                                            |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine the time, in minutes, |
   |                  | between activating or rebooting VC-Enet modules     |
   | /ETHACTDELAY     |                                                     |
   |                  | Possible value:                                     |
   |                  |                                                     |
   |                  | Max 60 minutes, the default is 0 minutes.           |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine the time to wait      |
   |                  | between activating or rebooting VC-FC modules.      |
   | /FCACTDELAY      |                                                     |
   |                  | Possible value:                                     |
   |                  |                                                     |
   |                  | Max 60 minutes, the default is 0 minutes.           |
   +------------------------------------------------------------------------+

  1.3.5 HP SUM CLI input file examples

    1.3.5.1 Example: inputfile.txt

   REBOOTALLOWED = YES

   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 = usr/john/pkgsource1

   USELATEST = YES

   SILENT = YES

   OPTIONS = --f:rom (Linux) OPTIONS = /f:rom (Windows)

   [TARGETS]

   HOST = schinta1

   HOST = schinta2

   UID = root

   PWD = root123

   HOST = 234.567.765.432

   [END]

      Usage

   To run the input file example above, use the following command from the
   command line in the directory where you saved HP SUM.

   hpsum --inputfile <path:/inputfile.txt> (Linux) hpsum /inputfile
   <path:\inputfile.txt (Windows)

    1.3.5.2 Example: Update two nodes

   This example passes two nodes to be updated. The nodes do not necessarily
   have to be OAs. They can be any node that HP SUM supports.

   DRYRUN = YES

   SILENT = YES

   [TARGETS]

   HOST = BL465C-01

   HOST = 192.168.1.2

   [END]

    1.3.5.3 Example: Pass a host DNS, user ID, and password to a target host.

   This example passes a host DNS, 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]

    1.3.5.4 Example: Update one remote Windows node

   SILENT = YES

   IGNOREERRORS = ServerNotFound,BadPassword, FailedDepedencies

   SKIPTARGET = NO

   SOURCEPATH = /usr/john/spp/hp/swpackages

   [GROUPS]

   HOST=winserver

   UID=Userid

   PWD=password

   [END]

    1.3.5.5 Example: Update four remote nodes with force

   SILENT = YES

   IGNOREERRORS = ServerNotFound,BadPassword, FailedDepedencies

   SKIPTARGET = NO

   SOURCEPATH = usr/john/spp/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]

    1.3.5.6 Example: Update some Superdome 2/X partitions and unassigned blades,
    and reboot the partitions

   Superdome 2/X input files:

   IGNOREWARNINGS = TRUE

   [TARGET] HOST = 10.0.0.206

   UID = Userid

   PWD = password

   UPDATETYPE = PARTITIONS

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

   REBOOTLIST=npar1,npar2

   [END]

      Usage

   Usage example of access level.

   hpsum --inputfile <path:/inputfile.txt> (Linux) hpsum /inputfile
   <path:\inputfile.txt (Windows)

    1.3.5.7 Example: Update one remote node using a baseline in the current
    directory

   SILENT = YES

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   [END]

    1.3.5.8 Example: Update multiple targets using sudo in an input file

   SILENT = YES

   USESUDO = YES

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   [END]

   [TARGETS]

   HOST = 10.0.1.73

   UID = Userid

   PWD = password

   [END]

    1.3.5.9 Example: Using super user to update Linux components

   SILENT = YES

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   SUUSERNAME = root

   SUPASSWORD = rootpwd

   [END]

    1.3.5.10 Example: Update multiple targets using super user in an input file

   Update multiple targets using super user in an input file when all targets
   have the same super user credentials.

   SILENT = YES

   SUUSERNAME = root

   SUPASSWORD = rootpwd

   [TARGETS]

   HOST = 10.0.1.7

   UID = Userid

   PWD = password

   [END]

   [TARGETS]

   HOST = 10.0.1.73

   UID = Userid

   PWD = password

   [END]

  1.3.6 Downloading HP SUM and components from the SDR

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

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