HP Smart Update Manager CLI Help Copyright (c) 2009, 2012 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Acknowledgments Microsoft(R), Windows(R), Windows Vista(R), and Windows Server(R) are U.S. registered trademarks of Microsoft Corporation. May 2012 Abstract This guide is intended for individuals familiar with the configuration and operation of Microsoft Windows, Windows Server, Linux, smart components, and deployment of firmware and software. Because of the risk of data loss, only individuals experienced with using firmware and software should implement the procedures. ---------------------------------------------------------------------- Chapter 1 Scripted deployment 1.1 Command-line interface The HP SUM command-line interface enables you to script custom installations. For more information on using HP SUM, see the HP Smart Update Manager User's Guide HP SUM documentation website at http://www.hp.com/go/hpsum/documentation. 1.1.1 Command-line syntax The general command-line syntax for HP SUM is: hpsum [/h[elp]] [/?] [/f[orce]] [/f[orce]:bundle] [/f[orce]:rom] [/f[orce]:software] [/f[orce]:all ] [/g (/downgrade)] [/e (/rewrite) [/r[eboot]] [/reboot_message "reboot message"] [/reboot_delay timeout_in_seconds] [/reboot_always] [/s[ilent]] [/c[omponent] ] [/group "group_name"] [/b[undle] ] [/allow_update_to_bundle] [/allow_non_bundle_components] [/use_latest] [/use_location "file_share"] [/use_web] [/use_d[ownloaded]] [/tpmbypass] [/ignore_tpm] [/use_snmp] [/use_wmi] [/use_ams][/romonly] [/softwareonly] [/dryrun] [/continue_on_error ] [/override_existing_connection] [/express_install] [/user or /username ] [/passwd ] [/current_credential] [/target "netAddress"] [/logdir "path"] [/v[erbose]] [/veryv[erbose]] [/report][/inventory_report] [/firmware_report] [/On_failed_dependency:] [/oa_username ] [/oa_password ] [/use_proxy ] [/proxy_script ] [/proxy_user ] [/proxy_passwd ][/inputfile "filename"] [/c[omponent] ][ ...][ ...] The following commands are only supported by Superdome 2 servers: [/update_type] [/device_list ] [/reboot_list ] HP SUM with Onboard Administrator requires a user ID and password to log in. The user ID must be an administrator equivalent ID and not an operator or user equivalent level ID. [Note] Note: All arguments and information enclosed in brackets are optional. The arguments may be prefixed with either a '-' or '/' character. These examples show only the '/'. On Windows operating systems, use a slash (/) before each argument. On Linux operating systems, use a hyphen (-) before each argument. If the /s[ilent] argument is not included on the command line, the HP SUM GUI appears. [Note] Note: Command line syntax does not support double-byte character sets. Any messages entered through the command line using a double-byte character set will not be displayed correctly. 1.1.1.1 Switch update commands G7 and earlier servers do not support AMS agents. The following tables show what updates occur when you use the switch agent commands. The following table shows what updates if no switches are currently installed: +-----------------------------------------------------------------+ | Command | G7 and earlier | Gen8 | |---------------------------+----------------+--------------------| | no switches | SNMP | AMS | |---------------------------+----------------+--------------------| | /use_ams | Nothing | AMS | |---------------------------+----------------+--------------------| | /use_snmp | SNMP | SNMP | |---------------------------+----------------+--------------------| | /use_wmi | WBEM | WBEM | |---------------------------+----------------+--------------------| | /use_ams/use_snmp | SNMP | AMS and SNMP | |---------------------------+----------------+--------------------| | /use_ams/use_wmi | WBEM | AMS and WBEM | |---------------------------+----------------+--------------------| | /use_wmi/use_snmp | WBEM and SNMP | WBEM and SNMP | |---------------------------+----------------+--------------------| | /use_ams/use_wmi/use_snmp | WBEM and SNMP | AMS, SNMP and WBEM | +-----------------------------------------------------------------+ The following table shows what updates if SNMP switches are currently installed: +-----------------------------------------------------------------+ | Command | G7 and earlier | Gen8 | |---------------------------+----------------+--------------------| | no switches | SNMP | SNMP | |---------------------------+----------------+--------------------| | /use_ams | SNMP | SNMP and AMS | |---------------------------+----------------+--------------------| | /use_snmp | SNMP | SNMP | |---------------------------+----------------+--------------------| | /use_wmi | WBEM and SNMP | WBEM and SNMP | |---------------------------+----------------+--------------------| | /use_ams/use_snmp | SNMP | AMS and SNMP | |---------------------------+----------------+--------------------| | /use_ams/use_wmi | WBEM and SNMP | AMS, SNMP and WBEM | |---------------------------+----------------+--------------------| | /use_wmi/use_snmp | WBEM and SNMP | WBEM and SNMP | |---------------------------+----------------+--------------------| | /use_ams/use_wmi/use_snmp | WBEM and SNMP | AMS, SNMP and WBEM | +-----------------------------------------------------------------+ The following table shows what updates if WBEM switches are currently installed: +-----------------------------------------------------------------+ | Command | G7 and earlier | Gen8 | |---------------------------+----------------+--------------------| | no switches | WBEM | WBEM | |---------------------------+----------------+--------------------| | /use_ams | WBEM | WBEM and AMS | |---------------------------+----------------+--------------------| | /use_snmp | WBEM and SNMP | WBEM and SNMP | |---------------------------+----------------+--------------------| | /use_wmi | WBEM | WBEM | |---------------------------+----------------+--------------------| | /use_ams/use_snmp | WBEM and SNMP | AMS, SNMP and WBEM | |---------------------------+----------------+--------------------| | /use_ams/use_wmi | WBEM | WBEM and AMS | |---------------------------+----------------+--------------------| | /use_wmi/use_snmp | WBEM and SNMP | WBEM and SNMP | |---------------------------+----------------+--------------------| | /use_ams/use_wmi/use_snmp | WBEM and SNMP | AMS, SNMP and WBEM | +-----------------------------------------------------------------+ AMS already Installed - G7 and earlier servers do not support AMS +-----------------------------------------------------------------+ | Command | G7 and earlier | Gen8 | |---------------------------+----------------+--------------------| | no switches | N/A | AMS | |---------------------------+----------------+--------------------| | /use_ams | N/A | AMS | |---------------------------+----------------+--------------------| | /use_snmp | N/A | AMS and SNMP | |---------------------------+----------------+--------------------| | /use_wmi | N/A | AMS and WBEM | |---------------------------+----------------+--------------------| | /use_ams/use_snmp | N/A | AMS and SNMP | |---------------------------+----------------+--------------------| | /use_ams/use_wmi | N/A | AMS and WBEM | |---------------------------+----------------+--------------------| | /use_wmi/use_snmp | N/A | AMS, SNMP and WBEM | |---------------------------+----------------+--------------------| | /use_ams/use_wmi/use_snmp | N/A | AMS, SNMP and WBEM | +-----------------------------------------------------------------+ 1.1.2 Command-line arguments This version of HP SUM recognizes the following command-line arguments. These arguments can be used to pre-populate the GUI in the Source Selection and Review/Install Updates screens. If you specify the target and credentials, then the /s[ilent] parameter is required to proceed with the installation. You cannot use some arguments, such as /romonly and /softwareonly together. +-----------------------------------------------------------------------+ | Help | Description | |---------------+-------------------------------------------------------| | /h[elp] or /? | This argument displays command line help information. | +-----------------------------------------------------------------------+ +------------------------------------------------------------------------+ | Installation options | Description | |---------------------------------------+--------------------------------| | | This argument enables you to | | | override or downgrade an | | /f[orce] | existing component | | | installation. This argument | | | produces the same results as | | | /f:software. | |---------------------------------------+--------------------------------| | | This argument enables you to | | | override or downgrade the | | /f[orce]:bundle | existing installation of | | | components in the selected | | | bundle. | |---------------------------------------+--------------------------------| | | This argument enables you to | | | override or downgrade the | | /f[orce]:rom | existing installation of the | | | selected firmware components | | | (applies to firmware only). | |---------------------------------------+--------------------------------| | | This argument enables you to | | /f[orce]:software | override or downgrade the | | | existing installation of the | | | selected software components. | |---------------------------------------+--------------------------------| | | This argument enables you to | | | override or downgrade the | | /f[orce]:all | existing installation of the | | | selected software components, | | | firmware components, and | | | bundles. | |---------------------------------------+--------------------------------| | | This argument enables you to | | | downgrade to an earlier | | | version of firmware for | | /g or /downgrade | multi-target devices such as | | | hard drives and array | | | controllers (applies to | | | firmware only). | |---------------------------------------+--------------------------------| | | This argument enables you to | | | downgrade to an earlier | | | version of firmware for | | /e or /rewrite | multi-target devices such as | | | hard drives and array | | | controllers (applies to | | | firmware only). | |---------------------------------------+--------------------------------| | | This argument causes the | | | installation to run silently | | | with no GUI or console output. | | | All data writes to the log | | | file. Any generated prompts | | | use the default option and | | | continue the installation | | | without user input. If a | | | component requires input | | | before installation (such as | | | configuration information), | | /s[ilent] | then the component | | | installation fails, and an | | | error message writes to the | | | log file. | | | | | | Failed dependencies are not | | | reported to the user when | | | using the /s[ilent] argument. | | | To check for failed | | | dependencies, remove the | | | /s[ilent] argument and reissue | | | the command line. The HP SUM | | | GUI appears. | |---------------------------------------+--------------------------------| | | This argument specifies | | | components to install. | | | Components to install can be | | | specified with or without the | | | /c[omponent] argument. | | | | | | o If using the /c[omponent] | | | argument, then only one | | | component can specified | | | with the argument. | | | However, multiple /c | | | arguments and components | | | can be specified on the | | | same line. | | | | | | o If the /c[omponent] | | | argument is not used, then | | | multiple components can be | | | specified at the same | | | time, but the components | | | must be separated by a | | | blank and listed after all | | /c[omponent] or | the arguments on the | | | command line. | | | | | | o The components are | | | installed in the order | | | provided unless | | | dependencies between | | | components require | | | installation in a | | | different order. If so, | | | the utility changes the | | | installation order based | | | on the component | | | dependencies to ensure the | | | successful installation of | | | as many components as | | | possible. | | | | | | o Multiple components and | | | bundles can be specified | | | on the same command line. | | | When mixing components and | | | bundles on the command | | | line, the filter switches | | | control what components | | | and bundles are installed. | |---------------------------------------+--------------------------------| | | This argument specifies an | | /group "group_name" | already defined group name in | | | the HP SUM graphical user | | | interface. | |---------------------------------------+--------------------------------| | | This argument specifies | | | bundles to install. Bundles to | | | install can be specified with | | | or without the /b[undle] | | | argument. | | | | | | o If using the /b[undle] | | | argument, then only one | | | bundle can specified with | | | the argument. However, | | | multiple /b arguments and | | | bundles can be specified | | | on the same line. | | | | | | o If the /b[undle] argument | | | is not used, multiple | | | bundles can be specified | | | at the same time, but the | | | bundles need to be | | | separated by a blank and | | | listed after all the | | | arguments on the command | | /b[undle] or | line. | | | | | | This argument specifies | | | bundles to install. | | | Bundles to install can be | | | specified with or without | | | the /b[undle] argument. | | | | | | If using the /b[undle] | | | argument, then only one | | | bundle can specified with | | | the argument. However, | | | multiple /b arguments and | | | bundles can be specified | | | on the same line. | | | | | | If the /b[undle] argument | | | is not used, multiple | | | bundles can be specified | | | at the same time, but the | | | bundles need to be | | | separated by a blank and | | | listed after all the | | | arguments on the command | | | line. | |---------------------------------------+--------------------------------| | | This argument is a filter | | | switch and enables the user to | | | install newer versions of | | | components defined in a PSP, | | | ISP, or firmware bundle. | | /allow_update_to_bundle | | | | This argument enables these | | | components to replace the | | | older versions of the same | | | component that might have | | | shipped with the bundles. | |---------------------------------------+--------------------------------| | | This argument is a filter | | | switch and enables the user to | | /allow_non_bundle_components | install components which are | | | not included in the bundle but | | | reside in the directory with | | | the components in the bundle. | |---------------------------------------+--------------------------------| | | This argument is a filter | | | switch for use with bundles. | | | The argument enables the | | | latest version of the bundle | | | to be used when multiple | | | versions of bundles are listed | | /use_latest | on the command line. If there | | | are no bundles specified on | | | the command line, and multiple | | | bundles are in the directory, | | | the /use_latest argument | | | allows HP SUM to use the | | | bundle with the latest version | | | for installation. | |---------------------------------------+--------------------------------| | | This argument specifies a | | | directory or file share that | | | contains the PSP, ISP, and | | | components for use with HP | | | SUM. The file_share format | | | must be a mapped file share | | | and not in Universal Naming | | | Convention (UNC) format. If | | | this argument is not | | | specified, the directory | | /use_location "file_share" | containing hpsum.exe or HP SUM | | | is used by default. | | | | | | The logged-in account must | | | have access to this location. | | | | | | The /user and /passwd | | | arguments do not have any | | | effect when attempting to | | | access the file share. Use | | | those arguments only when | | | connecting to a target system. | |---------------------------------------+--------------------------------| | | This argument specifies that | | | the checkbox for Check | | | ftp.hp.com on the Source | | /use_web | Selection screen is selected. | | | This enables components to be | | | retrieved from ftp.hp.com and | | | used in the list of possible | | | updates. | |---------------------------------------+--------------------------------| | | This argument enables the | | | inclusion of a proxy server | | | (and port number) to access | | /use_proxy | ftp.hp.com. This parameter | | | must be used with /use_web. | | | For example, /use_web | | | /use_proxy <1.22.33.44:80>. | |---------------------------------------+--------------------------------| | | This argument enables the | | | inclusion of a proxy script to | | | access ftp.hp.com. This | | /proxy_script | parameter must be used with | | | /use_web. For example, | | | /use_web /proxy_script | | | . | |---------------------------------------+--------------------------------| | | This argument sets the | | /proxy_password | password to be used for an | | | authenticating proxy server. | |---------------------------------------+--------------------------------| | | This argument specifies that | | | the checkbox for Use last | | | downloaded repository from | | | ftp.hp.com on the Source | | /use_d[ownloaded] | Selection screen in the GUI is | | | selected. This enables the | | | previously downloaded | | | components to be included in | | | the list of possible updates. | |---------------------------------------+--------------------------------| | | This argument specifies that | | | components that use SNMP | | | protocol and the AMS | | | components are available for | | /use_snmp | installation by default. When | | | the /use_snmp argument is | | | used, the AMS components are | | | required, but the WMI | | | components are optional. | |---------------------------------------+--------------------------------| | | This argument specifies that | | | components that use WMI | | | protocol are available for | | | installation. These components | | | are optional and are not | | | installed unless this argument | | /use_wmi | is used. When the /use_wmi | | | argument is used, and the | | | /use_snmp & /use_ams arguments | | | are not, the SNMP and AMS | | | components are optional. This | | | argument does not apply to HP | | | Integrity Servers. | |---------------------------------------+--------------------------------| | | This argument specifies that | | | components which Agentless | | | Monitoring service (AMS) | | | components can be installed | | | along with SNMP components. | | /use_ams | The AMS and SNMP components | | | are available to select by | | | default. When the /use_ams | | | argument is used, the SNMP | | | components are required, and | | | the WMI components are | | | optional. | |---------------------------------------+--------------------------------| | | This argument is a filter | | | switch and allows the user to | | | only see the firmware | | | components needed for | | | installation. When using this | | | filter switch, you must exit | | /romonly | and restart HP SUM if you wish | | | to return to an unfiltered | | | state. | | | | | | Do not use the /romonly | | | argument with the | | | /softwareonly argument. | | | (Applies to firmware only.) | |---------------------------------------+--------------------------------| | | This argument is a filter | | | switch and allows the user to | | | only see the software | | | components needed for | | | installation. When using this | | | filter switch, you must exit | | /softwareonly | and restart HP SUM if you wish | | | to return to an unfiltered | | | state. | | | | | | Do not use the /softwareonly | | | argument with the /romonly | | | argument. | |---------------------------------------+--------------------------------| | | This argument starts express | | | install (for local host only). | | | The HP SUM performs discovery, | | | install, or exit without user | | | interaction. The user can | | | cancel or terminate HP SUM. An | | | express installation will | | | force install all components | | | in the default repository and | | /express_install | may downgrade drivers and | | | firmware to the versions in | | | the default directory as part | | | of the installation operation. | | | The express installation | | | feature is intended to allow | | | the user to set a baseline and | | | enforce it regardless of the | | | currently installed version of | | | drivers and firmware on the | | | local server. | +------------------------------------------------------------------------+ +------------------------------------------------------------------------+ | Overriding errors | Description | |-------------------------------+----------------------------------------| | | These arguments specifies that if a | | | Trusted Platform Module (TPM) is | | /tpmbypass or /ignore_tpm | enabled, the warning message should be | | | ignored and component installation | | | will be allowed to continue. For more | | | information about TPM, see ???. | |-------------------------------+----------------------------------------| | | This argument allows the installation | | /ignore_warnings | to proceed on a Superdome 2 target | | | even when warnings are returned during | | | analysis. | |-------------------------------+----------------------------------------| | | This argument causes the installation | | | to continue and ignore errors. Valid | | | values are : | | | | | | * =ServerNotFound and | | | | | | * =BadPassword. | | /continue_on_error | | | | * =FailedDependencies | | | | | | The ServerNotFound option can be used | | | to bypass inactive or unavailable | | | remote hosts when deploying firmware | | | or software to multiple remote hosts | | | at the same time. | |-------------------------------+----------------------------------------| | | This argument is used to define the | | | behavior when a remote target has an | | /override_existing_connection | existing HP SUM session in progress. | | | It overrides the session in progress | | | and re-initializes the installation | | | framework on the remote host. | |-------------------------------+----------------------------------------| | | This argument provides HP SUM | | | the information of how to | | | proceed when a component has a failed | | | dependency. The supported parameters | | | for this argument are Omit_Host | | | (default), Omit_Component and Force. | | /On_failed_dependency: | Omit_Host causes the host to be put | | | into a failure state and no | | | installation is attempted. | | | Omit_Component deselects the affected | | | component(s) and proceeds with any | | | updates that do not have dependency | | | failures. Force attempts all updates, | | | even if they have dependency failures. | |-------------------------------+----------------------------------------| | /partition_only | Use this argument to select a | | | partition to update. | |-------------------------------+----------------------------------------| | | Use these arguments if you do not use | | | the /partition_only argument. If you | | /oa_name and /oa_password | do not enter the selections, then the | | | update will display and error and | | | exit. | +------------------------------------------------------------------------+ +------------------------------------------------------------------------+ | Reboot options | Description | |-------------------------+----------------------------------------------| | | If the following conditions are met, this | | | argument causes the server (or host server | | | in a remote installation) to reboot: | | | | | | o The /reboot option is selected or given | | | as a command-line argument. | | /r[eboot] | | | | o All components selected for installation | | | are successfully installed. | | | | | | o At least one of the installed components | | | requires a reboot to complete its | | | installation. | |-------------------------+----------------------------------------------| | | This argument displays the specified reboot | | /reboot_message "reboot | message on remote consoles connected to the | | message" | server you want to reboot. You must use this | | | argument with the /reboot option or the | | | argument is ignored. | |-------------------------+----------------------------------------------| | | This argument delays the reboot of the | | | server for the length of time specified by | | | the timeout_in_seconds variable. You must | | | use this argument with the /reboot option, | | | or the argument is ignored. Acceptable | | | values are between 15 and 3600. | | | | | /reboot_delay | o The default timeout value is 15 seconds | | timeout_in_secs | for Microsoft Windows operating systems | | | and 60 seconds for Linux. | | | | | | o For Linux, the Reboot Delay time is | | | converted from seconds to minutes, and | | | any value under a full minute, 59 | | | seconds or less, rounds to the next | | | minute. | |-------------------------+----------------------------------------------| | | o If the following conditions are met, | | | this argument forces the server to | | | reboot: The /reboot_always option is | | /reboot_always | selected or given as a command-line | | | argument. | | | | | | o All components selected for installation | | | are successfully installed. | +------------------------------------------------------------------------+ +------------------------------------------------------------------------+ | Simulating HP SUM | Description | |-------------------+----------------------------------------------------| | /dryrun | This argument simulates the installation for a | | | test run. Nothing is installed. | +------------------------------------------------------------------------+ +------------------------------------------------------------------------+ | Targets | Description | |----------------------+-------------------------------------------------| | /user or | This argument enables you to log in to the | | /username | remote targets with the user ID. For the OA | | | target, see /oa_username argument. | |----------------------+-------------------------------------------------| | | This argument enables you to use this password | | | for the user ID specified in the /user | | /psswd | parameter (except for the OA target). The | | | password is used to log in to remote targets. | | | For the OA target, see /oa_password argument. | |----------------------+-------------------------------------------------| | | This argument is the IP address or the DNS name | | | of a remote host which can be remote server, | | | remote iLO NIC port, Virtual Connect Ethernet | | | or Fibre Channel Module for c-Class | | | BladeSystem, or BladeSystem Onboard | | /target "netAddress" | Administrator(OA). | | | | | | When two Onboard Administrators are in an | | | enclosure, this argument should be the active | | | Onboard Administrator.When specifying the IP | | | address, use either the IPv4 or IPv6 format. | |----------------------+-------------------------------------------------| | | This argument enables the credential of the | | | local host to be used as the credential to | | | access the targets instead of providing the | | /current_credential | username and password explicitly for each | | | target. The assumption is that the current | | | credential is valid for the targets being | | | accessed. (Applies to Windows only) | |----------------------+-------------------------------------------------| | | This argument provides the username credential | | | for OA associated with VC specified with | | | "target" command-line parameter. Only one set | | | of OA credentials can be specified with | | | command-line parameters. You can only add | | | multiple VC targets to command-line parameters | | | with "target" parameter if the credentials of | | | OAs associated with specified VCs are the same. | | /oa_username | The argument oa_username is not required if VC | | | has the same credentials as the associated OA. | | | You do not need to provide an OA network | | | address associated with Virtual Connect. HP SUM | | | queries it from a specified VC target. | | | | | | To update multiple VCs with different username | | | and password or VCs with OAs which have | | | different credentials, the corresponding input | | | files OAUID and OAPWD must be used. | |----------------------+-------------------------------------------------| | | This argument provides the password credential | | | for associated with VC specified with "target" | | | command-line parameter. Only one set of OA | | | credentials can be specified with command-line | | | parameters. You can only add multiple VC | | | targets to command-line parameters with | | | "target" parameter if the credentials of OAs | | | associated with specified VCs are the same. The | | /_password | argument oa_password is not required if VC has | | | the same credentials as the associated OA. You | | | do not need to provide an OA network address | | | associated with Virtual Connect. HP SUM queries | | | it from a specified VC target. | | | | | | To update multiple VCs with different username | | | and password or VCs with OAs which have | | | different credentials, the corresponding input | | | files OAUID and OAPWD must be used. | +------------------------------------------------------------------------+ +------------------------------------------------------------------------+ | Log files | Description | |----------------+-------------------------------------------------------| | | This argument enables you to redirect the output from | | | HP SUM or the HP BladeSystem c-Class Onboard | | | Administrator flash utility to a different directory | | | than the default location. | | | | | | o For Windows components, the default location | | /logdir "path" | is%SYSTEMDRIVE%\CPQSYSTEM\hp\log and | | | the redirected location is | | | \hp\log\. | | | | | | o For Linux components, the default location | | | is/var/hp/log/ and the redirected | | | location is /hp/log/. | |----------------+-------------------------------------------------------| | | These arguments enable you to set the verbosity level | | | for the HP SUM execution log file, | | /v[erbose] or | hpsum_execution_log__