Upgrading a QFX5100 Switch with a USB Device to Join a QFX5110 Virtual Chassis or Virtual Chassis Fabric
Use this procedure to upgrade a standalone QFX5100 switch running “QFX 5 Series” Junos OS software to a “QFX 5e Series” software image so the QFX5100 switch can join a QFX5110 Virtual Chassis or Virtual Chassis Fabric (VCF).
A QFX5110 Virtual Chassis or VCF can have a combination of QFX5110 and QFX5100 switches all running compatible Junos OS “QFX 5e Series” software. This procedure explains how you identify the compatible “QFX 5e Series” install package for QFX5100 switches, create a USB boot device as the installation media, and use the boot device to upgrade the software on a QFX5100 switch to the “QFX 5e Series” image. After installing the new software image, when you reboot the QFX5100, the switch is running a compatible software image and you can successfully add it into a QFX5110 Virtual Chassis or VCF.
With releases prior to Junos OS Release 17.3R2 or 17.4R1, you must use this USB install method due to the differences in the boot structure and host OS software of the two types of devices.
Starting in Junos OS Releases 17.3R2 and 17.4R1, you are not required to use the USB install method to upgrade a QFX5100 switch from a “QFX 5 Series” to a “QFX 5e Series” image. Instead, you can install the “QFX 5e Series” package directly using the CLI command request system software add. See Installing a Standard Software Package on QFX5000 and EX4600 Switches for details on using the CLI install method.
If a QFX5100 switch is already running a “QFX 5e Series” image (software package filename contains the string “-qfx-5e-”), a QFX5110 Virtual Chassis or VCF can automatically update it to the right release when you add it to the Virtual Chassis or VCF. See Understanding Software Upgrades in a Virtual Chassis and Understanding Software Upgrades in a Virtual Chassis Fabric.
Identifying Compatible Software for QFX5100 Switches to Run in a QFX5110 Virtual Chassis or VCF
Standalone QFX5100 switches traditionally run Junos OS “QFX 5 Series” software, and the corresponding install media and installation software package file names include the string “-qfx-5-”. For example:
install-media-qfx-5-17.2R1.13.tgz jinstall-host-qfx-5-17.2R1.13-signed.tgz
QFX5110 switches run Junos OS “QFX 5e Series” software and use a secure-boot method at startup, so the install media and software package filenames for QFX5110 switches include “-qfx-5e-” and “secure”. For example:
install-media-host-usb-qfx-5e-x86-64-17.2R1.13-secure.tgz jinstall-host-qfx-5e-x86-64-17.2R1.13-secure-signed.tgz
QFX5100 switches can also run “5e Series” software, but in releases prior to Junos OS Release 17.3R2 or 17.4R1 they do not use the same secure boot method as QFX5110 switches, so the “QFX 5e Series” install media and software package filenames for QFX5100 switches include “-qfx-5e-” without the “secure” keyword. For example:
install-media-host-usb-qfx-5e-x86-64-17.3R1.6-signed.tgz
To add a QFX5100 switch to a QFX5110 Virtual Chassis or VCF, the QFX5100 must be running the same “QFX 5e Series” software version as the other switches in the Virtual Chassis or VCF. If the QFX5100 switch has a "QFX 5 Series” image, you must first upgrade it manually to a “QFX 5e Series” image using a USB boot device that does not employ the secure-boot method.
To create the USB boot device (see Creating a USB Boot Device for a QFX5100 Switch), use the same install media filename without the “secure” keyword that matches what’s running on the other QFX5110 Virtual Chassis or VCF members. For example:
If the Virtual Chassis or VCF is running the software from this install media package for QFX5110 switches (with the secure-boot method):
install-media-host-usb-qfx-5e-x86-64-17.3R1.6-secure-signed.tgz
Then the matching install media package for QFX5100 switches (without the secure-boot method) is:
install-media-host-usb-qfx-5e-x86-64-17.3R1.6-signed.tgz
After any QFX5100 switches are running a “QFX 5e Series” image, you can just use the same “jinstall-host-qfx-5e-” package file with the “secure” keyword to update the “QFX 5e Series” software running on all members of the Virtual Chassis or VCF, because when it starts up, the secure-boot install software determines whether or not to use the secure-boot method based on the type of switch on which it’s running. The Virtual Chassis or VCF can also successfully update any “QFX 5e Series” member switches as needed in the same way with the automatic software update feature for adding or replacing members, or even during initial Virtual Chassis or VCF configuration.
If you remove a QFX5100 switch from a QFX5110 Virtual Chassis or VCF and want to revert the QFX5100 switch to a “QFX 5 Series” software image to run as a standalone switch, you need to reinstall the image on the switch using a USB boot device with a “qfx-5-” install media file that does not use the secure-boot method.
Creating a USB Boot Device for a QFX5100 Switch
Use the following procedure to create a USB boot device with a Junos OS “QFX 5e Series” install media package (contains “-qfx-5e-” in the package filename) for a QFX5100 switch. You can then use the USB boot device to upgrade a QFX5100 switch to run that image.
You can create the USB boot device on the switch you want to upgrade, on another Juniper Networks switch or router, or on any PC or laptop that supports Linux. The following steps describe creating the boot device from a Junos OS device, and might differ based on the device you use to create the boot device.
Before you begin, download the installation media file from https://www.juniper.net/customers/support/ to the device where you are creating the boot device. The install media filename should include the string “-qfx-5e-” for the same Junos OS release as the QFX5110 Virtual Chassis or VCF, but without a “secure” keyword in the filename, because you must initially upgrade QFX5100 switches without using the same secure-boot method employed by QFX5110 switches. (See Identifying Compatible Software for QFX5100 Switches to Run in a QFX5110 Virtual Chassis or VCF for details.)
The Junos OS software running on the QFX5110 members must be the “QFX 5e Series” image that uses the secure-boot method, so the install media and package filenames used on QFX5110 switches include the “secure” keyword. After initial USB installation of a “QFX 5e Series” software image on a QFX5100 switch, the same software image that supports secure boot runs on either switch model, and determines the appropriate boot method to use based on the switch on which it is running. As a result, for future updates, you can directly install the same image with the “secure” keyword on both QFX5110 and QFX5100 switches in your Virtual Chassis or VCF.
On a Junos OS device where you are creating the USB boot device:
You can now use the USB storage device to install the “QFX 5e Series” Junos OS software image on a QFX5100 switch.
Upgrading a QFX5100 Switch from Junos OS “QFX 5 Series” to “QFX 5e Series” Software Using a USB Boot Device
You must upgrade a standalone QFX5100 switch running “QFX 5 Series” software to “QFX 5e Series” software before the switch can join a QFX5110 Virtual Chassis or VCF. For this upgrade, you need to boot and install the software using a USB boot device.
Before you begin, have a USB boot device ready with the required Junos OS software install package as described in Creating a USB Boot Device for a QFX5100 Switch. The upgrade process overwrites the contents of the internal flash storage on the QFX5100 switch, so if desired, before proceeding with the upgrade, save existing configuration, backup configurations, and other stored files to a remote system, server, or other storage device. Then:
Change History Table
Feature support is determined by the platform and release you are using. Use Feature Explorer to determine if a feature is supported on your platform.