Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

request system firmware upgrade

date_range 21-Feb-25

Syntax

content_copy zoom_out_map
request system firmware upgrade

    <bios <progress>
    <cb <(fancpld | fpga | optics | port-fpga)>>
    <cpld cpu <progress>>
    <cpld sys <progress>> 
    <eusb <progress>> 
    <fpc <(bcm-pfe | dpll | dpll-cfg | opticscpld<0|1|2|3> | slot slot-number)>> 
    <fpm>
    <ftc slot (0 | 1)>
    <mmc <progress>>
    <pem slot slot-number mcu (primary |secondary)>
    <poe fpc-slot slot-number> 
    <poe file jfirmware filename fpc-slot (number | all-numbers) <poe-at-firmware|poe-bt-firmware> 
    <re <(bios | fancpld | fpga | i210 | i40nvm | ssd (disk1 | disk2) | xmcfpga)>> 
    <sfb slot slot-number tag tag-number>
    <uboot <progress>>
    <vcpu> 

Description

Use this command to upgrade firmware and optics module on a system running Junos OS.

Options

The following table lists all possible options for the request system firmware upgrade command. The fields that are valid may vary depending on the platform and software release.

Use Feature Explorer to confirm platform and release support for specific features.

Review the Platform-Specific Behavior section for notes related to your platform.

bios

Upgrade BIOS.

  • progress—(Optional) Check the progress of BIOS upgrade.

cb

Upgrade baseboard FPGA.

  • fancpld—(Optional) Upgrade fanboard CPLD.

  • fpga—(Optional) Upgrade baseboard FPGA.

  • optics—(Optional) Upgrade optics CPLD.

  • port-fpga—(Optional) Upgrade baseboard PORT FPGA.

cpld cpu

Upgrade CPU CPLD.

  • progress—(Optional) Check the progress of CPU CPLD upgrade.

cpld sys

Upgrade system CPLD.

  • progress—(Optional) Check the progress of system CPLD upgrade.

eusb

Upgrade eUSB firmware.

  • progress—(Optional) Check the progress of eUSB firmware upgrade.

fpc

Upgrade FPC ROM monitor.

  • bcm-pfe—(Optional) Upgrade BCM PFE chip.

  • dpll—(Optional) Upgrade FPC DPLL firmware.

  • dpll-cfg—(Optional) Upgrade FPC DPLL configuration.

  • opticscpld<0|1|2|3>—(Optional) Upgrade optics CPLD.

    • opticscpld0—Upgrade optics CPLD 0.

    • opticscpld1—Upgrade optics CPLD 1.

    • opticscpld2—Upgrade optics CPLD 2.

    • opticscpld3—Upgrade optics CPLD 3.

    Note:

    Run the show system firmware command to verify the number of optics CPLDs supported on your device.

  • slot slot-number—(Optional) Upgrade all devices in a particular FPC slot.

    After you upgrade the firmware on the LC4800 or the LC9600 line card, the line card may go offline. If this happens, use the request chassis fpc slot-number restart command to restart the line card.

fpm

Upgrade front panel module firmware.

ftc slot (0 | 1)

Upgrade fan tray controller firmware.

mmc

Upgrade the eMMC firmware.

  • progress—(Optional) Check the progress of eMMC upgrade.

pem slot slot-number mcu (primary | secondary)

Upgrade PEM firmware.

Within the JNP10K-PWR-AC3 module, there are four types of MCUs; primary, secondary, communication, and LED. This module contains four primary MCUs; however, you can operate the device with three or fewer input leads attached. Before upgrading the firmware on this module, however, you must reattach all of the unattached input leads to ensure that all of the primary MCUs are upgraded to the same firmware version. If you do not reattach an unattached lead, the primary MCU corresponding to that lead is not upgraded, and the PEM remains offline with an alarm of firmware mismatch. This mismatch causes a corresponding PEM output shutdown, causing the PEM to appear offline to avoid issues caused by different firmware versions. If you did not ensure that all of the leads were attached before upgrading and now have the alarm firmware mismatch, attach all of the leads and repeat the firmware upgrade to clear the alarm.

content_copy zoom_out_map
root@host-re0> request system firmware upgrade pem slot 0
WARNING: Please ensure all inputs are connected to this PEM; otherwise, PEM will undergo a partial upgrade and go offline.
Perform indicated firmware upgrade? [yes, no] (no)
pic

Upgrade PIC firmware.

poe fpc-slot slot-number Upgrade Power over Ethernet (PoE) firmware.
poe file <jfirmware filename> fpc-slot (number | all-numbers) <poe-at-firmware | poe-bt-firmware>

Upgrade the PoE controller firmware for the Virtual Chassis member or line card specified by number, or for all Virtual Chassis members and line cards, specified by all-members.

  • poe-at-firmware—Rollback the PoE firmware to IEEE 802.3at (PoE-at).

  • poe-bt-firmware—Upgrade the PoE firmware to IEEE 802.3bt (PoE-bt).

