Rate and give feedback:  Feedback Received. Thank You!

Rate and give feedback: 

X

This document helped resolve my issue

Yes No

Additional Comments

800 characters remaining

May we contact you if necessary?

Name:  

E-mail: 

Enter a valid Email ID

Need product assistance? Contact Juniper Support

Submit

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply.

English  

English

Upgrading Jloader Software on QFX Series Devices

Jloader software contains a boot loader (Uboot), which is used to bring up QFX Series devices and load the Junos OS from the flash memory of these devices. You can upgrade Jloader software on QFX3500 switches, QFX3500 and QFX3600 Node devices, and QFX3600-I and QFX3008-I Interconnect devices.

Note: Before you upgrade the Jloader software, see Table 1, Table 2, and Table 3 to make sure that you are upgrading to the right version of Jloader software for the Junos OS software release running on your QFX3500 switches, or Node devices and Interconnect devices in your QFabric system.

See Table 4 to see which Uboot software versions are available and the filenames of the Jloader software packages.

Table 1: Junos OS and Jloader Software Compatibility Matrix for the QFX3500 Switch and QFX3500 Node Device

Junos OS Software Version	Jloader Software Version
	1.0.73	1.1.1	1.1.2	1.1.4	1.1.5
11.3R1 and later (QFX3500 switch)	Not supported	Supported	Supported	Supported and recommended	Not supported
11.3X30.6 and later (QFX3500 Node device)	Not supported	Supported	Supported	Supported and recommended	Not supported
12.1X49-D1 and later (QFX3500 switch)	Not supported	Supported	Supported	Supported and recommended	Not supported
12.2X50-D1 and later (QFX3500 switch and QFX3500 Node device)	Not supported	Supported	Supported	Supported and recommended	Not supported

Note: An en dash means that the item is not applicable.

Table 2: Junos OS and Jloader Software Compatibility Matrix for the QFX3008-I Interconnect Device

Junos OS Software Version	Jloader Software Version
	1.0.73	1.1.1	1.1.2	1.1.4	1.1.5
11.3X30.9 and later (QFX3008-I Interconnect device)	-	Supported	Supported	Supported and recommended	Not supported
11.3X30.6 and later (QFX3008-I Interconnect device)	-	Supported	Supported	Supported and recommended	Not supported
12.2X50-D1 and later (QFX3008-I Interconnect device)	-	Supported	Supported	Supported and recommended	Not supported

Note: An en dash means that the item is not applicable.

Table 3: Junos OS and Jloader Software Compatibility Matrix for the QFX3600-I Interconnect Device and QFX3600 Node Device

Junos OS Software Version	Jloader Software Version
	1.0.73	1.1.1	1.1.2	1.1.4	1.1.5
12.2X50-D1 and later (QFX3600-I Interconnect Device and QFX3600 Node Device)	-	-	-	-	Supported
12.2X50-D20 and later (QFX3600 switch)	-	-	-	-	Supported

Table 4: Uboot Software Release and Jloader Software Compatibility Matrix

Uboot Software Release Number	Jloader Package Name
1.0.73	jloader-qfx-1_0_73.tgz
1.1.1	jloader-qfx-11.3-20110510.0-signed.tgz
1.1.2	jloader-qfx-11.3X30.9-signed.tgz
1.1.4 (11.3R3 and 11.3R2 releases only. Not supported on 11.3R1)	jloader-qfx-11.3I20120127_0733_dc-builder-signed.tgz
1.1.4 (12.1R1 release and later)	jloader-qfx-12.1-20120125_pr.0-signed.tgz
1.1.5 (12.2X50-D1 and later)	jloader-qfx-12.2X50.D10.3-signed.tgz

Jloader Software Version 1.1.4 Guidelines

