This section provides details on downloading, installing, and managing firmware upgrades for CDB-supported transceivers across platforms, highlighting CMIS compliance, unified commands, and robust error handling.

This section includes the required details that allow the users to download, install, and manage firmware upgrades for all Command Data Block (CDB) supported transceivers or optical transceivers across multiple hardware platforms.

The key benefits include

CMIS compliance as this upgrade supports standards such as CMIS 4.0, 5.0, and above for modern transceivers
unified or consistent command syntax across all supported platforms, and
robust error handling through comprehensive error detection and recovery mechanisms.

The sections that follow explain the concept, procedures, and sample scenarios for the transceiver firmware upgrade using NX-OS commands.

Parallel firmware download queues and port mapping

The system supports parallel firmware downloads with eight separate queues. Each queue handles downloads for a specific range of ports. You can download up to eight files at once, with one assigned to each queue.

Here is a list of port to queue mappings:

Queue 1: Ports 1–8
Queue 2: Ports 9–16
Queue 3: Ports 17–24
Queue 4: Ports 25–32
Queue 5: Ports 33–40
Queue 6: Ports 41–48
Queue 7: Ports 49–56
Queue 8: Ports 57–64

Note

The parallel download behavior is determined by the selected ports and queues. If the specified ports are in different queues, then the file download happens simultaneously. If the specified ports are in the same queue, then other ports have to wait in the queue until the first port completes the file download.

Assuming the download is executed for ports 19 to 25, download starts for port 19 from queue 3. Port 20 to 24 will be in queue 3 in a waiting state. Download for port 25 from queue 4 will also start simultaneously.

Firmware upgrade phases

The firmware upgrade process for transceivers involves distinct phases to manage the transfer, activation, and permanence or persistence of new firmware.

Firmware upgrades for transceivers occur in four main phases:

Download: Transfers the new firmware image from the source (such as the switch bootflash) to the transceiver's memory. The download can be disruptive or non-disruptive.
Activate: Switches the transceiver from the current firmware to the newly downloaded version immediately, with no warning. This phase activates the new firmware and commits it by immediately making it operational and persistent or permanent without a separate commit step.
Run: Activates the new firmware temporarily for testing without making it permanent or persistent. If not committed, the firmware reverts after a reload. This phase allows you to test the new firmware without making the firmware upgrade permanent.
Commit: Makes the newly activated firmware persistent across reloads. This step is required only after the run phase, and not after the activate phase as activate executes commit automatically. If a commit is not performed, the transceiver reverts to the old firmware after a subsequent reboot or power cycle.

Firmware upgrade procedures

The procedure for firmware upgrade varies significantly depending on whether the transceiver supports non-disruptive upgrade or disruptive upgrade.

This is a flowchart that illustrates how the different phases are used for the transceiver upgrade. For more information about the procedure, see Upgrade firmware using NX-OS commands.

This table provides information about the upgrade phases recommended for transceivers based on the supported upgrade types.


Upgrade	Upgrade Type	Upgrade Phases
Disruptive	Immediate	Download Activate
Non-disruptive	Staged	Download Run Commit
Non-disruptive	Immediate	Download Activate

Note

To determine whether an upgrade is disruptive, use the show install transceiver interface ethernet <interface> info command. If the answer to Is Firmware Upgrade Service Affecting? is

Yes, then it indicates that the transceiver supports disruptive upgrade.

No, then it indicates that the transceiver supports non-disruptive upgrade.

For sample scenarios, see Examples for firmware upgrade.

Guidelines and limitations for firmware upgrade using NX-OS commands

Read these operational limitations and precautions to avoid interruptions or failures when performing firmware upgrade using NX-OS commands.

Beginning with Release 10.6(2)F, this feature is supported only on N9364E-SG2-Q and N9364E-SG2-O platforms and 800 G optics.
Complete the firmware download before reloading or power cycling the system to avoid corruption. If the system restarts and the optic is not detected, restart the firmware download process to restore functionality.

Upgrade firmware using NX-OS commands

Use the procedures provided in this section to upgrade the firmware of all Command Data Block (CDB) supported transceivers. For unsupported transceivers, the upgrade command displays an error.

For more information about ZR optics firmware upgrade, see Cisco Nexus 9000 Series NX-OS Interfaces Configuration Guide.

Note

Different firmware files may be required for different transceiver types.

Enter the show install transceiver interface ethernet <interface> status command after each state to determine current transceiver upgrade status and impact of next step.

