Upgrade and Downgrade Instructions for JUNOS Software Release 9.3 for M-series, MX-series, and T-series Routing Platforms

This section discusses the following topics:

Basic Procedure for Upgrading to Release 9.3

When upgrading or downgrading the JUNOS software, 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 JUNOS Software Installation and Upgrade Guide.

Note: You cannot upgrade by more than three releases at a time. For example, if your routing platform is running JUNOS Release 8.5, you can upgrade to JUNOS Release 9.2, but not to JUNOS Release 9.3. As a workaround, first upgrade to JUNOS Release 9.2 and then upgrade to JUNOS Release 9.3.

Note: If both PIM and NSR are enabled on the router, you might need to perform additional steps during the upgrade to JUNOS Release 9.3. For more information, see Upgrading to Release 9.3 on a Router Enabled for Both PIM and NSR.

Note: For JUNOS Release 9.0 and later, the compact flash disk memory requirement for JUNOS software is 1 GB. For M7i and M10i routing platforms with only 256 MB memory, see the Customer Support Center JTAC Technical Bulletin PSN-2007-10-001 at https://www.juniper.net/alerts/viewalert.jsp?txtAlertNumber=PSN-2007-10-001&actionBtn=Search.

Note: Before upgrading, back up the file system and the currently active JUNOS 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 the JUNOS software. 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) may be removed. To preserve the stored files, copy them to another system before upgrading or downgrading the routing platform. For more information, see the JUNOS System Basics Configuration Guide.

The download and installation process for JUNOS Release 9.3R4.4 is the same as for previous JUNOS releases.

If you are not familiar with the download and installation process, follow these steps:

Using a Web browser, follow the links to the download URL on the Juniper Networks Web page. Choose either Canada and U.S. Version or Worldwide Version:
- https://www.juniper.net/support/csc/swdist-domestic/ (customers in the United States and Canada)
- https://www.juniper.net/support/csc/swdist-ww/ (all other customers)
Log in to the Juniper Networks authentication system using the username (generally your e-mail address) and password supplied by Juniper Networks representatives.
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 routing platform.
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 command:
user@host> request system software add validate reboot source/jinstall-9.3R4.4-domestic-signed.tgz
All other customers use the following command:
user@host> request system software add validate reboot source/jinstall-9.3R4.4-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 Canada and U.S. version)
The validate option validates the software package against the current configuration as a prerequisite to adding the software package to ensure that the router reboots successfully. This is the default behavior when the software package being added is 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 can take 5 to 10 minutes.
Rebooting occurs only if the upgrade is successful.

Note: After you install a JUNOS 9.3 jinstall package, you cannot issue the request system software rollback command to return to the previously installed software. Instead you must issue the request system software add validate command and specify the jinstall package that corresponds to the previously installed software.

Upgrade Policy for JUNOS Software Extended End-Of-Life Releases

An expanded upgrade and downgrade path is now available for the JUNOS Software Extended End-of-Life (EEOL) releases. You can upgrade directly from one EEOL release to one of two adjacent later EEOL releases. You can also downgrade directly from one EEOL release to one of two adjacent earlier EEOL releases.

For example, JUNOS Software Releases 8.5, 9.3, 10.0, and 10.4 are all EEOL releases. You can upgrade from JUNOS Software Release 8.5 directly to either 9.3 or 10.0. To upgrade from Release 8.5 to 10.4, you first need to upgrade to JUNOS Software release 9.3 or 10.0, and then upgrade a second time to 10.4. Similarly, you can downgrade directly from JUNOS Software Release 10.4 to either 10.0 or 9.3. To downgrade from release 10.4 to 8.5, you first need to downgrade to 10.0 or 9.3, and then perform a second downgrade to Release 8.5.

For upgrades and downgrades to or from a non-EEOL release, the current policy is that you can upgrade and downgrade by no more than three releases at a time. This policy remains unchanged.

For more information on EEOL releases and to review a list of EEOL releases, see http://www.juniper.net/support/eol/junos.html.

Upgrading to Release 9.3 on a Router Enabled for Both PIM and NSR

JUNOS Release 9.3 introduces NSR support for PIM for IPv4 traffic. However, the following PIM features are not compatible with NSR in this release. The commit operation fails if the configuration includes both NSR and one or more of these features:

Anycast RP
Draft-Rosen multicast VPNs (MVPNs)
Local RP
Next-generation MVPNs with PIM provider tunnels
PIM join load balancing

JUNOS Release 9.3 introduces a new configuration statement that disables NSR for PIM only, so that you can activate incompatible PIM features and continue to use NSR for the other protocols on the router: the nonstop-routing disable statement at the [edit protocols pim] hierarchy level. (Note that this statement disables NSR for all PIM features, not only incompatible features.)

