Technical Documentation

Upgrading the Software for a Routing Matrix with a TX Matrix Router

Before you begin upgrading the software on a TX Matrix Router and to avoid unnecessary network disruption during the upgrade, ensure the following conditions are met.

Note: By default, when you upgrade software on the TX Matrix router (scc), the new image is loaded onto the TX Matrix router (scc) and distributed to all T640 routers (lcc) in the routing matrix.

Throughout this document, we use the term TX Matrix router to refer to the switch-card chassis (SCC) and T640 router to refer to the line-card chassis (LCC).

  • A minimum of free disk space and DRAM on each Routing Engine. The software upgrade will fail on any Routing Engine without the required amount of free disk space and DRAM. To determine the amount of disk space currently available on all Routing Engines of the routing matrix, use the CLI show system storage command. To determine the amount of DRAM currently available on all the Routing Engines in the routing matrix, use the CLI show chassis routing-engine command.
  • The master Routing Engines of the TX Matrix router (scc) and T640 routers (lcc) are all on re0 or are all on re1.
  • The backup Routing Engines of the TX Matrix router (scc) and T640 routers (lcc) are all on re1 or are all on re0.
  • All master Routing Engines in all routers run the same version of software. This is necessary for the routing matrix to operate.
  • All master and backup Routing Engines run the same version of software before beginning the upgrade procedure. Different versions of the JUNOS Software can have incompatible message formats especially if you turn on GRES. Because the steps in the process include changing mastership, running the same version of software is recommended.
  • The same Routing Engine model is used within a TX Matrix router (scc) and within a T640 router (lcc) of a routing matrix. For example, a routing matrix with an scc using two RE-A-2000s and an lcc using two RE-1600s is supported. However, an scc or an lcc with two different Routing Engine models is not supported. We suggest that all Routing Engines are the same model throughout all routers in the routing matrix. To determine the Routing Engine type, use the CLI show chassis hardware | match routing command.

Note: It is considered best practice to make sure that all master Routing Engines are re0 and all backup Routing Engines are re1 (or vice versa). For the purposes of this document, the master Routing Engine is re0 and the backup Routing Engine is re1.

On the TX Matrix router, perform a JUNOS Software upgrade on each Routing Engine separately to avoid unnecessary disruption to network operation. Install the new JUNOS Software release on the backup Routing Engine (re1) while keeping the currently running software version on the master Routing Engine (re0).

After making sure that the new software version is running correctly on the backup Routing Engine (re1), switch mastership over to re1, install the new software on the new backup Routing Engine (re0) and then revert mastership from re1 back to re0. These changes are propagated to all of the T640 routers in the routing matrix.

To upgrade the JUNOS Software for a routing matrix, perform the following tasks:

Disabling GRES on the Routing Matrix with a TX Matrix Router

Before upgrading the software on the routing matrix with a TX Matrix router, you must disable graceful Routing Engine switchover (GRES) on all the routers in the routing matrix. To disable GRES, perform the following steps on the TX Matrix router:

  1. Log in to the master Routing Engine’s (scc-re0) console.
    login: root
    Password: xxx
    
    --- JUNOS 9.5R2.1 built 2009-06-05 08:52:23 UTC
    %
  2. Enter the JUNOS Software CLI configuration mode:
    1. Start the CLI from the shell prompt using the cli command:
      % cli
      {master}
      user@host-scc-re0>
    2. Launche configuration mode:
      {master}
      user@host-scc-re0> configure
      Entering configuration mode

      {master} [edit]
      user@host-scc-re0 #
  3. Disable Routing Engine redundancy and verify that the configuration is removed:
    {master}[edit]
    user@host-scc-re0#  show chassis 
    redundancy {
        graceful-switchover;
    }
    
    {master}[edit]
    user@host-scc-re0# delete chassis redundancy
    {master}[edit] user@host-scc-re0# show chassis
  4. Save the configuration change on all Routing Engines in the routing matrix and exit the CLI configuration mode:
    {master}[edit]
    user@host-scc-re0#  commit synchronize and-quit 
    scc-re0: 
    configuration check succeeds
    lcc0-re1: 
    commit complete
    lcc0-re0: 
    commit complete
    lcc2-re1: 
    commit complete
    lcc2-re0: 
    commit complete
    scc-re1: 
    commit complete
    scc-re0: 
    commit complete
    
    user@host-scc-re0> 

Installing Software on All Backup Routing Engines of a Routing Matrix with a TX Matrix Router

Install the new JUNOS Software release on all backup Routing Engines (re1) of the TX Matrix router while keeping the currently running software version on the master Routing Engines (re0). This enables the master Routing Engines (re0) to continue operations, minimizing the disruption to the routing matrix with a TX Matrix router and your network.

