Juniper Networks, the Juniper Networks logo, JUNOS, NetScreen, ScreenOS, and Steel-Belted Radius are registered trademarks of Juniper Networks, Inc. in
the United States and other countries. JUNOSe is a trademark of Juniper Networks, Inc. All other trademarks, service marks, registered trademarks, or
registered service marks are the property of their respective owners.
Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify, transfer, or
otherwise revise this publication without notice.
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.
JUNOS® Software Software Installation and Upgrade Guide
Writing: Donice G. Evans-Mitchell, Mark Barnard, Stephen Meiers, Michael Scruggs, Philomena Dolla
Editing: Sonia Saruba, Nancy Kurahashi
Illustration: Faith Bradford
Cover Design: Edmonds Design
Revision History
May 2010—R1 JUNOS 10.2
The information in this document is current as of the date listed in the revision history.
YEAR 2000 NOTICE
Juniper Networks hardware and software products are Year 2000 compliant. The JUNOS Software has no known time-related limitations through the year
2038. However, the NTP application is known to have some difficulty in the year 2036.
ii■
Page 3
END USER LICENSE AGREEMENT
READ THIS END USER LICENSE AGREEMENT (“AGREEMENT”) BEFORE DOWNLOADING, INSTALLING, OR USING THE SOFTWARE. BY DOWNLOADING,
INSTALLING, OR USING THE SOFTWARE OR OTHERWISE EXPRESSING YOUR AGREEMENT TO THE TERMS CONTAINED HEREIN, YOU (AS CUSTOMER
OR IF YOU ARE NOT THE CUSTOMER, AS A REPRESENTATIVE/AGENT AUTHORIZED TO BIND THE CUSTOMER) CONSENT TO BE BOUND BY THIS
AGREEMENT. IF YOU DO NOT OR CANNOT AGREE TO THE TERMS CONTAINED HEREIN, THEN (A) DO NOT DOWNLOAD, INSTALL, OR USE THE SOFTWARE,
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”)
(collectively, the “Parties”).
2. The Software. In this Agreement, “Software” means the program modules and features of the Juniper or Juniper-supplied software, for which Customer
has paid the applicable license or support fees to Juniper or an authorized Juniper reseller, or which was embedded by Juniper in equipment which Customer
purchased from Juniper or an authorized Juniper reseller. “Software” also includes updates, upgrades and new releases of such software. “Embedded
Software” means Software which Juniper has embedded in or loaded onto the Juniper equipment and any updates, upgrades, additions or replacements
which are subsequently embedded in or loaded onto the equipment.
3. License Grant. Subject to payment of the applicable fees and the limitations and restrictions set forth herein, Juniper grants to Customer a non-exclusive
and non-transferable license, without right to sublicense, to use the Software, in executable form only, subject to the following use restrictions:
a. Customer shall use Embedded Software solely as embedded in, and for execution on, Juniper equipment originally purchased by Customer from Juniper
or an authorized Juniper reseller.
b. Customer shall use the Software on a single hardware chassis having a single processing unit, or as many chassis or processing units for which Customer
has paid the applicable license fees; provided, however, with respect to the Steel-Belted Radius or Odyssey Access Client software only, Customer shall use
such Software on a single computer containing a single physical random access memory space and containing any number of processors. Use of the
Steel-Belted Radius or IMS AAA software on multiple computers or virtual machines (e.g., Solaris zones) requires multiple licenses, regardless of whether
such computers or virtualizations are physically contained on a single chassis.
c. Product purchase documents, paper or electronic user documentation, and/or the particular licenses purchased by Customer may specify limits to
Customer’s use of the Software. Such limits may restrict use to a maximum number of seats, registered endpoints, concurrent users, sessions, calls,
connections, subscribers, clusters, nodes, realms, devices, links, ports or transactions, or require the purchase of separate licenses to use particular features,
functionalities, services, applications, operations, or capabilities, or provide throughput, performance, configuration, bandwidth, interface, processing,
temporal, or geographical limits. In addition, such limits may restrict the use of the Software to managing certain kinds of networks or require the Software
to be used only in conjunction with other specific Software. Customer’s use of the Software shall be subject to all such limitations and purchase of all applicable
licenses.
d. For any trial copy of the Software, Customer’s right to use the Software expires 30 days after download, installation or use of the Software. Customer
may operate the Software after the 30-day trial period only if Customer pays for a license to do so. Customer may not extend or create an additional trial
period by re-installing the Software after the 30-day trial period.
e. The Global Enterprise Edition of the Steel-Belted Radius software may be used by Customer only to manage access to Customer’s enterprise network.
Specifically, service provider customers are expressly prohibited from using the Global Enterprise Edition of the Steel-Belted Radius software to support any
commercial network access services.
The foregoing license is not transferable or assignable by Customer. No license is granted herein to any user who did not originally purchase the applicable
license(s) for the Software from Juniper or an authorized Juniper reseller.
4. Use Prohibitions. Notwithstanding the foregoing, the license provided herein does not permit the Customer to, and Customer agrees not to and shall
not: (a) modify, unbundle, reverse engineer, or create derivative works based on the Software; (b) make unauthorized copies of the Software (except as
necessary for backup purposes); (c) rent, sell, transfer, or grant any rights in and to any copy of the Software, in any form, to any third party; (d) remove
any proprietary notices, labels, or marks on or in any copy of the Software or any product in which the Software is embedded; (e) distribute any copy of
the Software to any third party, including as may be embedded in Juniper equipment sold in the secondhand market; (f) use any ‘locked’ or key-restricted
feature, function, service, application, operation, or capability without first purchasing the applicable license(s) and obtaining a valid key from Juniper, even
if such feature, function, service, application, operation, or capability is enabled without a key; (g) distribute any key for the Software provided by Juniper
to any third party; (h) use the Software in any manner that extends or is broader than the uses purchased by Customer from Juniper or an authorized Juniper
reseller; (i) use Embedded Software on non-Juniper equipment; (j) use Embedded Software (or make it available for use) on Juniper equipment that the
Customer did not originally purchase from Juniper or an authorized Juniper reseller; (k) disclose the results of testing or benchmarking of the Software to
any third party without the prior written consent of Juniper; or (l) use the Software in any manner other than as expressly provided herein.
5. Audit. Customer shall maintain accurate records as necessary to verify compliance with this Agreement. Upon request by Juniper, Customer shall furnish
such records to Juniper and certify its compliance with this Agreement.
■iii
Page 4
6. Confidentiality. The Parties agree that aspects of the Software and associated documentation are the confidential property of Juniper. As such, Customer
shall exercise all reasonable commercial efforts to maintain the Software and associated documentation in confidence, which at a minimum includes
restricting access to the Software to Customer employees and contractors having a need to use the Software for Customer’s internal business purposes.
7. Ownership. Juniper and Juniper’s licensors, respectively, retain ownership of all right, title, and interest (including copyright) in and to the Software,
associated documentation, and all copies of the Software. Nothing in this Agreement constitutes a transfer or conveyance of any right, title, or interest in
the Software or associated documentation, or a sale of the Software, associated documentation, or copies of the Software.
8. Warranty, Limitation of Liability, Disclaimer of Warranty. The warranty applicable to the Software shall be as set forth in the warranty statement that
accompanies the Software (the “Warranty Statement”). Nothing in this Agreement shall give rise to any obligation to support the Software. Support services
may be purchased separately. Any such support shall be governed by a separate, written support services agreement. TO THE MAXIMUM EXTENT PERMITTED
BY LAW, JUNIPER SHALL NOT BE LIABLE FOR ANY LOST PROFITS, LOSS OF DATA, OR COSTS OR PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
OR FOR ANY SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, THE SOFTWARE, OR ANY JUNIPER OR
JUNIPER-SUPPLIED SOFTWARE. IN NO EVENT SHALL JUNIPER BE LIABLE FOR DAMAGES ARISING FROM UNAUTHORIZED OR IMPROPER USE OF ANY
JUNIPER OR JUNIPER-SUPPLIED SOFTWARE. EXCEPT AS EXPRESSLY PROVIDED IN THE WARRANTY STATEMENT TO THE EXTENT PERMITTED BY LAW,
JUNIPER DISCLAIMS ANY AND ALL WARRANTIES IN AND TO THE SOFTWARE (WHETHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE), INCLUDING
ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT DOES JUNIPER
WARRANT THAT THE SOFTWARE, OR ANY EQUIPMENT OR NETWORK RUNNING THE SOFTWARE, WILL OPERATE WITHOUT ERROR OR INTERRUPTION,
OR WILL BE FREE OF VULNERABILITY TO INTRUSION OR ATTACK. In no event shall Juniper’s or its suppliers’ or licensors’ liability to Customer, whether
in contract, tort (including negligence), breach of warranty, or otherwise, exceed the price paid by Customer for the Software that gave rise to the claim, or
if the Software is embedded in another Juniper product, the price paid by Customer for such other product. Customer acknowledges and agrees that Juniper
has set its prices and entered into this Agreement in reliance upon the disclaimers of warranty and the limitations of liability set forth herein, that the same
reflect an allocation of risk between the Parties (including the risk that a contract remedy may fail of its essential purpose and cause consequential loss),
and that the same form an essential basis of the bargain between the Parties.
9. Termination. Any breach of this Agreement or failure by Customer to pay any applicable fees due shall result in automatic termination of the license
granted herein. Upon such termination, Customer shall destroy or return to Juniper all copies of the Software and related documentation in Customer’s
possession or control.
10. Taxes. All license fees payable under this agreement are exclusive of tax. Customer shall be responsible for paying Taxes arising from the purchase of
the license, or importation or use of the Software. If applicable, valid exemption documentation for each taxing jurisdiction shall be provided to Juniper prior
to invoicing, and Customer shall promptly notify Juniper if their exemption is revoked or modified. All payments made by Customer shall be net of any
applicable withholding tax. Customer will provide reasonable assistance to Juniper in connection with such withholding taxes by promptly: providing Juniper
with valid tax receipts and other required documentation showing Customer’s payment of any withholding taxes; completing appropriate applications that
would reduce the amount of withholding tax to be paid; and notifying and assisting Juniper in any audit or tax proceeding related to transactions hereunder.
Customer shall comply with all applicable tax laws and regulations, and Customer will promptly pay or reimburse Juniper for all costs and damages related
to any liability incurred by Juniper as a result of Customer’s non-compliance or delay with its responsibilities herein. Customer’s obligations under this
Section shall survive termination or expiration of this Agreement.
11. Export. Customer agrees to comply with all applicable export laws and restrictions and regulations of any United States and any applicable foreign
agency or authority, and not to export or re-export the Software or any direct product thereof in violation of any such restrictions, laws or regulations, or
without all necessary approvals. Customer shall be liable for any such violations. The version of the Software supplied to Customer may contain encryption
or other capabilities restricting Customer’s ability to export the Software without an export license.
12. Commercial Computer Software. The Software is “commercial computer software” and is provided with restricted rights. Use, duplication, or disclosure
by the United States government is subject to restrictions set forth in this Agreement and as provided in DFARS 227.7201 through 227.7202-4, FAR 12.212,
FAR 27.405(b)(2), FAR 52.227-19, or FAR 52.227-14(ALT III) as applicable.
13. Interface Information. To the extent required by applicable law, and at Customer's written request, Juniper shall provide Customer with the interface
information needed to achieve interoperability between the Software and another independently created program, on payment of applicable fee, if any.
Customer shall observe strict obligations of confidentiality with respect to such information and shall use such information in compliance with any applicable
terms and conditions upon which Juniper makes such information available.
14. Third Party Software. Any licensor of Juniper whose software is embedded in the Software and any supplier of Juniper whose products or technology
are embedded in (or services are accessed by) the Software shall be a third party beneficiary with respect to this Agreement, and such licensor or vendor
shall have the right to enforce this Agreement in its own name as if it were Juniper. In addition, certain third party software may be provided with the
Software and is subject to the accompanying license(s), if any, of its respective owner(s). To the extent portions of the Software are distributed under and
subject to open source licenses obligating Juniper to make the source code for such portions publicly available (such as the GNU General Public License
(“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
N. Mathilda Ave., Sunnyvale, CA 94089, ATTN: General Counsel. You may obtain a copy of the GPL at http://www.gnu.org/licenses/gpl.html, and
a copy of the LGPL at http://www.gnu.org/licenses/lgpl.html.
15. Miscellaneous. This Agreement shall be governed by the laws of the State of California without reference to its conflicts of laws principles. The provisions
of the U.N. Convention for the International Sale of Goods shall not apply to this Agreement. For any disputes arising under this Agreement, the Parties
hereby consent to the personal and exclusive jurisdiction of, and venue in, the state and federal courts within Santa Clara County, California. This Agreement
constitutes the entire and sole agreement between Juniper and the Customer with respect to the Software, and supersedes all prior and contemporaneous
iv■
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. No modification to this Agreement nor any waiver of any rights hereunder shall be effective unless expressly assented to in
writing by the party to be charged. If any portion of this Agreement is held invalid, the Parties agree that such invalidity shall not affect the validity of the
remainder of this Agreement. This Agreement and associated documentation has been written in the English language, and the Parties agree that the English
version will govern. (For Canada: Les parties aux présentés confirment leur volonté que cette convention de même que tous les documents y compris tout
avis qui s'y rattaché, soient redigés en langue anglaise. (Translation: The parties confirm that this Agreement and all related documentation is and will be
in the English language)).
■v
Page 6
vi■
Page 7
Abbreviated Table of Contents
About This Guidexvii
Part 1Introduction
Chapter 1Introduction to JUNOS Software3
Chapter 2Hardware Architecture13
Part 2JUNOS Software Installation
Chapter 3Installation Overview25
Chapter 4Completing a Standard or Change Category Installation29
Chapter 5Completing a Recovery Installation43
Part 3JUNOS Software Licenses
Chapter 6JUNOS Software Licenses Overview61
Chapter 7Managing JUNOS Software Licenses65
Part 4Index
Index71
Abbreviated Table of Contents■vii
Page 8
JUNOS Release 10.2 Software Installation and Upgrade Guide
viii■
Page 9
Table of Contents
About This Guidexvii
JUNOS Documentation and Release Notes ...................................................xvii
JUNOS Release 10.2 Software Installation and Upgrade Guide
xvi■List of Tables
Page 17
About This Guide
This preface provides the following guidelines for using the JUNOS® Software Software
Installation and Upgrade Guide:
■JUNOS Documentation and Release Notes on page xvii
■Objectives on page xvii
■Audience on page xviii
■Supported Routing Platforms on page xviii
■Documentation Conventions on page xix
■Documentation Feedback on page xx
■Requesting Technical Support on page xxi
JUNOS Documentation and Release Notes
For a list of related JUNOS documentation, see
http://www.juniper.net/techpubs/software/junos/ .
If the information in the latest release notes differs from the information in the
documentation, follow the JUNOS Release Notes.
Objectives
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/.
Juniper Networks supports a technical book program to publish books by Juniper
Networks engineers and subject matter experts with book publishers around the
world. These books go beyond the technical documentation to explore the nuances
of network architecture, deployment, and administration using JUNOS Software and
Juniper Networks devices. In addition, the Juniper Networks Technical Library,
published in conjunction with O'Reilly Media, explores improving network security,
reliability, and availability using JUNOS configuration techniques. All the books are
for sale at technical bookstores and book outlets around the world. The current list
can be viewed at http://www.juniper.net/books .
This guide provides a description of the JUNOS Software packages and includes
detailed information about how to initially configure, reinstall, and upgrade the JUNOS
system software.
JUNOS Documentation and Release Notes■xvii
Page 18
JUNOS Release 10.2 Software Installation and Upgrade Guide
NOTE: For additional information about JUNOS Software—either corrections to or
information that might have been omitted from this guide—see the software release
notes at http://www.juniper.net/.
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. You must also be
familiar with one or more of the following Internet routing protocols:
■Intermediate System-to-Intermediate System (IS-IS)
■Internet Control Message Protocol (ICMP) router discovery
■Internet Group Management Protocol (IGMP)
■Multiprotocol Label Switching (MPLS)
■Open Shortest Path First (OSPF)
■Protocol-Independent Multicast (PIM)
■Resource Reservation Protocol (RSVP)
■Routing Information Protocol (RIP)
■Simple Network Management Protocol (SNMP)
Personnel operating the equipment must be trained and competent; must not conduct
themselves in a careless, willfully negligent, or hostile manner; and must abide by
the instructions provided by the documentation.
Supported Routing Platforms
For the features described in this manual, the JUNOS Software currently supports
the following routers:
■J Series
■M Series
■MX Series
■T Series
■EX Series
xviii■Audience
Page 19
Documentation Conventions
Table 1 on page xix defines notice icons used in this guide.
Table 1: Notice Icons
About This Guide
DescriptionMeaningIcon
Indicates important features or instructions.Informational note
Indicates a situation that might result in loss of data or hardware damage.Caution
Alerts you to the risk of personal injury or death.Warning
Table 2 on page xix defines the text and syntax conventions used in this guide.
Table 2: Text and Syntax Conventions
Bold text like this
Fixed-width text like this
Italic text like this
Alerts you to the risk of personal injury from a laser.Laser warning
Represents text that you type.
Represents output that appears on the
terminal screen.
Introduces important new terms.
■
Identifies book names.
■
Identifies RFC and Internet draft
■
titles.
ExamplesDescriptionConvention
To enter configuration mode, type the
configure command:
user@host> configure
user@host> show chassis alarms
No alarms currently active
A policy term is a named structure
■
that defines match conditions and
actions.
JUNOS System Basics Configuration
■
Guide
RFC 1997, BGP Communities
■
Attribute
Italic text like this
Represents variables (options for which
you substitute a value) in commands or
configuration statements.
Configure the machine’s domain name:
[edit]
root@# set system domain-name
domain-name
Documentation Conventions■xix
Page 20
JUNOS Release 10.2 Software Installation and Upgrade Guide
Table 2: Text and Syntax Conventions (continued)
ExamplesDescriptionConvention
Plain text like this
| (pipe symbol)
# (pound sign)
[ ] (square brackets)
Indention and braces ( { } )
; (semicolon)
Represents names of configuration
statements, commands, files, and
directories; IP addresses; configuration
hierarchy levels; or labels on routing
platform components.
Enclose optional keywords or variables.< > (angle brackets)
Indicates a choice between the mutually
exclusive keywords or variables on either
side of the symbol. The set of choices is
often enclosed in parentheses for clarity.
Indicates a comment specified on the
same line as the configuration statement
to which it applies.
Enclose a variable for which you can
substitute one or more values.
Identify a level in the configuration
hierarchy.
Identifies a leaf statement at a
configuration hierarchy level.
To configure a stub area, include
■
the stub statement at the [edit
protocols ospf area area-id]
hierarchy level.
The console port is labeled
■
CONSOLE.
stub <default-metric metric>;
broadcast | multicast
(string1 | string2 | string3)
rsvp { # Required for dynamic MPLS only
community name members [
community-ids ]
[edit]
routing-options {
static {
route default {
nexthop address;
retain;
}
}
}
J-Web GUI Conventions
Bold text like this
> (bold right angle bracket)
Documentation Feedback
We encourage you to provide feedback, comments, and suggestions so that we can
improve the documentation. You can send your comments to
techpubs-comments@juniper.net, or fill out the documentation feedback form at
https://www.juniper.net/cgi-bin/docbugreport/. If you are using e-mail, be sure to include
the following information with your comments:
■Document or topic name
■URL or page number
xx■Documentation Feedback
Represents J-Web graphical user
interface (GUI) items you click or select.
Separates levels in a hierarchy of J-Web
selections.
In the Logical Interfaces box, select
■
All Interfaces.
To cancel the configuration, click
■
Cancel.
In the configuration editor hierarchy,
select Protocols>Ospf.
Page 21
■Software release version (if applicable)
Requesting Technical Support
Technical product support is available through the Juniper Networks Technical
Assistance Center (JTAC). If you are a customer with an active J-Care or JNASC support
contract, or are covered under warranty, and need postsales technical support, you
can access our tools and resources online or open a case with JTAC.
■JTAC policies—For a complete understanding of our JTAC procedures and policies,
■JTAC Hours of Operation —The JTAC centers have resources available 24 hours
a day, 7 days a week, 365 days a year.
About This Guide
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 solutions and answer questions using our Knowledge Base:
http://kb.juniper.net/
■Download the latest versions of software and review release notes:
http://www.juniper.net/customers/csc/software/
■Search technical bulletins for relevant hardware and software notifications:
https://www.juniper.net/alerts/
■Join and participate in the Juniper Networks Community Forum:
http://www.juniper.net/company/communities/
■
Open a case online in the CSC Case Management tool: http://www.juniper.net/cm/
To verify service entitlement by product serial number, use our Serial Number
Entitlement (SNE) Tool: https://tools.juniper.net/SerialNumberEntitlementSearch/
Opening a Case with JTAC
You can open a case with JTAC on the Web or by telephone.
■
Use the Case Management tool in the CSC at http://www.juniper.net/cm/ .
■Call 1-888-314-JTAC (1-888-314-5822 toll-free in the USA, Canada, and Mexico).
Requesting Technical Support■xxi
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
Page 23
Part 1
Introduction
■Introduction to JUNOS Software on page 3
■Hardware Architecture on page 13
Introduction■1
Page 24
JUNOS Release 10.2 Software Installation and Upgrade Guide
2■Introduction
Page 25
Chapter 1
Introduction to JUNOS Software
This chapter includes the following sections:
■JUNOS Software Overview on page 3
■Software Naming Convention on page 4
■JUNOS Software Editions on page 5
■FIPS 140-2 Security Compliance on page 5
■JUNOS Installation Packages on page 6
■Installation Media on page 6
■Installation Bundles on page 7
■Installation Modules on page 7
■JUNOS Software Release Numbers on page 8
■JUNOS Feature Licenses on page 9
■Software Package Information Security on page 9
■Configuration Files on page 9
■Automatic Installation of Configuration Files (J Series Routers) on page 11
JUNOS Software Overview
Juniper Networks provides high-performance network devices that create a responsive
and trusted environment for accelerating the deployment of services and applications
over a single network. JUNOS Software is the foundation of these high-performance
networks. Unlike other complex, monolithic software architectures, JUNOS Software
incorporates key design and developmental differences to deliver increased network
availability, operational efficiency, and flexibility. The key advantages to this approach
are:
■One Operating System on page 3
■One Software Release on page 4
■One Modular Software Architecture on page 4
One Operating System
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■3
Page 26
JUNOS Release 10.2 Software Installation and Upgrade Guide
engineers to develop software features once and share these features across all
product lines simultaneously. Because features are common to a single source, they
generally are implemented the same way for all product lines, thus reducing the
training required to learn different tools and methods for each product. Because all
Juniper Networks products use the same code base, interoperability between products
is not an issue.
One Software Release
Each new version of JUNOS Software is released concurrently for all product lines
following a preset quarterly schedule. Furthermore, each new version of software
must include all working features released in previous releases of the software, and
must have no critical regression errors. This discipline ensures reliable operations
for the entire release.
One Modular Software Architecture
Although individual modules of the JUNOS Software communicate through
well-defined interfaces, each module runs in its own protected memory space,
preventing one module from disrupting another. This separation enables the
independent restart of each module as necessary. This is in contrast to monolithic
operating systems where a malfunction in one module can ripple to other modules
and cause a full system crash or restart. This modular architecture then provides for
high performance, high availability, security, and device scalability not found in other
operating systems.
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. You simply need to configure the software so that the router can
participate in the network.
You can upgrade the router software as new features are added or software problems
are fixed. You normally obtain new software by downloading the software installation
packages from the Juniper Networks Support Web page onto your router or onto
another system on your local network. You then install the software upgrade onto
the router.
Juniper Networks routing platforms run only binaries supplied by Juniper Networks.
Each JUNOS Software image includes a digitally signed manifest of executables that
are registered with the system only if the signature can be validated. JUNOS Software
will not execute any binary without a registered signature. This feature protects the
system against unauthorized software and activity that might compromise the integrity
of your router.
Related TopicsImpacts of the Operating System on the Performance of Enterprise Networks white paper:
All JUNOS Software conforms to the following naming convention:
4■Software Naming Convention
Page 27
package-release-edition-cfxxx-signed.comp
For example:
jinstall-9.2R1.8–domestic-signed.tgz
where:
■
package is the name of the JUNOS package.
■
cfxxx designates the CompactFlash card size to use with the software. This value
is optional.
■
signed means that the software includes a digital signature for verification
purposes. This value is not used with all software packages.
JUNOS Software Editions
JUNOS Software is released in the following editions:
Chapter 1: Introduction to JUNOS Software
■Domestic—JUNOS Software for customers in the United States and Canada. This
edition includes high-encryption capabilities for data leaving the router.
■Export—JUNOS Software for all other customers. This edition does not include
any high-encryption capabilities for data leaving the router.
■JUNOS-FIPS—JUNOS Software that provides advanced network security for
customers who need software tools to configure a network of Juniper Networks
routers in a Federal Information Processing Standards (FIPS) 140-2 environment.
For more information about JUNOS-FIPS, see “FIPS 140-2 Security Compliance”
on page 5.
FIPS 140-2 Security Compliance
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
■Revised installation and configuration procedures
■Enforced security for remote access
■FIPS user roles (Crypto Officer, User, and Maintenance)
■FIPS-specific system logging and error messages
■IPsec configuration for Routing Engine–to–Routing Engine communication
■Enhanced password creation and encryption
JUNOS-FIPS has special installation and configuration requirements. Installation
procedures include downloading the FIPS software package from www.juniper.net.
For detailed guidelines on how installation and configuration procedures differ
between JUNOS and JUNOS-FIPS 140-2, see the Secure Configuration Guide for CommonCriteria and JUNOS-FIPS.
JUNOS Software Editions■5
Page 28
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). If JUNOS-FIPS is installed on the router, you
cannot configure passwords unless they meet this standard.
JUNOS Installation Packages
The installation package is used to upgrade and downgrade from one release to
another. When installed, the installation package completely reinstalls the software,
rebuilds the JUNOS file system, and may erase system logs and other auxiliary
information from the previous installation. The installation package does, however,
retain the configuration files from the previous installation.
The following installation packages are available for download:
Installation Media
DescriptionInstallation Package
jinstall*
jinstall-ex*
junos-jsr*
junos-juniper*
JUNOS Software for the M Series, MX Series, T Series, TX Matrix, and
TX Matrix Plus routers.
JUNOS Software for the EX Series Ethernet switch portfolio.
JUNOS Software for the J Series routers.
JUNOS-FIPS for the M Series, MX Series, T Series, TX Matrix, and TX
Matrix Plus routers.
Once the package is installed on a device, you cannot revert back to
the standard JUNOS Software installation without performing a software
recovery procedure.
The installation media is used to recover a router from a software failure. The
installation media repartitions the media and completely reinstalls the JUNOS
Software. No information from previous installations is retained during this
installation. Thus, an initial configuration is required before the router can be put
back into service. For more information on creating an initial configuration, see the
Getting Started Guide for your router.
NOTE: Once you have rebuilt a router using the installation media, access to the
router is restricted to the console port until the management port is configured during
the initial configuration.
6■JUNOS Installation Packages
Page 29
Chapter 1: Introduction to JUNOS Software
The following installation media files are available for download:
DescriptionInstallation Media
floppy1–<release>*
floppy2–<release>*
JUNOS Software for the M40 router when you use the
LS-120 external drive.
Installation Bundles
install-media*
junos-jsr-<release>-export-cf<size>.gz
JUNOS Software for the M Series, MX Series, T Series, TX
Matrix, and TX Matrix Plus routers.
JUNOS Software for the J Series routers. You must select
the correct installation media file that corresponds to the
correct CompactFlash card you are using.
The installation bundle can be used to downgrade or upgrade the JUNOS Software
between minor revisions (from Release 9.1 to Release 9.2, for example). When used,
the installation bundle modifies only the files required for the upgrade or downgrade
between versions.
NOTE: You should only use the installation bundle under direction of a Juniper
Networks support representative.
The following installation bundle files are available for download:
DescriptionInstallation Bundle
jbundle*
JUNOS Software for the M Series, MX Series, T Series, TX Matrix,
and TX Matrix Plus routers.
Installation Modules
Installation modules are used to upgrade individual software modules within the
software. For example, you can upgrade only the Routing Engine software by installing
the jroute* installation module.
NOTE: You should only use installation module files under the direction of a Juniper
Networks support representative.
The following installation module files are available for download:
DescriptionInstallation Module
Installation Bundles■7
Page 30
JUNOS Release 10.2 Software Installation and Upgrade Guide
jkernel*
jbase*
jroute*
jpfe*
jdocs*
jcrypto*
jweb*
JUNOS Software Release Numbers
The kernel and network tools package. This
package contains the basic operating system
files.
The base package for the JUNOS Software. This
package contains additions to the operating
system.
The Routing Engine package. This package
contains the Routing Engine software.
The Packet Forwarding Engine package. This
package contains the PFE software.
The documentation package. This package
contains the documentation set for the
software.
The encryption package. This package contains
the domestic version of the security software.
The J-Web package. This package contains the
graphical user interface software for M Series,
MX Series, T Series, TX Matrix, TX Matrix Plus,
and J Series routers.
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. On
the Juniper Networks Support Web page, you download JUNOS Software for a
particular JUNOS Software release number.
The following example shows how the software release number is formatted:
m.nZb.s
For example:
9.2R1.8
Where:
■
m is the major release number of the product
■
n is the minor release number of the product
■
Z is the type of software release. The following release types are used:
■
R—Released software
■
B—Beta release software
■
I—Internal release software
8■JUNOS Software Release Numbers
Page 31
■
b is the build number of the product
■
s 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.
For information about how to purchase JUNOS Software licenses, contact your Juniper
Networks sales representative.
As an honor-based licensing structure, JUNOS feature and scaling licenses are
universal, and the same feature or scaling key can be installed and configured on
multiple routers. However, to conform to JUNOS feature or scale licensing
requirements, you must purchase one license per router.
Chapter 1: Introduction to JUNOS Software
Software Package Information Security
All JUNOS Software is delivered in signed packages that contain digital signatures,
Secure Hash Algorithm (SHA-1), and Message Digest 5 (MD5) checksums. A package
is installed only if the checksum within it matches the hash recorded in its
corresponding file. Which checksum is used depends on the software version:
■Digital signatures are used when you upgrade or downgrade between
JUNOS Release 7.0 and a later version.
■The SHA-1 checksum is used when you upgrade or downgrade between
JUNOS Release 6.4 and a later version.
■The MD5 checksum is used when you upgrade or downgrade between
JUNOS Release 6.3 or earlier and a later version.
Configuration Files
All configuration settings for the router are handled in the configuration files on the
router. These files are saved in the /config directory on the router.
Configuration File Selection Sequence
During the boot process, the router is configured based on a predefined configuration
file. The router selects the configuration file based on the sequence shown in
Figure 1 on page 10.
JUNOS Feature Licenses■9
Page 32
JUNOS Release 10.2 Software Installation and Upgrade Guide
Figure 1: Configuration Selection Sequence
1.
/config/juniper.conf—Active configuration file.
2.
/config/rescue.conf—Rescue configuration file. This file is created by the router
The 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. For more information on setting up your router
from the factory default configuration, see the specific hardware guide for your
router.
Remote Storage of Configuration Files
Configuration files can be stored off the router. This can be helpful if the router
encounters a software failure or other problem that forces you to restore the router’s
software. Once the software is restored, you can then reload the saved configuration
file. For more information on restoring the JUNOS Software, see “Load and Commit
the Configuration File” on page 57.
When the configuration file is stored off the router, you can encrypt the configuration
files using the Data Encryption Standard (DES) encryption algorithm.
10■Configuration Files
Page 33
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. For
security purposes, you can encrypt these remote files using the DES cipher, and once
they have been retrieved, the router decrypts them for use on the server.
To encrypt the files, we recommend the openSSL tool. You can get the openSSL tool
at: http://www.openssl.org/. To encrypt the file, use the following syntax:
passphrase—Passphrase used to encrypt the configuration file. The passphrase
should be the name of the file without the path information or file extension.
■
original-file—Unencrypted configuration file.
■
encrypted-file—Name of the encrypted configuration file.
For example, if you are encrypting the active configuration file juniper.conf.gz, the
passphrase is juniper.conf. The openSSL syntax used to encrypt the file is:
Layer 2 and Layer 3 packet switching, route lookups, and packet forwarding.
From a system administration perspective, you install the software onto the Routing
Engine and during the installation, the appropriate software is forwarded to other
components as necessary. Each Routing Engine includes a CompactFlash card that
stores the JUNOS Software. On the M Series, MX Series, T Series, and TX Matrix
routers, the system also includes a hard drive that acts as a backup boot drive. The
TX Matrix Plus router includes either a hard drive or a solid state drive as a backup
boot drive.
NOTE: The MX80 router is a single-board router with a built-in Routing Engine and
single Packet Forwarding Engine. On an MX80 router, the JUNOS Software is stored
on dual, internal NAND flash devices. These devices provide the same functionality
as a CompactFlash card and hard drive.
On routing platforms with dual Routing Engines, each Routing Engine is independent
with regard to upgrading the software. To install new software on both Routing
Engines, you need to install the new software on each Routing Engine. On platforms
with dual Routing Engines configured for high availability, you can use the unified
in-service software upgrade procedure to upgrade the software. For more information
on this procedure, see the JUNOS High Availability Configuration Guide.
Hardware Architecture Overview■13
Page 36
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
Matrix, and TX Matrix Plus Routers) on page 16
■Boot Sequence (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus
Routers) on page 18
Hardware Overview (M Series, MX Series, T Series, and TX Matrix Routers)
Except for MX80 routers, the JUNOS Software is installed on both the CompactFlash
card and the hard drive. When installed, the internal CompactFlash card is the primary
boot device and the hard drive is the secondary boot device. When the internal
CompactFlash card is not installed, the hard drive is the primary boot device. Figure
2 on page 15 shows the standard layout of a typical Routing Engine. On MX80 routers,
the internal NAND flash devices (first da0, then da1) act as the primary and secondary
boot devices.
14■M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers
Page 37
Figure 2: Routing Engines
Chapter 2: Hardware Architecture
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. All M7i and M10i routers delivered before
December 7, 2007, had 256 MB of memory. These routers require a system memory
upgrade before you install JUNOS Release 9.0. To determine the amount of memory
currently installed on your system, use the show chassis routing-engine command in
the command-line interface (CLI).
Hardware Overview (M Series, MX Series, T Series, and TX Matrix Routers)■15
Page 38
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:
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. M7i and M10i routers are not usually delivered from the factory with the
CompactFlash card installed. In this case, the hard drive is the primary and only
boot device. The M7i and M10i routers can be upgraded to include the
CompactFlash card.
■Hard drive or solid state drive—The hard drive is normally the secondary boot
device for M Series, MX Series, T Series, and TX Matrix routers. The TX Matrix
Plus router includes either a hard drive or a solid state drive as the secondary
boot device. When the CompactFlash card is not installed on the router, the hard
drive or the solid state drive becomes the primary boot drive. It is also used to
store system log files and diagnostic dump files.
■External media storage device—Depending on the system, the external device
can be a CompactFlash card, a USB storage device, or an LS-120 floppy disk.
On MX80 routers, the internal NAND flash devices (first da0, then da1) act as the
primary and secondary boot devices.
The external devices are emergency boot devices and can be used to revive a routing
platform with damaged JUNOS Software. When these external devices are attached
to the system, the router attempts to boot from these devices before it boots from
the internal CompactFlash drive, the hard drive, or internal flash device.
When booting from the external emergency boot disk, the router requests a boot
acknowledgment from you on the console interface. If you enter yes, the external
media repartitions the internal primary drive and reloads the JUNOS Software onto
that drive. When the loading is complete, the routing platform requests that you
remove the external media and reboot the system. Once the reboot is complete, you
must perform an initial configuration of the router before it can be used on your
network.
Routing Engines and Storage Media Names (M Series, MX Series, T Series, TX Matrix, and
TX Matrix Plus Routers)
Table 3 on page 17 specifies the storage media names by Routing Engine. The storage
media device names are displayed when the router boots.
16■Routing Engines and Storage Media Names (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers)
Page 39
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)
Supported platforms:
M7i and M10i
Supported platforms:
M20 and M40e
Supported platforms:
M7i and M10i
Supported platforms:
M120
Supported platforms:
MX240, MX480, and MX960
CompactFlash
CardRouting Engine
Hard
Disk
Removable
Media
ad3ad1ad0RE-400-768 (RE5)
ad3ad1ad0RE-600-2048 (RE3)
ad3ad1ad0RE-850-1536 (RE-850)
da0ad2ad0RE-A-1000-2048 (RE-A-1000)
da0ad2ad0RE-S-1300-2048 (RE-S-1300)
Supported platforms:
M320, T320, T640, T1600, and the TX Matrix
Supported platforms:
M120, M320, MX240, MX480, MX960, T320, T640,
T1600, and the TX Matrix
Supported platforms:
T1600, and the TX Matrix Plus
Supported platforms:
T1600, and the TX Matrix Plus
ad3 and ad4ad1ad0RE-1600-2048 (RE4)
da0ad2ad0RE-A-2000-4096 (RE-A-2000)
da0ad1ad0RE-DUO-C2600-16G–S (SFC-RE)
da0ad1ad0RE-DUO-C1800-8G–S (LCC-RE)
Routing Engines and Storage Media Names (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers)■17
Page 40
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 da0 and da1. The USB storage
device is da2.
To view the storage media currently available on your system, use the CLI show
system storage command. For more information about this command, see the JUNOS
CLI User's Guide.
Boot Sequence (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers)
tThe M Series, MX Series (except for the MX80 routers), T Series, and TX Matrix
routers attempt to boot from the storage media in the following order:
1.Removable media
2.CompactFlash card (if available)
3.Hard disk
MX80 routers attempt to boot from the storage media in the following order:
1.USB media
2.
Dual, internal NAND flash device (first da0, then da1)
The TX Matrix Plus router attempts to boot from the storage media in the following
order:
1.USB media
2.CompactFlash card (if available)
3.Disk 1
4.Storage media available on the LAN
NOTE: Do not insert the removable media during normal operations. The router does
not operate normally when it is booted from the removable media.
If the router boots from an alternate boot device, the JUNOS Software displays a
message indicating this when you log in to the router. For example, the following
message shows that the software booted from the hard disk (/dev/ad2s1a):
login: username
Password: password
Last login: date on terminal
--- JUNOS 8.0 R1 built date
---
--- NOTICE: System is running on alternate media device (/dev/ad2s1a).
18■Boot Sequence (M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers)
Page 41
Chapter 2: Hardware Architecture
Related TopicsRouter Architecture for M Series Routers and T 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
J Series Routers■19
Page 42
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. All J Series routers have one or more USB ports.
The 4300 and 6300 J Series routers also include an external CompactFlash card slot.
You can install external storage devices through the USB ports and CompactFlash
card slots. When external storage devices are installed, these external devices can
be used as backup boot drives. You can also create a backup internal boot drive on
any externally attached CompactFlash card. This CompactFlash card can then be
used to replace the internal CompactFlash card on the J Series router in the event
that the internal card is damaged or otherwise made unusable by the router. Figure
3 on page 20 shows the location of the memory and ports on a J Series router.
Figure 3: J Series Routers (J4300 Shown)
The J Series routers include the following:
■System Memory on page 20
■Storage Media on page 21
System Memory
Starting with JUNOS Release 9.1, all J Series routers require a minimum of 512 MB
of router memory on each Routing Engine. Any router without this minimum requires
a system memory upgrade before you install JUNOS Release 9.1. To determine the
amount of memory currently installed on your router, use the CLI show chassis
routing-engine command.
For more information about memory requirements for the J Series routers, see the
Customer Support Center JTAC Technical Bulletin PSN-2008-04-021:
The J Series routers use the following media storage devices:
■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.
Routing Engines and Storage Media Names (J Series Routers)
Table 4 on page 21 specifies the storage media names used by the J Series routers.
The storage media device names are displayed as the router boots.
Table 4: Routing Engines and Storage Media Names (J Series Routers)
Chapter 2: Hardware Architecture
To view the storage media currently available on your system, use the CLI show
system storage command. For more information about this command, see the JUNOS
CLI User's Guide.
Boot Sequence (J Series Routers)
The router attempts to boot from the storage media in the following order:
1.Internal CompactFlash card
2.External CompactFlash card (J4300 and J6300 routers only)
3.USB storage media device
Internal
CompactFlash
CardRouting Engine
External CompactFlash Card
J4300 and J6300 Routers
Only
USB Storage Media
Devices
da0ad2ad0J Series Routers
Routing Engines and Storage Media Names (J Series Routers)■21
Page 44
JUNOS Release 10.2 Software Installation and Upgrade Guide
22■Boot Sequence (J Series Routers)
Page 45
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■23
Page 46
JUNOS Release 10.2 Software Installation and Upgrade Guide
24■JUNOS Software Installation
Page 47
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. It also covers the options available to
you during the installation process as well as issues that you need to understand
before you start an installation process.
This chapter includes the following topics:
■Installation Type Overview on page 25
■Installation Categories on the M Series, MX Series, T Series, TX Matrix, and TX
Matrix Plus Routers on page 26
■Installation Categories on the J Series Routers on page 27
■Verifying PIC Combinations on page 27
Installation Type Overview
The three types of installations used to upgrade or downgrade your routing platform
are standard installation, category change, and recovery. The standard installation
is the standard method of upgrading and downgrading the software. Use a category
change installation when you are moving from one software category to another;
for example, if you are changing the router from using the standard JUNOS Software
to the JUNOS-FIPS category. Perform a recovery installation when the software on
the router is damaged or otherwise unable to accommodate a software upgrade or
downgrade.
Standard Installation
A standard installation is the typical method used to upgrade or downgrade software
on the server. This method uses the installation package that matches the installation
package already installed on the system. For example, you might upgrade an M120
router running the JUNOS Software installed using the jinstall* installation package.
If you upgrade the router from the 9.0R2.10 release to the 9.1R1.8 release, you use
the jinstall-9.1R1.8–domestic-signed.tgz installation package. For information on the
different installation packages available, see “JUNOS Installation Packages” on
page 6.
Installation Type Overview■25
Page 48
JUNOS Release 10.2 Software Installation and Upgrade Guide
Category Change Installation
The category change installation process is used to move from one category of the
JUNOS Software to another on the same router; for example, moving from a JUNOS
standard installation on an M Series, MX Series, or T Series router to a JUNOS FIPS
installation. 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
a different JUNOS Software category on a router, once the installation is complete,
you should execute a request system snapshot command to delete the backup
installation from the system.
Recovery Installation
A recovery installation is performed to repair a router with damaged software or a
condition that prevents the upgrade, downgrade, or change in installation category
of the software.
For example, you may need to perform a recovery installation to change a router’s
software category from JUNOS-FIPS to standard JUNOS.
Installation Categories on the M Series, MX Series, T Series, TX Matrix, and TX
Matrix Plus Routers
The following installation categories are available with the M Series, MX Series, T
Series, TX Matrix, and TX Matrix Plus routers:
■
Standard JUNOS Software, domestic—jinstall-<release>-domestic-signed.tgz
This software includes high-encryption capabilities for data leaving the router.
Because of U.S. government export restrictions, this software can only be installed
on systems within the United States and Canada. Furthermore, no router can
be shipped out of the United States. or Canada without the domestic edition first
being overwritten by the export edition. There are no current system-enforced
restrictions when you install this software category.
■
Standard JUNOS Software, export—jinstall-<release>-export-signed.tgz
This software does not include high-encryption capabilities. It can be installed
on any system worldwide. There are no current system-enforced restrictions
when you install this software category.
■
JUNOS-FIPS—junos-juniper-<release>-domestic-signed.tgz and
junos-juniper-<release>-fips-signed.tgz
The JUNOS-FIPS Software base provides customers with the software tools to
configure the router for use within a Federal Information Processing Standards
(FIPS) environment. Once you have installed this software category onto a router,
you cannot install a different software category on the router using the request
26■Installation Categories on the M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus Routers
Page 49
Chapter 3: Installation Overview
system software add command. When attempting to install a different JUNOS
Software category package on the router, you receive the following warning
message:
WARNING: Package jinstall-<release>-<edition>-signed is not compatible with
this system.
WARNING: Please install a supported package (junos-juniper-*.tgz).
To return to a standard JUNOS Software category installation, you must perform
a system recovery installation of the software. All configuration files, logs, and
other data files on the server are overwritten during a recovery installation.
For more information about the JUNOS-FIPS Software base, see “FIPS 140-2
Security Compliance” on page 5.
NOTE: When you install a JUNOS Software installation package, the previous
installation is maintained as a backup installation. You should issue a request system
software snapshot command to overwrite the backup files any time you change
software categories on a router. This is mandatory if the router is to be shipped
outside of the United States or Canada after the Export edition of the JUNOS Software
has been installed. There are no current system-enforced restrictions when you install
this software category,
Installation Categories on the J Series Routers
The following installation categories are available with the J Series routers:
This software includes high-encryption capabilities for data leaving the router.
Because of U.S. Government export restrictions, this software can only be installed
on systems within the United States and Canada. Furthermore, no router can
be shipped out of the U.S. or Canada without first overwriting the domestic
edition with the worldwide edition. There are no current system-enforced
restrictions when you install this software category.
■
JUNOS, export—junos-jsr-<release>-export.tgz
This software does not include high-encryption capabilities. It can be installed on
any system worldwide. There are no current system-enforced restrictions when you
install this software category.
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).
Installation Categories on the J Series Routers■27
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. If any configuration rules affect your PIC combinations, the
installation process stops and displays a message similar to the following:
The combination of PICS in FPC slot 3 is not supported with this release
PIC slot 0 PIC slot 1 - 1x OC-12 ATM-II IQ
PIC slot 2 - 1x G/E IQ, 1000 BASE
PIC slot 3 - 1x Link Service (4)
If you continue the installation, one or more PICs on
FPC slot 3 might appear to be online but
cannot be enabled and cannot pass traffic with this release of JUNOS.
See the Release Notes for more information.
WARNING: This installation attempt will be aborted. If you
WARNING: wish to force the installation despite these warnings
WARNING: you may use the 'force' option on the command line.
pkg_add: package /var/tmp/jbundle-7.6R1.x-domestic-signed.tgz fails requirements
- not installed
The configuration checker has the following limitations:
■If a PIC is offline when you upgrade the router with new software, the
configuration checker cannot detect PIC combinations affected by configuration
rules and cannot warn about them.
■
If you specify the force option when you upgrade the JUNOS Software, the
configuration checker warns about the affected PIC combination and the software
installation continues. However, after rebooting, one or more PICs might fail to
initialize.
■The configuration checker looks for combinations of three affected PICs. If an
Enhanced FPC contains four affected PICs, the script generates multiple warnings.
If you install a PIC into a router already running JUNOS Software, you can identify
the presence of affected PIC combinations from messages in the system logging
(syslog) file:
Feb 6 17:57:40 CE1 feb BCHIP 0: uCode overflow - needs 129 inst space to load
b3_atm2_LSI_decode for stream 12
Feb 6 17:57:41 CE1 chassisd[2314]: CHASSISD_IFDEV_DETACH_PIC:
ifdev_detach_pic(0/3)
Feb 6 17:57:41 CE1 feb BCHIP 0: binding b3_atm2_LSI_decode to stream 12 failed
Feb 6 17:57:41 CE1 feb PFE: can not bind B3 ucode prog b3_atm2_LSI_decode to FPC
0: stream 12
For more information about checking for unsupported PIC combinations, see the
corresponding PIC guide for your router, the JUNOS Release Notes, and TechnicalSupport Bulletin PSN-2004-12-002, PIC Combination Notes Summary on the Juniper
Networks Support Web site at http://www.juniper.net/support/.
28■Verifying PIC Combinations
Page 51
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” on page 25
NOTE: When you upgrade from a previous installation of the JUNOS Software to
Release 8.4R1 or later on an MX Series router, the MAC addresses on the Dense Port
Concentrator (DPC) Ethernet ports change.
The change category installation process is used to move from one category of the
JUNOS Software to another. For example, you can move from standard JUNOS on
an M Series router to the export version of JUNOS Software. When performing a
software category change, you need to take special precautions during the installation.
These precautions delete the previous installation and prevent users from rolling
back the server to these older installations.
This chapter discusses the following topics:
■Checking the Current Configuration and Candidate Software
Compatibility on page 30
■Determining the JUNOS Software Version on page 30
■Downloading Software on page 30
■Connecting to the Console Port on page 32
■Backing Up the Current Installation (M Series, MX Series, T Series, TX Matrix,
and TX Matrix Plus Routers) on page 32
■Backing Up the Current Installation (J Series Routers) on page 33
■Installing the Software Package on a Router with a Single Routing
Engine on page 33
■Installing the Software Package on a Router with Redundant Routing
Engines on page 34
■Upgrading Individual Software Packages on page 39
■Upgrading Routers Using ISSU on page 41
■29
Page 52
JUNOS Release 10.2 Software Installation and Upgrade Guide
Checking the Current Configuration and Candidate Software Compatibility
When you upgrade or downgrade JUNOS Software, we recommend that you include
the validate option with the request system software add command to check that the
candidate software is compatible with the current configuration. By default, when
you add a package with a different release number, the validation check is done
automatically. For more information about the request system software add command,
see the JUNOS System Basics and Services Command Reference.
Determining the JUNOS Software Version
To determine which software packages are running on the router and to get
information about these packages, use the show version operational mode command
at the top level of the command-line interface (CLI).
NOTE: The show version command does not show the software category installed,
only the release number of the software.
Downloading Software
You can download the software in one of two ways: downloading the file in a browser
or using FTP on the command line:
■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. If you need help obtaining an account, complete the registration
form at the Juniper Networks Web site: https://www.juniper.net/registration/Register.jsp.
To download the software:
1.
In a browser, go to http://www.juniper.net/support/.
The Support page opens.
2.In the Download Software section, select the software version to download.
Depending on your location, select JUNOS Canada and US, or JUNOS Worldwide.
3.Select the current release to download.
4.Click the Software tab and select the JUNOS Installation Package to download.
30■Checking the Current Configuration and Candidate Software Compatibility
Page 53
Chapter 4: Completing a Standard or Change Category Installation
A dialog box opens.
5.Save the file to your system. If you are placing the file on a remote system, you
must make sure that the file can be accessible by the router using 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. If you need help obtaining an account, complete the registration
form at the Juniper Networks Web site: https://www.juniper.net/registration/Register.jsp.
To download the software:
1.
On the command line, initiate an FTP session with the server ftp.juniper.net:
ftp ftp.juniper.net
2.Log in with your customer support–supplied username and password:
User <black.juniper.net:<none>>: username
331 Password required for username.
Password: password
Once validated, the FTP session opens.
3.Navigate to the correct software directory.
The FTP server software download directory structure is as follows:
release—The software release. For more information on release numbers,
see “JUNOS Software Release Numbers” on page 8.
4.Set the file transfer mode to binary:
5.Specify the directory in which you wish to place the file.
bin
Type set to 1.
Downloading Software Using the Command-Line Interface■31
Page 54
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 /var/tmp directory. If you are placing the file on
a remote system, you must make sure that the file can be accessed by the router
using HTTP, FTP, or scp.
lcd /var/tmp
Local directory now /var/tmp.
6.Download the installation file:
get <filename>
7.Close the FTP session:
bye
Goodbye.
Connecting to the Console Port
The console port is a data terminal equipment (DTE) interface, providing a direct
and continuous interface with the router. It is important to connect to the console
during installation procedures so you can respond to any required user input and
detect any errors that may occur.
For more information about connecting to the console port, see the administration
guide for your particular router.
Backing Up the Current Installation (M Series, MX Series, T Series, TX Matrix, and
TX Matrix Plus Routers)
You should back up the current installation so that you can return to the current
software installation. In a dual Routing Engine system, you need to back up both
Routing Engines. This section covers the following:
The installation process using the installation package (jinstall*, for example) removes
all stored files on the router except the juniper.conf and SSH files. Therefore, you
should back up your current configuration in case you need to return to the current
software installation after running the installation program.
To back up the JUNOS Software on the M Series, MX Series, T Series, TX Matrix, and
TX Matrix Plus routers, issue the request system snapshot CLI operational command.
This command saves the current software installation on the hard drive.
NOTE: On M Series, MX Series, T Series, TX Matrix, and TX Matrix Plus routers with
dual Routing Engines, complete this operation on both Routing Engines. On routers
without a CompactFlash card, where the hard drive is the primary boot device, you
cannot back up your software installation.
32■Connecting to the Console Port
Page 55
Chapter 4: Completing a Standard or Change Category Installation
When the request system snapshot command is issued, 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. When the backup is completed, the current and backup
software installations are identical.
To copy the files to the router’s hard disk, use the following command:
user@host> request system snapshot
Backing Up the Current Installation (J Series Routers)
You should back up the current installation so that you can return to the current
software installation. In a dual Routing Engine system, you need to back up both
Routing Engines. This section covers the following:
The installation process using the installation package (junos-jsr*) removes all stored
files on the router except the juniper.conf and SSH files. Therefore, you should back
up your current configuration in case you need to return to the current software
installation after running the installation program.
These instructions offer the minimum steps required to create a backup during the
installation process. For a complete description of the backup process on the J Series
routers, see the J Series Services Router Administration Guide and the JUNOS SoftwareSystems Basics Configuration Guide.
To back up the JUNOS Software on the J Series routers:
1.Attach an external memory device to the router.
NOTE: Even when attached to a J Series router, the USB memory device is not listed
as a storage device in the show system storage CLI command output. You can view
the installed USB memory device on the J-Web interface’s system monitor screen.
2.
Issue the request system snapshot media usb command.
The current software installation and configuration are saved on the external
USB storage device.
Installing the Software Package on a Router with a Single Routing Engine
To upgrade the router software, follow these steps:
1.
Install the new software package using the request system software add command:
installation-package is the name of the installation package; for example
jinstall-9.2R1.8–domestic-signed.tgz
For more information about the request system software add command, see the
JUNOS System Basics and Services Command Reference.
user@host> request system software add /var/tmp/installation-package
Backing Up the Current Installation (J Series Routers)■33
Page 56
JUNOS Release 10.2 Software Installation and Upgrade Guide
2.
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.
To abort the installation, do not reboot the device; instead, finish the installation and
then issue the request system software delete jinstall command. This is your last
chance to stop the installation.
The software is loaded when you reboot the system. Installation can take between
5 and 10 minutes. The router then reboots from the boot device on which the
software was just installed. When the reboot is complete, the router displays the
login prompt.
While the software is being upgraded, the Routing Engine on which you are
performing the installation does not route traffic.
3.
Log in and issue the show version command to verify the version of the software
installed.
4.
(Optional) Add the jweb package using the request system software add command.
Before you can add this package, you must first download the software as you
did the installation package. For more information on downloading the jweb
package, see “Downloading Software” on page 30.
The jweb installation module adds a router management graphical user interface
that you can use to view and configure your router. For more information about
the jweb package, see “Installation Modules” on page 7.
5.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.
Installing the Software Package on a Router with Redundant Routing Engines
If the router has two Routing Engines, perform a JUNOS Software installation on each
Routing Engine separately to avoid disrupting network operation. Install the new
JUNOS Software release on the backup Routing Engine while keeping the currently
running software version on the master Routing Engine. After making sure that the
new software version is running correctly on the backup Routing Engine, switch over
to the newly installed Routing Engine to activate the new software. Finally, install
the new software on the new backup Routing Engine.
WARNING: If graceful Routing Engine switchover (GRES) is enabled when you initiate
a software installation, the software does not install properly. Make sure you issue
34■Installing the Software Package on a Router with Redundant Routing Engines
Page 57
the CLI delete chassis redundancy command when prompted. If GRES is enabled, it
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
Preparing the Router for the Installation
Perform the following steps before installing the software:
1.Log in to the master Routing Engine’s console.
Chapter 4: Completing a Standard or Change Category Installation
For more information on logging in to the Routing Engine through the console
port, see the administration manual for your particular router.
2.Enter the JUNOS Software CLI configuration mode:
Start the CLI from the shell prompt:
a.
# cli
user@host>
Enter configuration mode:
b.
user@host#> configure
Entering configuration mode
[edit]
user@host#
3.Disable Routing Engine redundancy:
[edit]
user@host# delete chassis redundancy
4.Save the configuration change on both Routing Engines:
[edit]
user@host# commit synchronize
Exit out of the CLI configuration mode:
5.
[edit]
user@host# exit
Preparing the Router for the Installation■35
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.
1.Log in to the backup Routing Engine’s console:
For more information on logging in to the Routing Engine through the console
port, see the administration manual for your particular router.
2.
Install the new software package using the request system software add command:
user@host> request system software add validate
/var/tmp/jinstall-9.2R1.8–domestic-signed.tgz
For more information on the request system software add command, see the
JUNOS System Basics and Services Command Reference.
3.
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 router.
To abort the installation, do not reboot your device, instead, finish the installation
and then issue the request system software delete jinstall command. This is your last
chance to stop the installation.
All the software is loaded when you reboot the device. Installation can take
between 5 and 10 minutes. The router then reboots from the boot device on
which the software was just installed. When the reboot is complete, the router
displays the login prompt.
While the software is being upgraded, the Routing Engine on which you are
performing the installation is not routing traffic.
4.
Log in and issue the show version command to verify the version of the software
installed.
5.
(Optional) Add the jweb package using the request system software add command.
Before you can add this package, you must first download the software as you
did the installation package. For more information on downloading the jweb
package, see “Downloading Software” on page 30.
The jweb installation module adds a router management graphical user interface
that you can use to view and configure your router. For more information about
the jweb package, see “Installation Modules” on page 7.
36■Installing Software on the Backup Routing Engine
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:
1.Log in to the primary Routing Engine console port.
For more information on logging in to the Routing Engine through the console
port, see the administration guide for your particular router.
Transfer routing control to the backup Routing Engine:
For more information about the request chassis routing-engine master command,
see the JUNOS System Basics and Services Command Reference.
3.Verify that the backup Routing Engine (slot 1) is the master Routing Engine:
user@host> show chassis routing-engine
Routing Engine status:
Slot 0:
Current state Backup
Election priority Master (default)
Routing Engine status:
Slot 1:
Current state Master
Election priority Backup (default)
4.
Install the new software package using the request system software add command:
user@host> request system software add validate
/var/tmp/jinstall-9.2R1.8–domestic-signed.tgz
For more information about the request system software add command, see the
JUNOS System Basics and Services Command Reference.
5.
Reboot the Routing Engine using the request system reboot command:
user@host> request system reboot
Reboot the system? [yes, no] (no) yes
NOTE: You must reboot to load the new installation of the JUNOS Software on the
router.
To abort the installation, do not reboot your system; instead, finish the installation
and then issue the request system software delete jinstall command. This is your last
chance to stop the installation.
The software is loaded when you reboot the system. Installation can take between
5 and 10 minutes. The router then reboots from the boot device on which the
software was just installed. When the reboot is complete, the router displays the
login prompt.
Installing Software on the Primary Routing Engine■37
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.
6.
Log in and issue the show version command to verify the version of the software
installed.
7.
(Optional) Add the jweb package using the request system software add command.
Before you can add this package, you must first download the software as you
did the installation package. For more information on downloading the jweb
package, see “Downloading Software” on page 30.
The jweb installation module adds a router management graphical user interface
that you can use to view and configure your router. For more information about
the jweb package, see “Installation Modules” on page 7.
Transfer routing control back to the master Routing Engine:
For more information about the request chassis routing-engine master command,
see the JUNOS System Basics and Services Command Reference.
9.Verify the master Routing Engine (slot 0) is indeed the master Routing Engine:
Finalizing the Installation
Once the software is installed on both Routing Engines, you return the router back
to its original configuration and back up the new installation.
1.Restore the configuration that existed before you deleted it at the start of this
2.Save the configuration change on both Routing Engines:
user@host> show chassis routing-engine
Routing Engine status:
Slot 0:
Current state Master
Election priority Master (default)
outing Engine status:
Slot 1:
Current state Backup
Election priority Backup (default)
procedure:
{backup}
user@host-re0> configure
[edit]
user@host-re0# rollback 1
3.After you have installed the new software and are satisfied that it is successfully
running, issue the request system snapshot command to back up the new software
on both master and backup Routing Engines:
38■Finalizing the Installation
[edit]
user@host-re0> commit synchronize and-quit
{master}
Page 61
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 /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.
For more information on the request routing-engine login command, see the
JUNOS System Basics and Services Command Reference.
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.
Upgrading Individual Software Packages
NOTE: When you install individual software packages, the following notes apply:
■When upgrading from JUNOS Release 8.2 or earlier to JUNOS Release 8.5, use
the system software add <image> no-validate command option.
■
Only use the jinstall JUNOS Software image when upgrading or downgrading to
or from JUNOS Release 8.5. Do not use the jbundle image.
■Before upgrading to JUNOS 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.)
Upgrading Individual Software Packages■39
Page 62
JUNOS Release 10.2 Software Installation and Upgrade Guide
To upgrade an individual JUNOS Software package, follow these steps:
1.Download the software packages you need from the Juniper Networks Support
Web site at http://www.juniper.net/support/. Choose either the Canada and U.S.
Version or the Worldwide Version.
To download the software packages, you must have a service contract and an
access account. If you need help obtaining an account, complete the registration
form at the Juniper Networks Web site:
NOTE: We recommend that you upgrade all individual software packages using an
out-of-band connection from the console or fxp0 interface, because in-band
connections can be lost during the upgrade process. On a TX Matrix Plus router and
the T1600 routers in a routing matrix, the management Ethernet interface is em0.
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.
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
user@host> request system software add/var/tmp/ installation package validate
installation-package is the full URL to the file.
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.
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:
40■Upgrading Individual Software Packages
Page 63
Chapter 4: Completing a Standard or Change Category Installation
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 more information about the request system software add command, see the
JUNOS 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
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.
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.
Upgrading Routers Using ISSU
Unified in-service software upgrade (ISSU) enables you to upgrade between two
different JUNOS Software releases with no disruption on the control plane and with
minimal disruption of traffic. ISSU is only supported by dual Routing Engine platforms.
In addition, graceful Routing Engine switchover (GRES) and nonstop active routing
(NSR) must be enabled.
For additional information about using ISSU, see the JUNOS High Availability Guide.
Upgrading Routers Using ISSU■41
Page 64
JUNOS Release 10.2 Software Installation and Upgrade Guide
42■Upgrading Routers Using ISSU
Page 65
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.
This chapter discusses the following topics:
■Creating an Emergency Boot Disk on page 43
■Saving a Rescue Configuration File on page 44
■Performing a Recovery Installation on page 45
■Creating a New Configuration on a Single Routing Engine on page 46
■Creating a New Configuration with Redundant Routing Engines on page 51
■Restoring a Saved Configuration on page 56
Creating an Emergency Boot Disk
If the router’s JUNOS Software is damaged in some way that prevents the JUNOS
Software from loading completely, you can use the emergency boot disk to revive
the router. The emergency boot disk repartitions the primary disk and reloads a fresh
installation of the JUNOS Software.
The procedures outlined in this section discuss how to create an emergency boot
disk for any M Series, MX Series, T Series, TX Matrix, or TX Matrix Plus router.
To create an emergency boot disk:
1.
Use FTP to copy the installation media into the router’s /var/tmp directory.
2.Insert the PC Card into the external PC Card slot.
3.
In the UNIX shell, navigate to the /var/tmp directory:
start shell
cd /var/tmp
4.
Log in as su:
su [enter]
password: [enter SU password]
Creating an Emergency Boot Disk■43
Page 66
JUNOS Release 10.2 Software Installation and Upgrade Guide
externalDrive—Refers to the removable media name. For example, the
removable media name on the M120 is da0 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)” on page 16.
■
installMedia—Refers to the installation media downloaded into the /var/tmp
directory. For example, install-media-9.0R2.10–domestic.tgz.
The following code example can be used to create an emergency boot disk using
a PC Card on an M20 router:
A rescue configuration file is helpful in the event that your router’s configuration file
has been misconfigured. You can restore the router to this rescue configuration to
bring the router back online. If you save this file off the router, the rescue configuration
can also be used to restore your router in the event of a software failure.
To save a current router configuration as a rescue configuration file:
1.Edit the configuration file on the router to reflect the base configuration you wish
to use.
For more information about editing the configuration, see the JUNOS SystemBasics Guide.
2.In the CLI operational mode, save this edited base configuration as the rescue
configuration file:
3.Copy the rescue configuration to a remote server:
44■Saving a Rescue Configuration File
user@host> request system configuration rescue save
Page 67
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. Once you have recovered the software you will need to restore the
router’s configuration. You can either create a new configuration as you did when
the router was shipped from the factory, or if you saved the router's previous
configuration, you can simply restore that file to the system.
Chapter 5: Completing a Recovery Installation
Depending on the situation, you should try to perform the following steps before you
perform the recovery installation:
1.Ensure you have an emergency recovery disk to use during the installation. When
the router is first shipped, an emergency recovery disk is provided with it. For
instructions on creating an emergency boot disk, see “Creating an Emergency
Boot Disk” on page 43
2.
Copy the existing configuration in the file /config/juniper.conf.gz from the router
to a remote system. For extra safety, you can also copy the backup configurations
(the files named /config/juniper.conf.n, where n is a number from 0 through 9).
WARNING: The recovery installation process completely overwrites the entire contents
of the fixed storage media.
3.Copy any other stored files to a remote system as desired.
To reinstall the JUNOS Software:
1.Insert the removable media into the router.
NOTE: You can store a configuration on installation media such as a PC Card.
2.Reboot the router. Do not power off the router if it is already on. Issue the CLI
request system reboot command.
3.When the software prompts you with the following question, type y:
Performing a Recovery Installation■45
Page 68
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
4.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.
5.Remove the removable media when prompted. The router then reboots from
the boot device on which the software was just installed. When the reboot is
complete, the router displays the login prompt.
6.Create a new configuration as you did when the router was shipped from the
factory, or restore a previously saved configuration file to the system. For more
information, see “Creating a New Configuration on a Single Routing Engine” on
page 46, “Creating a New Configuration with Redundant Routing Engines” on
page 51, and “Restoring a Saved Configuration” on page 56.
Creating a New Configuration on a Single Routing Engine
To create a new base configuration on a single Routing Engine:
■Log In to the Router Console on page 46
■Configure Administration User Accounts on page 47
■Add the Management Console to the Network on page 47
■Commit Changes on page 49
Log In to the Router Console
To log in to the router’s console interface and open the CLI in configuration mode:
1.Verify the router is powered on.
2.Log in through the console port as root.
Amnesiac <ttyd0>
login: root
NOTE: From the factory, the root administration user account is not associated with
a password. However, you must add a password to the root administration account
before you can successfully commit a configuration.
3.Start the CLI, which initially opens in operational mode. Note the command
prompt ends with > in the CLI operational mode.
4.
Enter the CLI configuration mode. Note the command prompt ends with # in
the CLI configuration mode.
46■Creating a New Configuration on a Single Routing Engine
root@% cli
root>
root> configure
Page 69
[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:
1.Add a password to the root (superuser) administration user account.
[edit]
root# set system root-authentication plain-text-password
New password: password
Retype new password: password
2.Create a management console user account.
Chapter 5: Completing a Recovery Installation
[edit]
root# set system login user user-name authentication plain-text-password
New Password: password
Retype new password: password
3.
Set the user account class to super-user.
[edit]
root# set system login user user-name class super-user
Add the Management Console to the Network
To add the management console to the network:
1.Specify the router hostname.
NOTE: The hostname specified in the router configuration is not used by the DNS
server to resolve to the correct IP address. This hostname is used to display the name
of the Routing Engine in the CLI. For example, this hostname appears on the
command line prompt when the user is logged in to the CLI:
user-name@host-name>
2.Configure the IP address of the DNS server.
3.Configure the router domain name.
[edit]
root# set system host-name host-name
[edit]
root# set system name-server address
Configure Administration User Accounts■47
Page 70
JUNOS Release 10.2 Software Installation and Upgrade Guide
[edit]
root# set system domain-name domain-name
4.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
■For TX Matrix Plus and T1600 routers in a routing matrix only:
[edit]
root@# set interfaces em0 unit 0 family inet address address/prefix-length
To use em0 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
5.Configure the IP address of a backup router. The backup router is used while the
local router is booting and if the routing process fails to start. Once the routing
process starts, the backup router address is removed from the local routing and
forwarding tables. For more information on the backup router, see the JUNOSSystem Basics Configuration Guide.
[edit]
root# set system backup-router address
6.(Optional) Configure the static routes to remote subnets with access to the
management port. Access to the management port is limited to the local subnet.
To access the management port from a remote subnet, you need to add a static
route to that subnet within the routing table. For more information on static
routes, see the JUNOS System Basics Configuration Guide.
[edit]
root# set routing-options static route remote-subnet next-hop destination-IP
retain no-readvertise
7.
Configure telnet service at the [edit system services] hierarchy level.
[edit]
root# set system services telnet
48■Add the Management Console to the Network
Page 71
Commit Changes
Chapter 5: Completing a Recovery Installation
Now that you have completed your changes to the configuration file, commit the
configuration changes.
1.Before committing the configuration, you can review your changes to the
configuration with the show command.
root# show
## Last changed: 2008-08-27 22:30:42 UTC
version 9.3B1.5;
system {
host-name tp8;
domain-name subnet.juniper.net;
backup-router 192.168.71.254;
root-authentication {
encrypted-password "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx."; ## SECRET-DATA
}
name-server {
192.168.5.68;
172.17.28.101;
}
login {
user regress {
class super-user;
authentication {
encrypted-password "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"; ##
SECRET-DATA
}
}
}
services {
telnet;
}
syslog {
user * {
any emergency;
}
file messages {
any notice;
authorization info;
}
file interactive-commands {
interactive-commands any;
}
}
}
interfaces {
fxp0 {
unit 0 {
family inet {
address 192.128.69.205/21;
}
}
Commit Changes■49
Page 72
JUNOS Release 10.2 Software Installation and Upgrade Guide
NOTE: If you receive an error message after you issue the commit statement, you
can review the configuration using the show command to find the errors in your
configuration. You can delete incorrect entries using the delete command. For
example, to delete a hostname from the configuration, issue the following statement:
[edit]
root# delete system host-name host-name
3.Exit configuration mode.
[edit]
root# exit
Exiting configuration mode
root>
Creating a New Configuration with Redundant Routing Engines
To create a new base configuration on a router with redundant Routing Engines:
■Configure Administration User Accounts on page 51
■Set Up Routing Engine Configuration Groups on page 52
■Complete the Management Console Configuration on page 54
■Commit and Synchronize Changes on page 54
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:
1.Add a password to the root (superuser) administration user account.
[edit]
root# set system root-authentication plain-text-password
New password: password
Retype new password: password
2.Create a management console user account.
3.
Set the user account class to super-user.
[edit]
root# set system login user user-name authentication plain-text-password
New Password: password
Retype new password: password
[edit]
Creating a New Configuration with Redundant Routing Engines■51
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. Within this configuration, create two Routing Engine groups, one for each
Routing Engine. Within these groups, you specify the Routing Engine–specific
parameters.
For more information about creating configuration groups, see JUNOS® Software CLIUser Guide.
For more information about the initial configuration for redundant Routing Engine
systems and the re0 group, see JUNOS® Software High Availability Configuration Guide.
1.
Create the configuration group re0. The re0 group is a special group designator
that is only used by RE0 in a redundant routing platform.
[edit]
root# set groups re0
2.
Navigate to the groups re0 level of the configuration hierarchy.
[edit]
root# edit groups re0
3.Specify the router hostname.
[edit groups re0]
root# set system host-name host-name
NOTE: The hostname specified in the router configuration is not used by the DNS
server to resolve to the correct IP address. This hostname is used to display the name
of the Routing Engine in the CLI. For example, the hostname appears at the
command-line prompt when the user is logged in to the CLI:
user-name@host-name>
4.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:
■For TX Matrix Plus and T1600 routers in a routing matrix only:
52■Set Up Routing Engine Configuration Groups
[edit]
root@# set interfaces fxp0 unit 0 family inet address address/prefix-length
[edit]
root@# set interfaces em0 unit 0 family inet address address/prefix-length
Page 75
Chapter 5: Completing a Recovery Installation
To use em0 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
Return to the top level of the hierarchy.
5.
[edit groups re0]
root# top
6.
Create the configuration group re1.
[edit]
root# set groups re1
7.
Navigate to the groups re1 level of the configuration hierarchy.
[edit]
root# edit groups re1
8.Specify the router hostname.
[edit groups re1]
root# set system host-name host-name
9.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
■For TX Matrix Plus and T1600 routers in a routing matrix only:
[edit]
root@# set interfaces em0 unit 0 family inet address address/prefix-length
To use em0 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
Return to the top level of the hierarchy.
10.
Specify the group application order.
11.
[edit groups re0]
root# top
[edit]
Set Up Routing Engine Configuration Groups■53
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.
1.Configure the IP address of the DNS server.
[edit]
root# set system name-server address
2.Configure the router domain name.
[edit]
root# set system domain-name domain-name
3.Configure the IP address of a backup router. The backup router is used while the
local router is booting and if the routing process fails to start. Once the routing
process starts, the backup router address is removed from the local routing and
forwarding tables. For more information about the backup router, see the JUNOSSystem Basics Configuration Guide.
[edit]
root# set system backup-router address
4.(Optional) Configure the static routes to remote subnets with access to the
management port. Access to the management port is limited to the local subnet.
To access the management port from a remote subnet, you need to add a static
route to that subnet within the routing table. For more information about static
routes, see the JUNOS System Basics Configuration Guide.
[edit]
root# set routing-options static route remote-subnet next-hop destination-IP
retain no-readvertise
5.
Configure telnet service at the [edit system services] hierarchy level.
[edit]
root# set system services telnet
Commit and Synchronize Changes
Commit the configuration changes. When you issue the synchronize command, the
configuration is shared between both Routing Engines and committed on both Routing
Engines simultaneously.
1.Before committing the configuration, you can review the configuration entries
using the show command.
54■Complete the Management Console Configuration
root# show
## Last changed: 2008-10-17 18:32:25 UTC
version 9.1R1.8;
groups {
re0 {
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;
}
apply-groups [ re0 re1 ];
system {
domain-name englab.juniper.net;
backup-router 192.168.71.254;
root-authentication {
encrypted-password "xxxxxxxxxxx"; ## SECRET-DATA
}
name-server {
192.168.1.1;
}
login {
user regress {
uid 2001;
class super-user;
authentication {
encrypted-password "xxxxxxxxxxx"; ## SECRET-DATA
}
}
}
services {
telnet;
}
syslog {
user * {
any emergency;
}
file messages {
Commit and Synchronize Changes■55
Page 78
JUNOS Release 10.2 Software Installation and Upgrade Guide
If you receive an error message after you issue the commit statement, you can
review the configuration using the show command to find the errors in your
configuration. You can delete incorrect entries using the delete command. For
example, to delete a hostname from the configuration, issue the following
command:
[edit]
root# delete system host-name host-name
3.Exit configuration mode.
[edit]
root# exit
Exiting configuration mode
Restoring a Saved Configuration
To restore a saved configuration, perform the following tasks:
1. Copy Saved Files to the Router on page 57
2. Load and Commit the Configuration File on page 57
56■Restoring a Saved Configuration
root>
Page 79
Copy Saved Files to the Router
To copy the saved configuration to the router:
1.
Log in to the console as root. There is no password.
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. Access through the management ports and interfaces is set in the
configuration. For information about accessing the router through the console
port, see the administration guide for your particular router.
Chapter 5: Completing a Recovery Installation
2.Start the CLI:
# cli
3.
Copy the configuration file on the remote server to the router’s /var/tmp directory:
root@host> ftp remote-server
user: username
password: password
ftp> bin
Type set to I.
ftp> get /path/file
ftp> bye
Goodbye.
Load and Commit the Configuration File
Once the saved configuration file is copied to the router, you load and commit the
file:
2.Load the file into the current configuration. You should override the existing file.
3.Commit the file.
user@host#
load override /var/tmp/filename
load complete
Copy Saved Files to the Router■57
Page 80
JUNOS Release 10.2 Software Installation and Upgrade Guide
user@host# commit
commit complete
4.Exit the CLI configuration mode.
user@host# exit
user@host>
5.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
request system snapshot command to back up the new software to the /altconfig
file system. If you do not issue the request system snapshot command, the
configuration on the alternate boot drive will be out of sync with the configuration
on the primary boot drive.
The request system snapshot command causes the root file system to be backed
up to /altroot, and /config to be 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.
58■Load and Commit the Configuration File
Page 81
Part 3
JUNOS Software Licenses
■JUNOS Software Licenses Overview on page 61
■Managing JUNOS Software Licenses on page 65
JUNOS Software Licenses■59
Page 82
JUNOS Release 10.2 Software Installation and Upgrade Guide
60■JUNOS Software Licenses
Page 83
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. 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.
For information about how to purchase JUNOS Software licenses, contact your Juniper
Networks sales representative.
As an honor-based licensing structure, JUNOS feature and scaling licenses are
universal, and the same feature or scaling key can be installed and configured on
multiple routers. However, to conform to JUNOS feature or scale licensing
requirements, you must purchase one license per router.
License Enforcement
For features or scaling levels that require a license, you must install and properly
configure the license to meet the requirements for using the licensable feature or
scale level. The router enables you to commit a configuration that specifies a licensable
feature or scale without a license for a 30-day grace period. The grace period is a
short-term grant that enables you to start using features in the pack or scale up to
the system limits (regardless of the license key limit) without a license key installed.
The grace period begins when the licensable feature or scaling level is actually used
by the router (not when it is first committed). In other words, you can commit
licensable features or scaling limits to the router configuration, but the grace period
does not begin until the router uses the licensable feature or exceeds a licensable
scaling level.
JUNOS Feature Licenses■61
Page 84
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. When the configuration
is committed, the router does not issue any license warnings, because it is not yet
known whether AAA or L2TP is using the configuration. However, at runtime, the
router checks for a license when AAA authenticates clients, but does not check when
L2TP authenticates clients.
The router reports any license breach as a warning log message whenever a
configuration is committed that contains a feature or scale limit usage that requires
a license. Following the 30-day grace period, the router periodically reports the breach
to the CLI command line until a license is installed and properly configured on the
router to resolve the breach.
NOTE: Successful commitment of a licensable feature or scaling configuration does
not imply that the required licenses are installed or not required. If a required license
is not present, the system issues a warning message after it commits the configuration.
Software Feature Licenses
Each license is tied to one software feature pack or scaling level, and that license is
valid for only one router. Table 5 on page 62 lists the software features, their current
level of support, and the license name.
The license data defines the device ID for which the license is valid and the version
of the license.
License Key Components■63
Page 86
JUNOS Release 10.2 Software Installation and Upgrade Guide
64■License Key Components
Page 87
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.
■Establish basic network connectivity with the router. For instructions on
establishing basic connectivity, see the Getting Started Guide for your router.
To add a new license key to the router with the CLI:
1.Enter operational mode in the CLI.
2.Enter one of the following CLI commands:
■To add a license key from a file or URL, enter the following command,
specifying the filename or the URL where the key is located:
user@host> request system license add filename | url
■To add a license key from the terminal, enter the following command:
user@host> request system license add terminal
3.When prompted, enter the license key, separating multiple license keys with a
blank line.
If the license key you enter is invalid, an error appears in the CLI output when
you press Ctrl+d to exit license entry mode.
4.Go on to “Verifying JUNOS Licenses” on page 66.
Adding New Licenses■65
Page 88
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:
1.Enter operational mode in the CLI.
2.Enter the following command for each license, specifying the license ID. You
can delete only one license at a time.
user@host> request system license delete license-id
3.Go on to “Verifying JUNOS Licenses” on page 66.
Saving License Keys
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 save the licenses installed on the router to a file using the CLI:
1.Enter operational mode in the CLI.
2.To save the installed license keys to a file or URL, enter the following command:
user@host> request system license save filename | url
For example, the following command saves the installed license keys to a file
named license.config:
user@host> request system license save ftp://user@host/license.config
3.Go on to “Verifying JUNOS Licenses” on page 66.
Verifying JUNOS Licenses
To verify JUNOS license management, perform the following tasks:
■Displaying Installed Licenses on page 66
■Displaying License Usage on page 67
■Displaying Installed License Keys on page 68
Displaying Installed Licenses
PurposeVerify that the expected licenses are installed and active on the router.
66■Deleting a License
Page 89
ActionFrom the CLI, enter the show system license command.
Licenses installed:
License identifier: E000185416
License version: 2
Features:
subscriber-acct - Per Subscriber Radius Accounting
permanent
subscriber-auth - Per Subscriber Radius Authentication
permanent
subscriber-addr - Address Pool Assignment
permanent
subscriber-vlan - Dynamic Auto-sensed Vlan
permanent
subscriber-ip - Dynamic and Static IP
permanent
Chapter 7: Managing JUNOS Software Licenses
MeaningThe output shows a list of the license usage and a list of the licenses installed on the
router. Verify the following information:
■Each license is present. Licenses are listed in ascending alphanumeric order by
■The state of each license is permanent.
NOTE: A state of invalid indicates that the license key is not a valid license key. Either
it was entered incorrectly or it is not valid for the specific device.
■The feature for each license is the expected feature. The features enabled are
■All configured features have the required licenses installed. The Licenses needed
Displaying License Usage
PurposeVerify that the licenses fully cover the feature configuration on the router.
ActionFrom the CLI, enter the show system license usage command.
license ID.
listed by license. An all-inclusive license has All features listed.
column must show that no licenses are required.
Displaying License Usage■67
Page 90
JUNOS Release 10.2 Software Installation and Upgrade Guide
Sample Outputuser@router> show system license usage
Licenses Licenses Licenses Expiry
Feature name used installed needed
subscriber-addr 1 0 1 29 days
scale-subscriber 0 1000 0 permanent
scale-l2tp 0 1000 0 permanent
scale-mobile-ip 0 1000 0 permanent
MeaningThe output shows any licenses installed on the router and how they are used. Verify
the following information:
■Any configured licenses appear in the output. The output lists features in
ascending alphabetical order by license name. The number of licenses appears
in the third column. Verify that you have installed the appropriate number of
licenses.
■The number of used licenses matches the number of configured features. If a
licensed feature is configured, the feature is considered used. The sample output
shows that the subscriber address pooling feature is configured.
■A license is installed on the router for each configured feature. For every feature
configured that does not have a license, one license is needed.
For example, the sample output shows that the subscriber address feature is
configured but that the license for the feature has not yet been installed. The
license must be installed within the remaining grace period to be in compliance.
Displaying Installed License Keys
PurposeVerify the license keys installed on the router.
ActionFrom the CLI, enter the show system license keys command.
Sample Outputuser@router> show system license keys