Based on the upgrade types, there are three ways to upgrade the transceiver:

Disruptive immediate upgrade of the transceiver
Non-disruptive staged upgrade of the transceiver
Non-disruptive immediate upgrade of the transceiver

Before you begin

The common pre-requisites for the three procedures are:

Verify that the firmware file is correct and compatible with the transceiver model.
Ensure that you have access to the switch command line interface and the ability to copy the firmware file from a remote location where it is stored (SCP, SFTP, and so on).

A detailed information about the three procedures are provided here.

Disruptive immediate upgrade of the transceiver

Use this procedure for transceivers that support only disruptive upgrade.

For more information about the different phases and upgrade procedures, see the Firmware upgrade procedures section before you perform this procedure.

For two sample scenarios, see Sample disruptive immediate upgrade with both banks valid and Sample disruptive immediate upgrade with one bank invalid.

Procedure

	1.	Get the firmware file, copy it on to the switch bootflash, and check the information of the firmware. Copy the firmware file to the switch under bootflash. Example: `switch# copy scp://<ip-address>/<location of firmware>/bank_trapp_qsfp-100g-sr-s_signed_rel_0.73.4.bin bootflash:///bank_trapp_qsfp-100g-sr-s_signed_rel_0.73.4.bin vrf management use` Verify the information of the firmware including versions and default running images that reside in the module using the show install transceiver interface ethernet <interface> info command. Example: switch# show install transceiver interface ethernet 1/7/1 info Eth1/7/1 ******************Bank A******************* ================================================= Version : 2.6.0 : Build Time: May 28 2025 15:56:10 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B******************* ================================================= Version : 2.6.0 : Build Time: May 28 2025 15:56:10 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- Note In the show install output, `Yes` indicates that the transceiver supports disruptive upgrade and a `No` indicates that the transceiver supports non-disruptive upgrade as well. Verify the output for other significant information such as: Image version – indicates the version of the image Operational Status – indicates the operational status of the image, whether it is running or not running Administrative Status - indicates whether the image is committed or not committed Image validity - indicates the validity of the image, whether it is valid or invalid Verify the status using the show install transceiver interface ethernet** <interface> status command. Example: `switch# show install transceiver interface ethernet 1/7/1 status Eth1/7/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` When the status is `Ready to start`, proceed to the next step.
	2.	Download firmware on the transceiver module and verify the download status. Download and install the firmware on the transceiver with the install transceiver interface ethernet <interface>download bootflash:<firmware-file-name> command. The download is disruptive. Note Parallel firmware download is supported for Silicon One PIDs with range command support for non-ZR transceiver. If the same firmware file is used for all transceivers, use the same file across all devices. If different firmware files are required for different transceivers, copy those files under bootflash and specify the corresponding file names in the download command. Example: `switch# install transceiver interface ethernet 1/11 download bootflash:tmg_bank_trappb_qdd-400g-bd_signed_dev.bin` Verify the status of the firmware download using the show install transceiver interface ethernet <interface> status command. Track the progress of the download using this command. Example: `switch# show install transceiver interface E1/16 status Eth1/16: Last download is completed successfully Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` Note When the download is in progress, you can execute the next command, which will be queued.
	3.	Activate the firmware using the install transceiver interface ethernet <interface> activate command. The new upgrade persists across reloads. Example: `switch# install transceiver interface E1/16 activate` After performing this command, verify the progress using the show install transceiver interface ethernet <interface> status command.
	4.	Verify that the module is upgraded and the newly downloaded image is running and committed using the show install transceiver interface ethernet <interface> info command.

Non-disruptive staged upgrade of the transceiver

Use this procedure for transceivers that support non-disruptive upgrade and when you want the upgrade to be a staged upgrade.

For more information about the different phases and upgrade procedures, see the Firmware upgrade procedures section before you perform this procedure.

For a sample scenario, see Sample non-disruptive staged upgrade.

