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 --r hpsum /s /use_location /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 on a Windows system, or hpsum --s 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 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 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 (Linux) |Changes the port HP SUM uses for the| | |internal HTTP server from 63001 to | |/port (Windows) |the selected port. | |-----------------------------------+------------------------------------| |--ssl_port (Linux) |Changes the port HP SUM uses for the| | |internal HTTPS server from 63002 to | |/ssl_port (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]|The utility installs components in | |or |the order provided unless | | (Linux) |dependencies between components | | |require installation in a different | |/c[omponent] |order. If so, the utility changes | |or |the installation order based on the | | (Windows) |component dependencies to ensure the| | |successful installation of as many | | |components as possible. | | | | | |Specify multiple components (see | | |--c[omponent])| | |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] (Linux) | | | |Specify multiple components and | |/b[undle] (Windows) |bundles (see b[undle] ) | | |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 | | (Linux) |settings for components in the | | |specified baseline. Imported | |/import_configuration |component configurations override | | (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: | | | | | | =ServerNotFound | | | | | | =BadPassword | | | | | | =FailedDependencies | | | | | | Use the ServerNotFound option | | | to bypass inactive or | | | unavailable remote hosts when | | | you deploy firmware or | | --continue_on_error (Linux) | software to multiple remote | | | hosts at the same time. | | /continue_on_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 or | | | --username | Use this argument to log in to the remote | | (Linux) | nodes with the user ID. | | | | | /user or | Make sure the user name belongs to the | | /username | root or administrator group. | | (Windows) | | |---------------------------+--------------------------------------------| | --password | | | (Linux) | Password for the user ID specified in the | | | user parameter (except for the OA node). | | /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 and the | | --logdir "path" | redirected location is \hp\log\. | | (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/ and the redirected location | | | is /hp/log/. | |-----------------+------------------------------------------------------| | --v[erbose] or | | | --veryv[erbose] | Sets the verbosity level for the HP SUM execution | | (Linux) | log file, hpsum_execution_log__