Technical Documentation

Upgrading Software on an EX8200 Standalone Switch Using Nonstop Software Upgrade (CLI Procedure)

You can use nonstop software upgrade (NSSU) to upgrade the software on standalone EX8200 switches with redundant Routing Engines. NSSU upgrades the software running on the Routing Engines and line cards with minimal traffic disruption during the upgrade. NSSU is supported on switches running Junos OS Release 10.4 or later.

With NSSU, you can upgrade both Routing Engines at the same time with a single command. You also have the option of upgrading just one Routing Engine, the backup Routing Engine, which becomes the master Routing Engine after the upgrade is done. You then use the standard software installation process to upgrade the original master Routing Engine.

This topic covers:

Preparing the Switch for Software Installation

Before you begin software installation using NSSU:

(Optional) Configure line-card upgrade groups as described in Configuring Line-Card Upgrade Groups for Nonstop Software Upgrade (CLI Procedure). By default, an NSSU upgrades line cards one at a time to allow aggregated Ethernet links that have members on different line cards to remain up through the upgrade process. Configuring line-card upgrade groups reduces the time an upgrade takes because the line cards in each upgrade group are upgraded at the same time rather than sequentially.

Verify that the Routing Engines are running the same version of the software. Enter the following command:

{master}
user@switch> show version invoke-on all-routing-engines
re0:
--------------------------------------------------------------------------
Hostname: switch
Model: ex8208
JUNOS Base OS boot [11.3-20110429.1]
JUNOS Base OS Software Suite [11.3-20110429.1]
JUNOS Kernel Software Suite [11.3-20110429.1]
JUNOS Crypto Software Suite [11.3-20110429.1]
JUNOS Online Documentation [11.3-20110429.1]
JUNOS Enterprise Software Suite [11.3-20110429.1]
LC JUNOS Installation Software [11.3-20110429.1]
JUNOS Routing Software Suite [11.3-20110429.1]
JUNOS Web Management [11.3-20110429.1]

re1:
--------------------------------------------------------------------------
Hostname: switch
Model: ex8208
JUNOS Base OS boot [11.3-20110429.1]
JUNOS Base OS Software Suite [11.3-20110429.1]
JUNOS Kernel Software Suite [11.3-20110429.1]
JUNOS Crypto Software Suite [11.3-20110429.1]
JUNOS Online Documentation [11.3-20110429.1]
JUNOS Enterprise Software Suite [11.3-20110429.1]
LC JUNOS Installation Software [11.3-20110429.1]
JUNOS Routing Software Suite [11.3-20110429.1]
JUNOS Web Management [11.3-20110429.1]

If the Routing Engines are not running the same version of the software, use the request system software add command to upgrade the Routing Engine that is running the earlier software version. For instructions on upgrading a single Routing Engine, see Installing Software on an EX Series Switch with Redundant Routing Engines (CLI Procedure).

Ensure that nonstop active routing (NSR) and graceful Routing Engine switchover (GRES) are enabled. To verify that they are enabled, you need to check only the state of nonstop active routing—if nonstop active routing is enabled, then graceful Routing Engine switchover is enabled.
To verify that nonstop active routing is enabled, execute the following command:
```
{master}
user@switch> show task replication
        Stateful Replication: Enabled
        RE mode: Master

    Protocol                Synchronization Status
    OSPF                    Complete
    RIP                     Complete
    PIM                     Complete
    RSVP                    Complete
```
If nonstop active routing is not enabled (Stateful Replication is Disabled), see Configuring Nonstop Active Routing on EX Series Switches (CLI Procedure) for information on how to enable it.
(Optional) Back up the system software on each Routing Engine to an external storage device with the request system snapshot command.

Upgrading Both Routing Engines Using NSSU

This procedure describes how to upgrade both Routing Engines using NSSU. When the upgrade completes, both Routing Engines are running the new version of the software, and the backup Routing Engine is the new master Routing Engine.

To upgrade both Routing Engines using NSSU:

Download the software package by following the procedure in Downloading Software Packages from Juniper Networks.
Copy the software package to the switch. We recommend that you use FTP to copy the file to the /var/tmp directory.
Log in to the master Routing Engine using the console connection. You can perform an NSSU from the management interface, but a console connection allows you to monitor the progress of the master Routing Engine reboot.

Install the new software package:

{master}
user@switch> request system software nonstop-upgrade reboot
 /var/tmp/package-name-m.nZx-distribution.tgz

where package-name-m.nZx-distribution.tgz is, for example, jinstall-ex-8200-10.4R1.5-domestic-signed.tgz.

The switch displays the following status messages as the upgrade executes:

Chassis ISSU Check Done
ISSU: Validating Image
ISSU: Preparing Backup RE
Pushing bundle to re1
WARNING: A reboot is required to install the software
WARNING:     Use the 'request system reboot' command immediately
Backup upgrade done
Rebooting Backup RE