Procedure

	1.	Get the firmware file, copy it on to the switch bootflash, and check the information of the firmware. Copy the firmware file to the switch under bootflash. Example: `switch# copy scp://<ip-address>/<location of firmware>/bank_trapp_qsfp-100g-sr-s_signed_rel_0.73.4.bin bootflash:///bank_trapp_qsfp-100g-sr-s_signed_rel_0.73.4.bin vrf management use` Verify the information of the firmware including versions and default running images that reside in the module using the show install transceiver interface ethernet <interface> info command. Example: switch# show install transceiver interface ethernet 1/7/1 info Eth1/7/1 ******************Bank A******************* ================================================= Version : 2.6.0 : Build Time: May 28 2025 15:56:10 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B******************* ================================================= Version : 2.6.0 : Build Time: May 28 2025 15:56:10 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- Note In the show install output, Yes indicates that the transceiver supports disruptive upgrade and a No indicates that the transceiver supports non-disruptive upgrade as well. Verify the output for information such as Image version – indicates the version of the image Operational Status – indicates the operational status of the image, whether it is running or not running Administrative Status - indicates whether the image is committed or not committed Image validity - indicates the validity of the image, whether it is valid or invalid Is Firmware Upgrade Service Affecting? – Yes indicates that the transceiver supports disruptive upgrade and No indicates that the transceiver supports non-disruptive upgrade Verify the status using the show install transceiver interface ethernet** <interface> status command. Example: `switch# show install transceiver interface ethernet 1/7/1 status Eth1/7/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` When the status is `Ready to start`, proceed to the next step.
	2.	Download firmware on the transceiver module and verify the download status. Download and install the firmware on the transceiver with the install transceiver interface ethernet <interface>download bootflash:<firmware-file-name> command. The download is disruptive. Note Parallel firmware download is supported for Silicon One PIDs with range command support for non-ZR transceiver. If the same firmware file is used for all transceivers, use the same file across all devices. If different firmware files are required for different transceivers, copy those files under bootflash and specify the corresponding file names in the download command. Example: `switch# dnf repolist` Verify the status of the firmware download using the show install transceiver interface ethernet <interface> status command. Track the progress of the download using this command. Example: `switch# show install transceiver interface E1/16 status Eth1/16: Last download is completed successfully Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` Note When the download is in progress, you can execute the next command, which will be queued.
	3.	Activate the firmware using the run and commit commands. Both commands are non-disruptive. Run the new firmware version using the install transceiver interface ethernet <interface> run command. Note Do not reload before running the commit command. The upgrade is non-persistent. So, if you reload before using the commit command, the transceiver reverts to the version before the upgrade. Example: `switch# install transceiver interface E1/16 run` Commit the downloaded firmware. Use the install transceiver interface ethernet <interface> commit command, so the module records the new firmware image, which is now active and is ready to be used on any future reset or reboot. Example: `switch# install transceiver interface E1/16 commit` After performing the commit command, verify the progress using the show install transceiver interface ethernet <interface> status command.
	4.	Verify that the module is upgraded and the newly downloaded image is running and committed using the show install transceiver interface ethernet <interface> info command.

Non-disruptive immediate upgrade of the transceiver

Use this procedure for transceivers that support non-disruptive upgrade and when you want the upgrade to be an immediate upgrade.

For more information about the different phases and upgrade procedures, see the Firmware upgrade procedures section before you perform this procedure.

For a sample scenario, see Sample non-disruptive immediate upgrade.

