Rate and give feedback:  Feedback Received. Thank You!

Rate and give feedback: 

X

This document helped resolve my issue

Yes No

Additional Comments

800 characters remaining

May we contact you if necessary?

Name:  

E-mail: 

Enter a valid Email ID

Need product assistance? Contact Juniper Support

Submit

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply.

English  

English

Installing the Software Package on a Router with Redundant Routing Engines

If the router has two Routing Engines, perform a Junos OS installation on each Routing Engine separately to avoid disrupting network operation.

Warning: If graceful Routing Engine switchover (GRES), or nonstop active routing (NSR) is enabled when you initiate a software installation, the software does not install properly. Make sure you issue the CLI delete chassis redundancy command when prompted. If GRES is enabled, it will be removed with the redundancy command. By default, NSR is disabled. If NSR is enabled, remove the nonstop-routing statement from the [edit routing-options] hierarchy level to disable it.

To upgrade the router software, perform the following tasks:

1. Preparing the Router for the Installation
2. Installing Software on the Backup Routing Engine
3. Installing Software on the Master Routing Engine
4. Finalizing the Installation

Preparing the Router for the Installation

Perform the following steps before installing the software:

1. Log in to the master Routing Engine’s console.

   For more information about logging in to the Routing Engine through the console port, see the specific hardware guide for your router.

2. From the router command line, enter configuration mode:

   1. user@host#> configure
      Entering configuration mode
        
      [edit]
      user@host#

3. Disable Routing Engine redundancy:

   [edit]
   user@host# delete chassis redundancy
   

4. Save the configuration change on both Routing Engines:

   [edit]
   user@host# commit synchronize

5. Exit out of the CLI configuration mode:

   [edit]
   user@host# exit

Installing Software on the Backup Routing Engine

After the router has been prepared, you first install the new Junos OS release on the backup Routing Engine while keeping the currently running software version on the master Routing Engine. This enables the master Routing Engine to continue operations, minimizing disruption to your network.

1. Log in to the console port on the other Routing Engine (currently the master).

   For more information about logging in to the Routing Engine through the console port, see the specific hardware guide for your router.

2. Install the new software package using the request system software add command:

   user@host> request system software add validate /var/tmp/jinstall-9.2R1.8–domestic-signed.tgz

   For M Series, MX Series, and T Series routers and Branch SRX Series firewall filters running Junos OS Release 12.2 and above, you can use the request system software add set command to install multiple software packages at the same time:

   user@host> request system software add set /var/tmp/installation-package

   installation-package can either be a list of installation packages, each separated by a blank space, or the full URL to the directory or tar file containing the list of installation packages.

   Use the request system software add set command to retain any SDK configuration by installing the SDK add-on packages along with the core Junos OS installation package.

   Warning: Do not include the re0 | re1 option when you install a package using the request system software add command, if the Routing Engine on which the package is located and the Routing Engine on which you want to install the package are the same. In such cases, the package gets deleted after a successful upgrade.

   For more information about the request system software add command, see the Junos OS System Basics and Services Command Reference .

3. Reboot the router to start the new software using the request system reboot command:

   user@host> request system reboot
   Reboot the system? [yes, no] (no) yes

   Note: You must reboot the device to load the new installation of Junos OS on the router. To abort the installation, do not reboot your device. Instead, finish the installation and then issue the request system software delete jinstall command. This is your last chance to stop the installation.

   All the software is loaded when you reboot the device. Installation can take between 5 and 10 minutes. The router then reboots from the boot device on which the software was just installed. When the reboot is complete, the router displays the login prompt.

   While the software is being upgraded, the Routing Engine on which you are performing the installation is not routing traffic.

4. Log in and issue the show version command to verify the version of the software installed.
5. (Optional) Add the jweb package using the request system software add command. Before you can add this package, you must first download the software as you did the installation package. For more information about downloading the jweb package, see Downloading Software.

   The jweb installation module adds a router management graphical user interface that you can use to view and configure your router. For more information about the jweb package, see Installation Modules.

Installing Software on the Master Routing Engine

