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 Software

To upgrade Junos OS, you need to install the appropriate upgrade package on the device. Upgrading involves these tasks:

Note: If you want to use the Open Network Install Environment (ONIE) to install software, see Installing and Recovering Software Using the Open Network Install Environment (ONIE).

1. Downloading Software Files with a Browser
2. Accessing Software Downloaded to a Remote Location
3. Connecting to the Console Port
4. Backing Up the Current Configuration Files
5. Installing a Standard Software Package on QFX5100, QFX5110, and QFX5200 Switches
6. Installing a Standard Software Package on QFX10002 Switches
7. Upgrading Software from Junos OS Release 15.1X53-D3X to Junos OS Release 15.1X53-D60, 15.1X53-D61.7, 15.1X53-D62, and 15.1X53-D63 on QFX10008 and QFX10016 Switches
8. Installing a Software Package on QFX10008 and QFX10016 Switches

Downloading Software Files with a Browser

To download the software package from the Juniper Networks Support website, go to http://www.juniper.net/support/ .

Note: To access the download site, you must have a service contract with Juniper Networks and an access account. If you need help obtaining an account, complete the registration form at the Juniper Networks website https://www.juniper.net/registration/Register.jsp . This procedure shows you how to upgrade software on a QFX Series device, but you can follow the same procedure for any device unless otherwise specified.

1. Using a Web browser, navigate to the http://www.juniper.net/support .
2. Click Download Software.
3. In the Switching box, click Junos OS Platforms.
4. In the QFX Series section, click the name of the platform for which you want to download software.
5. Click the Software tab and select the release number from the Release drop-down list.
6. In the Install Package section of the Software tab, select the Install Package for the release.

   A login screen appears.

7. Enter your name and password and press Enter.
8. Read the End User License Agreement, click the I agree radio button, and then click Proceed.
9. Save the jinstall-qfx-<version>-secure-domestic.tgz file on your computer.
10. Open or save the installation package either to the local system in the var/tmp directory 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.

Accessing Software Downloaded to a Remote Location

Connecting to the Console Port

We recommend that you connect to the console port while installing the installation package so you can respond to any required user input and detect any errors that may occur.

Backing Up the Current Configuration Files

Before you install the new installation package, we strongly recommend that you back up your current configuration files because the upgrade process removes all of the stored files on the switch.

To back up your current configuration files, enter the save command:

Executing this command saves a copy of your configuration files to a remote location such as an external USB device.

Installing a Standard Software Package on QFX5100, QFX5110, and QFX5200 Switches

Note: Before you install the software, back up any critical files in /var/home. For more information regarding how to back up critical files, contact Customer Support at http://www.juniper.net/support.

Note: On QFX5100 and EX4600 switches, the Host OS is not upgraded automatically, so you must use the force-host option if you want the Junos OS and Host OS versions to be the same. However, pay attention to these notes regarding Junos OS and Host OS versions: The Junos OS and Host OS versions do not need to be the same. During an ISSU, the Host OS cannot be upgraded. Upgrading the Host OS is not required for every software upgrade, as noted above.

Note: On QFX5100 and EX4600 switches, you must use the force-host option if you are downgrading from Junos OS Release 14.1X53-D40 to any release earlier than 14.1X53-D40 otherwise the switch will issue core dumps.

If the installation package resides locally on the switch, execute the request system software add <pathname><source> reboot command.

For example:

user@switch> request system software add /var/tmp/jinstall-host-qfx-5-17.2R1.n-signed.tgz reboot

If the Install Package resides remotely, execute the request system software add <pathname><source> reboot command.

For example:

user@switch> request system software add ftp://ftpserver/directory/jinstall-host-qfx-5-17.2R1.n-signed.tgz reboot

After the reboot has finished, verify that the new version of software has been properly installed by executing the show version command.

user@switch> show version

Installing a Standard Software Package on QFX10002 Switches

Note: Before you install the software, back up any critical files in /var/home. For more information regarding how to back up critical files, contact Customer Support at http://www.juniper.net/support.

Note: If you want to downgrade from Junos OS Release 15.1X53-D60 to a previous release, pay attention to these caveats:

