Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Performing a Nonstop Software Upgrade on the QFabric System

 
Note

Before you perform a nonstop software upgrade, contact JTAC to perform a pre-upgrade health check on the QFabric system.

Note

Before you can perform a nonstop software upgrade to Junos OS Release 13.1X50-D10, you must have Junos OS Release 12.2X50-D42 or later installed. You cannot perform a nonstop software upgrade with Junos OS Release 12.2X50-D41 or earlier. Contact the Juniper Technical Assistance Center for information on how to download Junos OS Release 12.2X50-D42. Performing a standard software upgrade (that is, issuing the request system software add component all command) does not require that you that you upgrade to an intermediate Junos OS software release.

To perform a nonstop software upgrade to Junos OS Release 13.1X50-D10:

  1. First perform a nonstop software upgrade to Junos OS Release 12.2X50-D42.
  2. Then perform a nonstop software upgrade to Junos OS Release 13.1X50-D10.

Nonstop software upgrade enables you to upgrade a QFabric system with minimal packet loss and maximum uptime. This feature introduces several high availability improvements to the QFabric system software upgrade process, including:

  • Upgrading members of a Director group or Node group one at a time so that one device in the group is always operational

  • Switching mastership of Routing Engine processes to the backup Director device before upgrading the master Director device

  • Rebooting Interconnect devices and fabric control Routing Engines one at a time, so that one Interconnect device or one fabric control Routing Engine is always operational

  • Switching mastership of a Node group to the backup Node device before upgrading the master Node device

  • Specifying an upgrade group if you want all Node devices in a Node group to be upgraded in parallel (which shortens the time of the upgrade)

  • Rebooting devices automatically as part of the nonstop upgrade process

When performing a nonstop upgrade, start with the Director group upgrade, then issue the fabric upgrade, and end with the Node group upgrades.

Note

Because there is no redundancy for Node groups containing a single Node device, traffic loss occurs when the device reboots during the upgrade. For node-groups defined with two node-devices, both must be online in order for upgrade to succeed.

Note

Before you install the software, we recommend that you back up your current configuration files by issuing the request system software configuration-backup command.

Note

Before you can perform a nonstop software upgrade in your QFabric system, you must first upgrade your system to Junos OS Release 12.2 by using a conventional upgrade method such as issuing the request system software add component all command.

This topic describes the following tasks:

Backing Up the Current Configuration Files

To back up your current configuration files:

user@qfabric> request system software configuration-backup path

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

For example:

user@qfabric> request system software configuration-backup/media/USB/

Downloading Software Files Using a Browser

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 .

  1. Using a Web browser, navigate to the https://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. 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 press Enter.
  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:
    user@qfabric> request system software download /path/package-name

    For example:

    user@qfabric> request system software download ftp://server/files/jinstall-qfabric-12.2X50-D10.3.rpm

Performing a Nonstop Software Upgrade for Director Devices in a Director Group

Note

If you reboot any Node groups or Interconnect devices after you perform a nonstop upgrade on the Director group, these devices are upgraded to the same version of software that is running on the Director group.

To upgrade the software on the Director devices in a Director group:

  • Issue the request system software nonstop-upgrade director-group package-name command.

    For example:

    user@qfabric> request system software nonstop-upgrade director-group jinstall-qfabric-12.2X50-D10.3.rpm

When the Director group is rebooting the first Director device during the upgrade and transferring mastership to the peer director device, you might not be able to log in and access the QFabric system CLI for several minutes while user interface services come back online.

Performing a Nonstop Software Upgrade for Interconnect Devices and Other Fabric-Related Components

Before you perform a nonstop upgrade on the Interconnect devices and other fabric-related components, verify that both Director devices in the Director group are online. Both Director devices must be online before you attempt to perform a nonstop upgrade. To do verify that both Director devices are online, issue the show fabric administration inventory director-group status command.

To install the software on the Interconnect device and other components in the fabric:

  • Issue the request system software nonstop-upgrade fabric package-name command.

    For example:

    user@qfabric> request system software nonstop-upgrade fabric jinstall-qfabric-12.2X50-D10.3.rpm

(Optional) Creating Upgrade Groups for Node Groups

Upgrade groups enable two or more Node devices in a Node group, or an entire Node group, to be rebooted at the same time. If you do not create an upgrade group, the Node devices are upgraded one at a time. Before performing a nonstop upgrade on a Node group, create an upgrade group and include the devices you want to reboot at the same time.

Note

If you add Node devices that have links to the same link aggregation group (LAG), there might be traffic loss.

  • Create the upgrade group by issuing the set chassis node-group node-group-name nssu upgrade-group upgrade-group-name node-devices command at the [edit chassis] hierarchy.

    For example:

    user@qfabric# set chassis node-group nodegroup1 nssu upgrade-group upgrade1 node-devices [ node1 node2 ]

Performing a Nonstop Software Upgrade on a Node Group

When you perform a nonstop software upgrade on a network Node group, the Node devices in the network Node group are upgraded in a serial fashion except when upgrade groups are configured. If you perform a nonstop upgrade on a redundant server Node group, both Node devices must be online for a successful upgrade. If one of the Node devices is no longer available, remove it from the configuration before you perform the nonstop software upgrade. If you perform a nonstop upgrade on a Node group with only one Node device, traffic loss occurs while the Node device is rebooting.

Note

You can upgrade multiple Node groups with this command. However, if more than one Node group is specified, there may be traffic loss depending on the topology of the network.

To install software on a Node group:

  • Issue the request system software nonstop-upgrade node-group node-group-name package-name command.

    To perform a nonstop upgrade on one Node group:

    user@qfabric> request system software nonstop-upgrade node-group nodegroup1 jinstall-qfabric-12.2X50-D10.3.rpm

    To perform a nonstop upgrade on more than one Node group:

    user@qfabric> request system software nonstop-upgrade node-group [nodegroup1 nodegroup2 nodegroup3] jinstall-qfabric-12.2X50-D10.3.rpm