3.6 JUNOS Software Upgrade Procedure

Juniper Networks releases several new versions of JUNOS software each year, as needed. This section will prepare you to perform a JUNOS software upgrade to the router.

Every JUNOS software release is actually a group of files bundled together. These files can be installed all at once or individually. Table 3-6 lists the files contained in the release.

Table 3-6. JUNOS Upgrade Software Release Files

Filename	Contents
jbase	Additions to JUNOS
jkernel	The operating system package
jroute	The routing engine software
jpfe	The PFE software
jdocs	Updated online reference documentation
jcrypto	Security software (U.S. domestic only)
jbundle	All of the files combined

To see the software that is currently installed on the router, use the following command:

 root@router> show system software  Information for jbase: Comment: JUNOS Base OS Software Suite [5.0R3.3] Information for jcrypto: Comment: JUNOS Crypto Software Suite [5.0R3.3] Information for jdocs: Comment: JUNOS Online Documentation [5.0R3.3] Information for jkernel: Comment: JUNOS Kernel Software Suite [5.0R3.3] Information for jpfe: Comment: JUNOS Packet Forwarding Engine Support [5.0R3.3] Information for jroute: Comment: JUNOS Routing Software Suite [5.0R3.3] Information for junos: Comment: JUNOS Base OS boot [5.0R3.3] 

To upgrade your software, there are several simple steps (following this list, we will explain each item in more detail):

1. Download the software package(s) you need from the Juniper Networks Web site.

2. Perform a system backup on the router you wish to upgrade.

3. Copy the software package(s) to the router you wish to upgrade.

4. Add the new software package(s) to the router you wish to upgrade (this will effectively delete the old packages).

5. Reboot the router.

3.6.1 Downloading the Software

When you download JUNOS software from the Juniper Networks Web site at www.juniper.net/support using your authorized username and password, you will notice that the packages use a standard naming convention. The format is package-x.yZnumber.tgz :

• Package is the name of the file (such as jbundle ).

• x.y is the software version.

• Z is the type of release. For most customers, this will be an R for released version. For some customers, it may be A (alpha release), B (beta release), or I (internal release).

• number is the software release number and build, if applicable .

3.6.2 Backing Up the System

You can create a recoverable snapshot of the current system, if it is stable, before proceeding. Using this command, however, will make the running and backup versions of the software identical and will mean that you cannot revert back to the original version that shipped with the router. To make the snapshot, use the following command:

 root@router# request system snapshot 

This will back up the /root file system to /altroot and the /config file system to /altconfig on the hard disk.

3.6.3 Copying the Package(s) to the Router

After you have backed up your system files, copy the new software bundle to the router's hard disk, using a command such as the following:

 root@router# file copy  ftp://  username:  prompt@ftp.  hostname.  net/  filename  /var/tmp/  filename  

This will copy the file from an FTP server to the /var/tmp directory on the router's hard disk. This is simply an example of one way to copy the file. The M40 also has an LS-120 floppy drive that can be used for the storage and transfer of files. When installing a new software version, you should do so from an out-of-band management source, such as the console. An in- band source, such as Telnet, could be lost while you are upgrading.

3.6.4 Adding the Package(s)

Once the files have been copied to the hard disk, upgrade the software using the following command:

 root@router>  request system software add  package-name   Checking available free disk space...11600k available, 6076k suggested... Installing package  '/var/tmp/jbundle-package-name' ...   Auto-deleting old jroute...  Auto-deleting old jdocs... Auto-deleting old jpfe... Auto-deleting old jkernel... Adding JUNOS base software release-number... Adding jkernel... Adding jpfe... Adding jdocs...  Adding jroute...  NOTICE: uncommitted changes have been saved in /var/db/config/juniper.conf.pre-install Saving package file in /var/sw/pkg/jbundle-  package-name  ... 

As you can see in the example, once you begin to install the new jbundle , the system deletes the old information and explodes (expands) the zipped files contained in the new bundle into the /var/sw/pkg/jbundle- package-name file.

3.6.5 Finishing the Upgrade

Once the software upgrade has completed, you should perform a system reboot. This is the last step in upgrading the JUNOS software package(s). Use the following command:

 root@router> request system reboot 

Note

Special instructions for upgrading to version 5.0 or reverting to an earlier release from version 5.0 are available on the Juniper Networks Web site at www.juniper.net/techpubs/software/junos50/swconfig50-getting-started/html/ getting-started -upgrade50.html#1017395.