re

Upgrade baseboard BIOS/FPGA. There is an active BIOS image and a backup BIOS image.

  • bios—(Optional) Upgrade BIOS.

  • ctrl-fpga—(Optional) Upgrade Control FPGA.

  • fancpld—(Optional) Upgrade fanboard CPLD.

  • fpga—(Optional) Upgrade baseboard FPGA.

  • i210-ha0—(Optional) Upgrade Intel I210-HA0 GbE NIC.

  • i210-ha1—(Optional) Upgrade Intel I210-HA1 GbE NIC.

  • i210—(Optional) Upgrade baseboard i210 GbE NIC.

  • i40nvm—(Optional) Upgrade baseboard i40.

    Starting in Junos OS Release 19.3R1, you can upgrade the i40e NVM firmware on routers with VM Host support.

  • ssd—(Optional) Upgrade Routing Engine solid-state drive (SSD) firmware.

    • disk1—Upgrade SSD disk1 firmware.

    • disk2—Upgrade SSD disk2 firmware.

    Starting in Junos OS Release 17.2R1, you can upgrade the SSD firmware on routers with the VM Host support.

  • ucd—(Optional) Upgrade RE UCD firmware.

  • xmcfpga—(Optional) Upgrade XMC FPGA.

Note:

To upgrade the re fpga component from version 0x0108 to 0x010A on QFX5130-32CD, the upgrade must be performed twice since the first upgrade command upgrades the component to version 0x0109.

sfb slot slot-number tag tag-number

Upgrade the SF2 and SFB2 switch fabric firmware. slot-number can be 0 to 5. For tag tag-number option, specify the tag number that indicates you want to update the FPGA. To find out what number you should use for the tag option, issue the show system firmware command. For example, the show system firmware command shows the tag numbers in the third column as follows:

content_copy zoom_out_map
user@host> show system firmware                              
Part           Type             Tag  Current             Available         Status
                                       version             version
[output truncated]
...
SFB 0          FPGA PRIM         0   0.13.0               0.13.0               OK                
SFB 1          FPGA PRIM         0   0.13.0               0.13.0               OK                
SFB 2          FPGA PRIM         0   0.13.0               0.13.0               OK                
SFB 3          FPGA PRIM         0   0.13.0               0.13.0               OK                
SFB 4          FPGA PRIM         0   0.13.0               0.13.0               OK                
SFB 5          FPGA PRIM         0   0.13.0               0.13.0               OK              
...
[output truncated]

After you upgrade the firmware on the SFB, you must take the SFB offline by using the request chassis sfb slot slot-number offline command. Once the SFB is offline, bring the SFB back online and make the new firmware take effect by using the request chassis sfb slot slot-number online-reload command.

uboot <progress>

Upgrade the U-boot firmware.

  • progress—(Optional) Check the progress of U-boot upgrade.

vcpu Upgrade VCPU ROM monitor.

Required Privilege Level

maintenance

Output Fields

When you enter this command, you are provided with the resulting status of the command.

Sample Output

request system firmware upgrade

content_copy zoom_out_map
user@host> request system firmware upgrade re bios             
Part             Type           Tag Current   Available Status
                                    version   version
Routing Engine 0 RE BIOS        0   1.5       1.9       OK
Routing Engine 0 RE BIOS Backup 1   1.7       1.9       OK
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re bios backup             
Part             Type           Tag Current   Available Status
                                    version   version
Routing Engine 0 RE BIOS        0   1.5       1.9       OK
Routing Engine 0 RE BIOS Backup 1   1.7       1.9       OK
Perform indicated firmware upgrade ? [yes,no] (no) yes

user@host> request system firmware upgrade re ssd disk1             
Part    Type    Tag    				Current   Available   	Status
                                 	version   version
Routing Engine   0 RE SSD1    4      12028     12029        OK
Perform indicated firmware upgrade ? [yes,no] (no) yes

Firmware upgrade initiated, use "show system firmware"  to monitor status.

user@host> request system firmware upgrade pem slot 0
...
...
Firmware upgrade initiated, use "show system firmware"  to monitor status. 

user@host> request system firmware upgrade optics fpc-slot 0
...
...
Firmware optics upgrade initiated, use "show system firmware"  to monitor status. 

request system firmware upgrade (SRX1600, SRX2300, and SRX4300)

content_copy zoom_out_map
user@host> request system firmware upgrade re ssd ? 
Possible completions:
  disk1                SSD Disk1
  disk2                SSD Disk2
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re ssd disk1
Part             Type              Tag Current               Available             Status
                                       version               version
Routing Engine 0 SSD1              3   40004                 40007                 OK       
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re ssd disk2
Part             Type              Tag Current               Available             Status
                                       version               version