Jloader software version 1.1.4 is compatible with Junos OS Release 11.3R3 and 11.3R2, and Junos OS Release 12.1R1 and later. Jloader software version 1.1.4 is not compatible with Junos OS
Release 11.3R1. The Jloader package names are different for versions 1.1.4 (Junos OS 11.3R3 and 11.3R2) and 1.1.4 (Junos OS 12.2R1 release and later), but the binaries are the same. Because the binaries are the same, you can upgrade or downgrade to any Junos OS release.

• If you have Junos OS Release 11.3 installed and want to upgrade the Jloader software from version 1.1.2 to version 1.1.4, you need to upgrade using the jloader-qfx-11.3I20120127_0733_dc-builder-signed.tgz package.
• If you have Junos OS Release 11.3R2 installed and want to upgrade to Junos OS Release 12.1, you do not need to upgrade the Jloader software version and can continue to use Jloader version 1.1.2.
• If you have Junos OS Release 12.1 installed and want to upgrade the Jloader software from version 1.1.2 to version 1.1.4, you need to upgrade using the jloader-qfx-12.1-20120125_pr.0-signed.tgz package.
• If you upgrade to Junos OS Release 12.1, you can upgrade to Jloader version 1.1.4 using the jloader-qfx-12.1-20120125_pr.0-signed.tgz package.

Upgrading Jloader Software on a QFX3500 Switch

The Jloader software for a QFX3500 switch resides in two flash memory banks. At any time, one bank acts as the primary bank, and the QFX3500 switch boots from it. The other bank is the backup bank—if the QFX3500 switch cannot boot from the primary bank, it boots from the backup bank. When you upgrade the Jloader software, the upgraded software is installed in the backup bank, which then becomes the new primary bank. Thus the primary and backup banks alternate each time you upgrade the Jloader software, with the primary bank containing the most recently installed version of the software, and the backup bank containing the previous version. To upgrade the Jloader software on a QFX3500 switch, you must perform the upgrade twice: once for each bank. Each upgrade requires that you to reboot the QFX3500 switch.

Note: If you are running Junos OS Release 11.3R1 or Junos OS Release 11.3R2, you must use the no-validate option when you issue the request system software add command to upgrade the Jloader software. Otherwise, the installation will fail and you receive a configuration error. The no-validate option is not required for Junos OS Release 11.3R3 and later.

Note: After you upgrade the Jloader software on the first bank, the package is deleted after you reboot. Make sure that you have either downloaded the Jloader software to either a remote site or in a local directory on the switch, such as the /var/tmp directory on the QFX3500 device.

1. In a browser, go to https://www.juniper.net/support/downloads/junos.html .

   The Junos Platforms Download Software page appears.

2. In the QFX Series section of the Junos Platforms Download Software download page, select the QFX Series platform software you want to download.
3. Select the number of the software version that you want to download in the Release: pull-down window to the right of the tabs on the Download Software page.
4. Select the Software tab and then select the install package you want to download in the Install Package section.
5. In the pop-up Alert box, click the link to the Product Support Notification (PSN) document.
6. Enter your name and password and press Enter.
7. Read the End User License Agreement, click the I agree radio button, and then click Proceed.
8. Open or save the jloader-qfx-version-signed.tgz file either to a local system or to a remote location. If you are saving the installation package to a remote system, make sure that you can access it using HTTP, TFTP, FTP, or scp.
9. Log in to the QFX3500 switch and enter the shell. We recommend using a console connection.
10. Determine the version of the Jloader software package installed on the switch.

    For example:

    root@switch% ls

    gres-tp krt_gencfg_filter.txt

    jloader-qfx-11.3-20110510.0-signed.tgz
11. Determine the version of the Uboot software that is running in the bank:

    For example:

    root@switch% kenv | grep boot.version

    boot.version="1.0.7"
