Location 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 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 (available only for Canada and U.S. version).
    Use scp://hostname/pathname/package-name. To specify authentication credentials, use scp://<username>:<password>@hostname/pathname/package-name.

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 MGD process 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 On a J Series Services Router, when you install the software from a remote location, the package is removed at the earliest opportunity in order to make room for the installation to be completed. If you copy the software to a local directory on the router and then install the new package, use the unlink option to achieve the same effect and allow the installation to be completed.

(Optional) Activate a partial load and treat parsing errors as warnings instead of errors.

(QFabric systems only) (Optional) Install software package on all of the QFabric components.

(Optional) Install a software package or bundle, but do not restart software processes.

(Optional) Force the addition of the software package or bundle (ignore warnings).

(TX Matrix 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 (or line-card chassis) 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 T1600 router (or line-card chassis) that is connected to the TX Matrix Plus router. Replace number with a value from 0 through 3.

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

(QFX3500 switches only) (Optional) Format and repartition the media before installation.

(TX Matrix routers only) (Optional) Install a software package or bundle on a Routing Engine on a TX Matrix router (or switch-card chassis).

(TX Matrix Plus routers only) (Optional) Install a software package or bundle on a Routing Engine on a TX Matrix Plus router (or switch-fabric chassis). Replace number with 0.

(Optional) Install a software package or bundle, but do not save copies of the package or bundle files.

(Optional) When loading a software package or bundle with a different release, suppress the default behavior of the validate option.

(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).

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

(Mixed EX4200 and EX4500 Virtual Chassis only) (Optional) 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.

(M Series, MX Series, T Series routers, and Branch SRX Series Services Gateways only) (Optional) Install multiple software packages and software add-on packages at the same time.

(Optional) On J Series Services Routers, this option ensures that the software package is removed at the earliest opportunity in order to make room for the installation to be completed. 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.

(Optional) Install one or more configuration files.

(Optional) Specify the configuration file fomat, text or xml. The default format is text.

Note: The upgrade-with-config and upgrade-with-config-format options are only available locally on the router or switch. In a routing matrix, the configuration is applied only to the local router and is not propagated to other routers. The options are validated during the validation process and applied to the router or switch during the upgrade process. If the upgrade process is successful, the options are removed from the configuration. If the upgrade process fails, the configuration file is renamed with the .failed suffix.