Procedure

	1.	Get the firmware file, copy it on to the switch bootflash, and check the information of the firmware. Copy the firmware file to the switch under bootflash. Example: `switch# copy scp://<ip-address>/<location of firmware>/bank_trapp_qsfp-100g-sr-s_signed_rel_0.73.4.bin bootflash:///bank_trapp_qsfp-100g-sr-s_signed_rel_0.73.4.bin vrf management use` Verify the information of the firmware including versions and default running images that reside in the module using the show install transceiver interface ethernet <interface> info command. Example: switch# show install transceiver interface ethernet 1/7/1 info Eth1/7/1 ******************Bank A******************* ================================================= Version : 2.6.0 : Build Time: May 28 2025 15:56:10 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B******************* ================================================= Version : 2.6.0 : Build Time: May 28 2025 15:56:10 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- Note In the show install output, Yes indicates that the transceiver supports disruptive upgrade and a No indicates that the transceiver supports non-disruptive upgrade as well. Verify the output for information such as Image version – indicates the version of the image Operational Status – indicates the operational status of the image, whether it is running or not running Administrative Status - indicates whether the image is committed or not committed Image validity - indicates the validity of the image, whether it is valid or invalid Is Firmware Upgrade Service Affecting? – Yes indicates that the transceiver supports disruptive upgrade and No indicates that the transceiver supports non-disruptive upgrade Verify the status using the show install transceiver interface ethernet** <interface> status command. Example: `switch# show install transceiver interface ethernet 1/7/1 status Eth1/7/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` When the status is `Ready to start`, proceed to the next step.
	2.	Download firmware on the transceiver module and verify the download status. Download and install the firmware on the transceiver with the install transceiver interface ethernet <interface>download bootflash:<firmware-file-name> command. The download is non-disruptive. Note Parallel firmware download is supported for Silicon One PIDs with range command support for non-ZR transceiver. If the same firmware file is used for all transceivers, use the same file across all devices. If different firmware files are required for different transceivers, copy those files under bootflash and specify the corresponding file names in the download command. Example: `switch# install transceiver interface ethernet 1/11 download bootflash:tmg_bank_trappb_qdd-400g-bd_signed_dev.bin` Verify the status of the firmware download using the show install transceiver interface ethernet <interface> status command. Track the progress of the download using this command. Example: `switch# show install transceiver interface E1/16 status Eth1/16: Last download is completed successfully Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` Note When the download is in progress, you can execute the next command, which will be queued.
	3.	Activate the firmware using the run and commit commands. Both commands are non-disruptive. Run the new firmware version using the install transceiver interface ethernet <interface> run command. Note Do not reload before running the commit command. The upgrade is non-persistent. So, if you reload before using the commit command, the transceiver reverts to the version before the upgrade. Example: `switch# install transceiver interface E1/16 run` Commit the downloaded firmware. Use the install transceiver interface ethernet <interface> commit command, so the module records the new firmware image, which is now active and is ready to be used on any future reset or reboot. Example: `switch# install transceiver interface E1/16 commit` After performing the commit command, verify the progress using the show install transceiver interface ethernet <interface> status command.
	4.	Activate the firmware using the install transceiver interface ethernet <interface> activate command. The new upgrade persists across reloads. Example: `switch# install transceiver interface E1/16 activate` After performing this command, verify the progress using the show install transceiver interface ethernet <interface> status command.
	5.	Verify that the module is upgraded and the newly downloaded image is running and committed using the show install transceiver interface ethernet <interface> info command.

Examples for firmware upgrade

This section provides few examples for certain scenarios that you may encounter during the firmware upgrade.

Sample disruptive immediate upgrade with both banks valid

Transceivers have either one or two banks, labeled as Bank A and B, to store the firmware image. Either of the banks can hold valid firmware images. During an upgrade, the new firmware is first downloaded to the inactive bank—the one not in use. After the download, the firmware is activated by switching the active bank to the newly updated bank, while the previously active bank becomes inactive. This method allows for a safer upgrade process by retaining the previous firmware until the new firmware is fully committed and finalized.

This section shows a sample scenario for the disruptive immediate upgrade of a transceiver firmware that supports only disruptive upgrade and has both Bank A and B status as valid.

For more information about the procedure, see Disruptive immediate upgrade of the transceiver.

Let us assume that v 3.2.0 is the current active version of your transceiver firmware and you want to upgrade to v 3.9.0.

Procedure

	1.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.1.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.2.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- The current active image is v 3.2.0 and this resides in Bank B.
	2.	Next, enter the download command. Example: `switch# install transceiver interface ethernet 1/1 download bootflash:CISCO-EOPTOLINK_QDD-8X100G-FR_HW_1.0_FW_3.9.bin Transceiver firmware download Command submitted, Please use status command to check progress.`
	3.	Enter the status command to verify the progress. Example: `switch# show install transceiver interface ethernet 1/1 status Downloading is in progress [5/100 Completed]. Eth1/1 Download Status: In Progress Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` The download is in progress. After completion of the download, the status command output displays that the download is completed. `switch# show install transceiver interface ethernet 1/1 status Last Download is completed successfully Eth1/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start`
	4.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.9.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.2.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- The new image, v 3.9.0, is downloaded to Bank A, the passive bank (which has the new but inactive image) .
	5.	Enter the activate command to activate the new image, v 3.9.0. Example: `switch# install transceiver interface ethernet 1/1 activate Transceiver firmware Activate Command submitted, Please use status command to check progress`
	6.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.9.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.2.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- Bank A is active now with the new image, v 3.9.0.

The transceiver firmware upgrade is complete.

Sample disruptive immediate upgrade with one bank invalid

Transceivers have either one or two banks to store the firmware image. The banks are labelled as Bank A and Bank B. This section shows a sample scenario for the disruptive immediate upgrade of a transceiver firmware that supports only disruptive upgrade and has only one Bank with a valid status, either Bank A or Bank B.

For more information about the procedure, see Disruptive immediate upgrade of the transceiver.

