- request system software add package-name
- <best-effort-load>
- <delay-restart>
- <force>
- <no-copy>
- <no-validate>
- <reboot>
- <unlink>
- <validate>
- request system software add package-name
- <best-effort-load>
- <delay-restart>
- <force>
- <lcc number | scc>
- <no-copy>
- <no-validate>
- <re0 | re1>
- <reboot>
- <unlink>
- <validate>
Command introduced before JUNOS Release 7.4.
best-effort-load and unlink options added in JUNOS Release 7.4.
Install a software package or bundle on the router.
package-name — Location from which the software package or bundle is to be installed. For example:
![]() |
|
best-effort-load — (Optional) Activate a partial load and treat parsing errors as warnings instead of errors.
delay-restart — (Optional) Install software package or bundle, but do not restart software processes.
force — (Optional) Force the addition of the software package or bundle (ignore warnings).
lcc number | scc — (Routing matrix only) (Optional) Install a software package or bundle on a T640 routing node (or line-card chassis) or on a Routing Engine on a TX Matrix platform (or switch-card chassis), respectively. Replace number with a value from 0 through 3.
no-copy — (Optional) Install a software package or bundle, but do not save copies of 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.
re0 | re1 — (Routing matrix only) Load a software package or bundle on a particular Routing Engine.
reboot — (Optional) After adding the software package or bundle, reboot the system.
unlink — (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 and T-series routers, use the unlink option to remove the software package from this directory after a successful upgrade is completed.
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.
Before upgrading the software on the router, 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 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.
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:
- user@host> request system software add /var/tmp/jbase
- user@host> request system software add /var/tmp/jkernel
- user@host> request system software add /var/tmp/jpfe
- user@host> request system software add /var/tmp/jdocs
- user@host> request system software add /var/tmp/jroute
- user@host> request system software add /var/tmp/jcrypto
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.
maintenance
request system software delete
request system software rollback
request system software validate
request system storage cleanup
When you enter this command, you are provided feedback on the status of your request.
user@host> request system software add validate
/var/tmp/ jinstall-7.2R1.7-domestic-signed.tgz
Checking compatibility with configuration Initializing... Using jbase-7.1R2.2 Using /var/tmp/jinstall-7.2R1.7-domestic-signed.tgz Verified jinstall-7.2R1.7-domestic.tgz signed by PackageProduction_7_2_0 Using /var/validate/tmp/jinstall-signed/jinstall-7.2R1.7-domestic.tgz Using /var/validate/tmp/jinstall/jbundle-7.2R1.7-domestic.tgz Checking jbundle requirements on / Using /var/validate/tmp/jbundle/jbase-7.2R1.7.tgz Using /var/validate/tmp/jbundle/jkernel-7.2R1.7.tgz Using /var/validate/tmp/jbundle/jcrypto-7.2R1.7.tgz Using /var/validate/tmp/jbundle/jpfe-7.2R1.7.tgz Using /var/validate/tmp/jbundle/jdocs-7.2R1.7.tgz Using /var/validate/tmp/jbundle/jroute-7.2R1.7.tgz Validating against /config/juniper.conf.gz mgd: commit complete Validation succeeded Validating against /config/rescue.conf.gz mgd: commit complete Validation succeeded Installing package '/var/tmp/jinstall-7.2R1.7-domestic-signed.tgz' ... Verified jinstall-7.2R1.7-domestic.tgz signed by PackageProduction_7_2_0 Adding jinstall... WARNING: This package will load JUNOS 7.2R1.7 software. WARNING: It will save JUNOS configuration files, and SSH keys WARNING: (if configured), but erase all other files and information WARNING: stored on this machine. It will attempt to preserve dumps WARNING: and log files, but this can not be guaranteed. This is the WARNING: pre-installation stage and all the software is loaded when WARNING: you reboot the system. Saving the config files ... Installing the bootstrap installer ... WARNING: A REBOOT IS REQUIRED TO LOAD THIS SOFTWARE CORRECTLY. Use the WARNING: 'request system reboot' command when software installation is WARNING: complete. To abort the installation, do not reboot your system, WARNING: instead use the 'request system software delete jinstall' WARNING: command as soon as this operation completes. Saving package file in /var/sw/pkg/jinstall-7.2R1.7-domestic-signed.tgz ... Saving state for rollback ...