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
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.
- Under the
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 ---