Unified ISSU
A unified in-service software upgrade (unified ISSU) enables
you to upgrade between two different Junos OS releases with no disruption
on the control plane and with minimal disruption of traffic. Unified
ISSU is supported only on dual Routing Engine platforms. In addition,
the graceful Routing Engine switchover (GRES) and nonstop active routing (NSR) must be enabled.
A unified ISSU provides the following benefits:
- Eliminates network downtime during software image upgrades
- Reduces operating costs, while delivering higher service levels
- Allows fast implementation of new features
A unified ISSU has the following caveats:
- The master Routing Engine and backup Routing Engine must be running the same software version before you can perform a unified ISSU.
- Graceful Routing Engine switchover (GRES) (check it with show system switchover)and NSR nonstop active routing must be enabled. (note NSR is not supported in all devices.
- You cannot take any PICs online or offline during a unified ISSU.
- You can verify the unified ISSU compatibility of the software, hardware, and the configuration on a device by issuing the request system software validate in-service-upgrade command. This command runs the validation checks, and shows whether the operating system, device components, and configurations are ISSU compatible or not. See request system software validate-in-service-upgrade for more information.
- Unicast RPF-related statistics are not saved across a unified ISSU, and the unicast RPF counters are reset to zero during a unified ISSU.
- BGP session uptime and downtime statistics are not synchronized between the primary and backup Routing Engines during NSR and ISSU. The backup Routing Engine maintains its own session uptime based on the time when the backup first becomes aware of the established sessions. For example, if the backup Routing Engine is rebooted (or if you run restart routing on the backup Routing Engine), the backup's uptime is a short duration, because the backup has just learned about the established sessions. If the backup is operating when the BGP sessions first come up on the primary, the uptime on the primary and the uptime on the backup are almost the same duration. After a Routing Engine switchover, the new master continues from the time left on the standby Routing Engine.
- You must disable the unconditional-src-learn statement at the [edit interfaces interface-name unit 0 family inet] hierarchy level before the unified ISSU process begins and enable it after the unified ISSU process is complete. Note that the unconditional-src-learn statement is disabled by default.
- Starting with Junos OS Release 13.2, unified ISSU is supported on PTX5000 routers with the FPC-PTX-P1-A FPC. However, you can perform unified ISSU only from Junos OS Release 13.2 to 13.3 and from Junos OS Release 14.1 to a later release. You must not perform unified ISSU from Junos OS Release 13.2 or 13.3 to 14.1 and later releases.
- LACP is not supported during unified ISSU on PTX Series routers. You must disable the lacp statement at the [edit interfaces interface-name aggregated-ether-options] hierarchy level before the unified ISSU process begins and enable it after the unified ISSU process is complete.
After the request system software in-service-upgrade command is issued, the following process occurs.
 |
Note:
In the illustrations below, a solid line indicates the
high-speed internal link between a Routing Engine and a Packet Forwarding
Engine. A dotted line indicates the chassis process (chassisd), another
method of communication between a Routing Engine and a Packet Forwarding
Engine. RE0m and RE1s indicate master and backup (or standby) Routing
Engines, respectively.
|
|
Note:
The following process pertains to all supported routing
platforms except the TX Matrix router and TX Matrix Plus router. For
information about the unified ISSU process on the TX Matrix router,
see Unified ISSU Process on the TX Matrix Router. For more information about the unified ISSU process
on the TX Matrix Plus router, see Unified ISSU Process on the TX Matrix Plus Router and on the TX Matrix Plus Router with 3D SIBs. On most routers, the Packet Forwarding
Engine resides on an FPC. However, on an M120 router, the Forwarding
Engine Board (FEB) replaces the functions of a Packet Forwarding Engine.
In the illustrations and steps, when considering an M120 router, you
can regard the PFE as an FPC. As an additional step on an M120 router,
after the FPCs and PICs have been upgraded, the FEBs are upgraded.
|
- The master Routing Engine validates the router configuration
to ensure that it can be committed when you use the new software version.
Checks are made for disk space available for the
/varfile system on both Routing Engines, for unsupported configurations, and for unsupported Physical Interface Cards (PICs). If there is not sufficient disk space available on either of the Routing Engines, the unified ISSU process fails and returns an error message saying that the Routing Engine does not have enough disk space available. However, unsupported PICs do not prevent a unified ISSU. The software issues a warning to indicate that these PICs will restart during the upgrade. Similarly, an unsupported protocol configuration does not prevent a unified ISSU. The software issues a warning that packet loss may occur for the protocol during the upgrade. - When the validation succeeds, the kernel state synchronization daemon (ksyncd) synchronizes the kernel on the backup Routing Engine with the master Routing Engine.
- The backup Routing Engine is upgraded with the new software
image. Before being upgraded, the backup Routing Engine gets the configuration
file from the master Routing Engine and validates the configuration
to ensure that it can be committed using the new software version.
After being upgraded, it is resynchronized with the master Routing
Engine. In the illustration, an apostrophe ( ' ) indicates that the
device is running the new version of software.
- The chassis process (chassisd) on the master Routing Engine prepares other software processes for the unified ISSU. When all the processes are ready, chassisd sends an ISSU_PREPARE message to the FPCs installed in the router.
- The Packet Forwarding Engine on each FPC saves its state
and downloads the new software image from the backup Routing Engine.
Next, each Packet Forwarding Engine sends an ISSU_READY message to
the chassis process (chassisd).
- After receiving an ISSU_READY message from a Packet Forwarding Engine, the chassis process (chassisd) sends an ISSU_REBOOT message to the FPC on which the Packet Forwarding Engine resides. The FPC reboots with the new software image. After the FPC is rebooted, the Packet Forwarding Engine restores the FPC state and a high-speed internal link is established with the backup Routing Engine running the new software. The chassis process (chassisd) is also reestablished with the master Routing Engine.
- After all Packet Forwarding Engines have sent a READY
message using the chassis process (chassisd) on the master Routing
Engine, other software processes are prepared for a Routing Engine
switchover. The system is ready for a switchover at this point.Note: For M120 routers, the FEBs are upgraded at this point. When all FEBs have been upgraded, the system is ready for a switchover.
- The Routing Engine switchover occurs, and the backup Routing
Engine becomes the new master Routing Engine.
- The new backup Routing Engine is now upgraded to the new
software image. (This step is skipped if you have not specified the no-old-master-upgrade option.)
- When the backup Routing Engine has been successfully upgraded, the unified ISSU is complete.
Performing a Unified ISSU
You can perform a unified
ISSU in one of three ways:
- Upgrading and Rebooting Both Routing Engines Automatically
- Upgrading Both Routing Engines and Rebooting the New Backup Routing Engine Manually
- Upgrading and Rebooting Only One Routing Engine
Upgrading and Rebooting Both Routing Engines Automatically
When you issue the request system software in-service-upgrade command with the reboot option, the system automatically
upgrades both Routing Engines to the newer software and reboots both
Routing Engines. This option enables you to complete the unified ISSU
with a single command.
To perform a unified ISSU using the request system software in-service-upgrade package-name reboot command, complete the following steps:
- Download the software package from the Juniper Networks Support website, http://www.juniper.net/support/. Choose the Canada and U.S., Worldwide, or Junos-FIPS edition. Place the package on a local server. To download the package, you must have a service contract and an access account. If you do not have an access account, complete the registration form at the Juniper Networks website: https://www.juniper.net/registration/Register.jsp.
- Copy the package to the router. We recommend that you
copy it to the
/var/tmpdirectory, which is a large file system on the hard disk.user@host>file copy ftp://username:prompt@ftp.hostname.net/filename/var/tmp/filename - To verify the current software version running on both
Routing Engines, on the master Routing Engine issue the show version invoke-on all-routing-engines command. The following
example shows that both Routing Engines are running an image of Junos
OS, Release 9.0, that was built on December 11, 2007:
{backup}user@host> show version invoke-on all-routing-enginesre0: -------------------------------------------------------------------------- Hostname: host Model: m320 JUNOS Base OS boot [9.0-20071211.2] JUNOS Base OS Software Suite 9.0-20071211.2] JUNOS Kernel Software Suite [9.0-20071211.2] JUNOS Crypto Software Suite [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M320) [9.0-20071211.2] JUNOS Online Documentation [9.0-20071211.2] JUNOS Routing Software Suite [9.0-20071211.2] re1: -------------------------------------------------------------------------- Hostname: host1 Model: m320 JUNOS Base OS boot [9.0-20071211.2] JUNOS Base OS Software Suite [9.0-20071211.2] JUNOS Kernel Software Suite [9.0-20071211.20] JUNOS Crypto Software Suite [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M320) [9.0-20071211.2] JUNOS Online Documentation [9.0-20071211.2] JUNOS Routing Software Suite [9.0-20071211.2]
- On the master Routing Engine, issue the request system software in-service-upgrade package-name reboot command. The following example upgrades the current version to an
image of Junos OS, Release 9.0, that was built on January 14, 2008:
{master}user@host> request system software in-service-upgrade /var/tmp/jinstall-9.0-20080114.2-domestic-signed.tgz rebootISSU: Validating Image PIC 0/3 will be offlined (In-Service-Upgrade not supported) Do you want to continue with these actions being taken ? [yes,no] (no) yes ISSU: Preparing Backup RE Pushing bundle to re1 Checking compatibility with configuration Initializing... Using jbase-9.0-20080114.2 Verified manifest signed by PackageProduction_9_0_0 Using /var/tmp/jinstall-9.0-20080114.2-domestic-signed.tgz Verified jinstall-9.0-20080114.2-domestic.tgz signed by PackageProduction_9_0_0 Using jinstall-9.0-20080114.2-domestic.tgz Using jbundle-9.0-20080114.2-domestic.tgz Checking jbundle requirements on / Using jbase-9.0-20080114.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jkernel-9.0-20080114.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jcrypto-9.0-20080114.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jpfe-9.0-20080114.2.tgz Using jdocs-9.0-20080114.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jroute-9.0-20080114.2.tgz Verified manifest signed by PackageProduction_9_0_0 Hardware Database regeneration succeeded Validating against /config/juniper.conf.gz mgd: commit complete Validation succeeded Installing package '/var/tmp/jinstall-9.0-20080114.2-domestic-signed.tgz' ... Verified jinstall-9.0-20080114.2-domestic.tgz signed by PackageProduction_9_0_0 Adding jinstall... Verified manifest signed by PackageProduction_9_0_0 WARNING: This package will load JUNOS 9.0-20080114.2 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.0-20080114.2-domestic-signed.tgz ... Saving state for rollback ... 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: Backup RE Prepare Done 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 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 Installing package '/var/tmp/paKEuy' ... Verified jinstall-9.0-20080114.2-domestic.tgz signed by PackageProduction_9_0_0 Adding jinstall... Verified manifest signed by PackageProduction_9_0_0 WARNING: This package will load JUNOS 9.0-20080114.2 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.0-20080114.2-domestic-signed.tgz ... cp: /var/tmp/paKEuy is a directory (not copied). Saving state for rollback ... ISSU: Old Master Upgrade Done ISSU: IDLE Shutdown NOW! Reboot consistency check bypassed - jinstall 9.0-20080114.2 will complete installation upon reboot [pid 30227] *** FINAL System shutdown message from root@host *** System going down IMMEDIATELY Connection to host closed.When the new backup (old master) Routing Engine is rebooted, you are logged out from the router. - After waiting a few minutes, log in to the router again.
You are logged in to the new backup Routing Engine (re0). To verify that both Routing Engines have been upgraded, issue
the following command:
{backup}user@host> show version invoke-on all-routing-enginesre0: -------------------------------------------------------------------------- Hostname: host Model: m320 JUNOS Base OS boot [9.0-20080114.2] JUNOS Base OS Software Suite 9.0-20080114.2] JUNOS Kernel Software Suite [9.0-20080114.2] JUNOS Crypto Software Suite [9.0-20080114.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0-20080114.2] JUNOS Packet Forwarding Engine Support (M320) [9.0-20080114.2] JUNOS Online Documentation [9.0-20080114.2] JUNOS Routing Software Suite [9.0-20080114.2] re1: -------------------------------------------------------------------------- Hostname: host1 Model: m320 JUNOS Base OS boot [9.0-20080114.2] JUNOS Base OS Software Suite [9.0-20080114.2] JUNOS Kernel Software Suite [9.0-20080114.2] JUNOS Crypto Software Suite [9.0-20080114.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0-20080114.2] JUNOS Packet Forwarding Engine Support (M320) [9.0-20080114.2] JUNOS Online Documentation [9.0-20080114.2] JUNOS Routing Software Suite [9.0-20080114.2]
- To make re0 the master Routing Engine, issue
the following command:
{backup}user@host> request chassis routing-engine master acquireAttempt to become the master routing engine ? [yes,no] (no) yes Resolving mastership... Complete. The local routing engine becomes the master. {master} user@host>if for any reason ISSU procedure stops progressing complete
open a new session on the master ROuting Engine and Issue the request system
software abort in-service-upgrade command
- Issue the request system snapshot command on each Routing Engine to back up the system software to
the router’s hard disk.Note: The root file system is backed up to
/altroot, and/configis backed up to/altconfig. After you issue the request system snapshot command, the router’s flash and hard disks are identical. You can return to the previous version of the software only by booting the router from removable media.
Upgrading Both Routing Engines and Rebooting the New Backup Routing Engine Manually
When you issue the request system software in-service-upgrade command without any options, the system upgrades and reboots the
new master Routing Engine to the newer software. The new software
is placed on the new backup (old master) Routing Engine; however,
to complete the upgrade, you must issue the request system reboot command on the new backup Routing Engine.
To perform a unified ISSU using the request system software in-service-upgrade package-name command without any options, complete the following steps:
- Download the software package from the Juniper Networks Support website, http://www.juniper.net/support/. Choose the Canada and U.S., Worldwide, or Junos-FIPS edition. Place the package on a local server. To download the package, you must have a service contract and an access account. If you do not have an access account, complete the registration form at the Juniper Networks website: https://www.juniper.net/registration/Register.jsp.
- Copy the package to the router. We recommend that you
copy it to the
/var/tmpdirectory, which is a large file system on the hard disk.user@host>file copy ftp://username:prompt@ftp.hostname.net/filename/var/tmp/filename - To verify the current software version running on both
Routing Engines, on the master Routing Engine, issue the show version invoke-on all-routing-engines command. The following
example shows that both Routing Engines are running Junos OS Release
9.0R1:
{master}user@host> show version invoke-on all-routing-enginesre0: -------------------------------------------------------------------------- Hostname: host Model: m320 JUNOS Base OS boot [9.0R1] JUNOS Base OS Software Suite [9.0R1] JUNOS Kernel Software Suite [9.0R1] JUNOS Crypto Software Suite [9.0R1] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0R1] JUNOS Packet Forwarding Engine Support (M320) [9.0R1] JUNOS Online Documentation [9.0R1] JUNOS Routing Software Suite [9.0R1] re1: -------------------------------------------------------------------------- Hostname: host1 Model: m320 JUNOS Base OS boot [9.0R1] JUNOS Base OS Software Suite [9.0R1] JUNOS Kernel Software Suite [9.0R1] JUNOS Crypto Software Suite [9.0R1] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0R1] JUNOS Packet Forwarding Engine Support (M320) [9.0R1] JUNOS Online Documentation [9.0R1] JUNOS Routing Software Suite [9.0R1]
- On the master Routing Engine, issue the request system software in-service-upgrade package-name command. The following example upgrades the current version to Junos
OS Release 9.0R1.2:
user@host> request system software in-service-upgrade /var/tmp/jinstall-9.0R1.2-domestic-signed.tgzISSU: Validating Image FPC 4 will be offlined (In-Service-Upgrade not supported) Do you want to continue with these actions being taken ? [yes,no] (no) yes ISSU: Preparing Backup RE Pushing bundle to re1 Checking compatibility with configuration Initializing... Using jbase-9.0-20080117.0 Verified manifest signed by PackageProduction_9_0_0 Using /var/tmp/jinstall-9.0R1.2-domestic-signed.tgz Verified jinstall-9.0R1.2-domestic.tgz signed by PackageProduction_9_0_0 Using jinstall-9.0R1.2-domestic.tgz Using jbundle-9.0R1.2-domestic.tgz Checking jbundle requirements on / Using jbase-9.0R1.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jkernel-9.0R1.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jcrypto-9.0R1.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jpfe-9.0R1.2.tgz Using jdocs-9.0R1.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jroute-9.0R1.2.tgz Verified manifest signed by PackageProduction_9_0_0 Hardware Database regeneration succeeded Validating against /config/juniper.conf.gz mgd: commit complete Validation succeeded Installing package '/var/tmp/jinstall-9.0R1.2-domestic-signed.tgz' ... Verified jinstall-9.0R1.2-domestic.tgz signed by PackageProduction_9_0_0 Adding jinstall... Verified manifest signed by PackageProduction_9_0_0 WARNING: This package will load JUNOS 9.0R1.2 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.0R1.2-domestic-signed.tgz ... Saving state for rollback ... 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: Backup RE Prepare Done 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 Online (ISSU) FPC 4 Offline Offlined by cli command FPC 5 Online (ISSU) Resolving mastership... Complete. The other routing engine becomes the master. ISSU: RE switchover Done ISSU: Upgrading Old Master RE Installing package '/var/tmp/paeBi5' ... Verified jinstall-9.0R1.2-domestic.tgz signed by PackageProduction_9_0_0 Adding jinstall... Verified manifest signed by PackageProduction_9_0_0 WARNING: This package will load JUNOS 9.0R1.2 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.0R1.2-domestic-signed.tgz ... cp: /var/tmp/paeBi5 is a directory (not copied). Saving state for rollback ... ISSU: Old Master Upgrade Done ISSU: IDLE
- Issue the show version invoke-on all-routing-engines command to verify that the new backup (old master) Routing Engine
(re0), is still running the previous software image, while
the new master Routing Engine (re1) is running the new
software image:
{backup}user@host> show versionre0: -------------------------------------------------------------------------- Hostname: user Model: m320 JUNOS Base OS boot [9.0R1] JUNOS Base OS Software Suite [9.0R1] JUNOS Kernel Software Suite [9.0R1] JUNOS Crypto Software Suite [9.0R1] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0R1] JUNOS Packet Forwarding Engine Support (M320) [9.0R1] JUNOS Online Documentation [9.0R1] JUNOS Routing Software Suite [9.0R1] labpkg [7.0] JUNOS Installation Software [9.0R1.2] re1: -------------------------------------------------------------------------- Hostname: user1 Model: m320 JUNOS Base OS boot [9.0R1.2] JUNOS Base OS Software Suite [9.0R1.2] JUNOS Kernel Software Suite [9.0R1.2] JUNOS Crypto Software Suite [9.0R1.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0R1.2] JUNOS Packet Forwarding Engine Support (M320) [9.0R1.2] JUNOS Online Documentation [9.0R1.2] JUNOS Routing Software Suite [9.0R1.2]
- At this point, if you choose not to install the newer software version on the new backup Routing Engine (re1), you can issue the request system software delete jinstall command on it. Otherwise, to complete the upgrade, go to the next step.
- Reboot the new backup Routing Engine (re0)
by issuing the request system reboot command:
{backup}user@host> request system rebootReboot the system ? [yes,no] (no) yes Shutdown NOW! Reboot consistency check bypassed - jinstall 9.0R1.2 will complete installation upon reboot [pid 6170] {backup} user@host> System going down IMMEDIATELY Connection to host closed by remote host. Connection to host closed.If you are not on the console port, you are disconnected from the router session. - After waiting a few minutes, log in to the router again.
You are logged in to the new backup Routing Engine (re0). To verify that both Routing Engines have been upgraded, issue
the following command:
{backup}user@host> show version invoke-on all-routing-enginesre0: -------------------------------------------------------------------------- Hostname: host Model: m320 JUNOS Base OS boot [9.0R1.2] JUNOS Base OS Software Suite [9.0R1.2] JUNOS Kernel Software Suite [9.0R1.2] JUNOS Crypto Software Suite [9.0R1.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0R1.2] JUNOS Packet Forwarding Engine Support (M320) [9.0R1.2] JUNOS Online Documentation [9.0R1.2] JUNOS Routing Software Suite [9.0R1.2] re1: -------------------------------------------------------------------------- Hostname: host1 Model: m320 JUNOS Base OS boot [9.0R1.2] JUNOS Base OS Software Suite [9.0R1.2] JUNOS Kernel Software Suite [9.0R1.2] JUNOS Crypto Software Suite [9.0R1.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0R1.2] JUNOS Packet Forwarding Engine Support (M320) [9.0R1.2] JUNOS Online Documentation [9.0R1.2] JUNOS Routing Software Suite [9.0R1.2]
- To make re0 the master Routing Engine, issue
the following command:
{backup}user@host> request chassis routing-engine master acquireAttempt to become the master routing engine ? [yes,no] (no) yes Resolving mastership... Complete. The local routing engine becomes the master. {master} user@host> - Issue the request system snapshot command on each Routing Engine to back up the system software to
the router’s hard disk.Note: The root file system is backed up to
/altroot, and/configis backed up to/altconfig. After you issue the request system snapshot command, the router’s flash and hard disks are identical. You can return to the previous version of the software only by booting the router from removable media.
Upgrading and Rebooting Only One Routing Engine
When you issue the request system software in-service-upgrade command with the no-old-master-upgrade option, the system
upgrades and reboots only the new master Routing Engine. To upgrade
the new backup (former master) Routing Engine, you must issue the request system software add command.
To perform a unified ISSU using the request system software in-service-upgrade package-name no-old-master-upgrade commands, complete the following steps:
- Download the software package from the Juniper Networks Support website, http://www.juniper.net/support/. Choose the Canada and U.S., Worldwide, or Junos-FIPS edition. Place the package on a local server. To download the package, you must have a service contract and an access account. If you do not have an access account, complete the registration form at the Juniper Networks website: https://www.juniper.net/registration/Register.jsp.
- Copy the package to the router. We recommend that you
copy it to the
/var/tmpdirectory, which is a large file system on the hard disk.user@host>file copy ftp://username:prompt@ftp.hostname.net/filename/var/tmp/filename - To verify the current software version running on both
Routing Engines, on the master Routing Engine issue the show version invoke-on all-routing-engines command. The following
example shows that both Routing Engines are running an image of Junos
OS Release 9.0 that was built on December 11, 2007:
{backup}user@host> show version invoke-on all-routing-enginesre0: -------------------------------------------------------------------------- Hostname: host Model: m320 JUNOS Base OS boot [9.0-20071211.2] JUNOS Base OS Software Suite 9.0-20071211.2] JUNOS Kernel Software Suite [9.0-20071211.2] JUNOS Crypto Software Suite [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M320) [9.0-20071211.2] JUNOS Online Documentation [9.0-20071211.2] JUNOS Routing Software Suite [9.0-20071211.2] re1: -------------------------------------------------------------------------- Hostname: host1 Model: m320 JUNOS Base OS boot [9.0-20071211.2] JUNOS Base OS Software Suite [9.0-20071211.2] JUNOS Kernel Software Suite [9.0-20071211.20] JUNOS Crypto Software Suite [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M/T Common) [9.0-20071211.2] JUNOS Packet Forwarding Engine Support (M320) [9.0-20071211.2] JUNOS Online Documentation [9.0-20071211.2] JUNOS Routing Software Suite [9.0-20071211.2]
- On the master Routing Engine, issue the request system software in-service-upgrade package-name no-old-master-upgrade command. The following example upgrades the current version to an
image of Junos OS Release 9.0 that was built on January 16, 2008:
{master}user@host> request system software in-service-upgrade /var/tmp/jinstall-9.0-20080116.2-domestic-signed.tgz no-old-master-upgradeISSU: Validating Image ISSU: Preparing Backup RE Pushing bundle to re1 Checking compatibility with configuration Initializing... Using jbase-9.0-20080116.2 Verified manifest signed by PackageProduction_9_0_0 Using /var/tmp/jinstall-9.0-20080116.2-domestic-signed.tgz Verified jinstall-9.0-20080116.2-domestic.tgz signed by PackageProduction_9_0_0 Using jinstall-9.0-20080116.2-domestic.tgz Using jbundle-9.0-20080116.2-domestic.tgz Checking jbundle requirements on / Using jbase-9.0-20080116.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jkernel-9.0-20080116.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jcrypto-9.0-20080116.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jpfe-9.0-20080116.2.tgz Using jdocs-9.0-20080116.2.tgz Verified manifest signed by PackageProduction_9_0_0 Using jroute-9.0-20080116.2.tgz Verified manifest signed by PackageProduction_9_0_0 Hardware Database regeneration succeeded Validating against /config/juniper.conf.gz mgd: commit complete Validation succeeded Installing package '/var/tmp/jinstall-9.0-20080116.2-domestic-signed.tgz' ... Verified jinstall-9.0-20080116.2-domestic.tgz signed by PackageProduction_9_0_0 Adding jinstall... Verified manifest signed by PackageProduction_9_0_0 WARNING: This package will load JUNOS 9.0-20080116.2 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.0-20080116.2-domestic-signed.tgz ... Saving state for rollback ... 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: Backup RE Prepare Done 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 Online (ISSU) FPC 5 Online (ISSU) Resolving mastership... Complete. The other routing engine becomes the master. ISSU: RE switchover Done Skipping Old Master Upgrade ISSU: IDLE {backup} user@host> - You are now logged in to the new backup (old master Routing Engine). If you want to install the new software version on the new backup Routing Engine, issue the request system software add /var/tmp/jinstall-9.0-20080116.2-domestic-signed.tgz command.