12. Enter the CLI and install the Jloader package.
    • To install a Jloader package that is located in the /var/tmp directory, issue the request system software add /var/tmp/jloader-qfx-version.tgz no-validate command:

      For example:

      user@switch> request system software add /var/tmp/jloader-qfx-11.3-20110510.0-signed.tgz no-validate

      You see the following messages during the installation:

      Verified jloader-qfx-11.3-20110510.0.tgz signed by PackageProduction_11_3_0
      Adding jloader-qfx...
      Installation in progress, please wait...
      Mounted jloader-qfx package on /dev/md8...
      Verified manifest signed by PackageProduction_11_3_0
      Verified jloader-qfx-11.3-20110510.0 signed by PackageProduction_11_3_0
      Registering jloader-qfx as unsupported
      
      Installation finished successfully.
      Please reboot to activate the package
      Saving package file in /var/sw/pkg/jloader-qfx-11.3-20110510.0-signed.tgz ...
      Saving state for rollback ...
      
      juniper@qfx3500> 

    • To install a Jloader package located on a remote server using FTP, issue the request system software add /ftp://hostname/pathname/jloader-qfx-version-signed.tgz no-validate command.

      For example:

      user@switch> request system software add /ftp://hostname/pathname/jloader-qfx-11.3-20110510.0-signed.tgz no-validate
    • To install a Jloader package located on a remote server using HTTP, issue the request system software add /http://hostname/pathname/jloader-qfx- version-signed.tgz no-validate command.

      For example:

      user@switch> request system software add /http://hostname/pathname/jloader-qfx-11.3-20110510.0-signed.tgz no-validate
13. When prompted, reboot the Control Board by issuing the request system reboot command.

    For example:

    user@switch> request system reboot

    Reboot the system ? [yes,no] (no) yes

14. Enter the shell and verify that the version of the Uboot software in the primary bank is the version you just installed.

    For example:

    root@switch% kenv | grep boot.version

    boot.version="1.1.1"
15. To install the Jloader software package on the current backup bank, repeat Step 10 through Step 14.

Upgrading Jloader Software on a QFabric System

This procedure explains how to upgrade the Jloader software on your Node devices and Interconnect devices. The example shows how to upgrade the Jloader software from version 1.1.1 to 1.1.2 on a Node device with the serial number BBAK1186.

Note: Before you upgrade the Jloader software, make sure you have the serial numbers of the Node devices, Interconnect devices, and Control Boards in the Interconnect devices you want to upgrade.

1. Issue the show chassis hardware node-device ? command to view the serial numbers of the Node devices.

   For example:

   user@qfabric> show chassis hardware node-device ?

   
     <node-device>        Node device identifier
     BBAK1186             Node device
     BBAK3149             Node device
     BBAK3177             Node device
     BBAK8063             Node device
     BBAK8799             Node device
     P2443-C              Node device
     P2515-C              Node device
     P3708-C              Node device
     P3885-C              Node device
     P3916-C              Node device
     node0                Node device
     node1                Node device
     node2                Node device
     node3                Node device
     node4                Node device
     node5                Node device
     node6                Node device
     node7                Node device
     node8                Node device
   

   An example of a Node device serial number is BBAK1186.

2. Issue the show chassis hardware interconnect-device ? command to view the serial numbers of the Interconnect devices.

   For example:

   user@qfabric> show chassis hardware interconnect-device ?

   
   Possible completions:
     interconnect-device  Interconnect device identifier
     IC-F1052             Interconnect device
     IC-F3947             Interconnect device
   

   The Interconnect device serial numbers are IC-F1052 and IC-F3947.

3. Issue the show chassis hardware interconnect-device name command to view the serial numbers of the Control Boards in the Interconnect device.

   For example:

   user@qfabric> show chassis hardware interconnect-device IC-F3947

   
   Hardware inventory:
   Item             Version  Part number  Serial number     Description
   Chassis          REV 10                F3947             QFXC08-3008
   Midplane         REV 10   750-035835   F3947-C           QFX Midplane
   CB 0             REV 14   750-035855   ZJ9432            QFX Chassis Control Board
     Routing Engine 0        BUILTIN      BUILTIN           QFX Routing Engine
   CB 1             REV 14   750-035855   ZJ9404            QFX Chassis Control Board
   

   The Control Board serial numbers are ZJ9432 and ZJ9404.

