Supported Platforms
Related Documentation
- EX Series, QFX Series standalone switches
- Understanding In-Service Software Upgrade (ISSU)
- EX, J, M, MX, PTX, T Series, QFX Series standalone switches
- request system software in-service-upgrade
Performing an In-Service Software Upgrade (ISSU)
You can use an in-service software upgrade to upgrade the software running on the switch with minimal traffic disruption during the upgrade.
![]() | Note: ISSU is supported in Junos OS Release 13.2X51-D15 and later on QFX5100 switches, and in Junos OS Release 13.2X51-D25 and later on EX4600 switches. |
This topic covers:
Preparing the Switch for Software Installation
Before you begin software installation using ISSU:
![]() | Note: Before you perform an in-service software upgrade, if applicable, remove the set system internet-options no-tcp-reset drop-all-tcp command from the configuration, otherwise the upgrade will fail and an error message will be displayed. |
- Ensure that nonstop active routing (NSR) and nonstop bridging
(NSB) are enabled. If enabled, disable graceful restart (GR), because NSR and GR cannot be enabled simultaneously.
NSB and GR enable NSB-supported Layer 2 protocols to synchronize protocol information
between the master and backup Routing Engines.
If nonstop active routing is not enabled (Stateful Replication is Disabled), see Configuring Nonstop Active Routing on Switches for information on how to enable it.
- Enable nonstop bridging (NSB). See Configuring Nonstop Bridging on Switches (CLI Procedure) for information on how to enable it.
- (Optional) Back up the system software—Junos OS, the active configuration, and log files—on the switch to an external storage device with the request system snapshot command.
Upgrading the Software Using ISSU
This procedure describes how to upgrade the software running on a standalone switch:
![]() | Note: If the Host OS software needs to be updated, you cannot perform an ISSU. Instead, perform a standard software upgrade. |
To upgrade the switch using ISSU:
- Download the software package by following the procedure in the Downloading Software Files with a Browser section in Upgrading Software.
- Copy the software package or packages to the switch. We recommend that you copy the file to the /var/tmp directory.
- Log in to the console connection. Using a console connection allows you to monitor the progress of the upgrade.
- Start the ISSU:
- On the switch, enter:
user@switch> request system software in-service-upgrade /var/tmp/package-name.tgz
where package-name.tgz is, for example, jinstall-132_x51_vjunos.domestic.tgz.
Note: During the upgrade, you will not be able to access the Junos OS CLI.
The switch displays status messages similar to the following messages as the upgrade executes:
warning: Do NOT use /user during ISSU. Changes to /user during ISSU may get lost! ISSU: Validating Image ISSU: Preparing Backup RE Prepare for ISSU ISSU: Backup RE Prepare Done Extracting jinstall-qfx-5-13.2X51-D15.4-domestic ... Install jinstall-qfx-5-13.2X51-D15.4-domestic completed Spawning the backup RE Spawn backup RE, index 0 successful GRES in progress GRES done in 0 seconds Waiting for backup RE switchover ready GRES operational Copying home directories Copying home directories successful Initiating Chassis In-Service-Upgrade Chassis ISSU Started ISSU: Preparing Daemons ISSU: Daemons Ready for ISSU ISSU: Starting Upgrade for FRUs ISSU: FPC Warm Booting ISSU: FPC Warm Booted ISSU: Preparing for Switchover ISSU: Ready for Switchover Checking In-Service-Upgrade status Item Status Reason FPC 0 Online (ISSU) Send ISSU done to chassisd on backup RE Chassis ISSU Completed ISSU: IDLE Initiate em0 device handoff
Note: An ISSU might stop instead of abort if the FPC is at the warm boot stage. Also, any links that go down and up will not be detected during a warm boot of the Packet Forwarding Engine (PFE).
Note: If the ISSU process stops, you can look at the log files to diagnose the problem. The log files are located at /var/log/vjunos-log.tgz.
- On the switch, enter:
- Log in after the reboot of the switch completes. To verify
that the software has been upgraded, enter the following command:user@switch> show version
- Disable nonstop active routing (NSR) and enable graceful restart (GR).
See Configuring Nonstop Active Routing on Switches for more information.
Related Documentation
- EX Series, QFX Series standalone switches
- Understanding In-Service Software Upgrade (ISSU)
- EX, J, M, MX, PTX, T Series, QFX Series standalone switches
- request system software in-service-upgrade
Modified: 2015-11-04
Supported Platforms
Related Documentation
- EX Series, QFX Series standalone switches
- Understanding In-Service Software Upgrade (ISSU)
- EX, J, M, MX, PTX, T Series, QFX Series standalone switches
- request system software in-service-upgrade