Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

request system software in-service-upgrade

 

Syntax

Syntax

Syntax (QFX Series)

Release Information

Command introduced in Junos OS Release 9.0.

Command introduced in Junos OS Release 12.3R2, 13.1R2, and 13.2R1 for TX Matrix Plus routers.

Command introduced in Junos OS Release 13.2 for PTX5000 routers.

Command introduced in Junos OS Release 13.2 X51-D15 for the QFX Series.

Command introduced in Junos OS Release 15.1X54-D60 for the ACX5000 line of routers.

status option introduced in Junos OS Release 19.4R1 for MX240, MX480, MX960, MX2010, MX2020, PTX3000, and PTX5000 routers.

Description

Perform a unified in-service software upgrade (ISSU). A unified ISSU enables you to upgrade from one Junos OS release to another with no disruption on the control plane and with minimal disruption of traffic.

On QFX5100 and QFX5200 switches, enable nonstop active routing (NSR) and nonstop bridging (NSB).

Options

package-nameLocation from which the software package or bundle is to be installed. For example:
  • /var/tmp/package-name— For a software package or bundle that is being installed from a local directory on the router.

  • protocol://hostname/pathname/package-name—For a software package or bundle that is to be downloaded and installed from a remote location. Replace protocol with one of the following:

    • ftp—File Transfer Protocol

    • http—Hypertext Transfer Protocol

    • scp—Secure copy (available only for Canada and U.S. version)

no-old-master-upgrade(Optional) When the no-old-master-upgrade option is included, after the backup Routing Engine is rebooted with the new software package and a switchover occurs to make it the new master Routing Engine, the former master (new backup) Routing Engine will not be upgraded to the new software. In this case, you must manually upgrade the former master (new backup) Routing Engine. If you do not include the no-old-master-upgrade option, the system will automatically upgrade the former master Routing Engine.
Note

This option is not available on QFX5100 and QFX5200 switches.

reboot(Optional) When the reboot option is included, the former master (new backup) Routing Engine is automatically rebooted after being upgraded to the new software. When the reboot option is not included, you must manually reboot the former master (new backup) Routing Engine using the request system reboot command.
Note

This option is not available on the QFX Series switches.

status(Optional) Starting in Junos OS Release 19.4R1, use this option to display the status of a unified ISSU during the upgrade. You will need to run this command on the Routing Engine where the ISSU was triggered to display the correct ISSU log file.
Note

This option is only available on MX240, MX480, MX960, MX2010, MX2020, PTX3000, and PTX5000 routers.

enhanced-mode(Optional) Starting in Junos OS Release 20.1R1, runs unified ISSU in enhanced mode, a mode of ISSU that eliminates packet loss during the unified ISSU process.
Note

This option is only available on MPC7E, MPC8E, and MPC9E line cards.

Additional Information

The following conditions apply to unified ISSUs:

  • Unified ISSU is not supported on every platform. For a list of supported platforms, see Unified ISSU System Requirements.

  • Unsupported PICs are restarted during a unified ISSU on certain routing devices. For information about supported PICs, see the High Availability User Guide.

  • Unsupported protocols will experience packet loss during a unified ISSU. For information about supported protocols, see the High Availability User Guide.

  • During a unified ISSU, you cannot bring any PICs online or offline on certain routing devices.

For more information, see the High Availability User Guide.

Required Privilege Level

view

List of Sample Output

request system software in-service-upgrade reboot

request system software in-service-upgrade reboot (TX Matrix Plus Router)

request system software in-service-upgrade (QFX5100 Switch)

request system software in-service-upgrade status

request system software in-service-upgrade enhanced-mode

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

request system software in-service-upgrade reboot

user@host> request system software in-service-upgrade /var/tmp/jinstall-9.0-20080114.2-domestic-signed.tgz reboot

request system software in-service-upgrade reboot (TX Matrix Plus Router)

user@host> request system software in-service-upgrade /var/tmp/jinstall-12.3R2-domestic-signed.tgz

request system software in-service-upgrade (QFX5100 Switch)

user@switch> request system software in-service-upgrade /var/tmp/jinstall-qfx-132_x51_vjunos.0-domestic.tgz

request system software in-service-upgrade status

user@host> request system software in-service-upgrade /var/tmp/jinstall-12.3R2-domestic-signed.tgz

request system software in-service-upgrade enhanced-mode

user@host> request system software in-service-upgrade /var/tmp/junos-install-mx-x86-32-20.1.tgz reboot enhanced-mode