4. Issue the show chassis firmware node-device name command to see which version of Uboot software you have installed on your Node device.

   For example:

   user@qfabric> show chassis firmware node-device BBAK1186

   Part                     Type       Version
   node4                    U-Boot     1.1.6 (May 10 2011 - 04:52:59) 1.1.1       
                            loader     FreeBSD/MIPS U-Boot bootstrap loader 0.1   
   

   The Uboot software version is 1.1.1. The loader software version appears after the timestamp for U-Boot 1.1.6.

5. Issue the show chassis firmware interconnect-device name command to see which version of Uboot software you have installed on the Routing Engines located on the Control Boards of the Interconnect device.

   For example:

   user@qfabric> show chassis firmware interconnect-device IC-F3947

   Part                     Type       Version
   Routing Engine 0         U-Boot     U-Boot 1.1.6 (Jan 27 2012 - 03:24:34) 1.1.4
                            loader     FreeBSD/MIPS U-Boot bootstrap loader 0.1   
   Routing Engine 1         U-Boot     U-Boot 1.1.6 (Jan 27 2012 - 03:24:34) 1.1.4
                            loader     FreeBSD/MIPS U-Boot bootstrap loader 0.1   
   

   The Uboot software version is 1.1.4. The loader software version appears after the timestamp for U-Boot 1.1.6.

6. In a browser, go to https://www.juniper.net/support/downloads/junos.html .

   The Junos Platforms Download Software page appears.

7. In the QFX Series section of the Junos Platforms Download Software download page, select the QFX Series platform software you want to download.
8. Select the number of the software version that you want to download in the Release: pull-down window to the right of the tabs on the Download Software page.
9. Select the Software tab and then select the install package you want to download in the Install Package section.
10. In the pop-up Alert box, click the link to the Product Support Notification (PSN) document.
11. Enter your username and password, and press Enter.
12. Read the End User License Agreement, click the I agree radio button, and then click Proceed.
13. Open or save the jloader-qfx-version-signed.tgz file either to a local system or to a remote location. If you are saving the installation package to a remote system, make sure that you can access it using HTTP, TFTP, FTP, or scp.
14. Retrieve the software from the location in which you downloaded it. To do this, issue the request system software download /path/package-name command.
    For example:

    user@qfabric> request system software download ftp://server/files/jloader-qfx-11.3X30.9-signed.tgz
15. Log in to the Director device as root and enter the shell to verify that you have downloaded the Jloader software package. We recommend using a console connection. The software package is copied from where you downloaded it and is placed locally on the QFabric system in the /pbdata/packages directory.

    For example:

    [root@dg0] # pwd

    /pbdata/packages

    [root@dg0] # ls

    jloader-qfx-11.3X30.9-signed.tgz

16. Before you copy over the Jloader software package to the Node device or Interconnect device, determine the directory that matches the serial number of the Node device or Interconnect device that you want to upgrade. View the remote logs and the Node device and Interconnect device serial numbers by issuing the ls /pdbata/export/rlogs command at the command line of the Director device before you copy the package over to the device.

    Note: The /pbdata/export/rlogs/node-device-serial-ID and /pbdata/export/rlogs/interconnect-device-serial-ID directories on the Director device are NFS mounted as the /tftpboot/logfiles directories on the Node device and Interconnect device. These directories are created for all Node devices and Interconnect devices in a QFabric system. The Jloader files are stored in the /tftpboot/logfiles directories for each Node device and Interconnect device.

    For example:

    [root@dg0 tmp] # ls /pdbata/export/rlogs

    02de4930-828b-11e1-a319-00e081c57938  c9898afe-828b-11e1-956c-00e081c57938
    04103b2a-29d5-e011-bf8a-0e6bdf3aa1e6  eeba4aac-828b-11e1-85e2-00e081c57938
    1e2739e0-828b-11e1-bf74-00e081c57938  F1052
    8d8a978c-828b-11e1-a833-00e081c57938  F3947
    ad55b89e-828b-11e1-b70e-00e081c57938  P2443-C
    BBAK1186                              P2515-C
    BBAK3149                              P3708-C
    BBAK3177                              P3885-C
    BBAK8063                              P3916-C
    BBAK8799
    

    BBAK1186 is the serial number of the Node device that needs to be upgraded.

