Migration, Upgrade, and Downgrade Instructions
This section contains the procedure to upgrade Junos OS, and the upgrade and downgrade policies for Junos OS for Junos fusion for provider edge. Upgrading or downgrading Junos OS might take several hours, depending on the size and configuration of the network.
Basic Procedure for Upgrading an Aggregation Device
When upgrading or downgrading Junos OS, always use the jinstall
package.
Use other packages (such as the jbundle
package) only when so instructed by
a Juniper Networks support representative. For information about the contents of the
jinstall
package and details of the installation process, see the Installation and Upgrade Guide.
Before upgrading, back up the file system and the currently active Junos OS configuration so that you can recover to a known, stable environment in case the upgrade is unsuccessful. Issue the following command:
user@host> request system snapshot
The installation process rebuilds the file system and completely reinstalls Junos OS.
Configuration information from the previous software installation is retained, but the
contents of log files might be erased. Stored files on the routing platform, such as
configuration templates and shell scripts (the only exceptions are the
juniper.conf
and ssh
files), might be removed. To
preserve the stored files, copy them to another system before upgrading or downgrading the
routing platform. See the Installation and Upgrade
Guide.
The download and installation process for Junos OS Release 21.1R1 is different from that for earlier Junos OS releases.
-
Using a Web browser, navigate to the Download Software URL on the Juniper Networks webpage:
-
Log in to the Juniper Networks authentication system by using the username (generally your e-mail address) and password supplied by Juniper Networks representatives.
-
Select By Technology > Junos Platform > Junos fusion to find the software that you want to download.
-
Select the release number (the number of the software version that you want to download) from the Version drop-down list to the right of the page.
-
Select the Software tab.
-
Select the software package for the release.
-
Review and accept the End User License Agreement.
-
Download the software to a local host.
-
Copy the software to the routing platform or to your internal software distribution site.
-
Install the new
jinstall
package on the aggregation device.Note:We recommend that you upgrade all software packages out-of-band using the console, because in-band connections are lost during the upgrade process.
Customers in the United States and Canada, use the following commands.
-
For 64-bit software:
Note:We recommend that you use 64-bit Junos OS software when implementing Junos fusion for provider edge.
user@host> request system software add validate reboot source/jinstall64-21.1R1.SPIN-domestic-signed.tgz
-
For 32-bit software:
user@host> request system software add validate reboot source/jinstall-21.1R1.SPIN-domestic-signed.tgz
All other customers, use the following commands.
-
For 64-bit software:
Note:We recommend that you use 64-bit Junos OS software when implementing Junos fusion for provider edge.
user@host> request system software add validate reboot source/jinstall64-21.1R1.SPIN-export-signed.tgz
-
For 32-bit software:
user@host> request system software add validate reboot source/jinstall-21.1R1.SPIN-export-signed.tgz
Replace
source
with one of the following values:-
/pathname—For a software package that is installed from a local directory on the router.
-
For software packages that are downloaded and installed from a remote location:
-
ftp://hostname/pathname
-
http://hostname/pathname
-
scp://hostname/pathname (available only for the Canada and U.S. version)
-
The
validate
option validates the software package against the current configuration as a prerequisite for adding the software package to ensure that the router reboots successfully. This is the default behavior when the software package being added is for a different release.Adding the
reboot
command reboots the router after the upgrade is validated and installed. When the reboot is complete, the router displays the login prompt. The loading process might take 5 to 10 minutes.Rebooting occurs only if the upgrade is successful.
-
After you install a Junos OS Release 21.1R1 jinstall
package, you cannot
return to the previously installed software by issuing the request system software
rollback
command. Instead, you must issue the request system software
add validate
command and specify the jinstall
package that
corresponds to the previously installed software.
Upgrading an Aggregation Device with Redundant Routing Engines
If the aggregation device has two Routing Engines, perform a Junos OS installation on each Routing Engine separately as follows to minimize disrupting network operations:
-
Disable graceful Routing Engine switchover (GRES) on the master Routing Engine and save the configuration change to both Routing Engines.
-
Install the new Junos OS release on the backup Routing Engine while keeping the currently running software version on the master Routing Engine.
-
After making sure that the new software version is running correctly on the backup Routing Engine, switch over to the backup Routing Engine to activate the new software.
-
Install the new software on the original master Routing Engine that is now active as the backup Routing Engine.
For the detailed procedure, see the Installation and Upgrade Guide.
Preparing the Switch for Satellite Device Conversion
Satellite devices in a Junos fusion topology use a satellite software package that is different from the standard Junos OS software package. Before you can install the satellite software package on a satellite device, you first need to upgrade the target satellite device to an interim Junos OS software version that can be converted to satellite software. For satellite device hardware and software requirements, see Understanding Junos fusion Software and Hardware Requirements
The following conditions must be met before a standalone switch that is running Junos OS Release 14.1X53-D43 can be converted to a satellite device when the action is initiated from the aggregation device:
-
The switch can be converted to only SNOS 3.1 and later.
-
Either the switch must be set to factory-default configuration by using the
request system zeroize
command, or the following command must be included in the configuration:set chassis auto-satellite-conversion
.
Customers with EX4300 switches, use the following command:
user@host> request system software add validate reboot source/jinstall-ex-4300-14.1X53-D43.3-domestic-signed.tgz
Customers with QFX5100 switches, use the following command:
user@host> request system software add reboot source/jinstall-qfx-5-14.1X53-D43.3-domestic-signed.tgz
When the interim installation has completed and the switch is running a version of Junos and OS on one line that is compatible with satellite device conversion, perform the following steps:
-
Log in to the device by using the console port.
-
Clear the device:
[edit] user@satellite-device# request system zeroize
Note:The device reboots to complete the procedure for resetting the device.
If you are not logged in to the device by using the console port connection, your connection to the device is lost after you enter the request system zeroize command.
If you lose your connection to the device, log in using the console port.
-
(EX4300 switches only) After the reboot is complete, convert the built-in 40-Gbps QSFP+ interfaces from Virtual Chassis ports (VCPs) into network ports:
user@satellite-device> request virtual-chassis vc-port delete pic-slot 1 port port-number
For example, to convert all four built-in 40-Gbps QSFP+ interfaces on an EX4300-24P switch into network ports:
user@satellite-device> request virtual-chassis vc-port delete pic-slot 1 port 0 user@satellite-device> request virtual-chassis vc-port delete pic-slot 1 port 1 user@satellite-device> request virtual-chassis vc-port delete pic-slot 1 port 2 user@satellite-device> request virtual-chassis vc-port delete pic-slot 1 port 3
This step is required for the 40-Gbps QSFP+ interfaces that will be used as uplink interfaces in a Junos fusion topology. Built-in 40-Gbps QSFP+ interfaces on EX4300 switches are configured into VCPs by default, and the default settings are restored after the device is reset.
After this initial preparation, you can use one of three methods to convert your switches into satellite devices—autoconversion, manual conversion, and preconfiguration. See Configuring Junos fusion for provider edge for detailed configuration steps for each method.
Converting a Satellite Device to a Standalone Device
If you need to convert a satellite device to a standalone device, you must install a new Junos OS software package on the satellite device and remove the satellite device from the Junos fusion topology.
If the satellite device is a QFX5100 switch, you need to install a PXE version of Junos OS. The PXE version of Junos OS is software that includes pxe in the Junos OS package name when it is downloaded from the Software Center—for example, the PXE image for Junos OS Release 14.1X53-D43 is named install-media-pxe-qfx-5-14.1X53-D43.3-signed.tgz . If the satellite device is an EX4300 switch, you install a standard jinstall-ex-4300 version of Junos OS.
The following steps explain how to download software, remove the satellite device from Junos fusion, and install the Junos OS software image on the satellite device so that the device can operate as a standalone device.
-
Using a Web browser, navigate to the Junos OS software download URL on the Juniper Networks webpage:
-
Log in to the Juniper Networks authentication system by using the username (generally your e-mail address) and password supplied by Juniper Networks representatives.
-
Select By Technology > Junos Platform > Junos fusion from the drop-down list and select the switch platform series and model for your satellite device.
-
Select the Junos OS Release 14.1X53-D30 software image for your platform.
-
Review and accept the End User License Agreement.
-
Download the software to a local host.
-
Copy the software to the routing platform or to your internal software distribution site.
-
Remove the satellite device from the automatic satellite conversion configuration.
If automatic satellite conversion is enabled for the satellite device’s member number, remove the member number from the automatic satellite conversion configuration. The satellite device’s member number is the same as the FPC slot ID.
[edit] user@aggregation-device# delete chassis satellite-management auto-satellite-conversion satellite member-number
For example, to remove member number 101 from Junos fusion:
[edit] user@aggregation-device# delete chassis satellite-management auto-satellite-conversion satellite 101
You can check the automatic satellite conversion configuration by entering the
show
command at the[edit chassis satellite-management auto-satellite-conversion]
hierarchy level. -
Commit the configuration.
To commit the configuration to both Routing Engines:
[edit] user@aggregation-device# commit synchronize
Otherwise, commit the configuration to a single Routing Engine:
[edit] user@aggregation-device# commit
-
Install the Junos OS software on the satellite device to convert the device to a standalone device.
[edit] user@aggregation-device> request chassis satellite install URL-to-software-package fpc-slot member-number
For example, to install a PXE software package stored in the /var/tmp directory on the aggregation device onto a QFX5100 switch acting as the satellite device using FPC slot 101:
[edit] user@aggregation-device> request chassis satellite install /var/tmp/install-media-pxe-qfx-5-14.1X53-D43.3-signed.tgz fpc-slot 101
For example, to install a software package stored in the var/tmp directory on the aggregation device onto an EX4300 switch acting as the satellite device using FPC slot 101:
[edit] user@aggregation-device> request chassis satellite install /var/tmp/jinstall-ex-4300-14.1X53-D30.3-domestic-signed.tgz fpc-slot 101
The satellite device stops participating in the Junos fusion topology after the software installation starts. The software upgrade starts after this command is entered.
-
Wait for the reboot that accompanies the software installation to complete.
-
When you are prompted to log back into your device, uncable the device from the Junos fusion topology. See Removing a Transceiver from a QFX Series Device or Remove a Transceiver, as needed. Your device has been removed from Junos fusion.
Note:The device uses a factory-default configuration after the Junos OS installation is complete.
Upgrading an Aggregation Device
When you upgrade an aggregation device to Junos OS Release 21.1R1, you must also upgrade your satellite device to Satellite Device Software version 3.1R1.
Upgrade and Downgrade Support Policy for Junos OS Releases
We have two types of releases, EOL and EEOL:
-
End of Life (EOL) releases have engineering support for twenty four months after the first general availability date and customer support for an additional six more months.
Extended End of Life (EEOL) releases have engineering support for thirty six months after the first general availability date and customer support for an additional six more months.
For both EOL and EEOL releases, you can upgrade to the next three subsequent releases or downgrade to the previous three releases. For example, you can upgrade from 20.4 to the next three releases – 21.1, 21.2 and 21.3 or downgrade to the previous three releases – 20.3, 20.2 and 20.1.
For EEOL releases only, you have an additional option - you can upgrade directly from one EEOL release to the next two subsequent EEOL releases, even if the target release is beyond the next three releases. Likewise, you can downgrade directly from one EEOL release to the previous two EEOL releases, even if the target release is beyond the previous three releases. For example, 20.4 is an EEOL release. Hence, you can upgrade from 20.4 to the next two EEOL releases – 21.2 and 21.4 or downgrade to the previous two EEOL releases – 20.2 and 19.4.
Release Type | End of Engineering (EOE) | End of Support (EOS) | Upgrade/Downgrade to subsequent 3 releases | Upgrade/Downgrade to subsequent 2 EEOL releases |
---|---|---|---|---|
End of Life (EOL) | 24 months | End of Engineering + 6 months | Yes | No |
Extended End of Life (EEOL) | 36 months | End of Engineering + 6 months | Yes | Yes |
For more information about EOL and EEOL releases, see https://www.juniper.net/support/eol/junos.html.
For information about software installation and upgrade, see the Installation and Upgrade Guide.
Downgrading from Junos OS Release 22.3
To downgrade from Release 22.3 to another supported release, follow the procedure for
upgrading, but replace the 21.1 jinstall
package with one that corresponds
to the appropriate release.
You cannot downgrade more than three releases.
For more information, see the Installation and Upgrade Guide.