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.

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 switches, enable nonstop active routing (NSR) and nonstop bridging (NSB).

On QFX5200 switches, non-stop 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 the 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.

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 Feature Guide.

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

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

For more information, see the High Availability Feature 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)

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