17. Copy the Jloader software package from the /var/tmp directory to the /pbdata/export/rlogs/BBAK1186 directory.

    For example:

    [root@dg0 tmp] # cp jloader-qfx-11.3X30.9-signed.tgz /pbdata/export/rlogs/BBAK1186
18. Confirm that the Jloader software package you copied over is in the /pbdata/export/rlogs/BBAK1186 directory.

    For example:

    [root@dg0 tmp] # ls /pbdata/export/rlogs/BBAK1186

    jloader-qfx-11.3X30.9-signed.tgz

19. Issue the /root/dns.dump command to find out the internal IP addresses of the Node device or Interconnect device.
    [root@dg0 tmp] # /root/dns.dump

    ; <<>> DiG 9.3.6-P1-RedHat-9.3.6-4.P1.el5 <<>> -t axfr pkg.dcbg.juniper.net @169.254.0.1
    ;; global options:  printcmd
    pkg.dcbg.juniper.net.   600     IN      SOA     ns.pkg.dcbg.juniper.net. mail.pkg.dcbg.juniper.net. 152 3600 600 7200 3600
    pkg.dcbg.juniper.net.   600     IN      NS      ns.pkg.dcbg.juniper.net.
    pkg.dcbg.juniper.net.   600     IN      A       169.254.0.1
    pkg.dcbg.juniper.net.   600     IN      MX      1 mail.pkg.dcbg.juniper.net.
    dcfnode---DCF-ROOT.pkg.dcbg.juniper.net. 45 IN A 169.254.192.17
    dcfnode---DRE-0.pkg.dcbg.juniper.net. 45 IN A   169.254.3.3
    dcfnode-8d8a978c-828b-11e1-a833-00e081c57938.pkg.dcbg.juniper.net. 45 IN A 169.254.128.19
    dcfnode-ad55b89e-828b-11e1-b70e-00e081c57938.pkg.dcbg.juniper.net. 45 IN A 169.254.128.20
    dcfnode-BBAK1186.pkg.dcbg.juniper.net. 45 IN A  169.254.128.14
    

    The internal IP address for BBAK1186 is 169.254.128.14.

