﻿                        HP Smart Update Manager CLI Help

   Published: July 2015

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

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

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

Chapter 1 HP SUM CLI and Input file commands overview

1.1 CLI commands

   In HP SUM CLI mode, you must type all parameters in one command line. When
   you press the Enter key, HP SUM executes the entire sequence. All CLI
   commands require the/s (Windows) or --s (Linux) to run.

  1.1.1 Command-line syntax

      ---------------------------------------------------------------------   
    IMPORTANT: Command-line mode does not support double-byte character sets. 
    Any commands entered in the command line using a double-byte character    
    set do not display correctly.                                             
      ---------------------------------------------------------------------   

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

   hpsum --s --use_location <baseline_directory> --r

   hpsum /s /use_location <baseline_directory> /r

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

      ---------------------------------------------------------------------   
    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.                                                      
      ---------------------------------------------------------------------   

  1.1.2 Scheduling CLI or Input file updates

   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 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 Input file overview

      ---------------------------------------------------------------------   
    IMPORTANT: The Input file contains both configuration details and target  
    node information. You can also add credentials and remote host            
    information for updates. Input files are plain-text files, for greater    
    security, omit the credentials from the file and pass them to HP SUM      
    using the command line. This requires that all nodes in the Input file    
    use the same user ID and password.                                        
      ---------------------------------------------------------------------   

   HP SUM CLI with Input files allows you to create .txt file scripts for
   updating multiple nodes, individual nodes, or groups of nodes (HP ProLiant
   and Integrity servers and options) within a single operation. Use any
   plain-text editor to create the Input file. It is similar to markup
   languages that require headers and trailers to match. Use commas,
   semicolons, or spaces as list separators for parameters that can take list
   values.

   After creating your script file, add it as the inputfile <filename>
   parameter to an HP SUM command line. For example, to run the Input file
   hpsum.in, type:

   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. Enclose the
   <filename> field in double quotes to enable paths with spaces.

      ---------------------------------------------------------------------   
    NOTE: There is no Input file parameter to open a firewall port. If you    
    want to open the firewall, add the parameter --open_firewall (Linux) or   
    /open_firewall (Windows). For example:                                    
                                                                              
    hpsum --inputfile hpsum.in (Linux) or hpsum /inputfile hpsum.in           
    (Windows).                                                                
      ---------------------------------------------------------------------   

   To modify an Input file without editing the file, use all of the command
   line options along with the Input file. The command line options take
   precedence over the commands in the Input file.

  1.2.1 Input file sections

   An Input file contains the following sections:

     o Configuration

     o Targets

   The table below explains the sections of a sample Input file.

 #Input file sample
 SILENT = YES
 IGNOREERRORS = ServerNotFound,BadPassword, FailedDepedencies
 SKIPTARGET = NO
 SOURCEPATH = C:\SPP
 FORCEALL = YES
 REBOOTALLOWED = YES
 REBOOTDELAY = 30
 REBOOTMESSAGE = "Install complete, server will reboot in 30 seconds"
 [TARGETS]
 HOST = 192.168.1.1
 UID = user
 PWD = password
 [END]
 [TARGETS]
 HOST = 192.168.1.2
 HOST = 192.168.1.2
 UID = user2
 PWD = password2
 [END]

