hpsum(8) USER COMMANDS hpsum(8) NAME hpsum - HP SUM Smart Update Manager SYNOPSIS Interactive Console Mode (technology preview) hpsum console_command [options] [args] (Legacy Commands) hpsum /s[ilent] [/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] [/c[omponent] ] [/group "group_name"] [/b[undle] ] [/allow_update_to_bundle] [/allow_non_bundle_compo- nents] [/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_cre- dential] [/target "netAddress"] [/logdir "path"] [/v[erbose]] [/veryv[erbose]] [/report][/inventory_report] [/firmware_report] [/On_failed_dependency:] [/oa_username ] [/oa_passwd ] [/use_proxy ] [/proxy_script ] [/proxy_user ] [/proxy_passwd ][/inputfile "filename"] [/c[omponent] ][ ...][ ...] NOTE: All arguments and information enclosed in brackets are optional. The argument may be prefixed with either a '-' or '/' character. These examples show only the '/'. DESCRIPTION HP Smart Update Manager recognizes the following command line argu- ments. These arguments pre-populate the GUI in the Select Items to be Installed screen. If /silent or /s command line arguments are apeci- fied, HPSUM runs in silent mode without any GUI or console messages. If no command line arguments are provided on the command line, the HP Smart Update Manager(HPSUM) GUI appears. OPTIONS To start HP SUM in interactive GUI mode: hpsum [--port <#>] [--ssl_port <#>] [--open_firewall] To use interactive console mode (technology preview): hpsum [--help | --h] For hpsum Console information: hpsum --help to access the built-in hpsum documentation. For hpsum CLI (legacy command) information: hpsum --s [--help | --h] /h[elp] or /? This argument displays command line Help information. /f[orce] This argument enables you to override or downgrade an existing component installation. This argument produces the same results as /f:software. /f[orce]:bundle This argument enables you to override or downgrade the existing installation of components in the selected bundle. /f[orce]:rom This argument enables you to override or downgrade the existing installation of the selected firmware components. (Applies to firmware only.) /f[orce]:software This argument enables you to override or downgrade the existing installation of the selected software components. /f[orce]:all This argument enables you to override or downgrade the existing installation of the selected software components, firmware com- ponents, and bundles. /g or /downgrade This argument enables you to downgrade to an earlier version of firmware for multi-target devices such as hard drives and array controllers. (Applies to firmware only.) /e or /rewrite This argument enables you to rewrite the same version of firmware only for multi-target devices such as hard drives and array controllers. (Applies to firmware only.) /r[eboot] If the following conditions are met, then this argument causes the server (or host server in a remote installation) to reboot: * The /reboot option is selected or given as a command-line argument. * All components selected for installation are successfully installed. * At least one of the installed components requires a reboot to complete its installation. /reboot_message "reboot message" This argument displays the specified reboot message on remote consoles connected to the server you want to reboot. You must use this argument with the /reboot option or the argument is ignored. /reboot_delay timeout_in_secs 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. * The default timeout value is 15 seconds for Microsoft(R) Win- dows(R) operating systems and 60 seconds for Linux. * For Linux, the Reboot Delay time is converted from seconds to minutes, and any value under a full minute, 59 seconds or less, rounds to the next minute. /reboot_always This argument forces the server to reboot if the following con- ditions are met: * The /reboot_always option is selected or given as a command line argument. * All components selected for installation were successfully installed. /s[ilent] 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), 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, reissue the command line, and then the HP SUM GUI appears. /c[omponent] or This argument specifies components to install. Components to install can be specified with or without the /c[omponent] argu- ment. * 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. * If the /c[omponent] argument is not used,then multiple com- ponents can be specified at the same time, but the components must be separated by a blank and listed after all the arguments on the command line. The components are installed in the order provided unless dependencies between components require instal- lation 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. 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. /group "group_name" This argument specifies an already defined group name in the HP Smart Update Manager graphical user interface. /b[undle] or 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 sepa- rated by a blank and listed after all the arguments on the com- mand line. 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. /allow_update_to_bundle This argument is a filter switch and enables the user to install newer versions of components defined in a PSP, ISP, or firmware bundle. This argument enables these components to replace the older versions of the same component that might have shipped with the bundles. /allow_non_bundle_components This argument is a filter switch and enables the user to install components which are not included in the bundle but reside in the directory with the components in the bundle. /use_latest This argument is a filter switch for use with bundles. The argu- ment enables the latest version of the bundle to be used when multiple versions of bundles are listed 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 Smart Update Manager to use the bundle with the latest version for installation. /use_location "file_share" This argument specifies a directory or file share that contains the PSP , ISP and components for use with HP Smart Update Man- ager. 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 containing hpsum.exe or HP Smart Update Manager 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. They are only used when connecting to a target system. /use_web This argument specifies that the checkbox for Check ftp.hp.com on the Source Selection screen is selected. This enables compo- nents to be retrieved from hp.com and used in the list of possi- ble updates. This argument is not supported on HP Integrity Servers. /use_proxy This argument enables the inclusion of a proxy server (and port number) to access ftp.hp.com. This parameter must be used with /use_web. For example, /use_web /use_proxy <1.22.33.44:80>. This argument is not supported on HP Integrity Servers. /proxy_script This argument enables the inclusion of a proxy script to access ftp.hp.com. This parameter must be used with /use_web. For example, /use_web /proxy_script . This argument is not supported on HP Integrity Servers. /proxy_user This argument sets the username to be used for an authenticating proxy server. /proxy_password This argument sets the password to be used for an authenticating proxy server /use_d[ownloaded] This argument specifies that the check box for Include compo- nents previously downloaded from HP.com on the Source Selection screen is to be selected. This allows those previously down- loaded components to be included in the list of possible updates. This argument is not supported on HP Integrity servers /tpmbypass or /ignore_tpm These arguments specifies that if a Trusted Platform Module (TPM) is enabled, the warning message should be ignored and com- ponent installation will be allowed to continue. /use_snmp This This argument specifies that components, which use SNMP protocol and the AMS components are available to be selected for installation. These components are available for selection by default. When the /use_snmp argument is used, the ams components are complesary, but /use_wmi argument is not, the WMI components are optional. This enable both components(SNMP&AMS) in HPSUM if they are present to install. /use_wmi This argument specifies that components, which use WMI protocol, are available to be selected for installation.These components are optional by default and are not installed unless this argu- ment is used. When the /use_wmi argument is used, and the /use_snmp & /use_ams arguments are not, the SNMP and AMS compo- nents are optional. This argument does not apply to HP Integrity Servers. /use_ams This argument specifies that components, which Agenles Monitor- ing service (AMS) copmonents that available to be selected for installation along with SNMP components. These components(AMS and SNMP) are available for selection by default. When the /use_ams argument is used, and the SNMP components are comple- sary, but /use_wmi argument is not, the WMI components are optional. This enable both components(AMS and SNMP) in HPSUM if they are present to install. /romonly 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 and restart HP Smart Update Manager if you wish to return to an unfiltered state. Do not use the /romonly argument with the /softwareonly argu- ment.(Applies to firmware only.) /softwareonly 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 and restart HP Smart Update Manager if you wish to return to an unfiltered state. Do not use the /softwareonly argument with the /romonly argu- ment. /dryrun This argument simulates the installation for a test run. Nothing is installed. /continue_on_error This argument causes the installation to continue and ignore errors. Valid values are : * =ServerNotFound and * =BadPassword. * =FailedDependencies The ServerNotFound option can be used to bypass inactive or unavailable remote hosts when deploy- ing firmware or software to multiple remote hosts at the same time. /override_existing_connection This argument is used to define the behavior when a remote tar- get has an existing HP Smart Update Manager session in progress. It overrides the session in progress and reinitializes the installation framework on the remote host. /express_install This argument starts express install (for local host only). The HP Smart Update Manager (HPSUM) performs discovery,install, or exit without user interaction. The user can cancel or terminate HP Smart Update Manager. /user or /username This argument enables you to log in to the remote target(except for the OA target) with the user ID. For the OA target, see /oa_username argument. /passwd This argument enables you to use this password for the user ID specified in the /user parameter (except for the OA target). The password is used to log in to remote targets. For the OA target, see /oa_password argument. /current_credential This argument enables the credential of the local host to be used as the credential to access the targets instead of provid- ing the username and password explicitly for each target. The assumption is that the current credential is valid for the tar- gets being accessed. (Applies to Windows(R) only) /target "netAddress" 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 Administrator(OA). When two Onboard Admin- istrators are in an enclosure, this argument should be the active Onboard Administrator.When specifying the IP address, you can use either the IPv4 or IPv6 format. /logdir "path" This argument enables you to redirect the output from HP Smart Update Manager or the HP BladeSystem c-Class Onboard Administra- tor flash utility to a different directory than the default location. * For Windows(R) components, the default location is %SYSTEM- DRIVE%\CPQSYSTEM\hp\log and the redirected location is \hp\log\. *For Linux components, the default location is /var/hp/log/ and the redirected location is /hp/log/. /v[erbose] or /veryv[erbose] These arguments enable you to set the verbosity level for the HP Smart Update Manager execution log file, hpsum_execu- tion_log__