Juniper Networks - SRX Getting Started - Junos Software Installation...

http://kb.juniper.net/InfoCenter/index?page=content&id=KB16652

Home > Support > KB Home

KB Home

Browse Knowledge Base Categories

Printer Friendly ASK THE KB Question or KB ID:

SRX Getting Started - Junos Software Installation/Upgrade

[KB16652] Show KB Properties

SUMMARY:
This article documents how to perform a Junos software installation or upgrade on SRX devices. For other topics, go to the SRX Getting Started main page. RELATED TOPICS Install Search Engine PlugIn Submit a Support Case KB Feedback

PROBLEM OR GOAL:
Junos software installation on SRX device Upgrade Junos on SRX

CAUSE: SOLUTION:
This sections contains the following: Download Software from Support site Software Installation Preparation Install Software via CLI (Method 1 - from software copied to SRX) Install Software via CLI (Method 2 - from software on FTP server) Install Software via CLI (Method 3 - from Junos software copied to USB stick) Install Software via J-Web Install Software via Bootloader (recovery method) Other Installation Methods Technical Documentation

Download Software from Support site

Download Junos software and Release Notes for the SRX from one of the following locations: Junos (US & Canada): Junos US/Canada Download Software Junos Worldwide: Junos Worldwide Download Software (Check 'notices' for SRX notifications.) Useful links: KB21476 - JTAC Recommended Junos Software Versions KB10911 - Understanding Junos software components and installation package names

Software Installation Preparation

1. Read the Release Notes, as they document new features, changes in default behavior, known limitations, and issues. A copy of the Release Notes are available at the following link: Junos Software for SRX Series Services Gateways Documentation . Click your Release version, and then click the Release Notes. Setup your connection to the SRX to log your session during the installation and through the reboot, as the transcript can provide valuable information if an issue happens and JTAC needs to review it. Confirm there are no uncommitted changes present because candidate changes are usually lost on a reboot. Enter the following command: user@srx# top user@srx# show | compare If the above command contains configuration information that you want to keep, then perform a commit.

2.

3.

4.

Backup your configuration, by logging your session while performing the following command. Keep it in a safe place. user@srx> show configuration | no-more

5.

If you want to backup the current Junos and configuration onto media (such as a USB/CF) so that it can be put back into the SRX if the SRX does not boot up and allow the SRX to boot up, refer to the following instructions: Backing Up the Current Installation. For example: a. Prepare USB Stick: KB10800 - How to format and mount a USB flash drive on a J-series or SRX device b. Save a snapshot from a running SRX to the USB Stick. Use the command: request system snapshot media usb

6.

If you are going to do a J-Web installation or copy the Junos software image to the SRX, then check the flash size and purge unused files: Check current Flash size: show system storage | match cf Purge logfiles: request system storage cleanup If Flashsize is still lower than the size of your image, then try the following: Clear files from the /var/log directory. Clear or remove any traceoptions files and clear any log files which are not needed. Note that you will loose all contents of the log file after a clear is done. clear log <log-filename> Purge software backup. Note that if you delete the backup software, you will not be able to rollback using the

1 of 3

18/06/2012 16:30

Juniper Networks - SRX Getting Started - Junos Software Installation...

http://kb.juniper.net/InfoCenter/index?page=content&id=KB16652

"request system software rollback" command. request system software delete-backup Locate directories on the flash with large amount of data show system directory-usage /cf To save space browse directories and erase files manually: Be careful with which file you choose to delete. file list /var/tmp file delete /var/tmp/xyz If you can't free up enough space, then refer to KB19466 - Common and safest files to remove in order to increase the system storage OR use CLI Installation Method 2 or 3 below. 7. Please note, for a Chassis cluster installation, a SRX with Redundant Routing Engines (JSRP), it is recommended to use CLI Installation Method 1 or 2. In Chassis cluster installation when the request system reboot command is executed it only affects the node on which this command is run. Both nodes of the cluster need to use the same hardware and release. In case of Chassis cluster upgrade we recommend to upgrade both the nodes followed by a reboot at the same time.

Install Software via CLI (Method 1 - from Junos software copied to SRX)
Refer to the following steps for copying the software to the SRX and then performing the software installation via the CLI: 1. Copy software to SRX via SCP or FTP to /var/tmp: For example: user@srx> scp junos-srxsme-10.0R2.10-domestic.tgz /tmp/junos-srxsme-10.0R2.10-domestic.tgz OR user@srx> user@srx> user@srx> user@srx> user@srx> 2. ftp <ip address of local ftp server> (and login) lcd /var/tmp bin get junos-srxsme-10.0R2.10-domestic.tgz bye user@srx:/var

