Rate and give feedback:  Feedback Received. Thank You!

Rate and give feedback: 

X

This document helped resolve my issue

Yes No

Additional Comments

800 characters remaining

May we contact you if necessary?

Name:  

E-mail: 

Enter a valid Email ID

Need product assistance? Contact Juniper Support

Submit

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply.

English  

English

Upgrading Software Packages

Note: When you install individual software packages, the following notes apply: When upgrading from Junos OS Release 8.2 or earlier to Junos OS Release 8.5, use the system software add <image> no-validate command option. Only use the jinstall Junos OS image when upgrading or downgrading to or from Junos OS Release 8.5. Do not use the jbundle image. Before upgrading to Junos OS Release 8.5, ensure that the routing platform’s CompactFlash card is 256 MB or larger to avoid disk size restrictions. (M7i routers without a CompactFlash card are excluded.)

1. Download the software packages you need from the Juniper Networks Support Web site at https://www.juniper.net/support/. For information about downloading software packages, see Downloading Software.

   Note: We recommend that you upgrade all individual software packages using an out-of-band connection from the console or management Ethernet interface, because in-band connections can be lost during the upgrade process.

2. Back up the currently running and active file system so that you can recover to a known, stable environment in case something goes wrong with the upgrade:
   user@host> request system snapshot

   The root file system is backed up to /altroot, and /config is backed up to /altconfig. The root and /config file systems are on the router’s CompactFlash card, and the /altroot and /altconfig file systems are on the router’s hard disk or solid-state drive (SSD).

   Note: After you issue the request system snapshot command, you cannot return to the previous version of the software, because the running copy and the backup copy of the software are identical.

3. If you are copying multiple software packages to the router, copy them to the /var/tmp directory on the hard disk or solid-state drive (SSD):
   user@host> file copy ftp://username :prompt@ftp.hostname .net/filename/var/tmp/filename
4. Add the new software package:
   • To add an individual software package:
     user@host> request system software add/var/tmp/ installation-package validate

     installation-package is the full URL to the file.

     If you are upgrading more than one package at the same time, add jbase first. If you are using this procedure to upgrade all packages at once, add them in the following order:

     user@host> request system software add /var/tmp/jbase-release-signed.tgz
     user@host> request system software add /var/tmp/jkernel-release-signed.tgz
     user@host> request system software add /var/tmp/jpfe-release-signed.tgz
     user@host> request system software add /var/tmp/jdocs-release- signed.tgz
     user@host> request system software add /var/tmp/jweb-release- signed.tgz
     user@host> request system software add /var/tmp/jroute-release-signed.tgz
     user@host> request system software add /var/tmp/jcrypto-release-signed.tgz
   • For M Series, MX Series, and T Series routers and Branch SRX Series firewall filters running Junos OS Release 12.2 and above, you can add more than one software package at the same time. To add multiple software packages:
     user@host> request system software add set /var/tmp/ installation-package/var/tmp/ installation-package validate

     installation-package can be any of the following:

     • A list of installation packages, each separated by a blank space. For example,
       user@host> request system software add set /var/tmp/ jinstall-10.2R1.8–domestic-signed.tgz /var/tmp/ jtools*.tgz validate
     • 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.

   Warning: Do not include the re0 | re1 option when you install a package using the request system software add command, if the Routing Engine on which the package is located and the Routing Engine on which you want to install the package are the same. In such cases, the package gets deleted after a successful upgrade.

   The system might display the following message:

   pkg_delete: couldn’t entirely delete package

   This message indicates that someone manually deleted or changed an item that was in a package. You do not need to take any action; the package is still properly deleted.

   For more information about the request system software add command, see the Junos OS System Basics and Services Command Reference .

5. Reboot the router to start the new software:
   user@host> request system reboot
6. After you have upgraded or downgraded the software and are satisfied that the new software is successfully running, issue the request system snapshot command to back up the new software:
   user@host> request system snapshot

   Note: On an ACX router, you must issue the request system snapshot slice alternate command.

   The root file system is backed up to /altroot, and /config is backed up to /altconfig. The root and /config file systems are on the router’s CompactFlash card, and the /altroot and /altconfig file systems are on the router’s hard disk or solid-state drive (SSD).

   Note: After you issue the request system snapshot command, you cannot return to the previous version of the software, because the running copy and backup copy of the software are identical.