Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Upgrading Software on a QFabric System

The QFabric system software package contains software for all of the different components in the QFabric system, such as the Director group, Interconnect devices, Node devices, and other QFabric system components. You can upgrade the software on all of the QFabric components at the same time using the request system software add package-name component all reboot command.


Downgrading software on a QFabric system is not supported.

This topic describes the following tasks:

Backing Up the Current Configuration Files

To back up your current configuration files:

Back up the configuration files to a local directory, remote server, or removable drive (for example, an external USB flash drive).

For example:

Downloading Software Files Using a Browser


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 .

  1. Using a Web browser, navigate to the .
  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. Select the complete install package you want to download in the QFabric System Install Package section:
    • If you want to upgrade the entire QFabric system, select QFabric System - Complete Install Package.

    • If you want to upgrade either a single Node or Interconnect device for recovery purposes, select Node and Interconnect Device Install Package. For information on how to perform a recovery installation on either a Node or Interconnect device, see Performing a Recovery Installation.

    A login screen appears.

  7. Enter your user ID and password and click Login.
  8. Read the End User License Agreement, select the I agree option button, and then click Proceed.
  9. Save the jinstall-qfabric-version.rpm file on your computer.

Retrieving Software Files for Download

Retrieve the software from the location in which you downloaded it. To do this, issue the request system software download command. The software package is copied from where you downloaded it and is placed locally on the QFabric system.

To retrieve the software:

For example:

Installing the Software Package on the Entire QFabric System


On a QFabric system, a QFX3500 Node device or QFX3600 Node device might not be able to participate as a Node device in the QFabric system if the Node device is running a different version of software from that of the Director group. This mismatch of software versions between the Node device and the Director group can occur when the Node device is introduced into the setup, and both Director devices go offline before the Node device completes its auto-upgrade process to upgrade its software version to the same software version running on the Director group. The workaround is to reboot the QFX3500 or QFX3600 Node device once the Director group comes back online. The QFX3500 or QFX3600 Node device will initiate auto-upgrade and upgrade its software version from the Director group.

  1. Issue the request system software add package-name component all reboot command.

    For example:


    If you receive an error message after issuing the request system software add package-name component all reboot command that says that the configuration file cannot be loaded as is, you will need to enter configuration mode, make any necessary changes to the configuration file, and then commit the changes.


    The default value for a QFabric system software upgrade is validate. The validation step adds up to 10 minutes to the overall software upgrade. If the validation fails, the upgrade does not proceed and the QFabric system automatically issues the request system software rollback command to restore the current software image. If you upgrade more than one component (for example, by issuing the component all option), validation failure on one device stops the upgrade process for the other devices. If you do not want to validate the software package against the current configuration, issue the no-validate option.

  2. After the reboot has finished, verify that the new version of software has been properly installed by issuing the show version component all command.