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 | [ --noAutoCommit ] | [ --noMaintMode ] | --group-execution continue-on-error | stop-on-error ]

Parameters

--fabric fabric-name
Specifies the name of the fabric.
--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.
--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.

The following table describes situations in which the noMaintMode option works with configuration of MaintModeOnReboot on the device.

MaintModeOnReboot NoMaintMode (FWDL) DRC Behavior
True True DRC is triggered after reboot.
True False DRC is triggered.
False True No DRC is triggered.
False False DRC is triggered.
--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 ---