Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

request system software add

 

List of Syntax

Syntax

Syntax (EX Series Switches)

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Syntax (MX Series Router)

Syntax (QFX Series)

Syntax (OCX Series)

Syntax (Junos OS Evolved)

Syntax

Syntax (EX Series Switches)

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Syntax (MX Series Router)

Syntax (QFX Series)

Syntax (OCX Series)

Syntax (Junos OS Evolved)

Release Information

Command introduced before Junos OS Release 7.4.

best-effort-load and unlink options added in Junos OS Release 7.4.

Command introduced in Junos OS Release 9.0 for EX Series switches.

sfc option introduced in Junos OS Release 9.6 for the TX Matrix Plus router.

Command introduced in Junos OS Release 11.1 for the QFX Series.

set [package-name1 package-name2] option added in Junos OS Release 11.1 for EX Series switches. Added in Junos OS Release 12.2 for M Series, MX Series, and T Series routers.

Note

On EX Series switches, the set [package-name1 package-name2] option allows you to install only two software packages on a mixed EX4200 and EX4500 Virtual Chassis, whereas, on M Series, MX Series, and T Series routers, the set [package-name1 package-name2 package-name3] option allows you to install multiple software packages and software add-on packages at the same time.

upgrade-with-config and upgrade-with-config-format format options added in Junos OS Release 12.3 for M Series routers, MX Series routers, and T Series routers, EX Series Ethernet switches, and QFX Series devices.

Command introduced in Junos OS Release 14.1X53-D20 for the OCX Series.

device-alias, satellite, upgrade-group, and version options introduced in Junos OS Release 14.2R3 for Junos Fusion.

validate-on-host and validate-on-routing-engine options added in Junos OS Release 15.1F3 for PTX5000 routers and MX240, MX480, and MX960 routers.

upgrade-with-config-format format option deleted in Junos OS Release 16.1 for M Series routers, MX Series routers, and T Series routers, EX Series Ethernet switches, and QFX Series devices.

The following options are deprecated in Junos OS Evolved Release 18.3R1: best-effort-load, delay-restart, no-copy, on-primary, (re0 | re1), set, unlink, validate, validate-on-host, and validate-on-routing-engine.

Description

For Junos OS Evolved, the request system software add command has a built-in feature not to start the upgrade if a reboot is pending after an upgrade or rollback.

Note

We recommend that you always download the software image to /var/tmp only. On EX Series and QFX Series switches, you must use the /var/tmp directory. Other directories are not supported.

Install a software package or bundle on the router or switch.

For information on valid filename and URL formats, see Format for Specifying Filenames and URLs in Junos OS CLI Commands.

Caution

Any configuration changes performed after inputting the request system software add command will be lost when the system reboots with an upgraded version of Junos OS.

Note

Starting from Junos OS Release 17.2R1, PTX10008 routers do not support the request system software add command. Starting from Junos OS Release 17.4R1, PTX10016 routers do not support the request system software add command. Use the request vmhost software add command instead of the request system software add command on the PTX10008 and PTX10016 routers to install or upgrade the Junos OS software package or bundle on the router. See request vmhost software add.

Note

When graceful Routing Engine switchover (GRES) is enabled on a device, you must perform a unified in-service software upgrade (ISSU) operation to update the software running on the device. With GRES enabled, if you attempt to perform a software upgrade by entering the request system software add package-name command, an error message is displayed stating that only in-service software upgrades are supported when GRES is configured. In such a case, you must either remove the GRES configuration before you attempt the upgrade or perform a unified ISSU.

Note

Starting with Junos OS Release 15.1F3, the statement request system software add installs a software package for the guest OS only for the PTX5000 router with RE-DUO-C2600-16G, and for MX240, MX480, and MX960 routers with RE-S-1800X4-32G-S.

Starting with Junos OS Release 15.1F5, the statement request system software add installs a software package for the guest OS only for the MX2010 and MX2020 routers with REMX2K-1800-32G-S.

On these routers, in order to install both Junos software and host software packages, use the request vmhost software add command.

Options

package-nameLocation from which the software package or bundle is to be installed.
Note

In Junos OS, package-name can be either the URL of a remote location or the pathname of a local package. But Junos OS Evolved does not support a remote iso for upgrade, so “URL” is removed from the help string in the CLI.

For example:

  • /var/tmp/package-name—For a software package or bundle that is being installed from a local directory on the router or switch.

  • 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.

      Use ftp://hostname/pathname/package-name. To specify authentication credentials, use ftp://<username>:<password>@hostname/pathname/package-name. To have the system prompt you for the password, specify prompt in place of the password. If a password is required, and you do not specify the password or prompt, an error message is displayed.

    • http—Hypertext Transfer Protocol.

      Use http://hostname/pathname/package-name. To specify authentication credentials, use http://<username>:<password>@hostname/pathname/package-name. If a password is required and you omit it, you are prompted for it.

    • scp—Secure copy (not available for limited editions).

      Use scp://hostname/pathname/package-name. To specify authentication credentials, use scp://<username>:<password>@hostname/pathname/package-name.