Rebooting re1
ISSU: Backup RE Prepare Done
Waiting for Backup RE reboot
GRES operational
Initiating Chassis In-Service-Upgrade
Chassis ISSU Started
ISSU: Preparing Daemons
ISSU: Daemons Ready for ISSU
ISSU: Starting Upgrade for FRUs
ISSU: Preparing for Switchover
ISSU: Ready for Switchover
Checking In-Service-Upgrade status
  Item           Status                  Reason
  FPC 0          Online (ISSU)               
  FPC 1          Online (ISSU)               
  FPC 2          Online (ISSU)                 
  FPC 3          Offline                 Offlined by CLI command
  FPC 4          Online (ISSU)                 
  FPC 5          Online (ISSU)               
  FPC 6          Online (ISSU)               
  FPC 7          Online (ISSU)               
Resolving mastership...
Complete. The other routing engine becomes the master.
ISSU: RE switchover Done
ISSU: Upgrading Old Master RE
WARNING: A reboot is required to install the software
WARNING:     Use the 'request system reboot' command immediately
ISSU: Old Master Upgrade Done
ISSU: IDLE

 
*** FINAL System shutdown message from user@switch *** 
System going down IMMEDIATELY          

Shutdown NOW!
[pid 2635]

Note: If you omit the reboot option in this step, you must manually reboot the original master Routing Engine with the request system reboot command for the upgrade to complete.

{backup}
user@switch> show version invoke-on all-routing-engines
re0:
------------------------------------------------------------------
Hostname: switch
Model: ex8208
JUNOS Base OS boot [12.1-20111229.0]
JUNOS Base OS Software Suite [12.1-20111229.0]
JUNOS Kernel Software Suite [12.1-20111229.0]
JUNOS Crypto Software Suite [12.1-20111229.0]
JUNOS Online Documentation [12.1-20111229.0]
JUNOS Enterprise Software Suite [12.1-20111229.0]
LC JUNOS Installation Software [12.1-20111229.0]
JUNOS Routing Software Suite [12.1-20111229.0]
JUNOS Web Management [12.1-20111229.0]

re1:
------------------------------------------------------------------
Hostname: switch
Model: ex8208
JUNOS Base OS boot [12.1-20111229.0]
JUNOS Base OS Software Suite [12.1-20111229.0]
JUNOS Kernel Software Suite [12.1-20111229.0]
JUNOS Crypto Software Suite [12.1-20111229.0]
JUNOS Online Documentation [12.1-20111229.0]
JUNOS Enterprise Software Suite [12.1-20111229.0]
LC JUNOS Installation Software [12.1-20111229.0]
JUNOS Routing Software Suite [12.1-20111229.0]
JUNOS Web Management [12.1-20111229.0]

To verify that the line cards that were online before the upgrade are online after the upgrade, log in to the master Routing Engine and enter the show chassis nonstop-upgrade command:

{backup}
user@switch> request routing-engine login master

{master}
user@switch> show chassis nonstop-upgrade
  Item           Status                  Reason
  FPC 0          Online (ISSU)              
  FPC 1          Online (ISSU)               
  FPC 2          Online (ISSU)                  
  FPC 3          Offline                 Offlined by CLI command 
  FPC 4          Online (ISSU)                 
  FPC 5          Online (ISSU)               
  FPC 6          Online (ISSU)               
  FPC 7          Online (ISSU)

If you want to make re0 the master Routing Engine again, enter the following command:
```
{master}
user@switch> request chassis routing-engine master switch
Toggle mastership between routing engines ? [yes,no] (no) yes
```
You can verify that re0 is the master Routing Engine by executing the show chassis routing-engine command.
To ensure that the resilient dual-root partitions feature operates correctly, execute the following command to copy the new Junos OS image into the alternate root partition on each Routing Engine:
user@switch> request system snapshot slice alternate routing-engine both
Resilient dual-root partitions allow the switch to boot transparently from the alternate root partition if the system fails to boot from the primary root partition.

Upgrading One Routing Engine Using NSSU

This procedure describes how to upgrade one of the Routing Engines using NSSU. When the upgrade completes, the backup Routing Engine is running the new software version and is the new master. The original master Routing Engine, now the backup Routing Engine, continues to run the previous software version.

To upgrade one Routing Engine using NSSU:

Download the software package by following the procedure in Downloading Software Packages from Juniper Networks.
Copy the software package to the switch. We recommend that you use FTP to copy the file to the /var/tmp directory.
Log in to the master Routing Engine.

Request an NSSU and specify the no-old-master-upgrade option:

{master}
user@switch> request system software nonstop-upgrade 
no-old-master-upgrade /var/tmp/package-name-m.nZx-distribution.tgz

where package-name-m.nZx-distribution.tgz is, for example, jinstall-ex-8200-10.4R2.5-domestic-signed.tgz.

The switch displays the following status messages as the upgrade executes:

Chassis ISSU Check Done
ISSU: Validating Image
ISSU: Preparing Backup RE
Pushing bundle to re1
WARNING: A reboot is required to install the software
WARNING:     Use the 'request system reboot' command immediately
Backup upgrade done
Rebooting Backup RE