Let us assume that v 126.4.0 is the current active version of your transceiver firmware and you want to upgrade to v 126.55.0.

Procedure

	1.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/23 info Eth1/23 ******************Bank A******************* ================================================= Version : 126.4.0 : Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- ****************Bank B******************* ================================================= Version : 0.0.0 : Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Invalid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- The current active image is v 126.4.0 and this resides in Bank A. Note** As the answer to the question `Is Firmware Upgrade Service Affecting?` is `Yes`, the transceiver supports disruptive upgrade.
	2.	Next, enter the download command. Example: `switch# install transceiver interface ethernet 1/23 download bootflash:CISCO-INNOLIGHT_OSFP-800G-VR8_HW_1.10_FW_126.55.bin Transceiver firmware download Command submitted, Please use status command to check progress`
	3.	Enter the status command to verify the progress. Example: `switch# show install transceiver interface ethernet 1/23 status Downloading is in progress [10/100 Completed]. Eth1/23 Download Status: In Progress Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` The download is in progress. After completion of the download, the status command output displays that the download is completed. `switch# show install transceiver interface ethernet 1/23 status Last Download is completed successfully Eth1/23 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start`
	4.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/23 info Eth1/23 ******************Bank A******************* ================================================= Version : 126.55.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- ****************Bank B******************* ================================================= Version : 0.0.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Invalid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- The new image, v 126.55.0, has replaced the existing image as it has only one bank to store the firmware image. It is activated by default. However, still it is recommended to use the activate command. Note** Bank B can be invalid in cases where the transceiver does not use Bank B.
	5.	Enter the activate command to activate the new image, v 126.55.0. Example: `switch# install transceiver interface ethernet 1/23 activate Transceiver firmware Activate Command submitted, Please use status command to check progress`
	6.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/23 info Eth1/23 ******************Bank A******************* ================================================= Version : 126.55.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 0.0.0 : Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Invalid ------------------------------------------------- Is Firmware Upgrade Service Affecting? Yes ------------------------------------------------- Bank A is active now with the new image, v 126.55.0. The transceiver firmware upgrade is complete.

Sample non-disruptive staged upgrade

This section shows a sample scenario for the non-disruptive staged upgrade of a transceiver firmware.

For more information about the procedure, see Non-disruptive staged upgrade of the transceiver.

Let us assume that v 3.12.0 is the current active version of your transceiver firmware and you want to upgrade to v 3.15.0.

Procedure

	1.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.9.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B******************* ================================================= Version : 3.12.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? No ------------------------------------------------- The current active image is v 3.12.0 and this resides in Bank B. Note** As the answer to the question `Is Firmware Upgrade Service Affecting?` is `No`, the transceiver supports non-disruptive upgrade.
	2.	Next, enter the download command. Example: `switch# install transceiver interface ethernet 1/1 download bootflash:CISCO-EOPTOLINK_QDD-8X100G-FR_HW_1.0_FW_3.15.bin Transceiver firmware download Command submitted, Please use status command to check progress.`
	3.	Enter the status command to verify the progress. Example: `switch# show install transceiver interface ethernet 1/1 status Downloading is in progress [5/100 Completed]. Eth1/1 Download Status: In Progress Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` The download is in progress. After completion of the download, the status command output displays that the download is completed. `switch# show install transceiver interface ethernet 1/1 status Last Download is completed successfully Eth1/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start`
	4.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.15.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.12.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? No ------------------------------------------------- The new image, v 3.15.0, is downloaded to Bank A, the passive bank. This image is inactive.
	5.	Enter the run command to activate the new image, v 3.15.0. Example: `switch# install transceiver interface ethernet 1/1 run Transceiver firmware Run Command submitted, Please use status command to check progress`
	6.	Enter the status command to check the progress. Example: `switch# show install transceiver interface ethernet 1/1 status Last Run is completed successfully Eth1/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` The output displays that the run command is completed. Now, enter the info command. switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.15.0 Operational Status : Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.12.0 Operational Status : Not Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? No ------------------------------------------------- Image v 3.15.0 in Bank A is running but not committed. Though the v 3.15.0 is active, it is temporarily active until the next reload or reset. It will be permanently or persistently active only after it is committed (next step). If not committed, then the existing image v 3.12.0 in bank B will become active after the next reset or reload operation.
	7.	Enter the commit command to make the activation persistent. Example: `switch# install transceiver interface ethernet 1/1 commit Transceiver firmware Commit Command submitted, Please use status command to check progress`
	8.	Enter the status command. Example: `switch# show install transceiver interface ethernet 1/1 status Last Commit is completed successfully Eth1/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start`
	9.	Enter the info command Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.15.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.12.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? No ------------------------------------------------- Bank A is active now with the new image, v 3.15.0, and the upgrade is persistent. Image v 3.12.0 in Bank B is inactive even after a reload.