Note
  • The pathname in the protocol is the relative path to the user’s home directory on the remote system and not the root directory.

  • Do not use the scp protocol in the request system software add command to download and install a software package or bundle from a remote location. The previous statement does not apply to the QFabric switch. The software upgrade is handled by the management process (mgd), which does not support scp.

    Use the file copy command to copy the software package or bundle from the remote location to the /var/tmp directory on the hard disk:

    file copy scp://source/package-name /var/tmp

    Then install the software package or bundle using the request system software add command:

    request system software add /var/tmp/package-name

best-effort-load(Optional) Activate a partial load and treat parsing errors as warnings instead of errors.
component all(QFabric systems only) (Optional) Install the software package on all of the QFabric components.
delay-restart(Optional) Install a software package or bundle, but do not restart software processes.
device-alias alias-name(Junos Fusion only) (Optional) Install the satellite software package onto the specified satellite device using the satellite device’s alias name.
force(Optional) Force the addition of the software package or bundle (ignore warnings).
force-host(Optional) Force the addition of the host software package or bundle (ignore warnings) on the QFX5100 device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) In a routing matrix based on the TX Matrix router, install a software package or bundle on a T640 router that is connected to the TX Matrix router. In a routing matrix based on the TX Matrix Plus router, install a software package or bundle on a router that is connected to the TX Matrix Plus router.

Replace number with the following values depending on the LCC configuration:

  • 0 through 3, when T640 routers are connected to a TX Matrix router in a routing matrix.

  • 0 through 3, when T1600 routers are connected to a TX Matrix Plus router in a routing matrix.

  • 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.

  • 0, 2, 4, or 6, when T4000 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.

member member-id(MX Series routers only) (Optional) Install a software package on the specified Virtual Chassis member. Replace member-id with a value of 0 or 1.
partition (QFX3500 switches only) (Optional) Format and repartition the media before installation.
satellite slot-id(Junos Fusion only) (Optional) Install the satellite software package onto the specified satellite device using the satellite devices FPC slot identifier.
scc(TX Matrix routers only) (Optional) Install a software package or bundle on a Routing Engine on a TX Matrix router (or switch-card chassis).
sfc number(TX Matrix Plus routers only) (Optional) Install a software package or bundle on a Routing Engine on a TX Matrix Plus router. Replace number with 0.
no-copy(Optional) Install a software package or bundle, but do not save copies of the package or bundle files.
no-validate(Optional) When loading a software package or bundle with a different release, suppress the default behavior of the validate option.
Note

Software packages from unidentified providers cannot be loaded. To authorize providers, include the provider-id statement at the [edit system extensions provider] hierarchy level.

re0 | re1(Optional) On routers or switches that support dual or redundant Routing Engines, load a software package or bundle on the Routing Engine in slot 0 (re0) or the Routing Engine in slot 1 (re1).
reboot(Optional) After adding the software package or bundle, reboot the system. On a QFabric switch, the software installation is not complete until you reboot the component for which you have installed the software.
restart(Optional) (For Junos OS Evolved only) This option allows you to upgrade the system using an application-level restart, that is, no system reboot. First the system determines how many applications need to restart (start with a new version), and then, after sending output to the CLI session, it restarts those applications. Restarted applications resync their state from the system. You can perform a dry run by using the request system software validate-restart command before using the request system software add restart command.
set [package-name1 package-name2](Mixed EX4200 and EX4500 Virtual Chassis, M Series, MX Series, and T Series routers only) (Optional) Install multiple packages at same time:
  • In the case of mixed EX4200 and EX4500 Virtual Chassis, install two software packages—a package for an EX4200 switch and the same release of the package for an EX4500 switch—to upgrade all member switches in a mixed EX4200 and EX4500 Virtual Chassis.

  • In the case of M Series, MX Series, and T Series routers, install multiple (two or more) software packages and software add-on packages at the same time. The variable package-name can either be a list of installation packages, each separated by a blank space, or the full URL to the directory or tar file containing the list of installation packages.

In each case, installation-package can either be a list of installation packages, each separated by a blank space, or the full URL to the directory or tar file containing the list of installation packages.

Use the request system software add set command to retain any SDK configuration by installing the SDK add-on packages along with the core Junos OS installation package.

unlink(Optional) On M Series, T Series, and MX Series routers, use the unlink option to remove the software package from this directory after a successful upgrade is completed.
upgrade-group [ all |upgrade-group-name](Junos Fusion only) (Required to configure a Junos Fusion using autoconversion or manual conversion) Associate a satellite software image with a satellite software upgrade group. The satellite software package is associated with the specified satellite software upgrade group using the upgrade-group-name, or for all satellite software upgrade groups in a Junos Fusion when the all keyword is specified.