Upgrading Software from Junos OS Release 15.1X53-D3X to Junos OS Release 15.1X53-D60, 15.1X53-D61.7, 15.1X53-D62, and 15.1X53-D63 on QFX10008 and QFX10016 Switches

Note: Before you install the software, back up any critical files in /var/home. For more information regarding how to back up critical files, contact Customer Support at http://www.juniper.net/support.

Note: If you want to downgrade from Junos OS Release 15.1X53-D60 to a previous release, pay attention to these caveats:

Table 2: Caveats for Downgrading from Junos OS Release 15.1X53-D60 to Previous Software Releases

Junos OS Software Releases	Using the CLI	Using a USB Stick
15.1X53-D33	Yes, but the configuration is lost, and there is no workaround. We recommend that you save the configuration to an external location, such as a remote server, and then load the configuration after you have successfully downgraded.	Yes, but the configuration is lost, and there is no workaround. We recommend that you save the configuration to an external location, such as a remote server, and then load the configuration after you have successfully downgraded.
15.1X53-D32	Yes, but the configuration is lost, and there is no workaround. We recommend that you save the configuration to an external location, such as a remote server, and then load the configuration after you have successfully downgraded. Note: You must downgrade to Junos OS Release 15.1X53-D33 before you downgrade to Junos OS Release 15.1X53-D30.	Yes, but the configuration is lost, and there is no workaround. We recommend that you save the configuration to an external location, such as a remote server, and then load the configuration after you have successfully downgraded. Note: You must downgrade to Junos OS Release 15.1X53-D33 before you downgrade to Junos OS Release 15.1X53-D32.
15.1X53-D30	No	Yes, but the configuration is lost, and there is no workaround. We recommend that you save the configuration to an external location, such as a remote server, and then load the configuration after you have successfully downgraded. Note: You must downgrade to Junos OS Release 15.1X53-D33 before you downgrade to Junos OS Release 15.1X53-D30.
Releases prior to 15.1X53-D30	No	Yes, but the configuration is lost, and there is no workaround. We recommend that you save the configuration to an external location, such as a remote server, and then load the configuration after you have successfully downgraded. Note: You must downgrade to Junos OS Release 15.1X53-D33 before you downgrade to Junos OS Release 15.1X53-D30.

The switch contains two routing engines, so you will need to install the software on each routing engine (re0 and re1).

If the installation package resides locally on the switch, execute the request system software add <pathname><source> command.

To install the software on re0:

user@switch> request system software add /var/tmp/jinstall-host-qfx-10-m-15.1X53-D60.4-secure-domestic-signed.tgz re0

If the Install Package resides remotely from the switch, execute the request system software add <pathname><source> re0 command.

For example:

user@switch> request system software add ftp://ftpserver/directory/jinstall-host-qfx-10-m-15.1X53-D60.4-secure-domestic-signed.tgz re0

To install the software on re1:

user@switch> request system software add /var/tmp/jinstall-host-qfx-10-m-15.1X53-D60.4-secure-domestic-signed.tgz re1

If the Install Package resides remotely from the switch, execute the request system software add <pathname><source> re1 command.

For example:

user@switch> request system software add ftp://ftpserver/directory/jinstall-host-qfx-10-m-15.1X53-D60.4-secure-domestic-signed.tgz re1

Reboot both routing engines.

For example:

user@switch> request system reboot both-routing-engines

After the reboot has finished, verify that the new version of software has been properly installed by executing the show version command.

user@switch> show version

Installing a Software Package on QFX10008 and QFX10016 Switches

Because the switch has two Routing Engines, perform a Junos OS installation on each Routing Engine separately to avoid disrupting network operation.

Note: Before you install the software, back up any critical files in /var/home. For more information regarding how to back up critical files, contact Customer Support at http://www.juniper.net/support.

Warning: If graceful Routing Engine switchover (GRES), nonstop bridging (NSB), or nonstop active routing (NSR) is enabled when you initiate a software installation, the software does not install properly. Make sure you issue the CLI delete chassis redundancy command when prompted. If GRES is enabled, it will be removed with the redundancy command. By default, NSR is disabled. If NSR is enabled, remove the nonstop-routing statement from the [edit routing-options] hierarchy level to disable it.