Routing Engine 0 SSD2              3   40004                 40007                 OK       
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re ctrl-fpga    
Part             Type              Tag Current               Available             Status
                                       version               version
Routing Engine 0 CTRL-FPGA         11  1.21                  1.29                  OK        
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re ucd  
Part             Type              Tag Current               Available             Status
                                       version               version
Routing Engine 0 UCD               12  0.2                   0.3                   OK  
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re i210  
Part             Type              Tag Current               Available             Status
                                       version               version
Routing Engine 0 I210              7   3.30.1908             3.30.2032                  OK                
Routing Engine 0 I210-HA0          8   3.30.2047             3.30.2047                  OK                
Routing Engine 0 I210-HA1          9   3.30.2047             3.30.2047                  OK 
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re bios  
Part             Type              Tag Current               Available             Status
                                       version               version
Routing Engine 0 BIOS             1    0.23.4                0.24.1                OK  
Perform indicated firmware upgrade ? [yes,no] (no) yes
user@host> request system firmware upgrade re fpga 
Part             Type              Tag Current               Available             Status
                                       version               version
Routing Engine 0 FPGA              2   1.71                  1.75                  OK     
Perform indicated firmware upgrade ? [yes,no] (no) yes

request system firmware upgrade cpld sys (EX4400-48XP and EX4400-48MXP)

content_copy zoom_out_map
user@host> request system firmware upgrade jfirmware cpld sys
cpld sys firmware upgrade initiated
Check progress using "request system firmware upgrade jfirmware <type> progress"

user@host> request system firmware upgrade jfirmware cpld sys progress
cpld sys firmware upgrade complete
Use "request system reboot" to initiate remote power cycle to install the firmware

request system firmware upgrade fpc slot

content_copy zoom_out_map
user@host> request system firmware upgrade fpc slot 0
...
...
FPC may go offline after the upgrade, Please restart FPC post upgrade.

“request chassis fpc <slot> restart” command can be used for restarting the fpc.

request system firmware upgrade sfb

content_copy zoom_out_map
user@host> request system firmware upgrade sfb slot 0 tag 0
...
...
"Firmware upgrade initiated, use "show system firmware" to monitor status. After upgrade, do "request chassis sfb slot <slot> offline" and “request chassis sfb slot <slot> online-reload” for new firmware to take effect.

Platform-Specific Behavior

Use Feature Explorer to confirm platform and release support for specific features.

Use the following table to review platform-specific behaviors for your platform:

Platform

Difference

MX Series

  • MX10004 and MX10008 support cb, fpm, ftc slot (0 | 1) and sfb slot slot-number tag tag-number

  • MX10004, MX10008, MX10016, and MX304 support pem slot slot-number mcu (primary | secondary)

    Note:

    The mcu option upgrades the firmware on one micro controller unit at a time, applies only to the MX304 router, and is required for the MX304 PEM firmware upgrade.

EX Series Switches

  • EX4100 support uboot <progress> and eusb

  • EX4100 and EX4400 support bios, cpld sys, and poe file <jfirmware filename>fpc-slot (number | all-numbers) <poe-at-firmware | poe-bt-firmware>

  • EX4100 and EX4400 support mmc, and cpld cpu

  • EX4300-48MP support poe-at-firmware

SRX Series

  • SRX1600, SRX2300, and SRX4300 does not support backup BIOS image.

PTX Series (Junos OS)

  • PTX10008 and PTX10016 support pem slot slot-number mcu (primary | secondary)

QFX Series Switches (Junos OS)

  • QFX10008 and QFX10016 support pem slot slot-number mcu (primary | secondary)

Release Information

Command introduced in Junos OS Release 10.2.

cb option added in Junos OS Evolved Releases 21.1R2 and 21.2R1. Support for the MX10004 router added in Junos OS Release 22.3R1.

pem option introduced in Junos OS Release 21.2R1.

sfb option introduced in Junos OS Release 21.4R1 for the MX10008 router. Support for the MX10004 router added in Junos OS Release 22.3R1.

mcu option introduced in Junos OS Release 22.2R1-S1 and 22.3R1 for the MX304 router.

opticscpld, and fancpld options introduced in Junos OS Evolved Release 23.4R1-S1 for QFX5130-48C devices.

ctrl-fpga, i210-ha0, i210-ha1, and ucd options introduced in Junos OS Release 23.4R1 for SRX1600 and SRX2300 devices.

ctrl-fpga, i210-ha0, i210-ha1, and ucd options introduced in Junos OS Release 24.1R1 for SRX4300 device.

dpll, and dpll-cfg options introduced in Junos OS Evolved Release 23.4R1-S1 for QFX5130-48C.

dpll, and dpll-cfg options introduced in Junos OS Evolved Release 23.4R2 for QFX5130-48CM.

dpll, and dpll-cfg options introduced in Junos OS Evolved Release 23.4R2 for QFX5230-64CD.

footer-navigation