Skip to content

flash-list

Flash jobs in the Dell Lifecycle Controller that have not finished.

This parameter contains a list of files to retrieve and run against the system.

The list contains objects that specify a type (RPM or BIN) and a URL or file to retrieve the files directory.

If not specified, the system will attempt to update to the latest block release. If the list is empty, nothing is updated.

You must specify a File per entry in this list, no matter what the Type is. If the file does not begin with http, then the task assumes it can be downloaded from the dr-provision file server at the specified location.

For the reboot and reboot-if-wanted types, the File entry should be a unique identifier in the list. Leaving it empty or not unique will have unexpected results.

The flash-list param currently understand the following flash types: - rpm is an HPE provided firmware update package supplied in RPM format. The update will be performed using the embedded setup command. - fwpkg is an HPE-provided raw firmware update package. The update will be performed via the iLO using the ilorest command. - bin is a Dell provided Linux firmware update package. The update will be performed by running the package. - exe is a Dell provided Windows firmware update package. The update will be performed by uploading the update package to the iDRAC using a Dell-provided redfish update script. - onecli is a Lenovo-provided firmware update package. The update will be performed using OneCLI. - reboot will force the system to unilaterally reboot. Flash updates will resume at the next entry in the list. - reboot-if-wanted will trigger a reboot if previous firmware packages signalled that they want a reboot. - script will attempt to flash the firmware package by sourcing the script provided in the Script field. See the comments contained in the flash-list.sh.tmpl template for details on what environment variables the embedded script should use and what it should set if the package needs a reboot or encountered an error.

Example: 

---
flash-list:
  - File: files/flash/dell/IdracUpdate.bin
    Type: bin                              # Dell binary update package
  - File: files/flash/dell/BiosUpdate.exe
    Type: exe                              # Dell .EXE update to hand over to the iDRAC.
  - File: files/flash/hpe/IloUpdate.rpm
    Type: rpm                              # HPe RPM firmware update file.
    Force: true                            # Force the flash whether it is a downgrade or not.
  - File: first-reboot
    Type: reboot                           # Unilaterally force a reboot here.
  - File: files/flash/hpe/BiosUpdate.fwpkg
    Type: fwpkg                            # HPe update package for Redfish
  - File: files/flash/lenovo/BiosUpdate.pkg
    Type: onecli                           # Lenovo firmware update package
  - File: files/flash/supermicro/BMC.bin
    Type: script                           # script update
    Script: |
      # This relies on the supermicro helper being pulled in to provide
      # a boilerplate wrapper around the `sum` command.
      # The wrapper verifies that the SUM binary has the basic capabilities needed
      # to signal that a reboot is needed and to avoid downgrading firmware if not called for.
      sum UpdateBios
  - File: files/flash/supermicro/bk.bin
    Type: script
    Script: |
      # You may also pass in extra arguments if the flash process needs it.
      # They are passed unaltered to the SUM binary.
      sum UpdateBackplaneCpld --index=0 --manual_ejected
  - File: files/flash/supermicro/nic.bin
    Type: script
    Script: |
      # You may also flash multiple devices at a time, provided you pay attention to
      # the want_reboot variable and the exit code from sum.
      sum UpdateAocNic --dev-id=1 || return $?
      [[ $want_reboot ]] && return 0
      sum UpdateAocNic --dev-id=2