20. Upgrade the Jloader software on the Node device or Interconnect device.

    Before you can upgrade the Jloader software, you need to use SSH to log in to the Node device or Interconnect device and verify that the software is in the /tftpboot/logfiles directory.

    1. Use SSH to log in to the Node device or Interconnect device.

       For example:

       [root@dg0 tmp] # ssh 160.254.128.14

       root@169.254.128.14's password: 
       --- JUNOS 11.3X30.10 built 2012-03-11 22:55:43 UTC
       At least one package installed on this device has limited support.
       Run 'file show /etc/notices/unsupported.txt' for details.
       root@sng3% 
       

    2. Verify that the Jloader software package is in the tftpboot/logfiles directory of the Node device or Interconnect device.

       For example:

       root@sng3% ls /tftpboot/logfiles

       .index                                  jloader-qfx-11.3X30.9-signed.tgz

    3. Copy the Jloader software package from the /tftpboot/logfiles directory to the /var/tmp directory of the Node device or Interconnect device.

       For example:

       root@sng3% cp /tftpboot/logfiles/jloader-qfx-11.3X30.9-signed.tgz /var/tmp
    4. Verify that the Jloader software package is in the /var/tmp directory of the Node device or Interconnect device.

       For example:

       root@sng3% ls /var/tmp

       .snap                                   jloader-qfx-11.3X30.9-signed.tgz        tmp
       gres-tp                                 krt_gencfg_filter.txt                   vc-autoupgrade
       if-rtsdb                                rtsdb
       

    5. Enter CLI mode and issue the request system software add /var/tmp/jloader-qfx-version-signed.tgz command.

       For example:

       root@sng3% cli

       root@sng3> request system software add /var/tmp/jloader-qfx-11.3X30.9-signed.tgz

       Validating on fpc0
       Checking compatibility with configuration
       Initializing...
       Using jbase-11.3X30.10
       Verified manifest signed by PackageProduction_11_3_0
       Verified jbase-11.3X30.10 signed by PackageProduction_11_3_0
       Using /var/tmp/jloader-qfx-11.3X30.9-signed.tgz
       Verified jloader-qfx-11.3X30.9.tgz signed by PackageProduction_11_3_0
       Using jloader-qfx-11.3X30.9.tgz
       Checking jloader-qfx requirements on /
       Verified manifest signed by PackageProduction_11_3_0
       Verified jloader-qfx-11.3X30.9 signed by PackageProduction_11_3_0
       Using jkernel-qfx-11.3X30.10
       Verified manifest signed by PackageProduction_11_3_0
       Verified jkernel-qfx-11.3X30.10 signed by PackageProduction_11_3_0
       Using jroute-qfx-11.3X30.10
       Verified manifest signed by PackageProduction_11_3_0
       Verified jroute-qfx-11.3X30.10 signed by PackageProduction_11_3_0
       Using jcrypto-qfx-11.3X30.10
       Verified manifest signed by PackageProduction_11_3_0
       Verified jcrypto-qfx-11.3X30.10 signed by PackageProduction_11_3_0
       Using jweb-qfx-11.3X30.10
       Verified manifest signed by PackageProduction_11_3_0
       Verified jweb-qfx-11.3X30.10 signed by PackageProduction_11_3_0
       Using jswitch-qfx-11.3X30.10
       Verified manifest signed by PackageProduction_11_3_0
       Verified jswitch-qfx-11.3X30.10 signed by PackageProduction_11_3_0
       Hardware Database regeneration succeeded
       Validating against /config/juniper.conf.gz
       mgd: commit complete
       Validation succeeded
       Done with validate on all chassis
       
       fpc0:
       Verified jloader-qfx-11.3X30.9.tgz signed by PackageProduction_11_3_0
       Adding jloader-qfx...
       Installation in progress, please wait...
       Mounted jloader-qfx package on /dev/md10...
       Verified manifest signed by PackageProduction_11_3_0
       Verified jloader-qfx-11.3X30.9 signed by PackageProduction_11_3_0
       #######################################
       ################################################################################################################################################################################################
       Installation finished successfully.
       Please reboot to activate the package
       Saving package file in /var/sw/pkg/jloader-qfx-11.3X30.9-signed.tgz ...
       Saving state for rollback ...
       
       
       Upgrade has completed successfully.  
       Reboot is now required.  
       

    6. Reboot both the Node device and Interconnect device twice, because they each contain two partitions.

       For example:

       root@sng3> request system reboot

       Reboot the system ? [yes,no] (no) yes
       Shutdown NOW!
       [pid 37663]
       
       root@sng3>                                                                                
       *** FINAL System shutdown message from root@sng3 ***                         
       System going down IMMEDIATELY 
       

    7. Verify that the Uboot software on the Node device or Interconnect device has been upgraded to the new Uboot software by logging in to the QFabric CLI and issuing either the show chassis firmware node-device name command or the show chassis firmware interconnect-device name command.

       For example:

       user@qfabric> show chassis firmware node-device BBAK1186

       Part                     Type       Version
       node4                    U-Boot     1.1.6 (Nov 19 2011 - 11:42:07) 1.1.2       
                                loader     FreeBSD/MIPS U-Boot bootstrap loader 0.1   
       

       The Uboot software version is now 1.1.2. The loader software version appears after the timestamp for U-Boot 1.1.6.