Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    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

    To access the installation package if you downloaded it to a remote location (for example, any system other than the switch):

    1. From the command line, make sure you are in the /var/tmp directory of the switch.
    2. Start the shell interface:
      user@switch> start shell
    3. Initiate an FTP, TFTP, or scp session.

      In this example, FTP is used.

      >ftp
    4. Use FTP to access the remote location where the installation package resides.

      For example:

      ftp ftp://<hostname>/<pathname>/<package-name-m.mZx-distribution>.tgz.

      where <package-name-m.mZx-distribution>.tgz is jinstall-qfx-m-15.1X53-D33.secure-domestic.tgz

    5. When prompted, enter your username and password.
    6. Use the get command to transfer the installation package from the remote location to your /var/tmp directory on your switch.
      get <package-name-m.mZx-distribution>.tgz
    7. Close the FTP session:
      bye

    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:

    user@switch# save filename

    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:

    Table 1: 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.

    Install the software in one of two ways:

    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-10-17.2R1.n-secure-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-10-17.2R1.n-secure-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

    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.

    After making sure that the new software version is running correctly on the backup Routing Engine, you are ready to switch routing control to the backup Routing Engine, and then upgrade or downgrade the software version on the other Routing Engine.

    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

    Once the software is installed on the backup Routing Engine, you are ready to switch routing control to the backup Routing Engine, and then upgrade or downgrade the master Routing Engine software:

    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)

    Modified: 2017-06-29