Software for e series broadband services routers service availability configuration guide (222 pages)
Summary of Contents for Juniper JUNOS SOFTWARE 10.2 - SOFTWARE INSTALLATION AND UPGRADE GUIDE 4-28-2010
Page 1
JUNOS® Software Software Installation and Upgrade Guide Release 10.2 Juniper Networks, Inc. 1194 North Mathilda Avenue Sunnyvale, California 94089 408-745-2000 www.juniper.net Published: 2010-04-28...
Page 2
Products made or sold by Juniper Networks or components thereof might be covered by one or more of the following patents that are owned by or licensed to Juniper Networks: U.S. Patent Nos. 5,473,599, 5,905,725, 5,909,440, 6,192,051, 6,333,650, 6,359,479, 6,406,312, 6,429,706, 6,459,579, 6,493,347, 6,538,518, 6,538,899, 6,552,918, 6,567,902, 6,578,186, and 6,590,785.
Page 3
AND (B) YOU MAY CONTACT JUNIPER NETWORKS REGARDING LICENSE TERMS. 1. The Parties. The parties to this Agreement are (i) Juniper Networks, Inc. (if the Customer s principal office is located in the Americas) or Juniper Networks (Cayman) Limited (if the Customer s principal office is located outside the Americas) (such applicable entity being referred to herein as “Juniper”), and (ii) the person or organization that originally purchased from Juniper or an authorized Juniper reseller the applicable license(s) for use of the Software (“Customer”)
Page 4
(“GPL”) or the GNU Library General Public License (“LGPL”)), Juniper will make such source code portions (including Juniper modifications, as appropriate) available upon request for a period of up to three years from the date of distribution. Such request can be made in writing to Juniper Networks, Inc., 1194 http://www.gnu.org/licenses/gpl.html...
Page 5
agreements relating to the Software, whether oral or written (including any inconsistent terms contained in a purchase order), except that the terms of a separate written agreement executed by an authorized Juniper representative and Customer shall govern to the extent such terms are inconsistent or conflict with terms contained herein.
Page 7
Abbreviated Table of Contents About This Guide xvii Part 1 Introduction Chapter 1 Introduction to JUNOS Software Chapter 2 Hardware Architecture Part 2 JUNOS Software Installation Chapter 3 Installation Overview Chapter 4 Completing a Standard or Change Category Installation Chapter 5 Completing a Recovery Installation Part 3 JUNOS Software Licenses...
Table of Contents About This Guide xvii JUNOS Documentation and Release Notes ...........xvii Objectives ....................xvii Audience .....................xviii Supported Routing Platforms ..............xviii Documentation Conventions ................xix Documentation Feedback ................xx Requesting Technical Support ..............xxi Self-Help Online Tools and Resources ............xxi Opening a Case with JTAC ..............xxi Part 1 Introduction Chapter 1...
Page 10
JUNOS Release 10.2 Software Installation and Upgrade Guide Chapter 2 Hardware Architecture Hardware Architecture Overview ..............13 M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers ...14 Hardware Overview (M Series, MX Series, T Series, and TX Matrix Routers) ....................14 System Memory ................15 Storage Media ..................16...
Page 11
Table of Contents Backing Up the Current Installation (J Series Routers) ........33 Installing the Software Package on a Router with a Single Routing Engine ....................33 Installing the Software Package on a Router with Redundant Routing Engines ....................34 Preparing the Router for the Installation ..........35 Installing Software on the Backup Routing Engine ........36 Installing Software on the Primary Routing Engine .........37 Finalizing the Installation ................38...
Page 12
JUNOS Release 10.2 Software Installation and Upgrade Guide Saving License Keys ..................66 Verifying JUNOS Licenses ................66 Displaying Installed Licenses ..............66 Displaying License Usage ................67 Displaying Installed License Keys ............68 Part 4 Index Index ......................71 Table of Contents...
Page 13
List of Figures Part 1 Introduction Chapter 1 Introduction to JUNOS Software Figure 1: Configuration Selection Sequence ...........10 Chapter 2 Hardware Architecture Figure 2: Routing Engines ................15 Figure 3: J Series Routers (J4300 Shown) ............20 xiii List of Figures...
Page 14
JUNOS Release 10.2 Software Installation and Upgrade Guide List of Figures...
List of Tables About This Guide xvii Table 1: Notice Icons ..................xix Table 2: Text and Syntax Conventions ............xix Part 1 Introduction Chapter 2 Hardware Architecture Table 3: Routing Engines and Storage Media Names (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers) ........17 Table 4: Routing Engines and Storage Media Names (J Series Routers) ..21 Part 3 JUNOS Software Licenses...
Page 16
JUNOS Release 10.2 Software Installation and Upgrade Guide List of Tables...
If the information in the latest release notes differs from the information in the documentation, follow the JUNOS Release Notes. To obtain the most current version of all Juniper Networks® technical documentation, see the product documentation page on the Juniper Networks website at http://www.juniper.net/techpubs/...
Page 18
Audience This guide is designed for network administrators who are configuring and monitoring a Juniper Networks M Series, MX Series, T Series, EX Series, or J Series router or switch. To use this guide, you need a broad understanding of networks in general, the Internet in particular, networking principles, and network configuration.
About This Guide Documentation Conventions Table 1 on page xix defines notice icons used in this guide. Table 1: Notice Icons Icon Meaning Description Informational note Indicates important features or instructions. Caution Indicates a situation that might result in loss of data or hardware damage. Warning Alerts you to the risk of personal injury or death.
Page 20
JUNOS Release 10.2 Software Installation and Upgrade Guide Table 2: Text and Syntax Conventions (continued) Convention Description Examples Represents names of configuration To configure a stub area, include Plain text like this statements, commands, files, and stub statement at the [edit directories;...
7 days a week, 365 days a year. Self-Help Online Tools and Resources For quick and easy problem resolution, Juniper Networks has designed an online self-service portal called the Customer Support Center (CSC) that provides you with the following features: Find CSC offerings: http://www.juniper.net/customers/support/...
Page 22
JUNOS Release 10.2 Software Installation and Upgrade Guide For international or direct-dial options in countries without toll-free numbers, visit us at http://www.juniper.net/support/requesting-support.html xxii Requesting Technical Support...
Unlike other network operating systems that share a common name but splinter into many different programs, JUNOS Software is a single, cohesive operating system that is shared across all routers and product lines. This allows Juniper Networks JUNOS Software Overview...
Page 26
The JUNOS Software is preinstalled on your Juniper Networks router when you receive it from the factory. Thus, when you first power on the router, all software starts automatically.
For advanced network security, a special version of JUNOS, called JUNOS-FIPS 140-2, is available. JUNOS-FIPS 140-2 provides customers with software tools to configure a network of Juniper Networks routers in a FIPS environment. FIPS support includes: Upgrade package to convert JUNOS to JUNOS-FIPS 140-2...
JUNOS Release 10.2 Software Installation and Upgrade Guide NOTE: JUNOS-FIPS has special password requirements. FIPS passwords must be between 10 and 20 characters in length. Passwords must use at least three of the five defined character sets (uppercase letters, lowercase letters, digits, punctuation marks, and other special characters).
Chapter 1: Introduction to JUNOS Software The following installation media files are available for download: Installation Media Description JUNOS Software for the M40 router when you use the floppy1 <release>* LS-120 external drive. floppy2 <release>* JUNOS Software for the M Series, MX Series, T Series, TX install-media* Matrix, and TX Matrix Plus routers.
JUNOS Software Release Numbers The JUNOS Software release number represents a particular revision of the software that runs on a Juniper Networks routing platform, for example, JUNOS Release 8.5, 9.1, or 9.2. Each JUNOS Software release has certain new features that complement the software processes that support Internet routing protocols, control the router s interfaces and the router chassis itself, and allow router system management.
Chapter 1: Introduction to JUNOS Software is the build number of the product is the spin number of the product JUNOS Feature Licenses To enable some JUNOS Software features or router scaling levels, you may need to purchase, install, and manage separate software license packs. The presence, on the router, of the appropriate software license keys (passwords) determines whether you can configure and use certain features or configure a feature to a predetermined scale.
JUNOS Release 10.2 Software Installation and Upgrade Guide Figure 1: Configuration Selection Sequence /config/juniper.conf —Active configuration file. /config/rescue.conf —Rescue configuration file. This file is created by the router administrator. —First rollback configuration. /config/juniper.conf.1 —Default factory configuration file. /etc/config/factory.conf factory.conf file is the initial router configuration file shipped with the system. All configuration settings are returned to the factory default, and access to the router is restricted to the console.
Chapter 1: Introduction to JUNOS Software Automatic Installation of Configuration Files (J Series Routers) On J Series routers, you can specify a remote server where configuration files are located. If a configuration file cannot be found on the router s CompactFlash card, the router automatically retrieves the configuration file from this remote server.
Page 34
JUNOS Release 10.2 Software Installation and Upgrade Guide Automatic Installation of Configuration Files (J Series Routers)
Chapter 2 Hardware Architecture Hardware Architecture Overview on page 13 M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers on page 14 J Series Routers on page 19 Hardware Architecture Overview Juniper Network routing platforms are made up of two basic routing components: Routing Engine—The Routing Engine controls the routing updates and system management.
JUNOS Release 10.2 Software Installation and Upgrade Guide M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers The following topics give a brief overview of the M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus routers. Hardware Overview (M Series, MX Series, T Series, and TX Matrix Routers) on page 14 Routing Engines and Storage Media Names (M Series, MX Series, T Series, TX...
Chapter 2: Hardware Architecture Figure 2: Routing Engines The M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus routers include the following: System Memory on page 15 Storage Media on page 16 System Memory Starting with JUNOS Release 9.0, all routing platforms require a minimum of 512 MB of system memory on each Routing Engine.
JUNOS Release 10.2 Software Installation and Upgrade Guide For more information about upgrading your M7i or M10i router, see the Customer Support Center JTAC Technical Bulletin PSN-2007-10-001: https://www.juniper.net/alerts/viewalert.jsp?txtAlertNumber=PSN-2007-10-001&actionBtn=Search Storage Media Except for MX80 routers, the M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus routers use the following media storage devices: CompactFlash card—The CompactFlash card is typically the primary storage device.
Chapter 2: Hardware Architecture Table 3: Routing Engines and Storage Media Names (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers) CompactFlash Hard Removable Routing Engine Card Disk Media RE-400-768 (RE5) Supported platforms: M7i and M10i RE-600-2048 (RE3) Supported platforms: M20 and M40e...
JUNOS Release 10.2 Software Installation and Upgrade Guide NOTE: On MX80 routers, the Routing Engine is a built-in device and has no model number. The dual internal NAND flash devices are . The USB storage device is To view the storage media currently available on your system, use the CLI show system storage command.
Chapter 2: Hardware Architecture Router Architecture for M Series Routers and T Series Routers: Related Topics http://www.juniper.net/techpubs/software/nog/nog-baseline/html/juniper-routers3.html Hardware Components of the M Series and T Series Routers: http://www.juniper.net/techpubs/software/nog/nog-baseline/html/juniper-routers7.html J Series Routers The following topics give a brief overview of the J Series routers. Hardware Overview (J Series Routers) on page 20 Routing Engines and Storage Media Names (J Series Routers) on page 21 Boot Sequence (J Series Routers) on page 21...
JUNOS Release 10.2 Software Installation and Upgrade Guide Hardware Overview (J Series Routers) The JUNOS Software is installed on the internal CompactFlash card. This internal CompactFlash card is the primary and only boot drive on the J Series routers when they are delivered from the factory.
Internal CompactFlash card—The CompactFlash card is the primary boot device. External media device—Depending on the system, this external device can be a CompactFlash card or a USB storage device. Juniper Networks recommends that you attach an external device to the system and use this external device as the backup boot device for the system.
Page 44
JUNOS Release 10.2 Software Installation and Upgrade Guide Boot Sequence (J Series Routers)
Part 2 JUNOS Software Installation Installation Overview on page 25 Completing a Standard or Change Category Installation on page 29 Completing a Recovery Installation on page 43 JUNOS Software Installation...
Chapter 3 Installation Overview This section describes how to install a different JUNOS Software version on a routing platform, for example, upgrading from JUNOS Release 8.4 to JUNOS Release 9.2. This chapter covers the different methods used to upgrade and downgrade the software and why each method is employed.
When moving from one installation category to another, you need to be aware of the restrictions regarding this change. NOTE: Juniper Networks does not support using the request system software rollback command to restore a different installation category on the router. When installing...
Verifying PIC Combinations On Juniper Networks routing platforms, you can typically install any combination of Physical Interface Cards (PICs) on a single Enhanced Flexible PIC Concentrator (FPC) or in two PIC slots served by a single Layer 2/Layer 3 Packet Processing application-specific integrated circuit (ASIC).
Page 50
JUNOS Release 10.2 Software Installation and Upgrade Guide Newer JUNOS services for some PICs can require significant Internet Processor ASIC memory, and some configuration rules limit certain combinations of PICs if they are installed on some platforms. During software installation, the configuration checker in the installation program checks the router s PICs.
Chapter 4 Completing a Standard or Change Category Installation This chapter describes how to perform a standard or change category installation of the JUNOS Software. For information about JUNOS Software media and packages, see “Introduction to JUNOS Software” on page 3. For information on the installation process, see “Installation Overview”...
Downloading Software with a Browser on page 30 Downloading Software Using the Command-Line Interface on page 31 Downloading Software with a Browser You download the software package you need from the Juniper Networks Support Web site at http://www.juniper.net/support/ NOTE: To access the download section, you must have a service contract and an access account.
Page 53
HTTP, FTP, or scp. Downloading Software Using the Command-Line Interface You download the software package you need from the Juniper Networks Support Web site at http://www.juniper.net/support/ NOTE: To access the download section, you must have a service contract and an access account.
JUNOS Release 10.2 Software Installation and Upgrade Guide On Juniper Networks servers running the JUNOS operating system, installation files are typically placed in the directory. If you are placing the file on /var/tmp a remote system, you must make sure that the file can be accessed by the router using HTTP, FTP, or scp.
Chapter 4: Completing a Standard or Change Category Installation When the command is issued, the file system is backed request system snapshot /root up to /altroot , and /config is backed up to /altconfig . The /root /config file systems are on the router s CompactFlash card, and the file systems /altroot...
JUNOS Release 10.2 Software Installation and Upgrade Guide Reboot the router to start the new software using the request system reboot command: user@host> request system reboot Reboot the system? [yes, no] (no) yes NOTE: You must reboot the device to load the new installation of the JUNOS Software on the device.
Chapter 4: Completing a Standard or Change Category Installation the CLI command when prompted. If GRES is enabled, it delete chassis redundancy will be removed with the redundancy command. To upgrade the router software, perform the following tasks: Preparing the Router for the Installation on page 35 Installing Software on the Backup Routing Engine on page 36 Installing Software on the Primary Routing Engine on page 37 Finalizing the Installation on page 38...
Page 58
JUNOS Release 10.2 Software Installation and Upgrade Guide Installing Software on the Backup Routing Engine Once the router is ready, you first install the software on the backup Routing Engine. This enables the primary Routing Engine to continue operations, minimizing the disruption to your network.
Page 59
Chapter 4: Completing a Standard or Change Category Installation Installing Software on the Primary Routing Engine Once the software is installed on the backup Routing Engine, you are ready to switch routing control to the backup Routing Engine and then upgrade or downgrade the primary Routing Engine software: Log in to the primary Routing Engine console port.
Page 60
JUNOS Release 10.2 Software Installation and Upgrade Guide While the software is being upgraded, the Routing Engine on which you are performing the installation does not route traffic. Log in and issue the command to verify the version of the software show version installed.
Chapter 4: Completing a Standard or Change Category Installation user@host-re0> request system snapshot {master} user@host-re0> request routing-engine login other routing-engine {backup} user@host-re1> request system snapshot {backup} The root file system is backed up to , and is backed up to /altroot /config /altconfig...
Page 62
JUNOS Release 10.2 Software Installation and Upgrade Guide To upgrade an individual JUNOS Software package, follow these steps: Download the software packages you need from the Juniper Networks Support Web site at . Choose either the Canada and U.S. http://www.juniper.net/support/ Version or the Worldwide Version.
Chapter 5 Completing a Recovery Installation If the router's software is corrupted or otherwise damaged, you may need to perform a recovery installation, using the emergency boot disk to restore the default factory installation. Once you have recovered the software in this fashion, you must configure the router as you would for a new router.
Page 66
JUNOS Release 10.2 Software Installation and Upgrade Guide issue the following commands: dd if=/dev/zero of=/dev/externalDrive count=20 dd if=installMedia of=/dev/externalDrive bs=64k where: —Refers to the removable media name. For example, the externalDrive removable media name on the M120 is for both Routing Engines. For the names of the storage media, see “Routing Engines and Storage Media Names (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers)”...
Page 67
Chapter 5: Completing a Recovery Installation user@host> ftp host Name: username Password: password 230 User user logged in. ftp> cd /filepath ftp> lcd /config ftp>bin Type set to I. ftp> put rescue.conf.gz Transfer complete. ftp> bye Goodbye. Performing a Recovery Installation If the router's software is corrupted or otherwise damaged, you may need to perform a recovery installation, using the emergency boot disk to restore the default factory installation.
JUNOS Release 10.2 Software Installation and Upgrade Guide WARNING: The installation will erase the contents of your disk. Do you wish to continue (y/n)? y The router copies the software from the removable media onto your system, occasionally displaying status messages. Copying the software can take up to 10 minutes.
Page 69
Chapter 5: Completing a Recovery Installation [edit] root# Configure Administration User Accounts Set the root administration user account password. You also need to set up one or more administration user accounts. These administration user accounts are used to log in to the router through the management console. To configure administration user accounts: Add a password to the root (superuser) administration user account.
Page 70
JUNOS Release 10.2 Software Installation and Upgrade Guide [edit] root# set system domain-name domain-name Configure the IP address and prefix length for the router Ethernet interface. For all routers except the TX Matrix Plus router and T1600 routers in a routing matrix: [edit] root@# set interfaces fxp0 unit 0 family inet address address/prefix-length...
Chapter 5: Completing a Recovery Installation Commit Changes Now that you have completed your changes to the configuration file, commit the configuration changes. Before committing the configuration, you can review your changes to the configuration with the command. show root# show ## Last changed: 2008-08-27 22:30:42 UTC version 9.3B1.5;...
Page 72
JUNOS Release 10.2 Software Installation and Upgrade Guide routing-options { static { route 172.16.0.0/12 { next-hop 192.168.71.254; retain; no-readvertise; route 192.168.0.0/16 { next-hop 192.168.71.254; retain; no-readvertise; On a TX Matrix Plus router, the management Ethernet interface is and not fxp0 .
Chapter 5: Completing a Recovery Installation NOTE: If you receive an error message after you issue the statement, you commit can review the configuration using the show command to find the errors in your configuration. You can delete incorrect entries using the command.
Page 74
JUNOS Release 10.2 Software Installation and Upgrade Guide root# set system login user user-name class super-user Set Up Routing Engine Configuration Groups In a router with two Routing Engines, one configuration should be shared between both Routing Engines. This ensures that both Routing Engine configurations are identical.
Page 75
Chapter 5: Completing a Recovery Installation To use as an out-of-band management Ethernet interface, you must configure its logical port, em0.0 , with a valid IP address. For a T1600 standalone router (not connected to a TX Matrix Plus router and not in a routing matrix): [edit] root@# set interfaces fxp0 unit 0 family inet address address/prefix-length...
Page 76
JUNOS Release 10.2 Software Installation and Upgrade Guide root# set apply-groups [ re0 re1 ] Complete the Management Console Configuration To configure the global management console parameters. Configure the IP address of the DNS server. [edit] root# set system name-server address Configure the router domain name.
Page 77
Chapter 5: Completing a Recovery Installation system { host-name spice-re0; interfaces { fxp0 { unit 0 { family inet { address 192.168.69.155/21; re1 { system { host-name spice-re1; interfaces { fxp0 { unit 0 { family inet { address 192.168.70.72/21; global;...
Chapter 5: Completing a Recovery Installation Copy Saved Files to the Router To copy the saved configuration to the router: Log in to the console as . There is no password. root Escape character is '^]'. [Enter] router (ttyd0) login: root Password: [Enter] Initially, access to the router is limited to the console port after a recovery installation.
Page 80
JUNOS Release 10.2 Software Installation and Upgrade Guide user@host# commit commit complete Exit the CLI configuration mode. user@host# exit user@host> Back up the JUNOS Software. After you have installed the software on the router, committed the configuration, and are satisfied that the new configuration is successfully running, issue the command to back up the new software to the request system snapshot /altconfig...
Chapter 6 JUNOS Software Licenses Overview JUNOS Feature Licenses on page 61 License Enforcement on page 61 Software Feature Licenses on page 62 License Key Components on page 63 JUNOS Feature Licenses To enable some JUNOS Software features or router scaling levels, you may need to purchase, install, and manage separate software license packs.
JUNOS Release 10.2 Software Installation and Upgrade Guide NOTE: Configurations might include both licensed and nonlicensed features. For these situations, the license is enforced up to the point where the license can be clearly distinguished. For example, an authentication-order configuration is shared by both Authentication, Authorization, and Accounting (AAA), which is licensed, and by Layer 2 Tunneling Protocol (L2TP), which is not licensed.
Chapter 7 Managing JUNOS Software Licenses Adding New Licenses on page 65 Deleting a License on page 66 Saving License Keys on page 66 Verifying JUNOS Licenses on page 66 Adding New Licenses Before adding new licenses, complete the following tasks: Purchase the required licenses.
JUNOS Release 10.2 Software Installation and Upgrade Guide Deleting a License Before deleting a licenses, establish basic network connectivity with the router. For instructions on establishing basic connectivity, see the Getting Started Guide for your router. To delete a license key from the router with the CLI: Enter operational mode in the CLI.
Page 89
Chapter 7: Managing JUNOS Software Licenses From the CLI, enter the command. Action show system license Sample Output user@router> show system license License usage: Licenses Licenses Licenses Expiry Feature name used installed needed subscriber-acct permanent subscriber-auth permanent subscriber-addr permanent subscriber-vlan permanent subscriber-ip permanent...
Page 90
JUNOS Release 10.2 Software Installation and Upgrade Guide Sample Output user@router> show system license usage Licenses Licenses Licenses Expiry Feature name used installed needed subscriber-addr 29 days scale-subscriber 1000 permanent scale-l2tp 1000 permanent scale-mobile-ip 1000 permanent The output shows any licenses installed on the router and how they are used. Verify Meaning the following information: Any configured licenses appear in the output.