To install the software on all of the backup Routing Engines (re1), perform the following steps:

  1. Log in to the backup TX Matrix router (re1) Routing Engine's console.

    For more information on logging in to the Routing Engine through the console port, see the administration manual for your particular router.

  2. To upgrade software for all the backup Routing Engines (re1) in the routing matrix, issue the request system software add command. Below is an example of the request system software add command and the output as the software is being added.
    user@host-scc-re1> request system software add /var/tmp/jinstall-9.6B2.7-domestic-signed.tgz 
    Pushing bundle to lcc0-re1
    Pushing bundle to lcc2-re1
    
    Validating on lcc0-re1
    Checking compatibility with configuration
    Initializing...
    Using jbase-9.6B1.8
    Verified manifest signed by PackageProduction_9_6_0
    Using /var/tmp/jinstall-9.6B2.7-domestic-signed.tgz
    Verified jinstall-9.6B2.7-domestic.tgz signed by PackageProduction_9_6_0
    Using jinstall-9.6B2.7-domestic.tgz
    Using jbundle-9.6B2.7-domestic.tgz
    Checking jbundle requirements on /
    Using jbase-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using /var/validate/chroot/tmp/jbundle/jboot-9.6B2.7.tgz
    Using jkernel-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jcrypto-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jpfe-9.6B2.7.tgz
    Using jdocs-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jroute-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jservices-9.6B2.7.tgz
    Auto-deleting old jservices-voice ...
    Removing /opt/sdk/jservices-voice ...
    Removing jservices-voice-bsg-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-voice ...
    Verified jservices-voice-bsg-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /var/sw/pkg ...
    Creating /opt/sdk/jservices-voice ...
    Storing jservices-voice-bsg-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-voice/jservices-voice-bsg -> /var/sw/pkg/jservices-voice-bsg-9.6B2.7.tgz...
    Auto-deleting old jservices-bgf ...
    Removing /opt/sdk/jservices-bgf ...
    Removing jservices-bgf-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-bgf ...
    Verified jservices-bgf-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-bgf ...
    Storing jservices-bgf-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-bgf/jservices-bgf-pic -> /var/sw/pkg/jservices-bgf-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-aacl ...
    Removing /opt/sdk/jservices-aacl ...
    Removing jservices-aacl-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-aacl ...
    Verified jservices-aacl-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-aacl ...
    Storing jservices-aacl-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-aacl/jservices-aacl-pic -> /var/sw/pkg/jservices-aacl-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-llpdf ...
    Removing /opt/sdk/jservices-llpdf ...
    Removing jservices-llpdf-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-llpdf ...
    Verified jservices-llpdf-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-llpdf ...
    Storing jservices-llpdf-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-llpdf/jservices-llpdf-pic -> /var/sw/pkg/jservices-llpdf-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-sfw ...
    Removing /opt/sdk/jservices-sfw ...
    Removing jservices-sfw-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-sfw ...
    Verified jservices-sfw-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-sfw ...
    Storing jservices-sfw-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-sfw/jservices-sfw-pic -> /var/sw/pkg/jservices-sfw-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-appid ...
    Removing /opt/sdk/jservices-appid ...
    Removing jservices-appid-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-appid ...
    Verified jservices-appid-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-appid ...
    Storing jservices-appid-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-appid/jservices-appid-pic -> /var/sw/pkg/jservices-appid-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-idp ...
    Removing /opt/sdk/jservices-idp ...
    Removing jservices-idp-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-idp ...
    Verified jservices-idp-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-idp ...
    Storing jservices-idp-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-idp/jservices-idp-pic -> /var/sw/pkg/jservices-idp-pic-9.6B2.7.tgz...
    Hardware Database regeneration succeeded
    Validating against /config/juniper.conf.gz
    mgd: commit complete
    Validation succeeded
    
    Validating on lcc2-re1
    Checking compatibility with configuration
    Initializing...
    Using jbase-9.6B1.8
    Verified manifest signed by PackageProduction_9_6_0
    Using /var/tmp/jinstall-9.6B2.7-domestic-signed.tgz
    Verified jinstall-9.6B2.7-domestic.tgz signed by PackageProduction_9_6_0
    Using jinstall-9.6B2.7-domestic.tgz
    Using jbundle-9.6B2.7-domestic.tgz
    Checking jbundle requirements on /
    Using jbase-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using /var/validate/chroot/tmp/jbundle/jboot-9.6B2.7.tgz
    Using jkernel-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jcrypto-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jpfe-9.6B2.7.tgz
    Using jdocs-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jroute-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jservices-9.6B2.7.tgz
    Auto-deleting old jservices-voice ...
    Removing /opt/sdk/jservices-voice ...
    Removing jservices-voice-bsg-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-voice ...
    Verified jservices-voice-bsg-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /var/sw/pkg ...
    Creating /opt/sdk/jservices-voice ...
    Storing jservices-voice-bsg-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-voice/jservices-voice-bsg -> /var/sw/pkg/jservices-voice-bsg-9.6B2.7.tgz...
    Auto-deleting old jservices-bgf ...
    Removing /opt/sdk/jservices-bgf ...
    Removing jservices-bgf-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-bgf ...
    Verified jservices-bgf-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-bgf ...
    Storing jservices-bgf-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-bgf/jservices-bgf-pic -> /var/sw/pkg/jservices-bgf-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-aacl ...
    Removing /opt/sdk/jservices-aacl ...
    Removing jservices-aacl-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-aacl ...
    Verified jservices-aacl-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-aacl ...
    Storing jservices-aacl-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-aacl/jservices-aacl-pic -> /var/sw/pkg/jservices-aacl-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-llpdf ...
    Removing /opt/sdk/jservices-llpdf ...
    Removing jservices-llpdf-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-llpdf ...
    Verified jservices-llpdf-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-llpdf ...
    Storing jservices-llpdf-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-llpdf/jservices-llpdf-pic -> /var/sw/pkg/jservices-llpdf-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-sfw ...
    Removing /opt/sdk/jservices-sfw ...
    Removing jservices-sfw-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-sfw ...
    Verified jservices-sfw-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-sfw ...
    Storing jservices-sfw-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-sfw/jservices-sfw-pic -> /var/sw/pkg/jservices-sfw-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-appid ...
    Removing /opt/sdk/jservices-appid ...
    Removing jservices-appid-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-appid ...
    Verified jservices-appid-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-appid ...
    Storing jservices-appid-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-appid/jservices-appid-pic -> /var/sw/pkg/jservices-appid-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-idp ...
    Removing /opt/sdk/jservices-idp ...
    Removing jservices-idp-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-idp ...
    Verified jservices-idp-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-idp ...
    Storing jservices-idp-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-idp/jservices-idp-pic -> /var/sw/pkg/jservices-idp-pic-9.6B2.7.tgz...
    Hardware Database regeneration succeeded
    Validating against /config/juniper.conf.gz
    mgd: commit complete
    Validation succeeded
    
    Validating on scc-re1
    Checking compatibility with configuration
    Initializing...
    Using jbase-9.6B1.8
    Verified manifest signed by PackageProduction_9_6_0
    Using /var/tmp/jinstall-9.6B2.7-domestic-signed.tgz
    Verified jinstall-9.6B2.7-domestic.tgz signed by PackageProduction_9_6_0
    Using jinstall-9.6B2.7-domestic.tgz
    Using jbundle-9.6B2.7-domestic.tgz
    Checking jbundle requirements on /
    Using jbase-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using /var/validate/chroot/tmp/jbundle/jboot-9.6B2.7.tgz
    Using jkernel-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jcrypto-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jpfe-9.6B2.7.tgz
    Using jdocs-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jroute-9.6B2.7.tgz
    Verified manifest signed by PackageProduction_9_6_0
    Using jservices-9.6B2.7.tgz
    Auto-deleting old jservices-voice ...
    Removing /opt/sdk/jservices-voice ...
    Removing jservices-voice-bsg-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-voice ...
    Verified jservices-voice-bsg-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /var/sw/pkg ...
    Creating /opt/sdk/jservices-voice ...
    Storing jservices-voice-bsg-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-voice/jservices-voice-bsg -> /var/sw/pkg/jservices-voice-bsg-9.6B2.7.tgz...
    Auto-deleting old jservices-bgf ...
    Removing /opt/sdk/jservices-bgf ...
    Removing jservices-bgf-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-bgf ...
    Verified jservices-bgf-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-bgf ...
    Storing jservices-bgf-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-bgf/jservices-bgf-pic -> /var/sw/pkg/jservices-bgf-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-aacl ...
    Removing /opt/sdk/jservices-aacl ...
    Removing jservices-aacl-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-aacl ...
    Verified jservices-aacl-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-aacl ...
    Storing jservices-aacl-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-aacl/jservices-aacl-pic -> /var/sw/pkg/jservices-aacl-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-llpdf ...
    Removing /opt/sdk/jservices-llpdf ...
    Removing jservices-llpdf-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-llpdf ...
    Verified jservices-llpdf-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-llpdf ...
    Storing jservices-llpdf-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-llpdf/jservices-llpdf-pic -> /var/sw/pkg/jservices-llpdf-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-sfw ...
    Removing /opt/sdk/jservices-sfw ...
    Removing jservices-sfw-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-sfw ...
    Verified jservices-sfw-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-sfw ...
    Storing jservices-sfw-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-sfw/jservices-sfw-pic -> /var/sw/pkg/jservices-sfw-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-appid ...
    Removing /opt/sdk/jservices-appid ...
    Removing jservices-appid-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-appid ...
    Verified jservices-appid-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-appid ...
    Storing jservices-appid-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-appid/jservices-appid-pic -> /var/sw/pkg/jservices-appid-pic-9.6B2.7.tgz...
    Auto-deleting old jservices-idp ...
    Removing /opt/sdk/jservices-idp ...
    Removing jservices-idp-pic-9.6B1.8.tgz from /var/sw/pkg ...
    Notifying mspd ...
    Installing new jservices-idp ...
    Verified jservices-idp-pic-9.6B2.7.tgz signed by PackageProduction_9_6_0
    Creating /opt/sdk/jservices-idp ...
    Storing jservices-idp-pic-9.6B2.7.tgz in /var/sw/pkg ...
    Link: /opt/sdk/jservices-idp/jservices-idp-pic -> /var/sw/pkg/jservices-idp-pic-9.6B2.7.tgz...
    Hardware Database regeneration succeeded
    Validating against /config/juniper.conf.gz
    mgd: commit complete
    Validation succeeded
    Done with validate on all chassis
    
    lcc0-re1:
    Installing package '/var/tmp/jinstall-9.6B2.7-domestic-signed.tgz' ...
    Verified jinstall-9.6B2.7-domestic.tgz signed by PackageProduction_9_6_0
    Adding jinstall...
    Verified manifest signed by PackageProduction_9_6_0
    
    WARNING:     This package will load JUNOS 9.6B2.7 software.
    WARNING:     It will save JUNOS configuration files, and SSH keys
    WARNING:     (if configured), but erase all other files and information
    WARNING:     stored on this machine.  It will attempt to preserve dumps
    WARNING:     and log files, but this can not be guaranteed.  This is the
    WARNING:     pre-installation stage and all the software is loaded when
    WARNING:     you reboot the system.
    
    Saving the config files ...
    NOTICE: uncommitted changes have been saved in /var/db/config/juniper.conf.pre-install
    Installing the bootstrap installer ...
    
    WARNING:     A REBOOT IS REQUIRED TO LOAD THIS SOFTWARE CORRECTLY. Use the
    WARNING:     'request system reboot' command when software installation is
    WARNING:     complete. To abort the installation, do not reboot your system,
    WARNING:     instead use the 'request system software delete jinstall'
    WARNING:     command as soon as this operation completes.
    
    Saving package file in /var/sw/pkg/jinstall-9.6B2.7-domestic-signed.tgz ...
    Saving state for rollback ...
    
    lcc2-re1:
    Installing package '/var/tmp/jinstall-9.6B2.7-domestic-signed.tgz' ...
    Verified jinstall-9.6B2.7-domestic.tgz signed by PackageProduction_9_6_0
    Adding jinstall...
    Verified manifest signed by PackageProduction_9_6_0
    
    WARNING:     This package will load JUNOS 9.6B2.7 software.
    WARNING:     It will save JUNOS configuration files, and SSH keys
    WARNING:     (if configured), but erase all other files and information
    WARNING:     stored on this machine.  It will attempt to preserve dumps
    WARNING:     and log files, but this can not be guaranteed.  This is the
    WARNING:     pre-installation stage and all the software is loaded when
    WARNING:     you reboot the system.
    
    Saving the config files ...
    NOTICE: uncommitted changes have been saved in /var/db/config/juniper.conf.pre-install
    Installing the bootstrap installer ...
    
    WARNING:     A REBOOT IS REQUIRED TO LOAD THIS SOFTWARE CORRECTLY. Use the
    WARNING:     'request system reboot' command when software installation is
    WARNING:     complete. To abort the installation, do not reboot your system,
    WARNING:     instead use the 'request system software delete jinstall'
    WARNING:     command as soon as this operation completes.
    
    Saving package file in /var/sw/pkg/jinstall-9.6B2.7-domestic-signed.tgz ...
    Saving state for rollback ...
    
    scc-re1:
    Installing package '/var/tmp/jinstall-9.6B2.7-domestic-signed.tgz' ...
    Verified jinstall-9.6B2.7-domestic.tgz signed by PackageProduction_9_6_0
    Adding jinstall...
    Verified manifest signed by PackageProduction_9_6_0
    
    WARNING:     This package will load JUNOS 9.6B2.7 software.
    WARNING:     It will save JUNOS configuration files, and SSH keys
    WARNING:     (if configured), but erase all other files and information
    WARNING:     stored on this machine.  It will attempt to preserve dumps
    WARNING:     and log files, but this can not be guaranteed.  This is the
    WARNING:     pre-installation stage and all the software is loaded when
    WARNING:     you reboot the system.
    
    Saving the config files ...
    NOTICE: uncommitted changes have been saved in /var/db/config/juniper.conf.pre-install
    Installing the bootstrap installer ...
    
    WARNING:     A REBOOT IS REQUIRED TO LOAD THIS SOFTWARE CORRECTLY. Use the
    WARNING:     'request system reboot' command when software installation is
    WARNING:     complete. To abort the installation, do not reboot your system,
    WARNING:     instead use the 'request system software delete jinstall'
    WARNING:     command as soon as this operation completes.
    
    Saving package file in /var/sw/pkg/jinstall-9.6B2.7-domestic-signed.tgz ...
    Saving state for rollback ...
    
    user@host-scc-re1> 

    For more information on the request system software add command, see the JUNOS System Basics and Services Command Reference.