Install software: Installing the Software For example: From the local file in /var/tmp user@srx> request system software add no-copy /var/tmp/junos-srxsme10.0R2.10-domestic.tgz user@srx> request system reboot

Install Software via CLI (Method 2 - from Junos software on FTP server)
In order to perform the software installation from the CLI via the software on a FTP server, follow the steps at Installing the Software EXCEPT use the syntax in the examples below for the 'request system software' commands: Two examples: Fetch from a FTP Server (user username) and reboot after update The no-copy option is used to save space. user@srx> request system software add no-copy ftp://username:password@172.16.1.1/junos-srxsme-10.0R2.10domestic.tgz user@srx> request system reboot Same example fetching from a FTP server with user anonymous If validation of configuration reports that your current config is not working with the new release (e.g. on downgrade), you can bypass this with the no-validate option. user@srx> request system software add no-copy no-validate ftp://172.16.1.1/junos-srxsme-10.0R2.10-domestic.tgz user@srx> request system reboot

Install Software via CLI (Method 3 - from Junos software copied to USB stick)
Refer to the following steps for performing the software installation via the CLI from a USB stick: 1. 2. Download the Junos upgrade file to the USB stick Locate the USB device ID that Junos is associating to the USB stick: user@srx> start shell user@srx% ls /dev/ 3. Insert the USB device into USB 0 slot. Then run the following command: user@srx% ls /dev/ Locate difference in outputs to locate drive label. (It will usually be da#s1, i.e. da0s1) 4. Create a mount directory: user@srx% mkdir /tmp/usb 5. Mount the USB to the directory: user@srx% mount -t msdosfs /dev/<drivelabel, e.g. #da0s1> /tmp/usb Example: user@srx% mount -t msdosfs /dev/da0s1 /tmp/usb (there is a space between the label name and /tmp) 6. Exit Shell and proceed with install software: user@srx% exit user@srx> request system software add /tmp/usb/<upgrade filename>

2 of 3

18/06/2012 16:30

Juniper Networks - SRX Getting Started - Junos Software Installation...

http://kb.juniper.net/InfoCenter/index?page=content&id=KB16652

no-validate no-copy For additional details regarding a software installation, refer to Installing the Software. 7. Upon completion, reboot the SRX: user@srx> request system reboot

Install Software via J-Web

Software installation via J-Web is the most simplest. However, it does require a minimum of 512MB compact flash and it is slower than the CLI methods. Refer to the following steps to install the software via J-Web: 1. 2. 3. Select Maintain > Software > Upload Package. Specify the 'File to Upload'. Then select the Upload and Install Package button to perform the installation.

For additional details regarding a software installation, refer to Installing Software Upgrades by Uploading Files on the SRX Series Services Gateways (J-Web Procedure).

Install Software via Bootloader

In the case that the kernal does not boot, either of these procedures can be performed to do an emergency software installation on SRX series devices: Note: The KB's below are valid only for Branch SRX devices. As of now, high-end SRX devices DO NOT support USB or TFTP installs from the loader. KB11752 - Installing Junos software from a TFTP server via Loader KB10386 - Boot from USB and Recovering from a Failed Software Upgrade

Other Installation Methods

For additional installation methods, refer to the following: KB17947 - How to upgrade SRX cluster with minimal downtime KB21637 - Detailed example of traffic loss and verification steps using SRX3000 series for KB17947 (Minimal downtime upgrade procedure) KB19576 - How to prepare an Emergency USB Boot Disk with install-media file for high-end SRX KB20959 - [ISSU] Overview and Procedural Steps for In-Service Software Upgrade KB23882 - USB autoinstallation on SRX Branch Platforms for Software upgrade/downgrade

Technical Documentation
For additional information not covered in this article, refer to the technical documentation: Junos 10.4 http://www.juniper.net/techpubs/software/junos-security/junos-security10.4/junos-security-adminguide/index.html?software-upgrade-chapter.html Junos 11.4 http://www.juniper.net/techpubs/en_US/junos11.4/information-products/pathway-pages/software-installation-and-upgrade /software-installation-and-upgrade.html#installation-and-upgrade

PURPOSE:
Configuration Implementation Installation

RELATED LINKS:

3 of 3

18/06/2012 16:30