+---------------------------------------------------------------------------------------------------+
|Input file example                                                  |Section      |Description     |
|--------------------------------------------------------------------+-------------+----------------|
|                                                                    |             |The             |
|                                                                    |             |configuration   |
|                                                                    |             |section assigns |
|                                                                    |             |all parameters  |
|                                                                    |             |for an Input    |
|#Input file sample                                                  |             |file. The       |
|SILENT = YES                                                        |             |configuration   |
|IGNOREERRORS = ServerNotFound,BadPassword, FailedDepedencies        |             |section ends at |
|SKIPTARGET = NO                                                     |             |the beginning of|
|SOURCEPATH = C:\SPP                                                 |Configuration|the TARGETS     |
|FORCEALL = YES                                                      |             |section.        |
|REBOOTALLOWED = YES                                                 |             |                |
|REBOOTDELAY = 30                                                    |             |Lines that begin|
|REBOOTMESSAGE = "Install complete, server will reboot in 30 seconds"|             |with a pound (#)|
|                                                                    |             |character are   |
|                                                                    |             |notes. No more  |
|                                                                    |             |than one pound  |
|                                                                    |             |character is    |
|                                                                    |             |allowed on a    |
|                                                                    |             |line.           |
|--------------------------------------------------------------------+-------------+----------------|
|[TARGETS]                                                           |             |The TARGETS     |
|HOST = 192.168.1.1                                                  |             |section defines |
|UID = user                                                          |Targets      |each node that  |
|PWD = password                                                      |             |you are         |
|[END]                                                               |             |updating.       |
|--------------------------------------------------------------------+-------------+----------------|
|                                                                    |             |If more than one|
|                                                                    |             |node uses the   |
|                                                                    |             |same user       |
|[TARGETS_GROUP_HOME]                                                |             |credentials,    |
|HOST = 192.168.1.2                                                  |             |list them all in|
|HOST = 192.168.1.2                                                  |             |the same TARGETS|
|UID = user2                                                         |Targets      |section.        |
|PWD = password2                                                     |             |                |
|[END]                                                               |             |You can add to a|
|                                                                    |             |[TARGETS] title |
|                                                                    |             |to provide an   |
|                                                                    |             |easy-to-remember|
|                                                                    |             |description.    |
+---------------------------------------------------------------------------------------------------+

      -----------------------------------------------   
    NOTE: Only one command is allowed per line of text. 
      -----------------------------------------------   

Chapter 2 CLI parameters

2.1 Management agent installation parameters

   G7 and earlier servers do not support AMS agents. The following tables
   show which new installations occur when you use the management agent
   parameters.

   To find out if you have any management agents installed, use HP SUM to
   create the Firmware Details Report. For example:

   $ ./hpsum --report --firmware_report --s (Linux)

   C:\ hpsum /report /firmware_report /s (Windows)

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

      ---------------------------------------------------------------------   
    NOTE: If the node already has management agents installed on it, HP SUM   
    upgrades the agents if a newer version is available.                      
                                                                              
    For example, if the node has SNMP installed on it, and you use the        
    use_ams parameter, AMS is installed and SNMP is upgraded, if a newer      
    version is available.                                                     
      ---------------------------------------------------------------------   

   +------------------------------------------------------------------------+
   |               Command                | G7 and earlier | Gen8 and later |
   |                                      |    servers     |    servers     |
   |--------------------------------------+----------------+----------------|
   | **If you provide no management agent |                |                |
   | parameters, HP SUM deploys:          | SNMP           | AMS            |
   |                                      |                |                |
   |--------------------------------------+----------------+----------------|
   | --no_mgmt (Linux)                    |                |                |
   |                                      |                |                |
   | /no_mgmt (Windows)                   |                |                |
   |                                      |                |                |
   | This parameter prevents any          | Nothing        | Nothing        |
   | installation or upgrade of SNMP,     |                |                |
   | AMS, and WBEM agents. It has no      |                |                |
   | impact on any management agents      |                |                |
   | installed on the system.             |                |                |
   |--------------------------------------+----------------+----------------|
   | --use_ams (Linux)                    |                |                |
   |                                      | Nothing        | AMS            |
   | /use_ams (Windows)                   |                |                |
   |--------------------------------------+----------------+----------------|
   | --use_snmp (Linux)                   |                |                |
   |                                      | SNMP           | SNMP           |
   | /use_snmp (Windows)                  |                |                |
   |--------------------------------------+----------------+----------------|
   |                                      |                |                |
   |                                      | WBEM           | WBEM           |
   | /use_wmi (Windows)                   |                |                |
   |--------------------------------------+----------------+----------------|
   | --use_ams --use_snmp (Linux)         |                |                |
   |                                      | SNMP           | AMS and SNMP   |
   | /use_ams /use_snmp (Windows)         |                |                |
   |--------------------------------------+----------------+----------------|
   |                                      |                |                |
   |                                      | WBEM           | AMS and WBEM   |
   | /use_ams /use_wmi (Windows)          |                |                |
   |--------------------------------------+----------------+----------------|
   |                                      |                |                |
   |                                      | WBEM and SNMP  | WBEM and SNMP  |
   | /use_wmi /use_snmp (Windows)         |                |                |
   |--------------------------------------+----------------+----------------|
   |                                      |                |                |
   |                                      |                | AMS, SNMP, and |
   |                                      | WBEM and SNMP  | WBEM           |
   | /use_ams /use_wmi /use_snmp          |                |                |
   | (Windows)                            |                |                |
   +------------------------------------------------------------------------+

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

  2.2.1 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.

    2.2.1.1 Help commands

   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) |                                         |
   +-------------------------------------------------------------------+

    2.2.1.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. Upgrades also occur when   |
   |                                   |you issue this command.             |
   |                                   |Can be used 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. Upgrades also occur when   |
   |                                   |you issue this command.             |
   |                                   |Can be used with downgrade          |
   |-----------------------------------+------------------------------------|
   |                                   |Limits components considered for    |
   |                                   |installation to only firmware       |
   |--romonly (Linux)                  |components. Cannot be used with     |
   |                                   |softwareonly. If neither            |
   |/romonly (Windows)                 |softwareonly nor 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 nor|
   |                                   |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. Specify components to      |
   |                                   |install with or without the         |
   |                                   |c[omponent] argument.               |
   |                                   |                                    |
   |                                   |If you use the c[omponent] argument,|
   |                                   |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, specify multiple          |
   |                                   |components separated by a blank     |
   |                                   |space, and listed after all other   |
   |                                   |arguments on the command line.      |
   |                                   |                                    |
   |--c[omponent]<component_to_install>|The utility installs components in  |
   |or <component1_to_install>         |the order provided unless           |
   |<component2_to_install> (Linux)    |dependencies between components     |
   |                                   |require installation in a different |
   |/c[omponent]<component_to_install> |order. If so, the utility changes   |
   |or <component1_to_install>         |the installation order based on the |
   |<component2_to_install> (Windows)  |component dependencies to ensure the|
   |                                   |successful installation of as many  |
   |                                   |components as possible.             |
   |                                   |                                    |
   |                                   |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. Specify bundles to install |
   |                                   |with or without the b[undle]        |
   |                                   |argument.                           |
   |--b[undle] <bundlename> (Linux)    |                                    |
   |                                   |Specify multiple components and     |
   |/b[undle] <bundlename> (Windows)   |bundles (see b[undle] <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 SPP 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 the 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.                           |
   |-----------------------------------+------------------------------------|
   |--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 not selected on the Deploy      |
   |/no_mgmt (Windows)                 |screen. In silent mode, HP          |
   |                                   |SUM does not update any management  |
   |                                   |components.                         |
   |-----------------------------------+------------------------------------|
   |--use_snmp (Linux)                 |HP SUM automatically selects the    |
   |/use_snmp (Windows)                |SNMP components for installation.   |
   |                                   |(Linux only) HP SUM also selects the|
   |                                   |SNMP RPMs and the smh_templates     |
   |                                   |RPMs.                               |
   |-----------------------------------+------------------------------------|
   |                                   |(Windows only) HP SUM automatically |
   |/use_wmi (Windows)                 |selects WBEM components for         |
   |                                   |deployment.                         |
   |-----------------------------------+------------------------------------|
   |--use_ams (Linux)                  |(Gen8 and later only) HP SUM        |
   |/use_ams (Windows)                 |automatically selects AMS components|
   |                                   |for deployment.                     |
   |-----------------------------------+------------------------------------|
   |--express_install (Linux)          |Starts the GUI and begins Localhost |
   |                                   |Guided Update in automatic mode.    |
   |/express_install (Windows)         |This parameter is ignored when the  |
   |                                   |/silent parameter is used.          |
   +------------------------------------------------------------------------+

    2.2.1.3 Override error commands

   The following table lists attributes used to override errors HP SUM
   encounters.

   +------------------------------------------------------------------------+
   |           Overriding errors            |          Description          |
   |----------------------------------------+-------------------------------|
   |                                        | If you have enabled TPM,      |
   |                                        | ignore the warning message    |
   | --tpmbypass or --ignore_tpm (Linux)    | and continue with component   |
   |                                        | installation. For more        |
   | /tpmbypass or /ignore_tpm (Windows)    | 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        |
   |                                        | phases.                       |
   |                                        |                               |
   | --ignore_warnings (Linux)              | Allows installation to        |
   |                                        | proceed after HP SUM receives |
   | /ignore_warnings (Windows)             | warnings on nodes. Some       |
   |                                        | warnings include:             |
   |                                        |                               |
   |                                        | Active member of a            |
   |                                        | Serviceguard cluster          |
   |                                        |                               |
   |                                        | HP-UX boot disk               |
   |                                        |                               |
   |                                        | Superdome 2/X OA              |
   |                                        |                               |
   |                                        | nodeps                        |
   |                                        |                               |
   |                                        | ignoresize                    |
   |----------------------------------------+-------------------------------|
   |                                        | Causes the installation to    |
   |                                        | continue and ignore errors.   |
   |                                        | Valid values are as follows:  |
   |                                        |                               |
   |                                        | <error>=ServerNotFound        |
   |                                        |                               |
   |                                        | <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)  |                               |
   +------------------------------------------------------------------------+

    2.2.1.4 Reboot commands

   The following table lists attributes used for rebooting the nodes.

   +------------------------------------------------------------------------+
   |      Reboot options       |                Description                 |
   |---------------------------+--------------------------------------------|
   |                           | The following conditions cause 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 Windows         |
   | /reboot_delay             | operating systems and 60 seconds for       |
   | timeout_in_secs (Windows) | 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.                |
   +------------------------------------------------------------------------+

    2.2.1.5 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)  |                                            |
   |---------------------------+--------------------------------------------|
   |                           | Use root (super user) username to start a  |
   |                           | session on a remote node, inventory, and   |
   |                           | update components when the credentials     |
   |                           | specified in username and passwd do not    |
   |                           | have root privileges to update components. |
   |                           |                                            |
   |                           | When the credentials specified in username |
   | --su_username (Linux)     | and passwd do not have root privileges to  |
   |                           | update components, use root (super user)   |
   | /su_username (Windows)    | username to start a session, and to        |
   |                           | inventory and update components Use with   |
   |                           | su_password                                |
   |                           |                                            |
   |                           | Use su_username with use_sudo access       |
   |                           | level.                                     |
   |                           |                                            |
   |                           | Do not use this command on the local host. |
   |---------------------------+--------------------------------------------|
   |                           | Use root (super user) username to start a  |
   |                           | session on a remote node, inventory, and   |
   |                           | update components when the credentials     |
   |                           | specified in username and passwd do not    |
   |                           | have root privileges to update components. |
   |                           |                                            |
   |                           | When the credentials specified in username |
   |                           | and passwd do not have root privileges to  |
   |                           | update components, use root (super user)   |
   |                           | password to start a session, and inventory |
   | --su_password (Linux)     | and update components Use with             |
   |                           | su_username.                               |
   | /su_password (Windows)    |                                            |
   |                           | Use su_password with use_sudo access       |
   |                           | level.                                     |
   |                           |                                            |
   |                           | Do not use this command on the local host. |
   |                           | To launch HP SUM on the local host using   |
   |                           | su, use the following example:             |
   |                           |                                            |
   |                           | su root                                    |
   |                           |                                            |
   |                           | hpsum --s --f --use_location /mnt/spp      |
   |---------------------------+--------------------------------------------|
   |                           | Specifies that username and password for a |
   |                           | remote node are sudo user credentials.     |
   |                           |                                            |
   |                           | When used with username and passwd,        |
   |                           | indicates that both are sudo user          |
   |                           | credentials.                               |
   | --use_sudo (Linux)        |                                            |
   |                           | Use use_sudo with su_username and          |
   | /use_sudo (Windows)       | su_password.                               |
   |                           |                                            |
   |                           | Do not use this command on the local host. |
   |                           | To use sudo on a local host, use the       |
   |                           | following command:                         |
   |                           |                                            |
   |                           | sudo hpsum --s --f --use_location /mnt/spp |
   |---------------------------+--------------------------------------------|
   |                           | 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 are:       |
   |                           |                                            |
   |                           | Windows                                    |
   |                           |                                            |
   |                           | Linux                                      |
   |                           |                                            |
   |                           | iLO                                        |
   |                           |                                            |
   |                           | HPUX                                       |
   |                           |                                            |
   |                           | fc_switch                                  |
   | --targettype "type"       |                                            |
   | (Linux)                   | oa                                         |
   |                           |                                            |
   | /targettype "type"        | SD2                                        |
   | (Windows)                 |                                            |
   |                           | 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, 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. Add multiple |
   |                           | VC nodes to command-line parameters with   |
   |                           | the "node" parameter only if the           |
   | --oa_password (Linux)     | 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:                            |
   |                           |                                            |
   |                           | Maximum 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:                            |
   |                           |                                            |
   |                           | Maximum 60 minutes, the default is 0       |
   |                           | minutes.                                   |
   |---------------------------+--------------------------------------------|
   |                           | Enter the IP address for the VMware        |
   |                           | vCenter.                                   |
   |                           |                                            |
   | --vcenter_host (Linux)    | Use this command with VMware vCenter nodes |
   |                           | to generate a ticket on VMware vCenters    |
   | /vcenter_host (Windows)   | that are in lock down mode. This command   |
   |                           | applies to all targets in the command      |
   |                           | line. For non-VMware nodes, the command is |
   |                           | ignored.                                   |
   |---------------------------+--------------------------------------------|
   | --vcenter_username (Linux)| Enter the username to login to the VMware  |
   |                           | vCenter. See the vcenter_host for more     |
   | /vcenter_username         | information.                               |
   | (Windows)                 |                                            |
   |---------------------------+--------------------------------------------|
   | --vcenter_password (Linux)| Enter the password to login to the VMware  |
   |                           | vCenter. See the vcenter_host for more     |
   | /vcenter_password         | information.                               |
   | (Windows)                 |                                            |
   |---------------------------+--------------------------------------------|
   | --skip_ilo (Linux)        | This command tells HP SUM to remove iLO    |
   |                           | smart components from an install set.      |
   | /skip_ilo (Windows)       | (Linux offline with EFM only)              |
   +------------------------------------------------------------------------+

    2.2.1.6 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.                     |
   |                 |                                                      |
   |                 | For Windows components, the default location is      |
   |                 | %SYSTEMDRIVE%\CPQSYSTEM\hp\log<netAddress> and the   |
   | --logdir "path" | redirected location is <path>\hp\log\<netAddress>.   |
   | (Linux)         |                                                      |
   |                 | HP SUM creates the %SYSTEMDRIVE%\CPQSYSTEM\          |
   | /logdir "path"  | directory as it processes components. HP SUM writes  |
   | (Windows)       | only the hpsum_log.txt, hpsum_detail_log.txt, and    |
   |                 | HPSUM_InstallDetails.txt files to the redirected     |
   |                 | directory. HP SUM writes other logs to the default   |
   |                 | directory,                                           |
   |                 |                                                      |
   |                 | 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)       |                                                      |
   +------------------------------------------------------------------------+

    2.2.1.7 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). Specify a node if
   you provide the appropriate credentials. 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, find the files in the same directory as the HP SUM log
   files.

   HP SUM generates reports in CSV format that opens in any application that
   supports CSV format.

   The HP SUM log files are located 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, the files are     |
   |                       | located 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, the report is     |
   |                       | located 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, the report is     |
   |                       | located 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 HP SUM saves         |
   |                       | reports. For example, hpsum --report           |
   | <report_type>         | ---reportdir /etc/user/reports.                |
   | /report_dir (Windows) |                                                |
   +------------------------------------------------------------------------+

    2.2.1.8 Input file commands

   Use the following commands to script the update of multiple or individual
   nodes, or groups of nodes. For details, see "Using the command line
   interface (CLI) with Input files"

   +------------------------------------------------------------------------+
   |     Using Input files      |                Description                |
   |----------------------------+-------------------------------------------|
   | --inputfile "filename"     | Create scripts for the deployment of      |
   | (Linux)                    | firmware and software to multiple remote  |
   |                            | systems at one time. For details, see     |
   | /inputfile "filename"      | "Using the command line interface (CLI)   |
   | (Windows)                  | with Input files".                        |
   |----------------------------+-------------------------------------------|
   | --deleteinputfile (Linux)  | Instruct HP SUM to delete the Input file  |
   |                            | after it has been read.                   |
   | /deleteinputfile (Windows) |                                           |
   +------------------------------------------------------------------------+

    2.2.1.9 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. Choose ALL, COMPLEX, or       |
   |                            | PARTITIONS. The default selection is ALL. |
   | /update_type <type>        |                                           |
   | (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          |
   +------------------------------------------------------------------------+

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

  2.2.3 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.                             |
   +------------------------------------------------------------------------+

  2.2.4 Linux smart-component and firmware RPM return codes

   Single-node server

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

  2.2.5 Linux software RPM return codes

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

  2.2.6 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:                                               |
   |             |                                                          |
   |             |   o The version to be installed is older than the        |
   |             |     version already installed.                           |
   |             |                                                          |
   | 3           |   o The supported hardware is not present, not enabled,  |
   |             |     or in a state that an installation could not be      |
   |             |     attempted.                                           |
   |             |                                                          |
   |             |   o The smart component does not support the             |
   |             |     environment.                                         |
   |             |                                                          |
   |             |   o There is nothing for the component to accomplish.    |
   |-------------+----------------------------------------------------------|
   |             | If the component is 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.                                            |
   +------------------------------------------------------------------------+

Chapter 3 CLI with Input file parameters

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

  3.1.1 Input file format and rules

   When using an Input file, you must include the target nodes and baseline
   you want to use. If you are running HP SUM in a directory that includes a
   baseline, HP SUM uses the baseline in that directory by default.

    3.1.1.1 Component-specific configuration

   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).

   For more information on using the interactive CLI, see the HP Smart Update
   Manager User Guide.

   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-x64                |