Loading the New JUNOS Software Version on the Backup Routing Engines of the Routing Matrix with a TX Matrix Router

After you have added the new software version to the backup Routing Engines (re1), reboot the routing matrix with a TX Matrix router to load the new software and verify the version of the software. To reboot the routing matrix, reboot the TX Matrix router which forces all T640 routers to reboot and loads the new software on all backup Routing Engines (re1) in the routing matrix.

  1. Reboot the TX Matrix router to start the new software using the request system reboot command:
    user@host-scc-re1> request system reboot
    Reboot the system ? [yes,no] (no) yes 
    
    rebooting lcc0-re1
    Rebooting lcc2-re1
    Shutdown NOW!
    Reboot consistency check bypassed - jinstall 9.6B2.7 will complete installation upon reboot
    [pid 23517]
    
    user@host-scc-re1>                                                                                
    
    *** FINAL System shutdown message from user@host-scc-re1> ***                         
    
    System going down IMMEDIATELY                                                  
    
    rlogin: connection closed
    user@host-scc-re0>

    Note: You must reboot to load the new installation of the JUNOS Software onto the backup Routing Engine (re1) of the TX Matrix router and to propagate the new image on all backup Routing Engines (re1) of the T640 routers in the routing matrix.

    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.

    All the software is loaded on all the backup Routing Engines when you reboot the system. Installation can take about 10 minutes. The backup Routing Engines (re1) then reboot from the boot device on which the software was just installed. When the reboot is complete, the TX Matrix router backup Routing Engine (re1) displays the login prompt.

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

  2. Log in to the TX Matrix router backup Routing Engine (re1) and issue the show version command to verify the version of the software installed:
    user@host-scc-re1>> show version
    scc-re1:
    --------------------------------------------------------------------------
    Hostname: z8-1
    Model: TX Matrix
    JUNOS Base OS boot [9.6B2.7]
    JUNOS Base OS Software Suite [9.6B2.7]
    JUNOS Kernel Software Suite [9.6B2.7]
    JUNOS Crypto Software Suite [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (M/T Common) [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (T-Series) [9.6B2.7]
    JUNOS Online Documentation [9.6B2.7]
    JUNOS Voice Services Container package [9.6B2.7]
    JUNOS Border Gateway Function package [9.6B2.7]
    JUNOS Services AACL Container package [9.6B2.7]
    JUNOS Services LL-PDF Container package [9.6B2.7]
    JUNOS Services Stateful Firewall [9.6B2.7]
    JUNOS AppId Services [9.6B2.7]
    JUNOS IDP Services [9.6B2.7]
    JUNOS Routing Software Suite [9.6B2.7]
    
    lcc0-re1:
    --------------------------------------------------------------------------
    Hostname: z8-lcc0-re1
    Model: t640
    JUNOS Base OS boot [9.6B2.7]
    JUNOS Base OS Software Suite [9.6B2.7]
    JUNOS Kernel Software Suite [9.6B2.7]
    JUNOS Crypto Software Suite [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (M/T Common) [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (T-Series) [9.6B2.7]
    JUNOS Online Documentation [9.6B2.7]
    JUNOS Voice Services Container package [9.6B2.7]
    JUNOS Border Gateway Function package [9.6B2.7]
    JUNOS Services AACL Container package [9.6B2.7]
    JUNOS Services LL-PDF Container package [9.6B2.7]
    JUNOS Services Stateful Firewall [9.6B2.7]
    JUNOS AppId Services [9.6B2.7]
    JUNOS IDP Services [9.6B2.7]
    JUNOS Routing Software Suite [9.6B2.7]
    
    lcc2-re1:
    --------------------------------------------------------------------------
    Hostname: z8-lcc2-re1
    Model: t640
    JUNOS Base OS boot [9.6B2.7]
    JUNOS Base OS Software Suite [9.6B2.7]
    JUNOS Kernel Software Suite [9.6B2.7]
    JUNOS Crypto Software Suite [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (M/T Common) [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (T-Series) [9.6B2.7]
    JUNOS Online Documentation [9.6B2.7]
    JUNOS Voice Services Container package [9.6B2.7]
    JUNOS Border Gateway Function package [9.6B2.7]
    JUNOS Services AACL Container package [9.6B2.7]
    JUNOS Services LL-PDF Container package [9.6B2.7]
    JUNOS Services Stateful Firewall [9.6B2.7]
    JUNOS AppId Services [9.6B2.7]
    JUNOS IDP Services [9.6B2.7]
    JUNOS Routing Software Suite [9.6B2.7]

Installing Software on the Master Routing Engines of a Routing Matrix with a TX Matrix Router

Before you install the new software on the master Routing Engines (re0) of the routing matrix with a TX Matrix router, you need to switch mastership over to the backup Routing Engines (re1) to minimize the disruption to network operation.

To change mastership and install the new software version on the new backup Routing Engine (re0), perform the following steps:

  1. On the TX Matrix router, log in to the original master Routing Engine (re0) console port.

    For more information on logging in to the Routing Engine through the console port, see the administration guide for your particular router.

  2. Transfer mastership to the backup Routing Engine (re1) for all routers in the routing matrix using the request chassis routing-engine master switch all-chassis command:
    user@host-scc-re0> request chassis routing-engine master switch all-chassis 
    warning: Traffic will be interrupted while the PFE is re-initialized
    Toggle mastership between routing engines ? [yes,no] (no) yes 
    
    lcc0-re0:
    --------------------------------------------------------------------------
    warning: Traffic will be interrupted while the PFE is re-initialized
    Resolving mastership...
    Complete. The other routing engine becomes the master.
    
    lcc2-re0:
    --------------------------------------------------------------------------
    warning: Traffic will be interrupted while the PFE is re-initialized
    Resolving mastership...
    Complete. The other routing engine becomes the master.
    
    scc-re0:
    --------------------------------------------------------------------------
    warning: Traffic will be interrupted while the PFE is re-initialized
    Resolving mastership...
    Complete. The other routing engine becomes the master.
  3. Verify that the backup Routing Engine (slot 1) is now the master Routing Engine on all routers in the routing matrix using the show chassis routing-engine command:
    user@host-scc-re0> show chassis routing-engine
    scc-re0:
    --------------------------------------------------------------------------
    Routing Engine status:
      Slot 0:
        Current state                  Backup
        Election priority              Master (default)
        [...Output Truncated...]
    Routing Engine status:
      Slot 1:
        Current state                  Master
        Election priority              Backup (default)
        [...Output Truncated...]
    
    lcc0-re0:
    --------------------------------------------------------------------------
    Routing Engine status:
      Slot 0:
        Current state                  Backup
        Election priority              Master (default)
        [...Output Truncated...]
                                           0.02       0.07       0.11
    Routing Engine status:
      Slot 1:
        Current state                  Master
        Election priority              Backup (default)
        [...Output Truncated...]
    
    lcc2-re0:
    --------------------------------------------------------------------------
    Routing Engine status:
      Slot 0:
        Current state                  Backup
        Election priority              Master (default)
        [...Output Truncated...]
    Routing Engine status:
      Slot 1:
        Current state                  Master
        Election priority              Backup (default)
        [...Output Truncated...]
  4. Install the new software package using the request system software add command:
    user@host-scc-re0> request system software add /var/tmp/jinstall-9.6B2.7-domestic-signed.tgz 
    Pushing bundle to lcc0-re0
    Pushing bundle to lcc2-re0
    [...Output Truncated...]
  5. Reboot the Routing Engine (re0) using the request system reboot command:
    user@host-scc-re0> request system reboot 
    Reboot the system ? [yes,no] (no) yes 
    
    Rebooting lcc0-re0
    Rebooting lcc2-re0
    Shutdown NOW!
    Reboot consistency check bypassed - jinstall 9.6B2.7 will complete installation upon reboot
    [pid 9071]
    
    user@host-scc-re0>                                                                                
    *** FINAL System shutdown message from user@host-scc-re0> ***                        
    System going down IMMEDIATELY                                                  
    
    Connection closed by foreign host.

    Note: You must reboot to load the new installation of the JUNOS Software onto the original master Routing Engine (re0) of the TX Matrix router and to propagate the new image on all original master Routing Engines (re0) of the T640 routers in the routing matrix.

    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 about 10 minutes. The routers then reboot from the boot device on which the software was just installed. When the reboot is complete, the TX Matrix Routing Engine (re0) displays the login prompt.

    While the software is being upgraded, the Routing Engine (re0) 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:
    user@host-scc-re0> show version
    scc-re0:
    --------------------------------------------------------------------------
    Hostname: z8
    Model: TX Matrix
    JUNOS Base OS boot [9.6B2.7]
    JUNOS Base OS Software Suite [9.6B2.7]
    JUNOS Kernel Software Suite [9.6B2.7]
    JUNOS Crypto Software Suite [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (M/T Common) [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (T-Series) [9.6B2.7]
    JUNOS Online Documentation [9.6B2.7]
    JUNOS Voice Services Container package [9.6B2.7]
    JUNOS Border Gateway Function package [9.6B2.7]
    JUNOS Services AACL Container package [9.6B2.7]
    JUNOS Services LL-PDF Container package [9.6B2.7]
    JUNOS Services Stateful Firewall [9.6B2.7]
    JUNOS AppId Services [9.6B2.7]
    JUNOS IDP Services [9.6B2.7]
    JUNOS Routing Software Suite [9.6B2.7]
    
    lcc0-re0:
    --------------------------------------------------------------------------
    Hostname: z8-lcc0-re0
    Model: t640
    JUNOS Base OS boot [9.6B2.7]
    JUNOS Base OS Software Suite [9.6B2.7]
    JUNOS Kernel Software Suite [9.6B2.7]
    JUNOS Crypto Software Suite [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (M/T Common) [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (T-Series) [9.6B2.7]
    JUNOS Online Documentation [9.6B2.7]
    JUNOS Voice Services Container package [9.6B2.7]
    JUNOS Border Gateway Function package [9.6B2.7]
    JUNOS Services AACL Container package [9.6B2.7]
    JUNOS Services LL-PDF Container package [9.6B2.7]
    JUNOS Services Stateful Firewall [9.6B2.7]
    JUNOS AppId Services [9.6B2.7]
    JUNOS IDP Services [9.6B2.7]
    JUNOS Routing Software Suite [9.6B2.7]
    
    lcc2-re0:
    --------------------------------------------------------------------------
    Hostname: z8-lcc2-re0
    Model: t640
    JUNOS Base OS boot [9.6B2.7]
    JUNOS Base OS Software Suite [9.6B2.7]
    JUNOS Kernel Software Suite [9.6B2.7]
    JUNOS Crypto Software Suite [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (M/T Common) [9.6B2.7]
    JUNOS Packet Forwarding Engine Support (T-Series) [9.6B2.7]
    JUNOS Online Documentation [9.6B2.7]
    JUNOS Voice Services Container package [9.6B2.7]
    JUNOS Border Gateway Function package [9.6B2.7]
    JUNOS Services AACL Container package [9.6B2.7]
    JUNOS Services LL-PDF Container package [9.6B2.7]
    JUNOS Services Stateful Firewall [9.6B2.7]
    JUNOS AppId Services [9.6B2.7]
    JUNOS IDP Services [9.6B2.7]
    JUNOS Routing Software Suite [9.6B2.7]
  7. (Optional to avoid another traffic disruption) Transfer routing control back to the original master Routing Engine (re0) using the request chassis routing-engine master switch all-chassis command:
    user@host-scc-re0> request chassis routing-engine master switch all-chassis 
    warning: Traffic will be interrupted while the PFE is re-initialized
    Toggle mastership between routing engines ? [yes,no] (no) yes 
    
    lcc0-re0:
    --------------------------------------------------------------------------
    warning: Traffic will be interrupted while the PFE is re-initialized
    Resolving mastership...
    Complete. The local routing engine becomes the master.
    
    lcc2-re0:
    --------------------------------------------------------------------------
    warning: Traffic will be interrupted while the PFE is re-initialized
    Resolving mastership...
    Complete. The local routing engine becomes the master.
    
    scc-re0:
    --------------------------------------------------------------------------
    warning: Traffic will be interrupted while the PFE is re-initialized
    Resolving mastership...
    Complete. The local routing engine becomes the master.
  8. Verify that the master Routing Engine (slot 0) is indeed the master Routing Engine using the show chassis routing-engine command:
    user@host-scc-re0> show chassis routing-engine
    scc-re0:
    --------------------------------------------------------------------------
    Routing Engine status:
      Slot 0:
        Current state                  Master
        Election priority              Master (default)
        [...Output Truncated...]
    
    Routing Engine status:
      Slot 1:
        Current state                  Backup
        Election priority              Backup (default)
        [...Output Truncated...]
    
    lcc0-re0:
    --------------------------------------------------------------------------
    Routing Engine status:
      Slot 0:
        Current state                  Master
        Election priority              Master (default)
        [...Output Truncated...]
    
    Routing Engine status:
      Slot 1:
        Current state                  Backup
        Election priority              Backup (default)
        [...Output Truncated...]
    
    lcc2-re0:
    --------------------------------------------------------------------------
    Routing Engine status:
      Slot 0:
        Current state                  Master
        Election priority              Master (default)
        [...Output Truncated...]
    
    Routing Engine status:
      Slot 1:
        Current state                  Backup
        Election priority              Backup (default)
        [...Output Truncated...]

Finalizing the Installation for a Routing Engine with a TX Matrix Router

After the software is installed on all Routing Engines, you return the routing matrix with a TX Matrix 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 using the configure and rollback commands:
    user@host-scc-re0> configure 
    Entering configuration mode
    
    [edit]
    user@host-scc-re0# rollback 1  
    load complete
  2. Save the configuration change on all Routing Engines using the commit synchronize and-quit command:
    [edit]
    user@host-scc-re0# commit synchronize and-quit 
    scc-re0: 
    configuration check succeeds
    lcc0-re1: 
    commit complete
    lcc0-re0: 
    commit complete
    lcc2-re1: 
    commit complete
    lcc2-re0: 
    commit complete
    scc-re1: 
    commit complete
    scc-re0: 
    commit complete
    
    user@host-scc-re0> 
  3. After you have installed the new software and are satisfied that it is successfully running, issue the following commands to back up the new software on both the master (re0) and the backup (re1) Routing Engines:
    user@host-scc-re0> request system snapshot
    user@host-scc-re0> request chassis routing-engine master switch all-chassis
    user@host-scc-re1> request system snapshot

    The sample output below shows examples of all the commands above.

    {master}
    user@host-scc-re0> request system snapshot 
    scc-re0:
    --------------------------------------------------------------------------
    Verifying compatibility of destination media partitions...
    Running newfs (220MB) on hard-disk media / partition (ad1s1a)...
    Running newfs (24MB) on hard-disk media /config partition (ad1s1e)...
    Copying '/dev/ad0s1a' to '/dev/ad1s1a' .. (this may take a few minutes)
    Copying '/dev/ad0s1e' to '/dev/ad1s1e' .. (this may take a few minutes)
    The following filesystems were archived: / /config
    
    lcc0-re0:
    --------------------------------------------------------------------------
    Verifying compatibility of destination media partitions...
    Running newfs (220MB) on hard-disk media / partition (ad1s1a)...
    Running newfs (24MB) on hard-disk media /config partition (ad1s1e)...
    Copying '/dev/ad0s1a' to '/dev/ad1s1a' .. (this may take a few minutes)
    Copying '/dev/ad0s1e' to '/dev/ad1s1e' .. (this may take a few minutes)
    The following filesystems were archived: / /config
    
    lcc2-re0:
    --------------------------------------------------------------------------
    Verifying compatibility of destination media partitions...
    Running newfs (220MB) on hard-disk media / partition (ad1s1a)...
    Running newfs (24MB) on hard-disk media /config partition (ad1s1e)...
    Copying '/dev/ad0s1a' to '/dev/ad1s1a' .. (this may take a few minutes)
    Copying '/dev/ad0s1e' to '/dev/ad1s1e' .. (this may take a few minutes)
    The following filesystems were archived: / /config

    {master}
    user@host-scc-re0> request chassis routing-engine master switch all-chassis 
    Toggle mastership between routing engines ? [yes,no] (no) yes 
    
    lcc0-re0:
    --------------------------------------------------------------------------
    Resolving mastership...
    Complete. The other routing engine becomes the master.
    
    lcc2-re0:
    --------------------------------------------------------------------------
    Resolving mastership...
    Complete. The other routing engine becomes the master.
    
    scc-re0:
    --------------------------------------------------------------------------
    Resolving mastership...
    Complete. The other routing engine becomes the master.
    {master}
    user@host-scc-re1> request system snapshot 
    scc-re1:
    --------------------------------------------------------------------------
    Verifying compatibility of destination media partitions...
    Running newfs (220MB) on hard-disk media / partition (ad1s1a)...
    Running newfs (24MB) on hard-disk media /config partition (ad1s1e)...
    Copying '/dev/ad0s1a' to '/dev/ad1s1a' .. (this may take a few minutes)
    Copying '/dev/ad0s1e' to '/dev/ad1s1e' .. (this may take a few minutes)
    The following filesystems were archived: / /config
    
    lcc0-re1:
    --------------------------------------------------------------------------
    Verifying compatibility of destination media partitions...
    Running newfs (223MB) on hard-disk media / partition (ad2s1a)...
    Running newfs (24MB) on hard-disk media /config partition (ad2s1e)...
    Copying '/dev/ad0s1a' to '/dev/ad2s1a' .. (this may take a few minutes)
    Copying '/dev/ad0s1e' to '/dev/ad2s1e' .. (this may take a few minutes)
    The following filesystems were archived: / /config
    
    lcc2-re1:
    --------------------------------------------------------------------------
    Verifying compatibility of destination media partitions...
    Running newfs (220MB) on hard-disk media / partition (ad1s1a)...
    Running newfs (24MB) on hard-disk media /config partition (ad1s1e)...
    Copying '/dev/ad0s1a' to '/dev/ad1s1a' .. (this may take a few minutes)
    Copying '/dev/ad0s1e' to '/dev/ad1s1e' .. (this may take a few minutes)
    The following filesystems were archived: / /config

    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.

    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.


Published: 2010-04-15