Skip to main content

multiflash command

Use the multiflash command to remotely upgrade the firmware of multiple BMC/SMM, update the firmware and driver for multiple Linux servers. It also specifies the information and the configuration parameters of the BMC/SMM and the Linux servers by using a JSON configuration file.

multiflash command syntax

OneCli.exe update multiflash < --configfile <arg>> [--dir <arg>] [--quiet|-q] [--forceid|-F <arg>] [--uselocalimg] 
[--check-trust|-C] [--never-check-trust|-N] [--output|-o <arg>] [--nolog] [--config <arg>] [--help|-h]

Options

  • --configfile: Specify the JSON configuration file. The template file is available in Sample/multi_task_config.json or Sample/ multi_remote_task_config.json in OneCLI binary.

Table 1. multiflash command specific parameters
ParameterRequired/OptionalNotes
--applytimeOptional

Specify the firmware apply time for bundle update.

Valid values include:

  • OnStartUpdateRequest

  • OnReset: Default value for IB update.

  • Immediate: Default value for Remote update.

--bundleOptionalUpdate the firmware with bundled packages.
--cleanupOptionalClear the staged tasks if any.
--configfileRequiredSpecify the JSON configuration file for multi-task commands. The template file is available in Sample/multi_task_config.json in OneCLI binary.
--configOptionalSpecify the file path for the OneCLI config commands.
--dirOptional

Specify the directory of the firmware package.

If no directory is specified, use the current directory.

--forceid, -FOptional

It supports to add the force tag for the update ID to enforce the downgrade.

It also supports <all>, which means it can add force tag for all the suggested flash packages.

--gracefulOptionalGracefully power off OS in the platform update process.
--includeid, -IOptionalThis parameter should be used with the --nocompare parameter.
--output, -oOptional

Specify the output directory. By default, the output directory is saved in ./logs/.

--quiet, -qOptional

This parameter answers yes for all questions, and decreases the outputs displayed on screen.

--scope, -sOptional
Specify the scope of update operations. Different scopes mean different operation strategies. Valid choices are:
  • uxsp: operation strategy is to focus on UXSP and make bundle update.
  • latest: operation strategy is to help users to find and use latest updates. Even a particular package name is given by using "--includeid", OneCLI will still search whether there are later versions of the package and use the newest one if there are.

  • individual: operation strategy is to find and use the packages specified by the --includeid parameter.
--uselocalimgOptional

If the --uselocalimg parameter is specified, the flash command forces to copy the payload file from the local folder to the SFTP server.

--platformOptionalUpdate firmware with OOB method and Bare Metal Update (BMU) method.
  • --check-trust, -C

  • --help,-h

  • --never-check-trust, -N

  • --nolog

Optional

Refer to Table 2.

Example of the multiflash command

OneCLI update multiflash --configfile xxxconfig.json --sftp user:pass@ip/xx