|                                              |Enterprise Linux|                                     |
|                                              |7 (AMD64/EM64T) |                                     |
|----------------------------------------------+----------------+-------------------------------------|
|                                              |HP SNMP Agents  |                                     |
|                                              |for SUSE Linux  |                                     |
|hp-snmp-agents-10.10-2732.34.sles12.x86_64.rpm|Enterprise      |hpsnmpagent-sles12-x64               |
|                                              |Server 12       |                                     |
|                                              |(AMD64/EM64T)   |                                     |
+-----------------------------------------------------------------------------------------------------+

   Use the following syntax to use when you configure components with an
   Input file:

   [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
   hpsnmpagent-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]

  3.1.2 File encoding

   To permit double-byte characters, the Input file is in UTF-8 format.

  3.1.3 Error reporting

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

  3.1.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. 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 selected the REBOOTALWAYS option or     |
   |                           |provided it as an Input file argument.      |
   |                           |                                            |
   |                           |All components selected for installation are|
   |                           |successfully installed.                     |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |REBOOTMESSAGE              |Any string (not exceeding 256 characters)   |
   |                           |                                            |
   |                           |Creates a message to be displayed prior to  |
   |                           |rebooting.                                  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |REBOOTDELAY                |Time in seconds                             |
   |                           |                                            |
   |                           |Adds 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   |
   |                           |SPP or bundle.                              |
   |                           |                                            |
   |                           |Allows these components to replace the older|
   |                           |versions of the same component that might   |
   |                           |have shipped with the bundles.              |
   |---------------------------+--------------------------------------------|
   |                           |This specifies the 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.                           |
   |                           |   ---------------------------------------  |
   |---------------------------+--------------------------------------------|
   |                           |This parameter causes the installation and  |
   |                           |ignore errors.                              |
   |                           |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |ServerNotFound - Bypasses inactive or       |
   |                           |unavailable remote hosts when deploying     |
   |                           |firmware or software to multiple remote     |
   |                           |hosts at the same time.                     |
   |                           |                                            |
   |                           |BadPassword - Bypasses remote nodes that    |
   |IGNOREERRORS               |report incorrect credentials provided and   |
   |                           |continue with other nodes.                  |
   |                           |                                            |
   |                           |FailedDependencies - Ignores any nodes with |
   |                           |failed dependencies and proceeds with nodes |
   |                           |that are ready.                             |
   |                           |                                            |
   |                           |   ---------------------------------------  |
   |                           | NOTE: This can be overridden by using      |
   |                           | ONFAILEDDEPENDENCY = OmitComponent or      |
   |                           | Force.                                     |
   |                           |   ---------------------------------------  |
   |---------------------------+--------------------------------------------|
   |                           |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                                     |
   |                           |                                            |
   |                           |Specifies availability of components using  |
   |USESNMP                    |SNMP 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                                     |
   |                           |                                            |
   |ROMONLY                    |Limits components considered for            |
   |                           |installation to only firmware               |
   |                           |components. Cannot be used with             |
   |                           |softwareonly. If neither softwareonly nor   |
   |                           |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 nor 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.                     |
   |---------------------------+--------------------------------------------|
   |                           |Tells HP SUM how to proceed when a component|
   |                           |has a failed dependency.                    |
   |                           |                                            |
   |                           |Possible values:                            |
   |                           |                                            |
   |                           |OmitHost (default) - Puts the host in a     |
   |                           |failure state, and HP SUM does not attempt  |
   |ONFAILEDDEPENDENCY         |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, 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. 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. 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                   |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   |
   |                           |include:                                    |
   |                           |                                            |
   |IGNOREWARNINGS             |Active member of a Serviceguard cluster     |
   |                           |                                            |
   |                           |HP-UX boot disk                             |
   |                           |                                            |
   |                           |Superdome 2/X OA                            |
   |                           |                                            |
   |                           |nodeps                                      |
   |                           |                                            |
   |                           |ignoresize                                  |
   |---------------------------+--------------------------------------------|
   |                           |Possible values:                            |
   |                           |                                            |
   |UPDATETYPE                 |ALL, COMPLEX, PARTITIONS                    |
   |                           |                                            |
   |                           |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                 |For 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                 |                                            |
   |                           |For 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, 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, 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, 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, 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:                                    |
   |                  |                                                     |
   |                  | <superusername>                                     |
   |                  |                                                     |
   |                  | Use this argument to provide a superuser username.  |
   |                  |                                                     |
   | SUUSERNAME       | Do not use SUUSERNAME with USESUDO access level.    |
   |                  |                                                     |
   |                  | Use root (super user) username to start a session   |
   |                  | on a remote node, inventory, and update components  |
   |                  | when the credentials specified in SUUSERNAME and    |
   |                  | SUPASSWORD do not have root privileges to update    |
   |                  | components.                                         |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   |                  |                                                     |
   |                  | <superuserpassword>                                 |
   |                  |                                                     |
   |                  | Use this argument to provide a superuser password.  |
   |                  |                                                     |
   | SUPASSWORD       | SUPASSWORD cannot be used with USESUDO access       |
   |                  | level.                                              |
   |                  |                                                     |
   |                  | Use root (super user) username to start a session   |
   |                  | on a remote node, inventory, and update components  |
   |                  | when the credentials specified in SUUSERNAME and    |
   |                  | SUPASSWORD do not have root privileges to update    |
   |                  | components.                                         |
   |------------------+-----------------------------------------------------|
   |                  | Possible values:                                    |
   |                  |                                                     |
   |                  | Yes, No                                             |
   |                  |                                                     |
   |                  | Allows use of the sudo command.                     |
   |                  |                                                     |
   |                  | When you specify USESUDO = YES in the Input file,   |
   |                  | along with UID and PWD, the specified UID and PWD   |
   | USESUDO          | are considered sudo users.                          |
   |                  |                                                     |
   |                  | You cannot use USESUDO with SUUSERNAME and          |
   |                  | SUPASSWORD access level.                            |
   |                  |                                                     |
   |                  | Specifies that username and password 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.                      |
   |------------------+-----------------------------------------------------|
   |                  | Enter the IP address for the VMware vCenter.        |
   |                  |                                                     |
   | /VCENTER_HOST    | Use this command with VMware vCenters to generate a |
   |                  | ticket on VMware vCenters that are in lock down     |
   |                  | mode.                                               |
   |------------------+-----------------------------------------------------|
   |                  | Enter the username to login to the VMware vCenter.  |
   | /VCENTER_USERNAME|                                                     |
   |                  | See VCENTER_HOST for more information.              |
   |------------------+-----------------------------------------------------|
   |                  | Enter the password to login to the VMware vCenter.  |
   | /VCENTER_PASSWORD|                                                     |
   |                  | See VCENTER_HOST for more information.              |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine VC-Enet module        |
   |                  | activation order.                                   |
   |                  |                                                     |
   |                  | Possible value:                                     |
   |                  |                                                     |
   | /ETHACTORDER     | ODDEVEN (default)                                   |
   |                  |                                                     |
   |                  | PARALLEL                                            |
   |                  |                                                     |
   |                  | SERIAL                                              |
   |                  |                                                     |
   |                  | MANUAL                                              |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine VC-FC activation      |
   |                  | order.                                              |
   |                  |                                                     |
   |                  | Possible value:                                     |
   |                  |                                                     |
   | /FCACTORDER      | ODDEVEN (default)                                   |
   |                  |                                                     |
   |                  | PARALLEL                                            |
   |                  |                                                     |
   |                  | SERIAL                                              |
   |                  |                                                     |
   |                  | MANUAL                                              |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine the time, in minutes, |
   |                  | between activating or rebooting VC-Enet modules     |
   | /ETHACTDELAY     |                                                     |
   |                  | Possible value:                                     |
   |                  |                                                     |
   |                  | 0 (default) to 60 minutes.                          |
   |------------------+-----------------------------------------------------|
   |                  | Use this command to determine the time to wait      |
   |                  | between activating or rebooting VC-FC modules.      |
   | /FCACTDELAY      |                                                     |
   |                  | Possible value:                                     |
   |                  |                                                     |
   |                  | 0 (default) to 60 minutes.                          |
   +------------------------------------------------------------------------+

  3.1.5 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.