The transceiver firmware upgrade is complete.

Sample non-disruptive immediate upgrade

This section shows a sample scenario for the non-disruptive immediate upgrade of a transceiver firmware.

For more information about the procedure, see Non-disruptive immediate upgrade of the transceiver.

Let us assume that v 3.9.0 is the current active version of your transceiver firmware and you want to upgrade to v 3.12.0.

Procedure

	1.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.9.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- ****************Bank B******************* ================================================= Version : 3.2.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? No ------------------------------------------------- The current active image is v 3.9.0 and this resides in Bank A. Note** As the answer to the question `Is Firmware Upgrade Service Affecting?` is `No`, the transceiver supports non-disruptive upgrade.
	2.	Next, enter the download command. Example: `switch# install transceiver interface ethernet 1/1 download bootflash:CISCO-EOPTOLINK_QDD-8X100G-FR_HW_1.0_FW_3.12.bin Transceiver firmware download Command submitted, Please use status command to check progress.`
	3.	Enter the status command to verify the progress. Example: `switch# show install transceiver interface ethernet 1/1 status Downloading is in progress [5/100 Completed]. Eth1/1 Download Status: In Progress Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start` The download is in progress. After completion of the download, the status command output displays that the download is completed. `switch# show install transceiver interface ethernet 1/1 status Last Download is completed successfully Eth1/1 Download Status: Ready to start Run Status: Ready to start Commit Status: Ready to start Activation Status: Ready to start`
	4.	Enter the info command. Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.9.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.12.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? No ------------------------------------------------- The new image, v 3.12.0, is downloaded to Bank B, the passive bank. This image is inactive.
	5.	Enter the activate command to activate the new image, v 3.12.0. Example: `switch# install transceiver interface ethernet 1/1 activate Transceiver firmware Activate Command submitted, Please use status command to check progress`
	6.	Enter the info command Example: switch# show install transceiver interface ethernet 1/1 info Eth1/1 ******************Bank A******************* ================================================= Version : 3.9.0 Operational Status : Not Running Administrative Status : Uncommitted Validity Status : Valid ------------------------------------------------- ****************Bank B********************* ================================================= Version : 3.12.0 Operational Status : Running Administrative Status : Committed Validity Status : Valid ------------------------------------------------- Is Firmware Upgrade Service Affecting? No ------------------------------------------------- Bank B is active now with the new image, v 3.12.0. Image v 3.9.0 in Bank A is inactive.

The transceiver firmware upgrade is complete.

Firmware upgrade for a range of interfaces or parallel firmware download

This is a sample output for the parallel firmware download and information command for a range of interfaces.

switch# show install transceiver interface E1/59,E1/60-64 info 
install transceiver interface E1/15-18 download bootflash:CISCO-EOPTOLINK_QDD-2X400G-LR4_HW_1.2_FW_3.13.bin
show install transceiver interface  E1/15-18 status
install transceiver interface E1/15-18 run
install transceiver interface E1/15-18 commit
install transceiver interface E1/15-18 activate

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Firmware upgrade using NX-OS commands

Overview

Parallel firmware download queues and port mapping

Firmware upgrade phases

Firmware upgrade procedures

Guidelines and limitations for firmware upgrade using NX-OS commands

Upgrade firmware using NX-OS commands

Before you begin

Disruptive immediate upgrade of the transceiver

Procedure

Example:

Example:

Example:

Example:

Example:

Example:

Non-disruptive staged upgrade of the transceiver

Procedure

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Non-disruptive immediate upgrade of the transceiver

Procedure

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Examples for firmware upgrade

Sample disruptive immediate upgrade with both banks valid

Procedure

Example:

Example:

Example:

Example:

Example:

Example:

Sample disruptive immediate upgrade with one bank invalid

Procedure

Example:

Example:

Example:

Example:

Example:

Example:

Sample non-disruptive staged upgrade

Procedure

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Example:

Sample non-disruptive immediate upgrade

Procedure

Example:

Example:

Example:

Example:

Example:

Example:

Firmware upgrade for a range of interfaces or parallel firmware download

Need help?