To upgrade the software, perform the following tasks:

1. Preparing the Switch for Installation
2. Installing Software on the Backup Routing Engine
3. Installing Software on the Master Routing Engine

Preparing the Switch for Installation

Perform the following steps before installing the software:

1. Log in to the master Routing Engine’s console.

   For more information about logging in to the Routing Engine through the console port, see the specific hardware guide for your switch.

2. From the command line, enter configuration mode:
   user@switch> configure
3. Disable Routing Engine redundancy:
   user@switch# delete chassis redundancy
4. Disable nonstop-bridging:
   user@switch# delete protocols layer2-control nonstop-bridging
5. Save the configuration change on both Routing Engines:
   user@switch# commit synchronize
6. Exit the CLI configuration mode:
   user@switch# exit

Installing Software on the Backup Routing Engine

After the switch has been prepared, you first install the new Junos OS release on the backup Routing Engine, while keeping the currently running software version on the master Routing Engine. This enables the master Routing Engine to continue operations, minimizing disruption to your network.

1. Log in to the console port on the other Routing Engine (currently the backup).

   For more information about logging in to the Routing Engine through the console port, see the specific hardware guide for your switch.

2. Install the new software package using the request system software add command:
   user@switch> request system software add validate /var/tmp/jinstall-host-qfx-10-17.2R1.n-secure-signed.tgz

   For more information about the request system software add command, see the CLI Explorer.

3. Reboot the switch to start the new software using the request system reboot command:
   user@switch> request system reboot

   Note: You must reboot the switch to load the new installation of Junos OS on the switch. To abort the installation, do not reboot your switch. Instead, finish the installation and then issue the request system software delete <package-name> command. This is your last chance to stop the installation.

   All the software is loaded when you reboot the switch. Installation can take between 5 and 10 minutes. The switch then reboots from the boot device on which the software was just installed. When the reboot is complete, the switch displays the login prompt.

   While the software is being upgraded, the Routing Engine on which you are performing the installation is not sending traffic.

4. Log in and issue the show version command to verify the version of the software installed.
   user@switch> show version

Installing Software on the Master Routing Engine

1. Log in to the master Routing Engine console port.

   For more information about logging in to the Routing Engine through the console port, see the specific hardware guide for your switch.

2. Transfer routing control to the backup Routing Engine:
   user@switch> request chassis routing-engine master switch

   For more information about the request chassis routing-engine master command, see the CLI Explorer.

3. Verify that the backup Routing Engine (slot 1) is the master Routing Engine:
   user@switch> show chassis routing-engine

   Routing Engine status:
     Slot 0:
       Current state                  Backup
       Election priority              Master (default)
   
   Routing Engine status:
     Slot 1:
       Current state                  Master
       Election priority              Backup (default)

4. Install the new software package using the request system software add command:
   user@switch> request system software add validate /var/tmp/jinstall-host-qfx-10-17.2R1.n-secure-signed.tgz

   For more information about the request system software add command, see the CLI Explorer.

5. Reboot the Routing Engine using the request system reboot command:
   user@switch> request system reboot

   Note: You must reboot to load the new installation of Junos OS on the switch. To abort the installation, do not reboot your system. Instead, finish the installation and then issue the request system software delete jinstall <package-name> command. This is your last chance to stop the installation.

   The software is loaded when you reboot the system. Installation can take between 5 and 10 minutes. The switch then reboots from the boot device on which the software was just installed. When the reboot is complete, the switch displays the login prompt.

   While the software is being upgraded, the Routing Engine on which you are performing the installation does not send traffic.

6. Log in and issue the show version command to verify the version of the software installed.
7. Transfer routing control back to the master Routing Engine:
   user@switch> request chassis routing-engine master switch

   For more information about the request chassis routing-engine master command, see the CLI Explorer.

8. Verify that the master Routing Engine (slot 0) is indeed the master Routing Engine:
   user@switch> show chassis routing-engine

   Routing Engine status:
     Slot 0:
       Current state                  Master
       Election priority              Master (default)
   
   outing Engine status:
     Slot 1:
       Current state                  Backup
       Election priority              Backup (default)