1. Log in to the master Routing Engine console port.

   For more information about logging in to the Routing Engine through the console port, see the specific hardware guide for your router.

2. Transfer routing control to the backup Routing Engine:

   user@host> request chassis routing-engine master switch

   For more information about the request chassis routing-engine master command, see the Junos OS System Basics and Services Command Reference .
3. Verify that the backup Routing Engine (slot 1) is the master Routing Engine:

   user@host> show chassis routing-engine
   
   Routing Engine status:
     Slot 0:
       Current state                  Backup
       Election priority              Master (default)
   
   Routing Engine status:
     Slot 1:
       Current state                  Master
       Election priority              Backup (default)

4. Install the new software package using the request system software add command:

   user@host> request system software add validate /var/tmp/jinstall-9.2R1.8–domestic-signed.tgz

   For M Series, MX Series, and T Series routers and Branch SRX Series firewall filters running Junos OS Release 12.2 and above, you can use the request system software add set command to install multiple software packages at the same time:

   user@host> request system software add set /var/tmp/installation-package

   installation-package can either be a list of installation packages, each separated by a blank space, or the full URL to the directory or tar file containing the list of installation packages.

   Use the request system software add set command to retain any SDK configuration by installing the SDK add-on packages along with the core Junos OS installation package.

   Warning: Do not include the re0 | re1 option when you install a package using the request system software add command, if the Routing Engine on which the package is located and the Routing Engine on which you want to install the package are the same. In such cases, the package gets deleted after a successful upgrade.

   For more information about the request system software add command, see the Junos OS System Basics and Services Command Reference .

5. Reboot the Routing Engine using the request system reboot command:

   user@host> request system reboot
   Reboot the system? [yes, no] (no) yes

   Note: You must reboot to load the new installation of Junos OS on the router. To abort the installation, do not reboot your system. Instead, finish the installation and then issue the request system software delete jinstall command. This is your last chance to stop the installation.

   The software is loaded when you reboot the system. Installation can take between 5 and 10 minutes. The router then reboots from the boot device on which the software was just installed. When the reboot is complete, the router displays the login prompt.

   While the software is being upgraded, the Routing Engine on which you are performing the installation does not route traffic.

6. Log in and issue the show version command to verify the version of the software installed.
7. (Optional) Add the jweb package using the request system software add command. Before you can add this package, you must first download the software as you did the installation package. For more information about downloading the jweb package, see Downloading Software.

   The jweb installation module adds a router management graphical user interface that you can use to view and configure your router. For more information about the jweb package, see Installation Modules.

8. Transfer routing control back to the master Routing Engine:

   user@host> request chassis routing-engine master switch

   For more information about the request chassis routing-engine master command, see the Junos OS System Basics and Services Command Reference .
9. Verify the master Routing Engine (slot 0) is indeed the master Routing Engine:

   user@host> show chassis routing-engine
   
   Routing Engine status:
     Slot 0:
       Current state                  Master
       Election priority              Master (default)
   
   outing Engine status:
     Slot 1:
       Current state                  Backup
       Election priority              Backup (default)

Finalizing the Installation

Once the software is installed on both Routing Engines, you return the router back to its original configuration and back up the new installation.

1. Restore the configuration that existed before you deleted it at the start of this procedure:
   {backup}user@host-re0> configure [edit]user@host-re0# rollback 1
2. Save the configuration change on both Routing Engines:
   [edit]user@host-re0> commit synchronize and-quit
3. After you have installed the new software and are satisfied that it is successfully running, issue the request system snapshot command to back up the new software on both master and backup Routing Engines:
   {master}user@host-re0> request system snapshot {master}user@host-re0> request routing-engine login other routing-engine{backup}user@host-re1> request system snapshot{backup}

   The root file system is backed up to /altroot, and /config is backed up to /altconfig. The root and /config file systems are on the router’s CompactFlash card, and the /altroot and /altconfig file systems are on the router’s hard disk or solid-state drive (SSD).

   For more information about the request routing-engine login command, see the Junos OS System Basics and Services Command Reference .

   Note: After you issue the request system snapshot command, you cannot return to the previous version of the software because the running copy and backup copy of the software are identical.