Supported Platforms
Related Documentation
- QFabric System
- Nonstop Software Upgrade Checklist for QFabric Systems
- QFabric System, QFX Series standalone switches
- Configuring Graceful Restart for QFabric Systems
- Understanding Nonstop Software Upgrade for QFabric Systems
- Verifying Nonstop Software Upgrade for QFabric Systems
- request system software nonstop-upgrade
Performing a Nonstop Software Upgrade on the QFabric System
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:
![]() | Note: Before you perform a nonstop software upgrade, contact JTAC to perform a pre-upgrade health check on the QFabric system. |
- 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
- Downloading Software Files Using a Browser
- Retrieving Software Files for Download
- Performing a Nonstop Software Upgrade for Director Devices in a Director Group
- Performing a Nonstop Software Upgrade for Interconnect Devices and Other Fabric-Related Components
- (Optional) Creating Upgrade Groups for Node Groups
- Performing a Nonstop Software Upgrade on a Node Group
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 |
To download the software package:
- In a browser, go to https://www.juniper.net/support/downloads/junos.html .
The Junos Platforms Download Software page appears.
- In the QFX Series section, select the Qfabric system for
which you want to download software.
The Software Download page for the selected QFabric system appears.
- 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.
- Select the Software tab and then select the install
package you want to download in the Install Package section.
A login screen appears.
- Select the Software tab and then select the complete
install package you want to download in the QFabric System Install
Package and Media section.
A login screen appears.
- Enter your user ID and password and press Enter.
- Read the End User License Agreement, select the I agree option button, and then click Proceed.
- 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
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
Related Documentation
- QFabric System
- Nonstop Software Upgrade Checklist for QFabric Systems
- QFabric System, QFX Series standalone switches
- Configuring Graceful Restart for QFabric Systems
- Understanding Nonstop Software Upgrade for QFabric Systems
- Verifying Nonstop Software Upgrade for QFabric Systems
- request system software nonstop-upgrade
Modified: 2015-11-11
Supported Platforms
Related Documentation
- QFabric System
- Nonstop Software Upgrade Checklist for QFabric Systems
- QFabric System, QFX Series standalone switches
- Configuring Graceful Restart for QFabric Systems
- Understanding Nonstop Software Upgrade for QFabric Systems
- Verifying Nonstop Software Upgrade for QFabric Systems
- request system software nonstop-upgrade