Smart Update Manager 20.0.0 (Beta) Command-Line Interface

The SUM 20.0.0 (Beta) command-line interface (CLI) supports scripting and automation of firmware update operations. The CLI executable is named smartupdate and is installed alongside the SUM service.
NOTE
The smartupdate CLI must run on the same host as the SUM service. Remote CLI invocations are not supported in this release.

Command syntax

smartupdate [--silent] --target <iLO-IP> --user <username> --passwd <password>
            --use_location <path-to-SPP-ISO>
            [options]

Command options

Target options
Flag Description
--target <ip> iLO IP address of the target server. Repeatable for multi-server operations
--user <user>, --username <user> iLO OS username
--passwd <pwd>, --password <pwd> iLO OS password
Firmware baseline options
Flag Description
--use_location <path>, -u <path> Path to the SPP ISO or zip file on the SUM host. If the ISO or zip has already been uploaded, SUM reuses the existing bundle automatically
Installation control options
Flag Description
--downgrade, -g Downgrade components whose installed version is higher than the baseline version
--install_sw_drivers Include software and driver components in addition to firmware during the update
--power_off Power off the server after the firmware update completes
--dryrun Analyze firmware compliance without applying any changes. Prints the analysis result and exits
--continue_on_error When updating multiple targets, continue if at least one target succeeds. Exit code reflects the successful targets
Logging options
Flag Description
--verbose, -v Enable verbose logging
--silent, -s Silent mode (Mandatory parameter)
Input file options
Flag Description
--inputfile <path> Path to a SUM-format input file containing flags and target definitions (see Input file format)
--deleteinputfile Delete the input file after processing

Exit codes

The following table lists the exit codes returned by the smartupdate CLI.
Code Linux exit status Windows exit status Description
0 0 0 Success - all firmware updates applied; no reboot required
1 1 1 Success - updates applied; a reboot is required to activate one or more components
3 3 3 Not required - all firmware components are already at the target version; no changes made
-1 255 -1 General failure - authentication error, server unreachable, or other fatal condition
-2 254 -2 Bad parameter - a required flag is missing or invalid
-3 253 -3 Component failed - one or more firmware component installations failed on the target
-4 252 -4 Command failed - job submission, polling timeout, or job cancelled

Command examples

Update firmware on a single server
smartupdate -s \
  --target 192.168.1.100 \
  --user Administrator --passwd Admin123 \
  --use_location /var/baselines/SPP2026.iso
Dry run — analyze compliance without applying changes
smartupdate -s \
  --target 192.168.1.100 \
  --user Administrator --passwd Admin123 \
  --use_location /var/baselines/SPP2026.iso \
  --dryrun
Update multiple servers in parallel
smartupdate -s \
  --target 192.168.1.100 --user Administrator --passwd Admin123 \
  --target 192.168.1.101 --user Administrator --passwd Admin456 \
  --use_location /var/baselines/SPP2026.iso

All targets are processed simultaneously. When --continue_on_error is specified, a failure on one target does not stop the others.

Downgrade the components to match the baseline
smartupdate -s \
  --target 192.168.1.100 \
  --user Administrator --passwd Admin123 \
  --use_location /var/baselines/SPP2026.iso \
  --downgrade
Power off server after update
smartupdate -s \
  --target 192.168.1.100 \
  --user Administrator --passwd Admin123 \
  --use_location /var/baselines/SPP2026.iso \
  --power_off
Verbose output
smartupdate -s \
  --target 192.168.1.100 \
  --user Administrator --passwd Admin123 \
  --use_location /var/baselines/SPP2026.iso \
  --verbose

Input file format

You can supply all flags in a text file instead of on the command line. This is useful for scheduled jobs or when managing many targets.
SILENT = YES
USE_LOCATION = /var/baselines/SPP2026.iso
CONTINUE_ON_ERROR=YES

[TARGETS]
HOST = 192.168.1.100
UID  = Administrator
PWD  = Admin123
[END]

[TARGETS]
HOST = 192.168.1.101
HOST = 192.168.1.102
UID  = Administrator
PWD  = Admin456
[END]
Input file rules
  • Global lines (KEY = VALUE) set flags for the whole run. CLI flags take precedence over values in the file.
  • Each [TARGETS]...[END] block defines one set of credentials.
  • Multiple HOST = lines inside a block share the same username and password.
  • Supported global keys: USE_LOCATION, DOWNGRADE, DRYRUN, VERBOSE, INSTALL_SW_DRIVERS, POWER_OFF, and CONTINUE_ON_ERROR.
Run with an input file
smartupdate --inputfile /var/scripts/update.txt
Delete the input file after processing
smartupdate --inputfile /var/scripts/update.txt --deleteinputfile