efa inventory device firmware-download execute

Clears out the prepared list for successfully completed devices. Any failed devices remain in the prepared list to allow for the run to be retried.

Syntax

efa inventory device firmware-download execute [ --fabric fabric-name | --prepared-list-name prepared-list-name | [ --noMaintMode ] | [ --noAutoCommit | [ --noActivate ] | --drc | --group-execution { continue-on-error | stop-on-error } | --help

Parameters

--fabric fabric-name
Specifies the name of the fabric.
--prepared-list-name prepared-list-name
Prepared list name.
--noMaintMode
Ignores Maintenance Mode operations during firmware download. The option defaults to FALSE, which means Maintenance Mode is turned off during firmware download. If you add the noMaintMode option, Maintenance Mode operations are not performed during the firmware download process.
--noAutoCommit
Configures auto commit in the firmware download. By default, the firmware download process automatically commits the firmware following successful completion. If you add the noAutoCommit option, you must manually run a new efa inventory device firmware-download commit command to commit the downloaded firmware on the device.
--noActivate
Configure Activation in Firmware Download. Device will not reload after the downloading the firmware. To activate the firmware, you must run the efa inventory device firmware-download activate command on the device.
--drc

During firmware download workflow DRC is controlled by user input flag "drc". If the flag is set to "true" and maintenance mode is enabled, then DRC is triggered. By default "drc" flag is "false". The following table describes the different scenarios for DRC during firmware download:

noMaint drc enable_on_reboot FWDL Reboot Behavior Comments
False False True/False
  • Maintenance mode will be enabled before reboot
  • NO DRC
  • Maintenance mode will be disabled after reboot

Default Case

FWDL is driving maint-mode so enable_on_reboot has no effect

False True True/False
  • Maintenance mode will be enabled before reboot
  • DRC will be triggered
  • Maintenance mode will be disabled on successful DRC

FWDL is driving maint-mode so enable_on_reboot has no effect

True False True
  • enable_on_reboot mode will bring switch in maintenance mode
  • NO DRC
  • Maintenance mode will be disabled after reboot
True False False
  • No maintenance mode
  • NO DRC
True True True
  • enable_on_reboot mode will bring switch in maintenance mode
  • DRC will be triggered
  • Maintenance mode will be disabled on successful DRC
True True False Invalid use case; appropriate error will be raised
--group-execution[ continue-on-error | stop-on-error]

Specifies the group run policy when a firmware download process fails on one or more devices defined in a group. When all devices defined in the group have completed the firmware download process and there is one or more device that has failed, the group run policy rules if the firmware download work flow continues to process the remaining groups or not.

There are two options:
  • Under the continue-on-error group run policy (the default), in case of a device upgrade failure, the work flow continues to the next group, until all groups have been processed.
  • Under the stop-on-error group run policy, in case of a device upgrade failure, the work flow does not continue to the next group.

Usage Guidelines

You may receive a general warning for traffic loss for single-homed servers if any leaf devices or non-Clos devices are prepared for firmware download.

Run only one instance of this command per fabric.

Example

efa inventory device firmware-download execute --noAutoCommit 
--fabric fabric 
Firmware Download Execute [success] 
Monitor firmware download execution progress using: 

efa inventory device firmware-download show --fabric fabric 

Please don't execute other commands on these devices until firmware download 
is in progress 

Firmware download execution initiated with '--noAutoCommit' flag, please 
commit/restore after completion using: 

efa inventory device firmware-download commit --fabric fabric 
efa inventory device firmware-download restore --fabric fabric 
 

Example

This example shows only a portion of all possible output.
efa inventory device firmware-download show --fabric fabric 
+-------------+-----------+-------+--------------+-----+------+--------------------------------+ 
| IP Address  | Host Name | Model | Chassis Name | ASN | Role | Current Firmware               | 
+-------------+-----------+-------+--------------+-----+------+--------------------------------+ 
| 10.20.246.5 | NHF-Leaf1 | 3009  | SLX9150-48Y  | 0   | Leaf | 20.2.2slxos20.2.2b_201208_0600 | 
+-------------+-----------+-------+--------------+-----+------+--------------------------------+ 
| 10.20.246.6 | NHF-Leaf2 | 3009  | SLX9150-48Y  | 0   | Leaf | 20.2.2slxos20.2.2b_201211_1800 | 
+-------------+-----------+-------+--------------+-----+------+--------------------------------+ 

Firmware Download Show Details 

Firmware Download Show Overall Status [Completed] 

If Firmware download execution initiated with '--noAutoCommit' flag, 
please commit/restore after completion using: 

efa inventory device firmware-download commit --fabric fabric 

efa inventory device firmware-download restore --fabric fabric  

Example

efa inventory device firmware-download execute --fabric fabric1 
--noMaintMode
Firmware Download Execute [success]
Monitor firmware download execution progress using:
efa inventory device firmware-download show --fabric fabric1 

Please don't execute other commands on these devices until firmware download 
is in progress 

--- Time Elapsed: 137.250437ms ---