If neither NSR nor PIM is enabled on the router to be upgraded, or only one of NSR or an incompatible PIM feature is enabled, no additional steps are necessary. Use the standard reboot or ISSU procedures described in the other sections of these instructions.

Because the new nonstop-routing disable statement is not available in JUNOS Release 9.2 and earlier, if both NSR and and an incompatible PIM feature are enabled on a router to be upgraded to JUNOS Release 9.3, you must disable either NSR or PIM before the upgrade and reenable it after the router is running JUNOS Release 9.3.

To disable and reenable NSR:

On the router running JUNOS Release 9.2 or earlier, enter configuration mode and disable NSR:
```
[edit]
```
user@host# deactivate routing-options nonstop-routing

user@host# commit
Upgrade to the JUNOS Release 9.3 software using the instructions appropriate for the router type. Note that you cannot use ISSU because it depends on NSR, which is currently disabled.
After the router reboots and is running JUNOS Release 9.3, enter configuration mode, disable PIM NSR, and reenable NSR:
```
[edit]
```
user@host# set protocols pim nonstop-routing disable

user@host# activate routing-options nonstop-routing

user@host# commit

To disable and reenable PIM:

On the router running JUNOS Release 9.2 or earlier, enter configuration mode and disable PIM:
```
[edit]
```
user@host# deactivate protocols pim

user@host# commit
Upgrade to the JUNOS Release 9.3 software using the instructions appropriate for the router type. You can either use the standard procedure with reboot or use ISSU.
After the router reboots and is running JUNOS Release 9.3, enter configuration mode, disable PIM NSR, and reenable PIM:
```
[edit]
```
user@host# set protocols pim nonstop-routing disable

user@host# activate protocols pim

user@host# commit

Upgrading a Router with Redundant Routing Engines

If the router has two Routing Engines, perform a JUNOS software installation on each Routing Engine separately to avoid disrupting network operation as follows:

Disable graceful Routing Engine switchover (GRES) on the master Routing Engine and save the configuration change to both Routing Engines.
Install the new JUNOS software 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 JUNOS Software Installation and Upgrade Guide.

Upgrading to Release 9.3 in a Routing Matrix

By default, when you upgrade software on the TX Matrix platform, the new image is loaded onto the TX Matrix platform and distributed to all routing nodes in the routing matrix. To upgrade software for the entire routing matrix, issue the request system software add command. Customers in the United States and Canada use the following command:

user@host> request system software add source/jinstall-9.3R4.4-domestic-signed.tgz

All other customers use the following command:

user@host> request system software add source/jinstall-9.3R4.4-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 TX Matrix platform.
For software packages that are downloaded and installed from a remote location:
- ftp://hostname/pathname
- http://hostname/pathname
- scp://hostname/pathname (available only for Canada and U.S. version)

When you complete the software installation and reboot the TX Matrix platform, all routing nodes also reboot and all hardware and software components in the routing matrix begin using the new software.

To upgrade the backup Routing Engines, log in to the backup Routing Engine on the TX Matrix platform before you issue the request system software add command. You can also update the software on the TX Matrix platform only or on a specific T640 routing node as needed by including the lcc or scc option.

Note: We recommend you run the same JUNOS software release on the master and backup Routing Engines on all components of a routing matrix. If you elect to run different JUNOS software releases on the Routing Engines, a change in Routing Engine mastership can cause one or all routing nodes to be logically disconnected from the TX Matrix platform. It is also a best practice to make sure that all master Routing Engines are re0 and all backup Routing Engines are re1 (or vice versa).

Note: You must use the same Routing Engine model on all routing platforms in a routing matrix. For example, it is not supported to use model RE-A-2000 on the TX Matrix platform and model RE-1600 on the routing nodes.

Upgrading Using ISSU

Unified in-service software upgrade (ISSU) enables you to upgrade between two different JUNOS software releases with no disruption on the control plane and with minimal disruption of traffic. Unified in-service software upgrade is only supported by dual Routing Engine platforms. In addition, graceful Routing Engine switchover (GRES) and nonstop active routing (NSR) must be enabled. For additional information about using unified in-service software upgrade, see the JUNOS High Availability Configuration Guide.

Downgrade from Release 9.3

To downgrade from Release 9.3 to another supported release, follow the procedure for upgrading, but replace the 9.3 jinstall package with one that corresponds to the appropriate release.

Note: You cannot downgrade more than three releases. For example, if your routing platform is running JUNOS Release 9.3, you can downgrade the software to Release 9.0 directly, but not to Release 8.5 or earlier; as a workaround, you can first downgrade to Release 9.0 and then downgrade to Release 8.5.

For more information, see the JUNOS Software Installation and Upgrade Guide.