A satellite software upgrade group is a group of satellite devices in a Junos Fusion that are designated to upgrade to the same satellite software version using the same satellite software package. See Understanding Software in a Junos Fusion Provider Edge, Understanding Software in a Junos Fusion Enterprise, and Managing Satellite Software Upgrade Groups in a Junos Fusion.

upgrade-with-config(Optional) Install one or more configuration files.
Note

Configuration files specified with this option must have the extension .text or .xml and have the extension specified. Using the extension .txt will not work.

validate(Optional) Validate the software package or bundle against the current configuration as a prerequisite to adding the software package or bundle. This is the default behavior when the software package or bundle being added is a different release.
Note

The validate option only works on systems that do not have graceful-switchover (GRES) enabled. To use the validate option on a system with GRES, either disable GRES for the duration of the installation, or install using the command request system software in-service-upgrade, which requires nonstop active routing (NSR) to be enabled when using GRES.

validate-on-host hostname(Optional) Validate the software package by comparing it to the running configuration on a remote Junos OS host. Specify a host, replacing hostname with the remote hostname. You can optionally provide the username that will be used to log in to the remote host by specifying the hostname in the format user@hostname.
validate-on-routing-engine routing-engine(Optional) Validate the software bundle or package by comparing it to the running configuration on a Junos OS Routing Engine on the same chassis. Specify a Routing Engine, replacing routing-engine with the routing engine name.

Additional Information

Before upgrading the software on the router or switch, when you have a known stable system, issue the request system snapshot command to back up the software, including the configuration, to the /altroot and /altconfig file systems. After you have upgraded the software on the router or switch and are satisfied that the new package or bundle is successfully installed and running, issue the request system snapshot command again to back up the new software to the /altroot and /altconfig file systems.

Note

The request system snapshot command is currently not supported on the QFabric system. Also, you cannot add or install multiple packages on a QFabric system.

After you run the request system snapshot command, you cannot return to the previous version of the software because the running and backup copies of the software are identical.

If you are upgrading more than one package at the same time, delete the operating system package, jkernel, last. Add the operating system package, jkernel, first and the routing software package, jroute, last. If you are upgrading all packages at once, delete and add them in the following order:

By default, when you issue the request system software add package-name command on a TX Matrix master Routing Engine, all the T640 master Routing Engines that are connected to it are upgraded to the same version of software. If you issue the same command on the TX Matrix backup Routing Engine, all the T640 backup Routing Engines that are connected to it are upgraded to the same version of software.

Likewise, when you issue the request system software add package-name command on a TX Matrix Plus master Routing Engine, all the T1600 or T4000 master Routing Engines that are connected to it are upgraded to the same version of software. If you issue the same command on the TX Matrix Plus backup Routing Engine, all the T1600 or T4000 backup Routing Engines that are connected to it are upgraded to the same version of software.

Before installing software on a device that has one or more custom YANG data models added to it, back up and remove the configuration data corresponding to the custom YANG data models from the active configuration. For more information see Managing YANG Packages and Configurations During a Software Upgrade or Downgrade.

Required Privilege Level

maintenance

List of Sample Output

request system software add validate

request system software add /var/tmp/ no-validate

request system software add no-copy no-validate reboot

request system software add validate-on-host

request system software add (Mixed EX4200 and EX4500 Virtual Chassis)

request system software add component all (QFabric Systems)

request system software add upgrade-group (Junos Fusion)

request system software add restart (Junos OS Evolved)

Output Fields

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

Sample Output

request system software add validate

user@host> request system software add validate /var/tmp/ jinstall-7.2R1.7-domestic-signed.tgz

request system software add /var/tmp/ no-validate

user@host> request system software add no-validate /var/tmp/junos-install-mx-x86-32-15.1R1.9.tgz

request system software add no-copy no-validate reboot

user@host> request system software add no-copy no-validate junos-install-srx-x86-64-17.3R1.tgz reboot

request system software add validate-on-host

user@host> request system software add validate-on-host user@xyz :/var/tmp/jinstall-15.1-20150516_ib_15_2_psd.0-domestic-signed.tgz

request system software add (Mixed EX4200 and EX4500 Virtual Chassis)

user@switch> request system software add set [/var/tmp/jinstall-ex-4200-11.1R1.1-domestic-signed.tgz /var/tmp/jinstall-ex-4500-11.1R1.1-domestic-signed.tgz]

request system software add component all (QFabric Systems)

user@switch> request system software add /pbdata/packages/jinstall-qfabric-12.2X50-D1.3.rpm component all

request system software add upgrade-group (Junos Fusion)

user@aggregation-device> request system software add /var/tmp/satellite-3.0R1.1-signed.tgz upgrade-group group1

request system software add restart (Junos OS Evolved)

user@device> request system software add restart /var/tmp/qfx-ms-fixed-1-target1-ifmanarpcos.iso
user@device> request system software add restart /var/tmp/qfx-ms-fixed-1-target2-ifmanarpcossysman.iso
user@device> request system software add restart /var/tmp/qfx-ms-fixed-1-target3-ifmanarpcossysmanimgdorchd.iso