Rebooting re1
ISSU: Backup RE Prepare Done
Waiting for Backup RE reboot
GRES operational
Initiating Chassis In-Service-Upgrade
Chassis ISSU Started
ISSU: Preparing Daemons
ISSU: Daemons Ready for ISSU
ISSU: Starting Upgrade for FRUs
ISSU: Preparing for Switchover
ISSU: Ready for Switchover
Checking In-Service-Upgrade status
  Item           Status                  Reason
  FPC 0          Online (ISSU)              
  FPC 1          Online (ISSU)               
  FPC 2          Online (ISSU)                  
  FPC 3          Offline                 Offlined by CLI command 
  FPC 4          Online (ISSU)                 
  FPC 5          Online (ISSU)               
  FPC 6          Online (ISSU)               
  FPC 7          Online (ISSU)               
Resolving mastership...
Complete. The other routing engine becomes the master.
ISSU: RE switchover Done
Skipping Old Master Upgrade
ISSU: IDLE

When the upgrade is complete, the original master Routing Engine (re0) becomes the backup Routing Engine.

To verify that the original backup Routing Engine (re1) has been upgraded, enter the following command:

{backup}
user@switch> show version invoke-on all-routing-engines
re0:
----------------------------------------------------------------------
Hostname: switch
Model: ex8208
JUNOS Base OS boot [11.3-20110429.1]
JUNOS Base OS Software Suite [11.3-20110429.1]
JUNOS Kernel Software Suite [11.3-20110429.1]
JUNOS Crypto Software Suite [11.3-20110429.1]
JUNOS Online Documentation [11.3-20110429.1]
JUNOS Enterprise Software Suite [11.3-20110429.1]
LC JUNOS Installation Software [11.3-20110429.1]
JUNOS Routing Software Suite [11.3-20110429.1]
JUNOS Web Management [11.3-20110429.1]

re1:
----------------------------------------------------------------------
Hostname: switch
Model: ex8208
JUNOS Base OS boot [12.1-20111229.0]
JUNOS Base OS Software Suite [12.1-20111229.0]
JUNOS Kernel Software Suite [12.1-20111229.0]
JUNOS Crypto Software Suite [12.1-20111229.0]
JUNOS Online Documentation [12.1-20111229.0]
JUNOS Enterprise Software Suite [12.1-20111229.0]
LC JUNOS Installation Software [12.1-20111229.0]
JUNOS Routing Software Suite [12.1-20111229.0]
JUNOS Web Management [12.1-20111229.0]

To verify that the line cards that were online before the upgrade are online after the upgrade, log in to the new master Routing Engine and enter the show chassis nonstop-upgrade command:

{backup}
user@switch> request routing-engine login master

--- JUNOS 12.1-20111229.0 built 2011-12-29 04:12:22 UTC
{master}
user@switch> show chassis nonstop-upgrade
  Item           Status                  Reason
  FPC 0          Online               
  FPC 1          Online                
  FPC 2          Online                   
  FPC 3          Offline                 Offlined by CLI command 
  FPC 4          Online                  
  FPC 5          Online                
  FPC 6          Online                
  FPC 7          Online

To ensure that the resilient dual-root partitions feature operates correctly, copy the new Junos OS image into the alternate root partition of the Routing Engine:
user@switch> request system snapshot slice alternate
Resilient dual-root partitions allow the switch to boot transparently from the alternate root partition if the system fails to boot from the primary root partition.

Upgrading the Original Master Routing Engine

This procedure describes how to upgrade the original master Routing Engine after you have upgraded the original backup Routing Engine as described in Upgrading One Routing Engine Using NSSU.

Enter configuration mode and disable nonstop active routing:

{master}[edit]
user@switch# delete routing-options nonstop-routing

Deactivate graceful Routing Engine switchover and commit the configuration:

{master}[edit]
user@switch# deactivate chassis redundancy graceful-switchover

{master}[edit]
user@switch# commit

Request a software installation:

user@switch> request system software add reboot 
/var/tmp/package-name-m.nZx-distribution.tgz

Note: When you use NSSU to upgrade only one Routing Engine, the installation package is not automatically deleted from /var/tmp, leaving the package available to be used to upgrade the original master Routing Engine.

After the upgrade completes, log in to the current master Routing Engine (re1) and enter CLI configuration mode.

Re-enable nonstop active routing and graceful Routing Engine switchover:

[edit]
user@switch# activate chassis redundancy graceful-switchover

[edit]
user@switch# set routing-options nonstop-routing

[edit]
user@switch# commit

To ensure that the resilient dual-root partitions feature operates correctly, exit the CLI configuration mode and copy the new Junos OS image into the alternate root partition of the Routing Engine:
user@switch> request system snapshot slice alternate
Resilient dual-root partitions allow the switch to boot transparently from the alternate root partition if the system fails to boot from the primary root partition.
(Optional) To return control to the original master Routing Engine (re0), enter the following command:
```
{master}
user@switch> request chassis routing-engine master switch
 Toggle mastership between routing engines ? [yes,no] (no) yes
```
You can verify that re0 is the master Routing Engine by executing the show chassis routing-engine command.

Choose Country

North America

Europe

Asia Pacific