Baseline Operation Guide PDF
Baseline Operation Guide PDF
Baseline Operation Guide PDF
This product includes memory allocation software developed by Mark Moraes, copyright © 1988, 1989, 1993, University of Toronto.
This product includes FreeBSD software developed by the University of California, Berkeley, and its contributors. All of the documentation and software
included in the 4.4BSD and 4.4BSD-Lite Releases is copyrighted by The Regents of the University of California. Copyright © 1979, 1980, 1983, 1986, 1988,
1989, 1991, 1992, 1993, 1994. The Regents of the University of California. All rights reserved.
GateD software copyright © 1995, The Regents of the University. All rights reserved. Gate Daemon was originated and developed through release 3.0 by
Cornell University and its collaborators. Gated is based on Kirton’s EGP, UC Berkeley’s routing daemon (routed), and DCN’s HELLO routing protocol.
Development of Gated has been supported in part by the National Science Foundation. Portions of the GateD software copyright © 1988, Regents of the
University of California. All rights reserved. Portions of the GateD software copyright © 1991, D. L. S. Associates.
Juniper Networks, the Juniper Networks logo, NetScreen, and ScreenOS are registered trademarks of Juniper Networks, Inc. in the United States and other
countries. JUNOS and JUNOSe are trademarks 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 Internet Software for M-series and T-series Routing Platforms Baseline Network Operations Guide
Writer: Merisha Wazna
Editor: Sonia Saruba
Covers and template design: Edmonds Design
Thanks to Robert Kim for his outstanding contribution to this book, and Siew Ng for his help.
Revision History
31 March 2004—Revision 1.
10 April 2006—Revision 2.
27 September 2006—Revision 3.
The information in this document is current as of the date listed in the revision history.
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.
Software License
The terms and conditions for using this software are described in the software license contained in the acknowledgment to your purchase order or, to the
extent applicable, to any reseller agreement or end-user purchase agreement executed between you and Juniper Networks. By using this software, you
indicate that you understand and agree to be bound by those terms and conditions.
Generally speaking, the software license restricts the manner in which you are permitted to use the software and may contain prohibitions against certain
uses. The software license may state conditions under which the license is automatically terminated. You should consult the license for further details.
For complete product documentation, please see the Juniper Networks Web site at www.juniper.net/techpubs.
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 Juniper Networks, Inc. and its subsidiaries (collectively “Juniper”), and 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, and updates and
releases of such software, for which Customer has paid the applicable license or support fees to Juniper or an authorized Juniper reseller. "Embedded
Software" means Software which Juniper has embedded in the Juniper 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 the 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 software on multiple computers requires multiple licenses, regardless of whether such computers 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 the Embedded Software on non-Juniper equipment; (j) use the 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.
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 for the Software are exclusive of taxes, withholdings, duties, or levies (collectively “Taxes”). Customer shall be responsible for
paying Taxes arising from the purchase of the license, or importation or use of the Software.
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.
! 3
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 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)).
Abbreviated Table of Contents
About This Guide xi
Part 6 Appendix
Part 7 Index
Index 343
iv ! Table of Contents
Table of Contents
Table of Contents ! v
JUNOS Baseline Network Operations Guide
vi ! Table of Contents
Table of Contents
Part 6 Appendix
Part 7 Index
Index 343
Table of Contents ! ix
JUNOS Baseline Network Operations Guide
x ! Table of Contents
About This Guide
This preface provides the following guidelines for using the JUNOS Internet Software
for M-series and T-series Routing Platforms Baseline Network Operations Guide and
related Juniper Networks, Inc., technical documents:
! Objectives on page xi
Objectives
This guide provides operational information helpful for the most basic tasks
associated with running a network using Juniper Networks products. This guide is
not directly related to any particular release of the JUNOS Internet software.
To obtain the most current version of this manual, refer to the product
documentation page on the Juniper Networks Web site, which is located at
http://www.juniper.net/.
Objectives ! xi
JUNOS Baseline Network Operations Guide
Audience
This guide is designed for Network Operations Center (NOC) personnel who
monitor a Juniper Networks M-series or T-series routing platform.
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:
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.
Chapter Organization
Most chapters in this guide consist of a checklist at the beginning of the chapter
listing the tasks and commands for monitoring the basic functions of a router and a
network. Tasks include displaying various types of information about a router and
the network, upgrading and reinstalling JUNOS software, tracing users and
accounts, and collecting crash data. The tasks and commands are then explained in
step-by-step procedures.
xii ! Audience
:
If the example configuration does not start at the top level of the hierarchy, the
example is a snippet. In this case, use the load merge relative command. These
procedures are described in the following sections.
1. From the HTML or PDF version of the manual, copy a configuration example
into a text file, save the file with a name, and copy the file to a directory on your
routing platform.
For example, copy the following configuration to a file and name the file
ex-script.conf. Copy the ex-script.conf file to the /var/tmp directory on your
routing platform.
system {
scripts {
commit {
file ex-script.xsl;
}
}
}
interfaces {
fxp0 {
disable;
unit 0 {
family inet {
address 10.0.0.1/24;
}
}
}
}
2. Merge the contents of the file into your routing platform configuration by
issuing the load merge configuration mode command:
[edit]
user@host# load merge /var/tmp/ex-script.conf
load complete
Merging a Snippet
To merge a snippet, follow these steps:
1. From the HTML or PDF version of the manual, copy a configuration snippet
into a text file, save the file with a name, and copy the file to a directory on your
routing platform.
For example, copy the following snippet to a file and name the file
ex-script-snippet.conf. Copy the ex-script-snippet.conf file to the /var/tmp
directory on your routing platform.
commit {
file ex-script-snippet.xsl;
}
2. Move to the hierarchy level that is relevant for this snippet by issuing the
following configuration mode command:
[edit]
user@host# edit system scripts
[edit system scripts]
3. Merge the contents of the file into your routing platform configuration by
issuing the load merge relative configuration mode command:
For more information about the load command, see the JUNOS CLI User Guide.
Documentation Conventions
Table 1 defines notice icons used in this guide.
Table 2 defines the text and syntax conventions used in this guide..
Italic typeface ! Introduces important new terms. ! A policy term is a named structure that defines
match conditions and actions.
! Identifies book names. ! JUNOS System Basics Configuration Guide
! Identifies RFC and Internet draft titles. ! RFC 1997, BGP Communities Attribute
Italic sans serif typeface Represents variables (options for which Configure the machine’s domain name:
you substitute a value) in commands or [edit]
configuration statements. root@# set system domain-name domain-name
Sans serif typeface Represents names of configuration ! To configure a stub area, include the stub
statements, commands, files, and statement at the [edit protocols ospf area area-id]
directories; IP addresses; configuration hierarchy level.
hierarchy levels; or labels on routing ! The console port is labeled CONSOLE.
platform components.
< > (angle brackets) Enclose optional keywords or variables. stub <default-metric metric>;
Documentation Conventions ! xv
JUNOS Baseline Network Operations Guide
> (bold right angle bracket) Separates levels in a hierarchy of J-Web In the configuration editor hierarchy, select
selections. Protocols>Ospf.
Book Description
JUNOS Internet Software for M-series and T-series Routing Platforms
Network Operations Guides
Baseline Describes the most basic tasks for running a network using Juniper Networks
products. Tasks include upgrading and reinstalling JUNOS software, gathering basic
system management information, verifying your network topology, and searching
log messages.
Interfaces Describes tasks for monitoring interfaces. Tasks include using loopback testing and
locating alarms.
MPLS Describes tasks for configuring, monitoring, and troubleshooting an example MPLS
network. Tasks include verifying the correct configuration of the MPLS and RSVP
protocols, displaying the status and statistics of MPLS running on all routers in the
network, and using the layered MPLS troubleshooting model to investigate problems
with an MPLS network.
MPLS Log Reference Describes MPLS status and error messages that appear in the output of the show
mpls lsp extensive command. The guide also describes how and when to configure
Constrained Shortest Path First (CSPF) and RSVP trace options, and how to examine
a CSPF or RSVP failure in a sample network.
Hardware Describes tasks for monitoring M-series and T-series routing platforms.
Table 4 lists the software and hardware guides and release notes for Juniper
Networks J-series, M-series, and T-series routing platforms and describes the
contents of each document.
Table 4: Technical Documentation for J-series, M-series, and T-series Routing Platforms (1 of 3)
Document Description
JUNOS Internet Software for J-series, M-series, and T-series Routing Platforms
Configuration Guides
Class of Service Provides an overview of the class-of-service (CoS) functions of the JUNOS software
and describes how to configure CoS features, including configuring multiple
forwarding classes for transmitting packets, defining which packets are placed into
each output queue, scheduling the transmission service level for each queue, and
managing congestion through the random early detection (RED) algorithm.
CLI User Guide Describes how to use the JUNOS command-line interface (CLI) to configure, monitor,
and manage Juniper Networks routing platforms. This material was formerly
covered in JUNOS System Basics Configuration Guide.
Feature Guide Provides a detailed explanation and configuration examples for several of the most
complex features in the JUNOS software.
JUNOS-FIPS (M-series and T-series routing platforms only) Provides an overview of JUNOS-FIPS
140-2 concepts and describes how to install and configure the JUNOS-FIPS software.
Describes FIPS-related commands and how to configure, authorize, and zeroize the
Adaptive Services (AS) II FIPS Physical Interface Card (PIC).
MPLS Applications Provides an overview of traffic engineering concepts and describes how to configure
traffic engineering protocols.
Multicast Protocols Provides an overview of multicast concepts and describes how to configure
multicast routing protocols.
Network Interfaces Provides an overview of the network interface functions of the JUNOS software and
describes how to configure the network interfaces on the routing platform.
Network Management Provides an overview of network management concepts and describes how to
configure various network management features, such as SNMP and accounting
options.
Policy Framework Provides an overview of policy concepts and describes how to configure routing
policy, firewall filters, forwarding options, and cflowd.
Routing Protocols Provides an overview of routing concepts and describes how to configure routing,
routing instances, and unicast routing protocols.
Services Interfaces Provides an overview of the services interfaces functions of the JUNOS software and
describes how to configure the services interfaces on the routing platform.
Software Installation and Upgrade Guide Provides a description of JUNOS software components and packaging, and includes
detailed information about how to initially configure, reinstall, and upgrade the
JUNOS system software. This material was formerly covered in JUNOS System Basics
Configuration Guide.
System Basics Describes Juniper Networks routing platforms, and provides information about how
to configure basic system parameters, supported protocols and software processes,
authentication, and a variety of utilities for managing your router on the network.
VPNs Provides an overview and describes how to configure Layer 2 and Layer 3 virtual
private networks (VPNs), virtual private LAN service (VPLS), and Layer 2 circuits.
Provides configuration examples.
Table 4: Technical Documentation for J-series, M-series, and T-series Routing Platforms (2 of 3)
Document Description
JUNOS References
Hierarchy and RFC Reference Describes the JUNOS configuration mode commands. Provides a hierarchy
reference that displays each level of a configuration hierarchy, and includes all
possible configuration statements that can be used at that level. This material was
formerly covered in JUNOS System Basics Configuration Guide.
Interfaces Command Reference Describes the JUNOS software operational mode commands you use to monitor and
troubleshoot interfaces.
Routing Protocols and Policies Command Describes the JUNOS software operational mode commands you use to monitor and
Reference troubleshoot routing protocols and policies, including firewall filters.
System Basics and Services Command Describes the JUNOS software operational mode commands you use to monitor and
Reference troubleshoot system basics, including commands for real-time monitoring and route
(or path) tracing, system software management, and chassis management. Also
describes commands for monitoring and troubleshooting services such as CoS, IP
Security (IPSec), stateful firewalls, flow collection, and flow monitoring.
System Log Messages Reference Describes how to access and interpret system log messages generated by JUNOS
software modules and provides a reference page for each message.
J-Web User Guide
J-Web Interface User Guide Describes how to use the J-Web GUI to configure, monitor, and manage Juniper
Networks routing platforms.
JUNOS API and Scripting Documentation
JUNOScript API Guide Describes how to use the JUNOScript application programming interface (API) to
monitor and configure Juniper Networks routing platforms.
JUNOS XML API Configuration Reference Provides reference pages for the configuration tag elements in the JUNOS XML API.
JUNOS XML API Operational Reference Provides reference pages for the operational tag elements in the JUNOS XML API.
JUNOS Configuration and Diagnostic Provides an overview, instructions for using, and examples of the commit script and
Automation Guide self-diagnosis features of the JUNOS software. This guide explains how to enforce
custom configuration rules defined in scripts that run at commit time, how to use
commit script macros to provide simplified aliases for frequently used configuration
statements, and how to configure diagnostic event policies and actions associated
with each policy.
NETCONF API Guide Describes how to use the NETCONF API to monitor and configure Juniper Networks
routing platforms.
JUNOS Comprehensive Index and Glossary
Comprehensive Index and Glossary Provides a complete index of all JUNOS software books, the JUNOScript API Guide,
and the NETCONF API Guide. Also provides a comprehensive glossary.
JUNOScope Documentation
JUNOScope Software User Guide Describes the JUNOScope software GUI, how to install and administer the software,
and how to use the software to manage routing platform configuration files and
monitor routing platform operations.
J-series Services Router Documentation
J-series Services Router Getting Started Provides an overview, basic instructions, and specifications for J-series Services
Guide Routers. The guide explains how to prepare your site for installation, unpack and
install the router and its components, install licenses, and establish basic
connectivity.
J-series Services Router Basic LAN and Explains how to configure the interfaces on J-series Services Routers for basic IP
WAN Access Configuration Guide routing with standard routing protocols, ISDN backup, and digital subscriber line
(DSL) connections.
Table 4: Technical Documentation for J-series, M-series, and T-series Routing Platforms (3 of 3)
Document Description
J-series Services Router Advanced WAN Explains how to configure J-series Services Routers in virtual private networks
Access Configuration Guide (VPNs) and multicast networks, configure data link switching (DLSw) services, and
apply routing techniques such as policies, stateless and stateful firewall filters, IP
Security (IPSec) tunnels, and class-of-service (CoS) classification for safer, more
efficient routing.
J-series Services Router Administration Shows how to manage users and operations, monitor network performance,
Guide upgrade software, and diagnose common problems on J-series Services Routers.
M-series and T-series Hardware Documentation
Hardware Guide Describes how to install, maintain, and troubleshoot routing platforms and
components. Each platform has its own hardware guide.
PIC Guide Describes the routing platform PICs. Each platform has its own PIC guide.
Release Notes
JUNOS Release Notes Summarize new features and known problems for a particular software release,
provide corrections and updates to published JUNOS, JUNOScript, and NETCONF
manuals, provide information that might have been omitted from the manuals, and
describe upgrade and downgrade procedures.
Hardware Release Notes Describe the available documentation for the routing platform and the supported
PICs, and summarize known problems with the hardware and accompanying
software. Each platform has its own release notes.
JUNOScope Software Release Notes Contain corrections and updates to the published JUNOScope manual, provide
information that might have been omitted from the manual, and describe upgrade
and downgrade procedures.
J-series Services Router Release Notes Briefly describe the J-series Services Router features, identify known hardware
problems, and provide upgrade and downgrade instructions.
Documentation Feedback
We encourage you to provide feedback, comments, and suggestions so that we can
improve the documentation. Send your comments to
[email protected], or fill out the documentation feedback form at
http://www.juniper.net/techpubs/docbug/docbugreport.html. If you are using e-mail,
be sure to include the following information with your comments:
! Document name
! Page number
Each Juniper Networks M-series and T-series routing platform is a complete routing
system that supports a variety of high-speed interfaces (including SONET/SDH,
Ethernet, and ATM) for large networks and network applications. Juniper Networks
routers share common JUNOS software, features, and technology for compatibility
across platforms.
This chapter provides a general overview of Juniper Networks M-series and T-series
routers and routing platforms:
! 3
JUNOS Baseline Network Operations Guide
Router Architecture
This section describes the following:
! The Routing Engine, which provides Layer 3 routing services and network
management.
! The Packet Forwarding Engine, which provides all operations necessary for
transit packet forwarding.
The Routing Engine and Packet Forwarding Engine perform their primary tasks
independently, while constantly communicating through a high-speed internal link.
This arrangement provides streamlined forwarding and routing control and the
capability to run Internet-scale networks at high speeds.
Figure 1 illustrates the relationship between the Routing Engine and the Packet
Forwarding Engine.
Routing Engine
100-Mbps link
Engine
The Routing Engine constructs and maintains one or more routing tables. From the
routing tables, the Routing Engine derives a table of active routes, called the
forwarding table, which is then copied into the Packet Forwarding Engine.
4 ! Router Architecture
Chapter 1: Juniper Networks Router Overview
The design of the Internet Processor II and T-series Internet Processor ASICs allows
the forwarding table in the Packet Forwarding Engine to be updated without
interrupting forwarding performance (see Figure 2).
Routing protocol
process
Routing Engine
Forwarding table
1240
The Packet Forwarding Engine uses ASICs to perform Layer 2 and Layer 3 packet
switching, route lookups, and packet forwarding. On M-series routers, the Packet
Forwarding Engine includes the router midplane (on an M40 router, the backplane),
Flexible PIC Concentrators (FPCs), Physical Interface Cards (PICs), and other
components, unique to each router, that handle forwarding decisions.
1. Packets enter the router through incoming PIC interfaces, which contain
controllers that perform media-specific processing.
2. The PICs pass the packets to the FPCs, where they are divided into cells and are
distributed to the router’s buffer memory.
Router Architecture ! 5
JUNOS Baseline Network Operations Guide
1. A packet enters through the incoming PIC, which parses and de-encapsulates
the packet, then passes it to the FPC.
2. On the FPC, the Packet Director ASIC distributes packets to the active I/O
Manager ASICs, where each is divided into cells and sent across the midplane
to the Switching and Forwarding Modules (SFMs). (On the M40e router, only
one SFM is online at a time.) In addition, the behavior aggregate (BA) classifier
determines the forwarding treatment for each packet.
Midplane
FPC SFM
Distributed
Buffer
I/O Manager
Packet
Manager
in
Internet
Controller PIC Processor II
Packet
Packet
out
Director
Routing
Engine = ASIC
1921
3. When cells arrive at an SFM, the Distributed Buffer Manager ASIC writes them
into packet buffer memory, which is distributed evenly across the router’s FPCs.
The Distributed Buffer Manager ASIC also extracts information needed for route
lookups and passes the information to the Internet Processor II ASIC.
4. The Internet Processor II ASIC performs the lookup in the full forwarding table,
and finds the outgoing interface and specific next hop for each packet. In
addition, the Internet Processor II ASIC performs filtering, policing, sampling
and mulitfield classification, if configured.
5. The forwarding table forwards all unicast packets that do not have options and
any multicast packets that have been previously cached. Packets with options
are sent to the Routing Engine for resolution.
6. After the Internet Processor II has determined the next hop, it notifies a second
Distributed Buffer Manager ASIC, which forwards the notification to the
outgoing FPC. Queueing policy and rewrites occur at this time on the egress
router. A pointer to the packet is queued at the outgoing port.
6 ! Router Architecture
Chapter 1: Juniper Networks Router Overview
7. When the packet pointer reaches the front of the queue and is ready for
transmission, the cells are read from packet buffer memory and are
reassembled into the packet, which is passed to the outgoing PIC interface.
8. The PIC performs media-specific processing and sends the packet into the
network.
1. Packets enter through an incoming PIC and are passed to the Packet
Forwarding Engine on the originating FPC.
2. The Layer2/Layer 3 Packet Processing ASIC parses the packets and divides them
into cells. In addition, the behavior aggregate (BA) classifier determines the
forwarding treatment for each packet.
Layer 2/Layer 3
Packets Switch
Packet
out PIC Interface
Processing
ASIC
ASIC
ASIC
ASIC ASIC
3. The network-facing Switch Fabric ASIC places the lookup key in a notification
and passes it to the T-series Internet Processor.
4. The Switch Fabric ASIC also passes the data cells to the Queuing and Memory
Interface ASICs for buffering on the FPC.
Router Architecture ! 7
JUNOS Baseline Network Operations Guide
5. The T-series Internet Processor performs the route lookup and forwards the
notification to the Queuing and Memory Interface ASIC. In addition, if
configured filtering, policing, sampling and mulitfield classification, are
performed at this time.
6. The Queuing and Memory Interface ASIC sends the notification to the
switch-fabric-facing Switch Interface ASIC, which sends bandwidth requests
through the switch fabric to the destination port, and issues read requests to the
Queuing and Memory Interface ASIC to begin reading data cells out of memory.
7. The Switch Interface ASIC on the destination FPC sends bandwidth grants
through the switch fabric to the originating Switch Interface ASIC.
8. Upon receipt of each grant, the originating Switch Interface ASIC sends a cell
through the switch fabric to the the destination Packet Forwarding Engine.
10. The T-series Internet Processor performs the route lookup and forwards the
notification to the Queuing and Memory Interface ASIC, which forwards it to
the network-facing Switch Interface ASIC.
11. The Switch Interface ASIC sends requests to the Queuing and Memory Interface
ASIC to read the data cells out of memory, and passes the cells to the
Layer2/Layer 3 Packet Processing ASIC, which reassembles the cells into
packets, performs the necessary Layer 2 encapsulation, and sends the packets
to the outgoing PIC. Queueing policy and rewrites occur at this time on the
egress router.
For more information about the M-series routers and T-series platforms, see the
router platform-specific hardware guide, and the JUNOS Hardware Network
Operations Guide.
8 ! Router Architecture
Chapter 1: Juniper Networks Router Overview
Hardware Components
Each Juniper Networks router consists of a chassis and a set of components,
including FPCs, PICs, Routing Engines, power supplies, cooling system, and cable
management system. Many of the components are field-replaceable units. The
following major components are discussed in this section:
! Chassis on page 9
Chassis
Chassis dimensions are listed in the physical specifications table for each router. For
more information about chassis dimensions, see the router platform-specific
hardware guide.
Each Juniper Networks router features a rigid sheet metal chassis that houses all of
the router components. The chassis are designed to install into a variety of racks,
including standard 19-inch equipment racks, telco center-mount racks, and
four-post racks and cabinets. See Table 5 for the maximum number of each router
type that can be installed into a rack. Each chassis includes mounting ears or
support posts to facilitate rack mounting, and one or more points for connecting an
electrostatic discharge (ESD) wrist strap for use when servicing the router.
Each chassis includes a midplane (called the backplane on an M40 router). The
midplane transfers data packets to and from the FPCs, distributes power to router
components, and provides signal connectivity to the router components for system
monitoring and control.
Hardware Components ! 9
JUNOS Baseline Network Operations Guide
10 ! Hardware Components
Chapter 1: Juniper Networks Router Overview
PICs install into the FPCs (on the M5 and M10 routers, into the FEB). Each FPC can
accept up to four PICs. The PICs for each router are unique to that router.
See Table 7 for the number and type of PICs that are currently supported on each
router.
M20 and
Supported PICs M160 M40e M40 M5 and M10
ATM DS-3 4 per FPC 4 per FPC M5–4, M10–8
ATM E3 4 per FPC 4 per FPC M5–4, M10–8
ATM OC-3 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
ATM OC-12 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Channelized DS-3 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Channelized E1 4 per FPC 4 per FPC M5–4, M10–8
Channelized OC-12 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Channelized STM-1 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Multichannel DS-3 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
DS-3 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
E1 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
E3 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Fast Ethernet 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Gigabit Ethernet 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
10-Gigabit Ethernet 1 per FPC 1 per FPC M5–1, M10–2
ES 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Monitoring Services 4 per FPC
Multilink Services 4 per FPC 4 per FPC M5–4, M10–8
Tunnel Services 4 per FPC 4 per FPC M5–4, M10–8
SONET/SDH OC-3c 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
SONET/SDH OC-12c 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
SONET/SDH OC-48c 4 per FPC 1 per FPC 1 per FPC M5–1, M10–2
SONET/SDH OC-192c 1 per FPC
T1 4 per FPC 4 per FPC 4 per FPC M5–4, M10–8
Hardware Components ! 11
JUNOS Baseline Network Operations Guide
Routing Engine
The Routing Engine consists of an Intel-based PCI platform running the JUNOS
software. The Routing Engine maintains the routing tables used by the router in
which it is installed and controls the routing protocols on the router. The T640
routing node, and the T320, M160, M40e, and M20 routers support up to two
Routing Engines, while the M40, M10, and M5 routers support a single Routing
Engine.
Each Routing Engine consists of a CPU; SDRAM for storage of the routing and
forwarding tables and other processes; a compact flash disk for primary storage of
software images, configuration files, and microcode; a hard disk for secondary
storage; a PC card slot (on some M40 routers, a floppy disk) for storage of software
upgrades; and interfaces for out-of-band management access.
Power Supplies
Each Juniper Networks M-series router and T-series platform has one, two, or four
load-sharing power supplies. A single power supply can provide full power while the
router is operational. The power supplies are redundant: if a power supply is
removed or fails, the other power supplies automatically assume the electrical load.
For more information about the redundant power supplies in each router, see
“Power Supplies” in the router platform-specific hardware guide.
The power supplies are connected to the router midplane (on an M40 router, to the
router backplane), which distributes the different output voltages throughout the
router and its components. Some routers can operate using either AC and DC
power; other routers operate with DC power only. For information about the type of
power used by each router, see the “Electrical Specifications” table in the router
platform-specific hardware guide.
12 ! Hardware Components
Chapter 1: Juniper Networks Router Overview
Cooling System
Each Juniper Networks M-series router and T-series platform features a cooling
system designed to keep all router components within recommended operating
temperature limits. If one component of the cooling system fails or is removed, the
system automatically adjusts the speed of the remaining components to keep the
temperature within the acceptable range. The cooling system for each router is
unique and can consist of fans, impellers, and air filters. For information about the
cooling system components of each router, see the “Major Hardware Components”
table in the router platform-specific hardware guide.
Hardware Components ! 13
JUNOS Baseline Network Operations Guide
NOTE: If the System Control Board (SCB), System and Switch Board (SSB), or
Forwarding Engine Board (FEB) is not running, information about chassis
components is not available through the command-line interface (CLI).
Action To use the CLI to monitor Juniper Networks routers, follow these steps:
1. Log in to the router. The CLI operational mode prompt (>) appears.
If the operational mode prompt does not appear when you log in to the router,
type cli to start the JUNOS software and enter operational mode. The prompt
changes to >, indicating that you are in operational mode.
2. Use one of the operational mode CLI commands listed in Table 9 to monitor
router hardware.
Command Description
show version Displays the router hostname, model number, and version of JUNOS software running
on the router.
show chassis firmware Displays the version of firmware running on the SCB, SFM, SSB, FEB, and FPCs.
show chassis hardware Displays an inventory of the hardware components installed in the router, including
the component name, version, part number, serial number, and a brief description.
show chassis environment Displays environmental information about the router chassis, including the
temperature and status.
show chassis environment Displays more detailed environmental information for the following router
component-name components: FPCs, Front Panel Module (FPM), Miscellaneous Subsystem (MCS), PFE
Clock Generator (PCG), Power Entry Module (PEM) or power supply, control board,
SONET clock generator (SCG), Switch Interface Board (SIB), Routing Engine, and SFM.
This command works only on the M40e, M160, and T320 routers, and the T640
routing node.
show chassis craft-interface Displays operational status information about the router, including the alarm status
and LED status of major components.
show chassis alarms Displays the current router component alarms that have been generated, including the
date, time, severity level, and description.
show chassis component-name Displays more detailed operational status information about the FPCs, Routing Engine,
FEB, SCB, SFMs, and SSB router components, including the temperature of air passing
by the Switch Plane Processor (SPP) card and the Switch Plane Router (SPR) card (the
two SFM serial components), in degrees Centigrade. The command displays the total
CPU DRAM and SRAM being used by the SFM processor. The command output
displays the time that the SFM became active and how long the SFM has been up and
running. A small uptime can indicate a problem.
show log messages Displays the contents of the messages system log file that records messages generated
by component operational events, including error messages generated by component
failures.
To monitor the messages file in real time, use the monitor start messages CLI
command. This command displays the new entries in the file until you stop
monitoring by using the monitor stop messages CLI command.
Command Description
show log chassisd Displays the contents of the chassis daemon (chassisd) log file that keeps track of the
state of each chassis component
To monitor the chassisd file in real time, use the monitor start chassisd CLI command.
This command displays the new entries in the file until you stop monitoring by using
the monitor stop chassisd CLI command.
request support information Use this command when you contact the Juniper Networks Technical Assistance
Center (JTAC) about your component problem. This command is the equivalent of
using the following CLI commands (see “Contact JTAC” on page 15):
! show version
! show chassis firmware
! show chassis hardware
! show chassis environment
! show interfaces extensive (for each configured interface)
! show configuration (excluding any SECRET-DATA)
! show system virtual-memory
Contact JTAC
If you cannot determine the cause of a problem or need additional assistance,
contact JTAC at [email protected] or at 1-888-314-JTAC (within the United States)
or 1-408-745-9500 (from outside the United States). For details on the information
you need to provide for JTAC, See “Contact JTAC” on page 99. For steps to return a
failed component, see “Return the Failed Component” on page 100.
This chapter provides quick reference information for the JUNOS software
command-line interface (CLI). For more detailed information about using the CLI,
see “Command-Line Interface Overview” on page 321.
! 17
JUNOS Baseline Network Operations Guide
Command Description
clear Clear statistics and protocol database information.
Syntax: clear (arp | bgp | firewall | helper | igmp | ike | ilmi | interfaces | ipsec | ipv6 | isis | ldp | log | mpls |
msdp | multicast | ospf | pim | rip | ripng | route | rsvp | snmp | system | vrrp)
configure Enter CLI configuration mode.
Alternative commands: configure <exclusive> <private>
file Perform file manipulation operations, such as copy, delete, list, rename, and show.
Syntax: file (compare | copy | delete | list | rename | show)
help Provide help information.
Syntax: help (reference | syslog | topic)
monitor Monitor a log file or interface traffic in real time.
Syntax: monitor (interface | list | start | stop | traffic)
mtrace Display trace information about a multicast path from a source to a receiver.
Syntax: mtrace (from-source | monitor | to-gateway)
ping Verify IP connectivity to another IP host or Asynchronous Transfer Mode (ATM) connectivity (ping ATM)
using Operation Administration and Maintenance (OAM) cells to an ATM endstation.
Syntax: ping host <interface source-interface> <bypass-routing> <count requests> <do-not-fragment> <interval
seconds> <pattern string> <record-route> <routing-instance routing-instance-name> <size bytes> <strict> <tos
type-of-service> <ttl value> <via route> <rapid | detail>
Syntax: ping atm interface interface <count count> <end-to-end | segment> <interval interval>
<sequence-number sequence-number> <vci vci> <brief>
Syntax: ping vpn-interface vpn-interface host <local echo-address>
pipe Filter the output of an operational mode or configuration mode command.
Syntax: | (compare | count | display <detail | inheritance | xml> | except pattern | find pattern | last lines |
match pattern | no-more | resolve <file-names> | save filename | trim columns)
quit Log out from the CLI process.
Syntax: quit
request Make system-level requests, such as halt or reboot the router, load software packages, and back up the
router’s file systems.
Syntax: request system (halt | reboot | snapshot | software)
restart Restart the router hardware or software processes.
Syntax: restart (fpc | class-of-service | gracefully | immediately | interface-control | mib-process |
network-access-service | remote-operations | routing | sampling | sfm | snmp | soft)
set Set CLI properties, the router’s date and time, and the craft interface display text.
Syntax: set (chassis | cli | date)
Command Description
show Show information about all aspects of the software, including interfaces and routing protocols.
Syntax: show (accounting | aps | arp | as-path | bgp | chassis | cli | configuration | connections | dvmrp | firewall
| helper | host | igmp | ike | ilmi | interfaces | ipsec | ipv6 | isis | l2circuit | l2vpn | ldp | link-management | log |
mpls | msdp | multicast | ntp | ospf | pfe | pim | policer | policy | rip | ripng | route | rsvp | sap | snmp | system |
task | ted | version | vrrp)
ssh Open a secure shell to another host.
Syntax: ssh host <bypass-routing> <routing-instance routing-instance-name> <source address> <vpn-interface
vpn-interface> <v1 | v2>
start Start a software process.
Syntax: start shell
telnet Start a telnet session to another host.
Syntax: telnet host <8bit> <bypass-routing> <inet | inet6> <noresolve> <port port> <interface interface-name>
<routing-instance routing-instance-name> <source address> <vpn-interface vpn-interface>
test Run various diagnostic debugging commands.
Syntax: test (configuration | interface | msdp | policy)
traceroute Trace the route to a remote host.
Syntax: traceroute host <as-number-lookup> <bypass-routing> <gateway address> <inet | inet6> <noresolve>
<routing-instance routing-instance-name> <source address> <tos value> <ttl value> <vpn-interface
vpn-interface> <wait seconds>
Table 11 lists each CLI configuration mode command and describes the options
available for each command. The commands are organized alphabetically.
Command Description
activate Remove the inactive: tag from a statement, effectively reading the statement or identifier to the
configuration. Statements or identifiers that have been activated take effect when you next issue the commit
command.
Syntax: activate (statement-path | identifier)
annotate Add comments to a configuration.
Syntax: annotate <statement-path> “comment-string”
commit Commit the set of changes to the database and cause the changes to take operational effect.
Syntax: commit <and-quit> <check> <confirmed <minutes>> <synchronize>
copy Make a copy of an existing statement in the configuration.
Syntax: copy <statement-path> identifier 1 to identifier 2
deactivate Add the inactive: tag to a statement, effectively commenting out the statement or identifier from the
configuration. Statements or identifiers marked as inactive do not take effect when you issue the commit
command.
Syntax: deactivate (statement-path | identifier)
delete Delete a statement or identifier. All subordinate statements and identifiers contained within the specified
statement path are deleted with it.
Syntax: delete (statement-path | identifier)
edit Move inside the specified statement hierarchy. If the statement does not exist, it is created.
Syntax: edit <statement-path>
exit Exit the current level of the statement hierarchy, returning to the level prior to the last edit command, or exit
from configuration mode. The quit and exit commands are synonyms.
Syntax: exit <configuration-mode>
help Display help about available configuration statements.
Syntax: help (apropos | reference | syslog | topic ) <string >
insert Insert an identifier into an existing hierarchy.
Syntax: insert <statement-path> identifier1 (before | after) identifier2
load Load a configuration from an ASCII configuration file or from terminal input. Your current location in the
configuration hierarchy is ignored when the load operation occurs.
Syntax: load (merge | override | replace ) (filename | terminal)
Command Description
quit Exit the current level of the statement hierarchy, returning to the level prior to the last edit command, or exit
from configuration mode. The quit and exit commands are synonyms.
Syntax: quit <configuration-mode>
rename Rename an existing configuration statement or identifier.
Syntax: rename <statement-path> identifier1 to identifier2
rollback Return to a previously committed configuration. The software saves the last 10 committed configurations,
including the rollback number, date, time, and name of the user who issued the commit configuration
command. rollback 0 erases any configuration changes made to the current candidate configuration.
The currently operational JUNOS software configuration is stored in the file juniper.conf, and the last three
committed configurations are stored in the files juniper.conf.1.gz, juniper.conf.2.gz, and juniper.conf.3.gz.
These four files are located in the directory /config/, which is on the router’s flash drive. The remaining six
previous committed configurations, the files juniper.conf.4.gz through juniper.conf.9.gz, are stored in the
directory /var/db/config/, which is on the router’s hard disk.
Syntax: rollback <number>
run Run an operational mode CLI command without exiting from configuration mode.
Syntax: run <operation-command>
save Save the configuration to an ASCII file in the user’s home directory (by default) or to the user’s terminal
session. The statement hierarchy and the contents of the current level of the statement hierarchy (and
below) are saved. This allows a section of the configuration to be saved, while fully specifying the statement
hierarchy.
Syntax: save filename | terminal
set Create a statement hierarchy and set identifier values. This is similar to the edit command except that your
current level in the hierarchy does not change, and you can set identifier values, while the edit command
only allows access to a statement path.
Syntax: set (statement-path | identifier )
show Display the current configuration.
Syntax: show (statement-path | identifier)
status Display the users currently editing the configuration.
Syntax: status
top Return to the top level of configuration command mode, indicated by the [edit] banner, or execute a
command from the top level of the configuration.
Syntax: top <configuration-command>
up Move up one level in the statement hierarchy.
Syntax: up <number>
update Update a private database. For more information on the update command, see the JUNOS System Basics and
Services Command Reference.
Syntax: update
1. Create the configuration in a file using a text editor such as Notepad, making
sure that the syntax of the configuration file is correct. See JUNOS Internet
Software Protocols, Class of Service, Chassis, and Management Command
Reference, for information about testing the syntax of a configuration file.
2. In the text file, use an option to perform the required action. The following table
lists and describes some options. For an example of a text file, see “What It
Means.”
merge Combines the current configuration and the configuration in filename or the
one that you type at the terminal. A merge operation is useful when you are
adding a new section to an existing configuration. If the existing
configuration and the incoming configuration contain conflicting statements,
the statements in the incoming configuration override those in the existing
configuration.
override Discards the current candidate configuration and loads the configuration in
filename or the one that you type at the terminal. When you use the override
option and commit the configuration, all system processes reparse the
configuration. You can use the override option at any level of the hierarchy.
replace Searches for the replace tags, deletes the existing statements of the same
name, if any, and replaces them with the incoming configuration. If there is
no existing statement of the same name, the replace operation adds the
statements marked with the replace tag to the configuration.
Note: For this operation to work, you must include replace tags in the text file
or configuration you type at the terminal.
3. Enter Ctrl+a to select all the text, and Ctrl+c to copy the contents of the text file
to the clipboard.
user@host> cli
[edit]
user@host#
6. At the prompt, paste the contents of the clipboard using the mouse and the
paste icon.
[edit]
user@host# load merge terminal
[Type ^D at a new line to end input]
> Paste the contents of the clipboard here<
7. Hit Enter.
8. Enter Ctrl+d.
9. Commit the configuration to activate it on the router, or you can edit the
configuration interactively using the CLI and commit it at a later time.
Sample Output The following is an example of a text file with the replace option:
interfaces {
replace:
so-0/0/0 {
unit 0 {
family inet {
address 10.1.34.1/30;
}
}
}
protocols {
replace:
isis {
interface so-0/0/1.0 {
level 1 metric 10;
level 2 disable;
}
interface fxp0.0 {
disable;
}
interface lo0.0;
}
}
[edit]
user@R1# load merge terminal
[Type ^D at a new line to end input]
interfaces {
replace:
so-0/0/0 {
unit 0 {
family inet {
address 10.1.34.1/30;
}
}
}
protocols {
replace:
isis {
interface so-0/0/1.0 {
level 1 metric 10;
level 2 disable;
}
interface fxp0.0 {
disable;
}
interface lo0.0;
}
}
load complete
What It Means The sample output shows a configuration loaded from a text file with the replace
option. For more information about loading a configuration, see the JUNOS System
Basics Configuration Guide.
Action To load a configuration from the local router to a target router, follow these steps:
user@R1> cli
[edit]
user@host#
[edit]
user@R1# edit interfaces
[edit interfaces]
user@R1# show | display set
set interfaces so-0/0/0 unit 0 family inet accounting destination-class-usage
set interfaces so-0/0/0 unit 0 family inet address 10.1.12.1/30
set interfaces fxp0 unit 0 family inet address 10.168.70.143/21
set interfaces lo0 unit 0 family inet address 10.0.0.1/32
set interfaces lo0 unit 0 family iso address 49.0002.1000.0000.0003.00
4. Copy each line of the configuration individually from the local router to the
target router. In the target router, you must be at the top level of the
configuration and in configuration mode. For example:
mwazna@R2> edit
Entering configuration mode
[edit]
mwazna@R2# set interfaces so-0/0/0 unit 0 family inet accounting
destination-class-usage
6. Commit the configuration to activate it on the router, or you can edit the
configuration interactively using the CLI and commit it at a later time.
This chapter describes how to work with problems on your network. It discusses
troubleshooting basics, using an example network, and includes the commands you
might use to diagnose problems with the router and network.
! 29
JUNOS Baseline Network Operations Guide
Purpose By applying the standard four-step process illustrated in Figure 5, you can isolate a
failed node in the network.
1408
Isolate causes Take action Done
the symptom the solution
Not solved
Before you embark on the four-step process, however, it is important that you are
prepared for the inevitable problems that occur on all networks. While you might
find a solution to a problem by simply trying a variety of actions, you can reach an
appropriate solution more quickly if you are systematic in your approach to the
maintenance and monitoring of your network. To prepare for problems on your
network, understand how the network functions under normal conditions, have
records of baseline network activity, and carefully observe the behavior of your
network during a problem situation.
Figure 6 shows the network topology used in this section to illustrate the process of
diagnosing problems in a network.
AS 65001 AS 65002
Aggregate Routes:
100.100.1.0/24
100.100.2.0/24
R1 100.100.3.0/24 R2 R3
lo0: .1 100.100.4.0/24 lo0: .2 lo0: .3
so-0/0/0–.12.2 so-0/0/1–.23.1
so-0/0/0–.12.1 so-0/0/1–.23.2
R5 R6
lo0: .5 lo0: .6
Key: I-BGP
so-0/0/X: 10.1.x.x/30
E-BGP
lo0: 10.0.0.x/32
Steps To Take To isolate a failed connection in your network, follow these steps:
Action To identify the symptoms of a problem on your network, start at one end of your
network and follow the routes to the other end, entering all or one of the following
JUNOS command-line interfaces (CLI) operational mode commands:
^C
--- 10.0.0.5 ping statistics ---
3 packets transmitted, 0 packets received, 100% packet loss
What It Means The sample output shows an unsuccessful ping command in which the packets are
being rejected because the time to live is exceeded. The output for the show route
command shows the interface (10.1.26.1) that you can examine further for
possible problems. The traceroute command shows the loop between 10.1.26.1
(R2) and 10.1.26.2 (R6), as indicated by the continuous repetition of the two
interface addresses.
Action To isolate the cause of a particular problem, enter one or all of the following JUNOS
CLI operational mode command:
user@host> show < configuration | bgp | interfaces | isis | ospf | route >
Your particular problem may require the use of more than just the commands listed
above. See the appropriate command reference for a more exhaustive list of
commonly used operational mode commands.
What It Means The sample output shows that all interfaces on R6 are up. The output from R2
shows that a static route [Static/5] configured on R2 points to R6 (10.1.26.2) and is
the preferred route to R5 because of its low preference value. However, the route is
looping from R2 to R6, as indicated by the missing reference to R5 (10.1.15.2).
Action To resolve the problem in this example, enter the following JUNOS CLI commands:
[edit]
user@R2# delete routing-options static route destination-prefix
user@R2# commit and-quit
user@R2# show route destination-prefix
[edit]
user@R2# commit and-quit
commit complete
Exiting configuration mode
What It Means The sample output shows the static route deleted from the [routing-options]
hierarchy and the new configuration committed. The output for the show route
command now shows the BGP route as the preferred route, as indicated by the
asterisk (*).
You can address possible causes in any order. In relation to the network in Figure 6,
we chose to work from the local router toward the remote router, but you might
start at a different point, particularly if you have reason to believe that the problem
is related to a known issue, such as a recent change in configuration.
Action To evaluate the solution, enter the following JUNOS CLI commands:
What It Means The sample output shows that there is now a connection between R6 and R5. The
show route command shows that the BGP route to R5 is preferred, as indicated by
the asterisk (*). The ping command is successful and the traceroute command
shows that the path from R6 to R5 is through R2 (10.1.26.1), and then through R1
(10.1.12.1).
This chapter describes how to stop and start the JUNOS software after it has been
installed. (See Table 16.)
Table 16: Checklist for Stopping and Starting the JUNOS Software
! 37
JUNOS Baseline Network Operations Guide
Purpose To avoid damage to the file system, gracefully shut down the JUNOS software before
powering down the router. If you have configured a backup Routing Engine, it must
be shut down before the master Routing Engine.
Action To stop the JUNOS software, use the following JUNOS command-line interface (CLI)
operational mode command:
user@host> Dec 17 17:28:40 init: syslogd (PID 2514) exited with status=0 Normal
Exit
Waiting (max 60 seconds) for system process `bufdaemon' to stop...stopped
Waiting (max 60 seconds) for system process `syncer' to stop...stopped
syncing disks... 4
done
Uptime: 3h31m41s
ata0: resetting devices .. done
The operating system has halted.
Please press any key to reboot.
What It Means The sample output shows that all system process have stopped and the operating
system was halted immediately. For more detailed information on the request
system halt command, see the JUNOS System Basics and Services Command
Reference.
Purpose Reboot JUNOS software after a software upgrade and occasionally to recover from
an error condition.
Action To reboot the JUNOS software, use the following JUNOS CLI operational mode
command:
user@host> Dec 17 17:34:20 init: syslogd (PID 409) exited with status=0 Normal
Exit
Waiting (max 60 seconds) for system process `bufdaemon' to stop...stopped
Waiting (max 60 seconds) for system process `syncer' to stop...stopped
syncing disks... 10 6
done
Uptime: 2m45s
ata0: resetting devices .. done
Rebooting...
What It Means The sample output shows the final stages of the system shutdown and the execution
of the reboot. Reboot requests are recorded to the system log files, which you can
view with the show log messages command. You can view the process names with
the show system processes command. For more information about the show system
processes command, see “Check That the Process Has Restarted” on page 42. For
more detailed information about rebooting your system, see the JUNOS System
Basics and Services Command Reference.
Purpose Restart a JUNOS software process when you need to recover from an error
condition
Action To display information about the software processes that are running on the router,
use the following JUNOS CLI operational mode command:
PID USERNAME PRI NICE SIZE RES STATE TIME WCPU CPU COMMAND
546 root 10 0 9096K 1720K nanslp 0:21 0.00% 0.00% chassisd
685 root 2 0 12716K 3840K kqread 0:01 0.00% 0.00% rpd
553 root 2 0 8792K 1544K select 0:01 0.00% 0.00% mib2d
552 root 2 0 8632K 1556K select 0:01 0.00% 0.00% snmpd
563 root 2 0 9316K 1564K select 0:00 0.00% 0.00% kmd
564 root 2 0 7736K 948K select 0:00 0.00% 0.00% fud
131 root 10 0 770M 25568K mfsidl 0:00 0.00% 0.00% newfs
547 root 2 0 7732K 888K select 0:00 0.00% 0.00% alarmd
545 root 2 0 10292K 2268K select 0:00 0.00% 0.00% dcd
550 root 2 -12 1308K 692K select 0:00 0.00% 0.00% ntpd
1 root 10 0 816K 520K wait 0:00 0.00% 0.00% init
750 root 32 0 21716K 828K RUN 0:00 0.00% 0.00% top
560 root 2 0 8208K 1088K select 0:00 0.00% 0.00% rmopd
561 root 2 0 8188K 1156K select 0:00 0.00% 0.00% cosd
559 root 2 0 1632K 840K select 0:00 0.00% 0.00% ilmid
What It Means The sample output shows the central processing unit (CPU) utilization and lists the
processes in order of CPU utilization.
Table 17 lists and describes the output fields included in the sample output for the
show processes extensive command. The fields are listed in alphabetical order.
Field Description
COMMAND Command that is running.
CPU Raw (unweighted) CPU usage. The value of this field is used to sort the
processes in the output.
last pid Last process identifier assigned to the process.
load averages Three load averages, followed by the current time.
Mem Information about physical and virtual memory allocation.
NICE UNIX “nice” value. The nice value allows a process to change it’s final
scheduling priority.
PID Process identifier.
PRI Current kernel scheduling priority of the process. A lower number indicates a
higher priority.
processes Number of existing processes and the number of processes in each state
(sleeping, running, starting, zombies, and stopped).
RES Current amount of resident memory, in KB.
SIZE Total size of the process (text, data, and stack), in KB.
STATE Current state of the process (sleep, wait, run, idle, zombi, or stop).
Swap Information about physical and virtual memory allocation.
USERNAME Owner of the process.
WCPU Weighted CPU usage.
For more details, see “Verify the Routing Engine CPU Memory” on page 179, and
the JUNOS Internet Software Protocols, Class of Service, Chassis, and Management
Command Reference.
What It Means The sample output shows that the routing protocol daemon was restarted and the
process identification (PID) was changed from 685 in the previous sample output to
751.
Table 18 lists and describes the options available for the restart command.
Option Description
class-of-service Restart the class-of-service process, which controls the router’s
class-of-service configuration.
gracefully Restart the software process by sending the equivalent of a UNIX
SIGTERM signal.
immediately Immediately restart the process by sending the equivalent of a
UNIX SIGKILL signal.
interface-control Restart the interface process, which controls the router’s physical
interface devices and logical interfaces.
mib-process Restart the Management Information Base (MIB) II process, which
provides the router’s MIB II agent.
network-access-service Restart the network access process, which provides the router’s
Challenge Handshake Authentication Process (CHAP)
authentication service.
remote-operations Restart the remote operations process, which provides the ping and
traceroute MIBs.
routing Restart the routing protocol process, which controls the routing
protocols that run on the router and maintains the routing tables.
sampling Restart the sampling process, which performs packet sampling and
cflowd export.
snmp Restart the Simple Network Management Process (SNMP) process,
which provides the router’s SNMP master agent.
soft Reread and reactivate the configuration without completely
restarting the software processes. For example, Border Gateway
Protocol (BGP) peers stay up and the routing table stays constant.
This option is the equivalent of a UNIX SIGHUP signal; omitting this
option is the equivalent of a UNIX SIGTERM (kill) operation.
Action To check that a process has restarted, use the following JUNOS CLI operational
mode command:
PID USERNAME PRI NICE SIZE RES STATE TIME WCPU CPU COMMAND
546 root 10 0 9096K 1720K nanslp 0:21 0.00% 0.00% chassisd
685 root 2 0 12716K 3840K kqread 0:01 0.00% 0.00% rpd
553 root 2 0 8792K 1544K select 0:01 0.00% 0.00% mib2d
552 root 2 0 8632K 1556K select 0:01 0.00% 0.00% snmpd
563 root 2 0 9316K 1564K select 0:00 0.00% 0.00% kmd
PID USERNAME PRI NICE SIZE RES STATE TIME WCPU CPU COMMAND
546 root 10 0 9096K 1720K nanslp 0:22 0.05% 0.05% chassisd
553 root 2 0 8792K 1544K select 0:01 0.00% 0.00% mib2d
552 root 2 0 8632K 1556K select 0:01 0.00% 0.00% snmpd
563 root 2 0 9316K 1564K select 0:00 0.00% 0.00% kmd
564 root 2 0 7736K 948K select 0:00 0.00% 0.00% fud
131 root 10 0 770M 25568K mfsidl 0:00 0.00% 0.00% newfs
547 root 2 0 7732K 888K select 0:00 0.00% 0.00% alarmd
545 root 2 0 10292K 2268K select 0:00 0.00% 0.00% dcd
1 root 10 0 816K 520K wait 0:00 0.00% 0.00% init
550 root 2 -12 1308K 692K select 0:00 0.00% 0.00% ntpd
758 root 32 0 21716K 832K RUN 0:00 0.00% 0.00% top
560 root 2 0 8208K 1088K select 0:00 0.00% 0.00% rmopd
561 root 2 0 8188K 1156K select 0:00 0.00% 0.00% cosd
559 root 2 0 1632K 840K select 0:00 0.00% 0.00% ilmid
573 lab 2 0 7480K 2580K select 0:00 0.00% 0.00% cli
751 root 2 0 12716K 3944K kqread 0:00 0.00% 0.00% rpd
558 root 2 20 8708K 1880K select 0:00 0.00% 0.00% sampled
555 root 2 0 1856K 932K select 0:00 0.00% 0.00% vrrpd
686 root 2 0 7808K 940K select 0:00 0.00% 0.00% apsd
What It Means The sample output shows that the routing protocol process (rpd) was restarted
because the process identifier (PID) of the process was renamed from 685, as
shown in the Sample Output 1, to 751 as shown in Sample Output 2.
This chapter describes how to display the hostname and version information for the
JUNOS software running on a router. (See Table 19.)
Tasks for Displaying JUNOS Software Information and Status Command or Action
Display JUNOS Software Information on page 46 show version
Display Version Information for JUNOS Software Packages on show version brief
page 47
! 45
JUNOS Baseline Network Operations Guide
Purpose Display JUNOS software information and status to determine if the version of
JUNOS software that you are running supports particular features or hardware. You
can also determine whether particular software bugs will affect your version of
JUUNOS software.
Action To display JUNOS software information, use the following JUNOS command-line
interface (CLI) operational mode command:
What It Means The sample output shows the hostname, the version information for the JUNOS
software packages installed on the machine, and the version information for each
software process.
Purpose Display version information for JUNOS software packages to determine if they
support particular features or hardware. You can also determine whether particular
software bugs will affect your version of JUNOS software.
Action To display brief information and status for the kernel and Packet Forwarding
Engine, use the following CLI operational mode command:
Sample Output The following sample output is for worldwide nonencrypted JUNOS software:
The following sample output is for Canada and USA encrypted JUNOS software:
What It Means The sample output shows version information for the JUNOS software packages
installed on the router. If the JUNOS Crypto Software Suite is listed the router has
Canada and USA encrypted JUNOS software. If the JUNOS Crypto Software Suite is
not listed, the router is running worldwide nonencrypted JUNOS software.
This chapter describes how to check the configuration on your router. (See
Table 20.)
! 49
JUNOS Baseline Network Operations Guide
Action To display the current, active router configuration, use the following command-line
interface (CLI) operational mode command:
}
}
}
static-host-mapping {
crater sysid 0102.5524.5045;
badlands sysid 0102.5524.5046;
[...output truncated...]
}
services {
finger;
ftp;
rlogin;
rsh;
ssh;
telnet;
}
syslog {
user * {
any emergency;
}
host log {
any notice;
pfe info;
interactive-commands any;
}
file messages {
any notice;
authorization info;
pfe info;
archive world-readable;
}
file security {
interactive-commands any;
archive world-readable;
}
file white_bx {
daemon notice;
archive size 40m world-readable;
}
}
processes {
routing enable;
snmp enable;
tnp-process enable;
ntp enable;
inet-process enable;
mib-process enable;
management enable;
watchdog enable;
}
ntp {
boot-server ntp.juniper.net;
server 172.17.27.46;
}
}
chassis {
dump-on-panic;
}
snmp {
location "Systest lab";
contact "Brian Matheson";
interface fxp0.0;
community public {
authorization read-only;
}
community private {
authorization read-write;
}
}
routing-options {
static {
/* corperate and alpha net */
route 172.16.0.0/12 {
next-hop 10.168.14.254;
retain;
no-readvertise; [...output truncated...]
}
}
}
}
}
re1;
}
apply-groups [ global re0 re1 ];
chassis {
fpc 0 {
pic 0 {
mlfr-uni-nni-bundles 4;
}
}
}
interfaces {
ls-0/0/0:0 {
encapsulation multilink-frame-relay-uni-nni;
unit 0 {
dlci 100;
family inet {
address 10.53.99.2/32 {
destination 10.53.99.1;
}
}
}
}
ct3-0/1/0 {
partition 1 interface-type t1;
partition 2 interface-type t1;
partition 3 interface-type t1;
partition 4 interface-type t1;
}
t1-0/1/0:1 {
encapsulation multilink-frame-relay-uni-nni;
unit 0 {
family mlfr-uni-nni {
bundle ls-0/0/0:0;
}
}
}
routing-options {
static {
route 10.1.1.0/24 next-hop 10.53.99.1;
}
autonomous-system 69;
forwarding-table {
export pplb;
}
}
protocols {
bgp {
disable;
group int {
type internal;
neighbor 10.255.14.30;
[...output truncated...] }
}
isis {
disable;
interface all {
level 1 disable;
}
interface fxp0.0 {
disable;
}
}
inactive: ospf {
traffic-engineering;
reference-bandwidth 4g;
area 0.0.0.0 {
interface all;
interface fxp0.0 {
disable;
}
}
}
}
policy-options {
policy-statement pplb {
then {
load-balance per-packet;
}
}
}
[...Output truncated...]
What It Means The sample output shows the current, active configuration for the router. When
displaying the configuration, the CLI indents each subordinate hierarchy level,
inserts braces to indicate the beginning and end of each hierarchy level, and places
semicolons at the end of statements that are at the lowest level of the hierarchy.
Action To view a specific configuration hierarchy, use the following CLI operational mode
command;
What It Means The sample output shows the active configuration under the [protocol bgp] hierarchy
level.
Purpose You can display additional information when you are not sure of the meaning of
configuration statements and what permission bits are required to add and modify
them.
Action To display additional information about the entire configuration, use the following
CLI configuration mode command:
To display additional information about a specific hierarchy, use the following CLI
configuration mode command:
Sample Output The following sample output is for the first command. The output for a particular
hierarchy appears similar to its section in this sample output.
user@host> edit
user@host# show | display detail
##
## version: Software version information
## require: system
##
version "3.4R1 [tlim]";
system {
##
## host-name: Host name for this router
## match: ^[[:alnum:]._-]+$
## require: system
##
host-name router-name;
##
## domain-name: Domain name for this router
## match: ^[[:alnum:]._-]+$
## require: system
##
domain-name isp.net;
##
## backup-router: Address of router to use while booting
##
backup-router 10.168.100.1;
root-authentication {
##
## encrypted-password: Crypted password string
##
encrypted-password "$1$BYJQE$/ocQof8pmcm7MSGK0"; # SECRET-DATA
}
##
## name-server: DNS name servers
## require: system
##
name-server {
##
## name-server: DNS name server address
##
208.197.1.0;
}
login {
##
## class: User name (login)
## match: ^[[:alnum:]_-]+$
##
class superuser {
##
## permissions: Set of permitted operation categories
##
permissions all;
}
...
##
## services: System services
## require: system
##
services {
## services: Service name
##
ftp;
##
## services: Service name
##
telnet;
##
}
syslog {
##
## file-name: File to record logging data
##
file messages {
##
## Facility type
## Level name
##
any notice;
##
## Facility type
## Level name
##
authorization info;
}
}
}
chassis {
alarm {
sonet {
##
## lol: Loss of light
## alias: loss-of-light
##
lol red;
}
}
}
}
interfaces {
##
## Interface name
##
at-2/1/1 {
atm-options {
##
## vpi: Virtual path index
## range: 0 .. 255
## maximum-vcs: Maximum number of virtual circuits on this VP
##
vpi 0 maximum-vcs 512;
}
##
## unit: Logical unit number
## range: 0 .. 16384
##
unit 0 {
##
## vci: ATM point-to-point virtual circuit identifier ([vpi.]vci)
## match: ^([[:digit:]]+.){0,1}[[:digit:]]+$
##
vci 0.128;
}
}
...
What It Means The sample output shows additional information that includes the help string
explaining each configuration statement, and the permission bits required to add
and modify the configuration statement.
As new features become available or as software problems are fixed, you might
periodically upgrade the router software. (See Table 21.)
5. Log the BGP, IS-IS, and OSPF Adjacency Information on show bgp summary | save filename
page 62 show isis adjacency brief | save filename
show ospf neighbor brief | save filename
6. Log the System Storage Information on page 63 show system storage | save filename
7. Back Up the Currently Running and Active File System on request system snapshot
page 63
8. Download JUNOS Software on page 64 http://www.juniper.net/support
Upgrade JUNOS Software on page 69
1. Copy JUNOS Software to the Router on page 69 file copy
ftp://username:[email protected]/jbundle-package-name
/var/tmp/jbundle-package-name
2. Add New Software on page 69 request system software add/var/tmp/jbundle-package-name
! 57
JUNOS Baseline Network Operations Guide
Purpose Before you upgrade the JUNOS software, it is important to log information about the
existing system so that after the upgrade you can compare the same information to
verify that all components are installed and working as expected. Also, during the
process of logging information, you might find an existing problem that you did not
know about and might have thought was caused by the upgrade.
Steps to Take To log important information about your system, follow these steps:
In all the logging steps, you can use your terminal program to save the output from
the commands, or use the save command to redirect the output to an external file.
To save the output to a file on another machine, use the following JUNOS
command-line interface (CLI) operational mode command:
By default, the file is placed in your home directory on the router. To redirect the
output to a file on another machine, change the filename to include the path to that
machine and file. For information about how you can specify the filename, see the
JUNOS System Basics and Services Command Reference.
The following example stores the output of the show version command in a file:
What It Means The sample output shows the hostname, router model, and the different JUNOS
software packages, processes, and documents.
Sample Output The output for the M-series routers varies depending on the chassis components of
each router. All routers have a chassis, midplanes or backplanes, power supplies,
and Flexible PIC Concentrators (FPCs). Refer to the hardware guides for information
about the different chassis components.
What It Means The sample output shows the hardware inventory for an M160 router with a chassis
serial number of 101. For each component, the output shows the version number,
part number, serial number, and description.
What It Means The sample output shows the configuration currently running on the router, which
is the last committed configuration.
What It Means The sample output shows summary information about the physical and logical
interfaces on the router.
Action To log protocol peer information, use the following JUNOS CLI operational mode
commands:
What It Means Sample output 1 displays summary information about BGP and its neighbors.
Sample output 2 displays information about IS-IS neighbors. Sample output 3
displays information about all OSPF neighbors.
What It Means The sample output shows statistics about the amount of free disk space in the
router’s file system. Values are displayed in 1024-byte (1-KB) blocks.
What It Means 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 internal flash drive, and the
/altroot and /altconfig file systems are on the router’s hard drive.
NOTE: After you issue the request system snapshot command, you cannot return
to the previous version of the software because the running and backup copies of
the software are identical.
NOTE: To download the JUNOS software packages, you must have a service
contract and an access account. Try to download the software packages a few days
before you intend to install them, as you may need to verify your service contract
and access account. If you need help obtaining an account, contact your Juniper
Networks sales representative or send an e-mail to [email protected].
Action To download the software packages from the Juniper Networks Support Web site,
follow these steps:
http://www.juniper.net/support
3. From Download Software, select the M- &T-series link. The Software Download
screen appears.
5. Click the software bundle you want to download. The Save As screen appears.
What It Means Each JUNOS software release consists of the following software packages:
The packages are also grouped together in a bundle, called jbundle. Normally, you
use the bundle to upgrade all of the software packages at the same time.
NOTE: If you are upgrading to Release 5.0 from Release 4.x or downgrading from
Release 5.0 to Release 4.x, use the jinstall package. Otherwise, use the jbundle
package to upgrade to a new release.
Downgrading from Release 5.0 to Release 4.x can be a two-step process. For more
information, see JUNOS Internet Software System Basics Configuration Guide.
You also can upgrade the software packages individually but this is not
recommended. When upgrading to a new release, you must install the entire
bundle; do not upgrade packages individually unless instructed to do so by the
Juniper Networks Technical Assistance Center (JTAC).
Two sets of JUNOS software packages are provided: one for customers in the United
States and Canada, and another for worldwide customers. The worldwide version
does not include any capabilities that provide encryption of data leaving the router.
Otherwise, the two packages are identical.
Purpose As new features become available or as software problems are fixed, you might
periodically upgrade the router software.
package-name is the full URL to the file and release-number is the major software
release number; for example, 4.2R1. Before the new software is added, the existing
software is automatically deleted.
NOTE: Even though you are adding the new software, the changes do not take
effect until the router has completed rebooting.
Action To reboot the router to complete the upgrade, use the following JUNOS CLI
operational mode command:
Steps To Take To verify that the new version of JUNOS software is running as expected after the
upgrade, follow these steps:
Action To obtain system information, use the following JUNOS CLI operational mode
commands:
Compare the information from these commands with the information you logged
before the upgrade.
Action To back up the upgraded software, use the following JUNOS CLI operational mode
command:
Sample Output 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 internal flash drive, and the
/altroot and /altconfig file systems are on the router’s hard drive.
NOTE: After you issue the request system snapshot command, you cannot return
to the previous version of the software because the running and backup copies of
the software are identical.
If the JUNOS software becomes damaged, you must reinstall it. (See Table 22.)
! 73
JUNOS Baseline Network Operations Guide
74 !
Chapter 8: Reinstall JUNOS Software
Purpose Before you reinstall the JUNOS software, it is important to log information about the
existing system so that after the reinstall you can verify that all software
components are installed and working as expected. Also, while logging information,
you might find an existing problem that you did not know about and might have
thought was caused by the reinstall.
Steps To Take To log important information about your system, follow these steps:
In all of the logging steps, you can use your terminal program to save the output
from the commands, or use the save command to redirect the output to an external
file.
To save the output to a file on another machine, use the following JUNOS
command-line interface (CLI) operational mode command:
By default, the file is placed in your home directory on the router. To redirect the
output to a file on another machine, change the filename to include the path to that
machine and file. For information about how you can specify the filename, see the
JUNOS System Basics and Services Command Reference.
The following example stores the output of the show version command in a file:
What It Means The sample output shows the hostname, router model, and the different JUNOS
software packages, processes, and documents.
Action To log the router chassis hardware version information, use the following JUNOS CLI
operational mode command:
Sample Output The output for the M-series routers varies depending on the chassis components of
each router. All routers have a chassis, midplanes or backplanes, power supplies,
and Flexible PIC Concentrators (FPCs). Refer to the hardware guides for information
about the different chassis components.
What It Means The sample output shows the hardware inventory for an M160 router with a chassis
serial number of 101. For each component, the output shows the version number,
part number, serial number, and description.
Sample Output The following example shows output from the show chassis environment command
for an M5 router:
What It Means The sample output shows the environmental information about the router chassis,
including the temperature and information about the fans, power supplies, and
Routing Engine.
Sample Output
What It Means The sample output shows the initial messages generated by the system kernel upon
boot. This is the content of the /var/run/dmesg.boot file.
What It Means The sample output shows the configuration currently running on the router, which
is the last committed configuration.
What It Means The sample output displays summary information about the physical and logical
interfaces on the router.
Action To log the protocol peer information, use the following JUNOS CLI operational mode
commands:
Sample Output 1
What It Means Sample output 1 displays summary information about BGP and its neighbors.
Sample output 2 displays information about IS-IS neighbors. Sample output 3
displays information about all OSPF neighbors.
What It Means The sample output displays statistics about the amount of free disk space in the
router’s file system. Values are displayed in 1024-byte (1-KB) blocks.
What It Means 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 internal flash drive, and the
/altroot and /altconfig file systems are on the router’s hard drive.
NOTE: After you issue the request system snapshot command, you cannot return
to the previous version of the software because the running and backup copies of
the software are identical.
WARNING: The installation will erase the contents of your disk. Do you wish to
continue (y/n)?
The router copies the software from the removable medium onto your system,
occasionally displaying status messages. This can take up to 10 minutes.
The router reboots from the primary boot device on which the software is
installed. When the reboot is complete, the router displays the login prompt.
Purpose After you have reinstalled the software, you must copy the router’s configuration
files back to the router. (You also can configure the router from scratch, as described
in JUNOS Internet Software System Basics Configuration Guide.) However, before you
can copy the configuration files, you must establish network connectivity.
root# cli
root@>
cli> configure
[edit]
root@#
4. Configure the name of the machine. If the name includes spaces, enclose the
entire name in quotation marks (" "):
[edit]
root@# set system host-name host-name
[edit]
root@# set system domain-name domain-name
6. Configure the IP address and prefix length for the router’s management
Ethernet interface:
[edit]
root@# set interfaces fxp0 unit 0 family inet address address/prefix-length
7. Configure the IP address of a default router. This system is called the backup
router because it is used only while the routing protocol process is not running.
[edit]
root@# set system backup-router address
[edit]
root@# set system name-server address
1. To set the root password, enter a clear-text password that the system will
encrypt, a password that is already encrypted, or a secure shell (ssh) public key
string.
! To enter a clear-text password, use the following command to set the root
password:
[edit]
root@# set system root-authentication plain-text-password
New password: password
Retype new password: password
[edit]
root@# set system root-authentication encrypted-password password
! To enter an ssh public string, use the following command to set the root
password:
[edit]
root@# set system root-authentication ssh-rsa key
[edit]
root@# commit
[edit]
root@# exit
root@>
If there is no response, verify that there is a route to the address using the show
route command. If the address is outside your fxp0 subnet, add a static route. Once
the backup configuration is loaded and committed, the static route is no longer
needed and should be deleted.
1. To copy the existing configuration and any backup configurations back onto the
router, use the file copy command. Place the files in the /var/tmp directory.
root@> configure
[edit]
root@# load merge /config/filename or load replace /config/filename
[edit]
root@# commit
Steps To Take To verify that the new version of the JUNOS software is running as expected after
the reinstall, follow these steps:
Compare the information from these commands with the information you obtained
before the reinstall.
Action To back up the reinstalled software, use the following JUNOS CLI operational mode
command:
Sample Output 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 internal flash drive, and the
/altroot and /altconfig file systems are on the router’s hard drive.
NOTE: After you issue the request system snapshot command, you cannot return
to the previous version of the software because the running and backup copies of
the software are identical.
This chapter describes how to check the hardware components of Juniper Networks
routers on your network. (See Table 23.)
b. Display Error Messages in the Messages Log File on page 97 show log messages
c. Display Error Messages in the Chassis Process Log File on show log chassisd
page 98
3. Verify the Component Problem on page 98 Make sure that the component is well seated in its slot
and connected to the router midplane.
Perform a swap test on the component with a problem.
4. Fix the Problem on page 99 Take action and correct the problem. For example,
replace a dirty air filter, clean a fiber-optic cable, connect
the component securely to the midplane, or reset the
component. Otherwise, escalate the alarm condition and
contact JTAC. Do not straighten bent pins.
5. Contact JTAC on page 99 request support information
request support information | save filename
6. Return the Failed Component on page 100 show chassis hardware
Obtain a Return Material Authorization (RMA) number
from JTAC. You can send e-mail to [email protected] or
call 1-888-314-JTAC (within the United States) or
1-408-745-9500 (from outside the United States).
! 91
JUNOS Baseline Network Operations Guide
Purpose When you monitor router components, you are making sure that there are no
hardware problems with the router. In the event of a minor problem, you can try to
fix it. For more difficult situations, you can call for assistance from the Juniper
Networks Technical Assistance Center (JTAC).
Steps To Take To monitor M-series and T-series router components, follow these steps:
Purpose When you check the router craft interface, the component LEDs, and the
environmental and operational information, you are either physically inspecting the
components or obtaining output about their status from commands you issue from
the command-line interface (CLI).
Steps To Take To check the router component status, follow these steps:
The command output displays the router alarm indicator status, the LCD
display information (router name, router uptime, and status message that rotate
at 2-second intervals), and the major component LED status.
! Physically look at the router craft interface. Table 24 shows the component
characteristics of the craft interface for each M-series router and T-series
platform.
Table 24: Craft Interface Components for the M-series Routers and T-series Platforms
M5 and
Component M10 M20 M40 M40e M160 T320 T640
Alarm LEDs X X X X X X X
Lamp test button X X X
Alarm cutoff button X X X X
Alarm relay contacts X X
Link and activity status lights X X
LCD display and navigation X X X X X
buttons
Routing Engine ports X X X
Routing Engine LEDs X X X
Host module LEDs X
Host subsystem LEDs X X
Physical Interface Card (PIC) X
online and offline buttons
M5 and
Component M10 M20 M40 M40e M160 T320 T640
Flexible PIC Concentrator (FPC) X X X X X X
LEDs
FPC offline buttons X X X X
FPC online buttons X X
Switch Interface Board (SIB) LEDs X X
The output shows the messages that are currently displayed on the craft
interface (for routers that have a display on the craft interface).
For examples of sample output, see the JUNOS System Basics and Services
Command Reference.
! Physically look at the craft interface. You see the following component LEDs:
Routing Engine, FPCs, PICs, host module (for M40e and M160 routers), and
host subsystem and SIB (for T-series platforms).
! Look at the LEDs on the component faceplate. Figure 25 describes where the
LEDs are located on the router or platform.
PCG On the PFE clock generator (PCG) faceplate at the rear of M40e and M160 routers
the router. Remove the component cover.
Power supply On the power supply faceplate at the bottom rear of the All routers
router.
Routing Engine On the rear Routing Engine panel. M20 router
On the craft interface. M20, M40, M40e, and M160 routers
SCB On the System Control Board (SCB) faceplate at the front M40 router
of the router, vertical in the middle of the FPC card cage.
SCG On the SONET Clock Generator (SCG) faceplate. T320 router and T640 routing node
Sample Output The command output displays the temperature of the air passing by the
component, in degrees Centigrade. It also displays the total percentage of CPU,
interrupt, heap space, and buffer space being used by the component processor,
including the total DRAM available to the component processor. The command
output displays the time when the component started running and how long the
component has been running. A short uptime can indicate a problem with the
component.
For examples of sample output, see the JUNOS System Basics and Services Command
Reference.
Figure 26 lists the operational mode CLI commands that display more detailed
information for each router and platform component.
The command output displays the temperature of the air passing by the
component, in degrees Centigrade and Fahrenheit. It displays the total percentage
of CPU, interrupt, heap space, and buffer space being used by the component
processor, including the total DRAM available to the component processor. The
command output displays the time when the component started running and how
long the component has been running. A short uptime can indicate a problem with
the component.
For examples of sample output, see the JUNOS System Basics and Services Command
Reference.
Figure 27 lists the components for which you can display more detailed operational
status information.
Purpose When you obtain information about component alarms and error messages, you
determine when a problem with a component first appeared and the details of the
situation.
The command output displays the number of alarms currently active, the time
when the alarm began, the severity level, and an alarm description. Note the date
and time of an alarm so that you can correlate it with error messages in the
messages system log file.
For examples of sample output, see the JUNOS System Basics and Services Command
Reference.
The messages system log file records the time the failure or event occurred, the
severity level, a code, and a message description. Error messages in the messages
system log file are logged at least 5 minutes before and after the alarm event.
To search for specific information in the log file, use the | match component-name
command; for example, use show log messages | match fpc. If there is a space in the
component name, enclose the component name in quotation marks; for example, |
match “power supply”.
To search for multiple items in the log file, use the | match command followed by
the multiple items, separated by the | (pipe), and enclosed in quotation marks; for
example, | match “fpc | sfm | kernel | tnp”.
To monitor the messages file in real time, use the monitor start messages CLI
command. This command displays the new entries in the file until you stop
monitoring by using the monitor stop messages CLI command.
For more information about system log messages, see the JUNOS System Log
Messages Reference.
The chassis process (chassisd) log file tracks the state of each chassis component.
For examples of sample output, see the JUNOS System Basics and Services Command
Reference.
To search for specific information in the log file, use the | match component-name
command; for example, show log messages | match fpc. If there is a space in the
component name, enclose the component name in quotation marks; for example, |
match “power supply”.
To search for multiple items in the log file, use the | match command followed by
the multiple items, separated by the | (pipe), and enclosed in quotation marks; for
example, | match “fpc | sfm | kernel | tnp”.
To monitor the chassisd file in real time, use the monitor start chassisd CLI
command. This command displays the new entries in the file until you stop
monitoring by using the monitor stop chassisd CLI command.
Purpose Test a component only if it is not associated with a previously reported router
component failure case and if testing will not compromise the integrity of the router
and other components.
1. Make sure that the component is well seated in its slot and connected to the
router midplane.
2. Perform a swap test on the component that has failed or has a problem. Take
the component offline if necessary, remove it, and replace it with one that you
know works. If the replaced component works, it confirms that there was a
problem with the component you removed.
NOTE: Before performing a swap test, always check for bent pins in the midplane
and check the component for stuck pins in the connector. Pins stuck in the
component connector can damage other good slots during a swap test.
Action If the router alarm condition is your responsibility, take action and correct it. For
example, replace a dirty air filter, clean a fiber-optic cable, connect the component
securely to the midplane, or reset the component. Otherwise, escalate the alarm
condition and contact JTAC.
NOTE: Do not straighten component pins. If the pins on a component are bent,
return the component with a Return Material Authorization (RMA). Straightening
the pins may cause intermittent problems in the future.
Contact JTAC
Action If you cannot determine the cause of a problem or need additional assistance,
contact JTAC at [email protected], or at 1-888-314-JTAC (within the United States)
or 1-408-745-9500 (from outside the United States).
To provide JTAC with information about the system, use the following CLI
command:
Because the output of this command is generally quite long, you can redirect the
output to a file by using the following CLI command:
1. Determine the part number and serial number of the component. To list the
numbers for all components installed in the chassis, use the following CLI
command:
If the component does not appear in the hardware inventory listing, check the
failed component for the attached serial number ID label.
NOTE: The cooling system components (fans and impellers) do not have serial
numbers. Therefore, you will not see a serial number listed in the hardware
inventory or a serial number ID label on the component.
2. Obtain a Return Material Authorization (RMA) number from JTAC. You can send
e-mail to [email protected], or call 1-888-314-JTAC (within the United States)
or 1-408-745-9500 (from outside the United States).
! Your name, organization name, telephone number, fax number, and e-mail
address
The support representative will validate your request and issue an RMA number
for the return of the component.
This chapter describes how to check the physical interfaces on a Juniper Networks
router. (See Table 28.)
! 101
JUNOS Baseline Network Operations Guide
Purpose When you check the physical interfaces on a router, you gather information to
quickly diagnose problems.
Steps To Take To check the physical interfaces on a router, follow these steps:
Sample Output The following sample output shows all interfaces on a router:
The following sample output is for a specific group of SONET interfaces on a router:
What It Means The sample output shows summary information about the interfaces on the router
listed in order of type of interface. The information includes the name of the
interface, whether it is turned on (up) or off (down), whether the state of the link is
up or down, the protocol configured on the interface, the local address of the
interface, and the address of the remote side of the connection if the interface is a
point-to-point interface.
Action To display detailed information about the status of an interface, use the following
JUNOS CLI operational mode command:
Sample Output The sample output is for an ATM interface. The fields vary depending on the type of
interface.
What It Means The sample output shows static status information about this particular ATM
interface. For examples of sample output for supported interfaces, see the JUNOS
Network Interfaces Configuration Guide.
Table 29 lists the interface types supported by the JUNOS software and shows the
interface name as it appears in the output.
Purpose Displaying real-time statistics about a physical interface is useful when you need to
narrow down possible causes of an interface problem. The monitor command
checks for and displays common interface failures, indicates whether loopback is
detected, and shows any increases in framing errors.
NOTE: If you are accessing the router from the console connection, make sure you
set the CLI terminal type using the set cli terminal command.
Action To display real-time statistics about a physical interface, use the following JUNOS
CLI operational mode command:
What It Means The sample output displays real-time statistics about the physical interface
(updating them every second), the amount that each field has changed since you
started the command or since you cleared the counters by using the C key. It also
checks for and displays common interface failures, such as SONET/SDH and T3
alarms, detected loopbacks, and increases in framing errors.
To control the output of the command while it is running, use the keys shown in
Table 30.
Key Action
N Display information about the next interface. The monitor interface command
scrolls through the physical or logical interfaces in the same order that they
are displayed by the show interfaces terse command.
I Display information about a different interface. The command prompts you
for the name of a specific interface.
F Freeze the display, halting the display of updated statistics.
T Thaw the display, resuming the display of updated statistics.
C Clear (zero) the current delta counters since monitor interface was started. It
does not clear the cumulative counter.
Q Stop the monitor interface command.
Purpose By looking through the messages file for any entries pertaining to the interface that
you are interested in, you can further investigate a problem with an interface.
Action To check system logging, use the following JUNOS CLI operational mode command:
Sample Output
What It Means The sample output shows entries in the messages file pertaining to the SONET
interface, so-0/3/1, and its Intermediate System-to-Intermediate System (IS-IS)
adjacencies and Label Distribution Protocol (LDP) neighbors. The entries indicate
that the interface went down on May 2 at 12:11:27, and that both the IS-IS
adjacency and the LDP neighbor are down.
Table 31: Checklist for Verifying the IS-IS Protocol and Adjacencies
5. Examine a Link-State Protocol Data Unit Header on page 126 show isis database extensive
! 111
JUNOS Baseline Network Operations Guide
Purpose For IS-IS to run on a router (intermediate system) in your network, you must enable
IS-IS on the router, configure a network entity title (NET) on the loopback interface
(lo0), and configure family iso on all interfaces on which you want to run IS-IS.
When you enable IS-IS on a router, Level 1 and Level 2 are enabled by default.
Area
49.0001
R4 R5 R6
L1 L2
Area
49.0003
L2 L2
Area L2 L1
49.0004
R1 R2 R3
Area
g003185
49.0002
In the following steps, the configuration of the various types of routers is examined.
Figure 8 provides more details about the IS-IS network topology on page 112 so that
you can verify the configuration output of the various routers.
Area
49.0001
R4 R5 R6 Area 49.0003
L1 - lo0: .4 L1/L2 - lo0: .5 L2 - lo0: .6
so-0/0/2
L1 .45.2 L2
so-0/0/2 so-0/0/0 so-0/0/0
.45.1 .56.1 .56.2
so-0/0/1 so-0/0/2
.15.2 .26.2
L2 L2
so-0/0/2
so-0/0/1
.26.1
.15.1
L2 L1
so-0/0/0 so-0/0/0 so-0/0/1 so-0/0/1
.12.1 .12.2 .23.1 .23.2
Area 49.0004 R1 R2 R3
L2 - lo0: .1 L1/L2 - lo0: .2 L1 - lo0: .3
Key:
so-0/0/X: 10.1.x.x/30 Area
g003186
lo0: 10.0.0.x/32 49.0002
Steps To Take To verify that IS-IS is configured correctly on routers at different levels, follow these
steps:
Sample output The following output is for an IS-IS configuration on R2, a Level 1/Level 2 router in
the network shown in Figure 7:
[edit interfaces]
user@R2# show
so-0/0/0 {
unit 0 {
family inet {
address 10.1.12.2/30;
}
family iso;
}
}
so-0/0/1 {
unit 0 {
family inet {
address 10.1.23.1/30;
}
family iso;
}
}
so-0/0/2 {
unit 0 {
family inet {
address 10.1.26.1/30;
}
family iso;
}
}
lo0 {
unit 0 {
family inet {
address 10.0.0.2/32;
}
family iso {
address 49.0002.1000.0000.0002.00;
}
}
}
What It Means The sample output shows a basic configuration of IS-IS on R2, a Level 1/Level 2
router. The basic configuration is at the [edit protocols isis] and [edit interfaces]
hierarchy levels.
At the [edit protocols isis] level, five interfaces are included: so-0/0/0, so-0/0/1,
so-0/0/2, fxp0, and the loopback (lo0) interface. Two interfaces, so-0/0/0.0 and
so-0/0/2.0, have Level 1 disabled, making them Level 2 interfaces. One interface,
so-0/0/1.0, has Level 2 disabled, making it a Level 1 interface. The management
interface (fxp0) is disabled so that IS-IS packets are not sent over it, and the
loopback interface (lo0) is included because it becomes a point of connection from
the router to the IS-IS network.
At the [edit interfaces] hierarchy level, all of the interfaces included in the [edit
protocols isis] hierarchy level are configured with family iso, and the loopback (lo0)
interface is configured with the NET address 49.0002.1000.0000.0002.00. Every
router in an IS-IS network must have at least one NET address that identifies a point
of connection to the IS-IS network. The NET address is generally configured on the
loopback (lo0) interface. Routers that participate in multiple areas can have multiple
NET addresses.
See the JUNOS Routing Protocols Configuration Guide for more information on
configuring IS-IS on a router.
Sample Output: The following sample output is for R4, a Level 1 router in the network shown in
Figure 7:
[edit interfaces]
user@R4# show
so-0/0/2 {
unit 0 {
family inet {
address 10.1.45.1/30;
}
family iso;
}
}
lo0 {
unit 0 {
family inet {
address 10.0.0.4/32;
}
family iso {
address 49.0001.1000.0000.0004.00;
}
}
}
What It Means The sample output shows a basic configuration of IS-IS on R4, a Level 1 router. The
basic configuration is at the [edit protocols isis] and [edit interfaces] hierarchy levels.
At the [edit protocols isis] hierarchy level, three interfaces are included: so-0/0/2.0,
fxp0, and the loopback (lo0) interface. Level 2 is disabled on the router, making it a
Level 1 router that sends packets within its local area, 49.0001. When a packet
destination is outside the local area, R4 establishes an adjacency with the nearest
Level 1/Level 2 router (R5) that forwards the packets. For more information on
adjacencies, see “Display the Status of IS-IS Adjacencies” on page 119.
One interface, so-0/0/2.0, is configured for IS-IS. The management interface (fxp0)
is disabled so that IS-IS packets are not sent over it, and the loopback interface (lo0)
is included because it becomes a point of connection from the router to the IS-IS
network.
At the [edit interfaces] hierarchy level, the interface included in the [edit protocols
isis] hierarchy level is also configured with family iso, and the loopback (lo0)
interface is configured with the NET address of 49.0001.1000.0000.0004.00.
Every router in an IS-IS network must have at least one NET address that identifies
a point of connection to the IS-IS network. The NET address is generally configured
on the loopback (lo0) interface. Routers that participate in multiple areas can have
multiple NET addresses.
See the JUNOS Routing Protocols Configuration Guide for more information on
configuring IS-IS on a router.
Sample Output: The following sample output is for R6, a Level 2 router in the network shown in
Figure 7:
[edit interfaces]
user@R6# show
so-0/0/0 {
unit 0 {
family inet {
address 10.1.56.2/30;
}
family iso;
}
}
so-0/0/2 {
unit 0 {
family inet {
address 10.1.26.2/30;
}
family iso;
}
}
lo0 {
unit 0 {
family inet {
address 10.0.0.6/32;
}
family iso {
address 49.0003.1000.0000.0006.00;
}
}
}
What It Means The sample output shows a basic configuration of IS-IS on R6, a Level 2 router. The
basic configuration is at the [edit protocols isis] and [edit interfaces] hierarchy levels.
At the [edit protocols isis] level, four interfaces are included: so-0/0/0.0,
so-0/0/2.0, fxp0, and the loopback (lo0) interface. Level 1 is disabled on the two
SONET interfaces, making this a Level 2 router that routes between areas and
towards other ASs. The management interface (fxp0) is disabled so that IS-IS
packets are not sent over it, and the loopback interface (lo0) is included because it
becomes a point of connection from the router to the IS-IS network.
At the [edit interfaces] hierarchy level, the interfaces included in the [edit protocols
isis] hierarchy level are also configured with family iso, and the loopback (lo0)
interface is configured with the NET address of 49.0003.1000.0000.0006.00.
Every router in an IS-IS network must have at least one NET address that identifies
a point of connection to the IS-IS network. The NET address is generally configured
on the loopback (lo0) interface. Routers that participate in multiple areas can have
multiple NET addresses.
See the JUNOS Routing Protocols Configuration Guide for more information on
configuring IS-IS on a router.
Purpose Assuming that all the routers are correctly configured for IS-IS, you can verify which
neighbors are adjacent and able to exchange IS-IS data. In addition, you can
examine the set of routes installed in the forwarding table to verify that the routing
protocol process (rpd) has relayed the correct information into the forwarding table.
Figure 9 illustrates the example IS-IS topology used for the procedures in this
section.
Area
49.0001
R4 R5 R6 Area 49.0003
L1 - lo0: .4 L1/L2 - lo0: .5 L2 - lo0: .6
so-0/0/2
L1 .45.2 L2
so-0/0/2 so-0/0/0 so-0/0/0
.45.1 .56.1 .56.2
so-0/0/1 so-0/0/2
.15.2 .26.2
L2 L2
so-0/0/2
so-0/0/1
.26.1
.15.1
L2 L1
so-0/0/0 so-0/0/0 so-0/0/1 so-0/0/1
.12.1 .12.2 .23.1 .23.2
Area 49.0004 R1 R2 R3
L2 - lo0: .1 L1/L2 - lo0: .2 L1 - lo0: .3
Key:
so-0/0/X: 10.1.x.x/30 Area
g003186
The network consists of Level 1 and Level 2 adjacencies. Level 1 adjacencies are
within areas 49.0001 and 49.0002. Level 2 adjacencies occur between all directly
connected Level 2 routers regardless of which area they are in. For example, R5 is in
area 49.0001, R6 is in area 49.0003, R1 is in area 49.0004, and R2 is in area
49.0002. The network in Figure 9 should have the following adjacencies:
! Level 2 adjacencies between all directly connected Level 2 routers (R1, R2, R5,
and R6).
! Level 1 adjacencies between routers in area 49.0001 (R4 and R5) and between
routers in area 49.0002 (R2 and R3).
Steps To Take To verify that routers are adjacent and able to exchange IS-IS data, follow these
steps:
Sample Output The following sample output shows the adjacencies that formed for all routers
shown in Figure 9:
What It Means The sample output shows the adjacencies that formed in the network illustrated in
Figure 9. The Level 1/Level 2 routers (R2 and R5) formed Level 1 adjacencies with
Level 1 routers (R3 and R4), and Level 2 adjacencies with the Level 2 routers (R1
and R6). To view the status of the adjacency, examine the State column. In this
example, all adjacencies in the network are up.
If the state is not Up for a particular neighbor, you must first examine the IS-IS
configuration for the particular interface. Make sure that the NET address is correct
and that the loopback (lo0) interface is configured. Use the show isis interface or
show isis interface detail command to display the IS-IS parameters for all interfaces
configured with IS-IS. With these two commands, you can see which interfaces are
configured for IS-IS, whether they are configured for Level 1 or Level 2, the IS-IS
metric, and other IS-IS information.
Action To examine a route in an IS-IS network, enter one or all of the following CLI
commands:
Sample Output 1 The following sample output shows the route from R5 to R3 when all metrics across
interfaces are set to the default of 10:
The following sample output shows the IS-IS configuration for transit router R6 with
the metric on so-0/0/2.0 changed from the default of 10 to 5:
Sample Output 2 The following sample output shows the route from R5 to R3 after the metric on R6
is changed from the default of 10 to 5:
What It Means Sample output 1 shows the cost for each route and the preferred next hop. In this
example, there are two next hops, one through R1 and the other through R6. Both
have an equal cost (30) to the destination. The cost is indicated in the Metric field.
The preferred next hop is randomly chosen. In this case, the preferred next hop is
through R1, interface so-0/0/1.0. In the output for the show route command, the
selected next hop is indicated by a forward arrow (>). With the show route detail
command, the next hop is indicated by the key word selected. The output for the
show isis route command shows the selected interface and indicates that the IS-IS
protocol is building the correct routing table from the link-state database.
In general, the output for the show route commands shows all active entries in the
routing table. The information displayed includes the name of the routing table
(inet.0), the number of destinations for which there are routes in the routing table
(28), how the route was learned, and the route preference value, such as [IS-IS/18].
In addition, any metric associated with the route (metric 30), and the name of the
interface through which the route was learned are displayed.
Action To examine the forwarding table for a router, enter the following CLI command:
What It Means The sample output shows the selected next hop between routers R5 and R3 sent
from the inet routing table and installed into the forwarding table. The first instance
shows the route through R1 and the second instance shows the route through R6. In
both instances, the preferred route displayed in Step 2 is installed in the forwarding
table.
In general, the sample output includes the destination address and destination type,
the next-hop address and next-hop type, the number of references to the next hop,
an index number into an internal next-hop database, and the interface used to
reach the next hop.
Action To examine the link-state database for routers at different levels of the network,
enter the following CLI command:
What It Means The sample output shows the details of the Level 1 and Level 2 IS-IS databases for
routers R1, R2, R3, R4, R5, and R6. Whether a router is configured for Level 1, Level
2 or Level 1/Level 2 is indicated by the type of IS-IS link-state datebase(s) in the
output for the show isis database command for that router. For example, R3 and R4
are Level 1 routers because they do not have LSPs in the Level 2 link-state database,
and the R1 and R6 are Level 2 routers because they do not have LSPS in the Level 1
link-state database. R2 and R5 are have LSPs in both Level 1/Level 2 link-state
databases, indicating they are Level 1/Level 2 routers.
In addition, the output for R2 shows that it is a Level 1/Level 2 router because it has
R3 in its Level 1 database, while R3 does not have the L2 notation in the Attributes
field, indicating that it is configured for Level 1.
The details of the Level 2 IS-IS database are the same for all Level 2 routers in the
network.
The key word Attached appears in the Level 1 link-state database for R2, R3, R4, and
R5, indicating that the Level 2 routers (R2 and R5) can communicate with other
Level 2 systems and act as gateways for the Level 1 routers (R3 and R4) in their
respective areas. If the links that connect R2 and R5 to the other Level 2 routers (R1
and R6) are broken, the key word Attached will not appear in the output because R2
and R5 will no longer act as gateways for the Level 1 routers.
Packet: LSP ID: R2.00-00, Length: 139 bytes, Lifetime : 1198 secs
Checksum: 0xbb8d, Sequence: 0x57, Attributes: 0xb <L1 L2 Attached>
NLPID: 0x83, Fixed length: 27 bytes, Version: 1, Sysid length: 0 bytes
Packet type: 18, Packet version: 1, Max area: 0
[...Output truncated...]
Header: LSP ID: R3.00-00, Length: 139 bytes
Allocated length: 284 bytes, Router ID: 10.0.0.3
Remaining lifetime: 823 secs, Level: 1,Interface: 68
Estimated free bytes: 145, Actual free bytes: 145
Aging timer expires in: 823 secs
Protocols: IP, IPv6
Packet: LSP ID: R3.00-00, Length: 139 bytes, Lifetime : 1198 secs
Checksum: 0xaaa2, Sequence: 0x59, Attributes: 0x1 <L1>
NLPID: 0x83, Fixed length: 27 bytes, Version: 1, Sysid length: 0 bytes
Packet type: 18, Packet version: 1, Max area: 0
[...Output truncated...]
IS-IS level 2 link-state database:
[...Output truncated...]
Header: LSP ID: R1.00-00, Length: 194 bytes
Allocated length: 284 bytes, Router ID: 10.0.0.1
Remaining lifetime: 398 secs, Level: 2,Interface: 67
Estimated free bytes: 145, Actual free bytes: 90
Aging timer expires in: 398 secs
Protocols: IP, IPv6
Packet: LSP ID: R1.00-00, Length: 194 bytes, Lifetime : 1196 secs
Checksum: 0x3e10, Sequence: 0x57, Attributes: 0x3 <L1 L2>
NLPID: 0x83, Fixed length: 27 bytes, Version: 1, Sysid length: 0 bytes
Packet type: 20, Packet version: 1, Max area: 0
[...Output truncated...]
Header: LSP ID: R2.00-00, Length: 236 bytes
Allocated length: 1492 bytes, Router ID: 10.0.0.2
Remaining lifetime: 677 secs, Level: 2,Interface: 0
Estimated free bytes: 1256, Actual free bytes: 1256
Aging timer expires in: 677 secs
Protocols: IP, IPv6
Packet: LSP ID: R2.00-00, Length: 236 bytes, Lifetime : 1198 secs
Checksum: 0x9790, Sequence: 0x5e, Attributes: 0x3 <L1 L2>
NLPID: 0x83, Fixed length: 27 bytes, Version: 1, Sysid length: 0 bytes
Packet type: 20, Packet version: 1, Max area: 0
[...Output truncated...]
What It Means The sample output is from router R2 and shows extensive information about the
Level 1 and Level 2 link-state databases, which are identical across all Level 2
routers. Level 1 routers only include information for the Level 1 link-state database,
which is identical to the Level 1 information in the output for a Level 2 router. The
sample output shows the details of four LSPs. Level 1 and Level 2 LSPs include
identical types of information except for the packet type. A Level 2 LSP has a packet
type of 20 and a Level 1 LSP has a packet type of 18.
The first three examples illustrate different values in the Attributes field:
! <L1 L2> and the key word Attached in the first example, R2.00-00, indicate that
router R2 is a Level1/Level 2 router acting as a gateway for Level 1 routers.
! <L1 L2> in the third example, R1.00-00, indicates that R1 is a Level 2 router
(the fourth example is also for a Level 2 router).
The fourth example, R2.00-00, is included to show that a Level 1/Level 2 router
appears in both the Level 1 and the Level 2 link-state databases. Note that in the
Level 2 link-state database, the key word Attached is not included in the Attributes
field.
It is useful to examine one LSP in greater detail. The third LSP, R1.00-00, was
originated by R1 as indicated by the LSP ID field. R1 is the hostname of the router.
The first 00 indicates that the LSP is for the router itself, and the final 00 denotes
that the LSP is not fragmented. Both IPv4 and IPv6 are supported by this router, as
indicated in the Protocols field. The Attributes field shows that the router is capable
of both Level 1 and Level 2 routing, is not connected to Level 1 routers in other
areas, and is not overloaded. The key words Attached and Overloaded would appear
in the Attributes field if this were the case. The remaining lifetime of the LSP is 1196
seconds. IS-IS lifetimes start at a configured age (1200 seconds by default) and
count down to zero.
This chapter describes how to check whether the Open Shortest Path First protocol
(OSPF) is configured correctly on a Juniper Networks router, the proper adjacencies
are formed in a network, and the appropriate link-state advertisements (LSAs) are
flooded throughout different parts of the OSPF autonomous system (AS). (See
Table 32.)
Table 32: Checklist for Verifying the OSPF Protocol and Neighbors
2. Examine the OSPF Link-State Database on page 144 show ospf database
3. Examine OSPF Routes on page 148 show route destination-prefix
show ospf database
4. Examine the Forwarding Table on page 151 show route destination-prefix extensive
show route forwarding-table destination destination-prefix
5. Examine Link-State Advertisements in Detail on page 152
a. Examine a Type 1 Router LSA on page 152 show ospf database router extensive
b. Examine a Type 3 Summary LSA on page 153 show ospf database netsummary extensive
c. Examine a Type 4 ASBR Summary LSA on page 154 show ospf database asbrsummary extensive
d. Examine a Type 5 AS External LSA on page 155 show ospf database extern extensive
e. Examine Type 7 NSSA External LSA on page 156 show ospf database nssa extensive
! 129
JUNOS Baseline Network Operations Guide
Purpose For OSPF to run on a router in your network, you must include the interfaces that
run OSPF at the [edit protocols ospf] hierarchy level and, for those interfaces, the
family inet statement must be included at the [edit interfaces interface-name unit
logical-unit-number] hierarchy level.
R2 Area: 0.0.0.0 R4
R1 R5
ASBR NSSA-ABR Backbone Stub-ABR Stub Router
g003252
R6 External
ASBR Router B
All non-backbone areas (0.0.0.1, 0.0.0.2, and 0.0.0.3) contain routers internal to
that area (R1, R5, and R6) as well as a single area border router (ABR) (R2, R3, and
R4). Internal routers generate LSAs within their area. The ABR translates these
internal LSAs into summary LSAs that represent the LSAs within its non-backbone
area and floods the summary LSAs to the backbone. The ABR is also responsible for
generating summary LSAs that represent the backbone LSAs and injecting them
into its attached areas. Because the ABR belongs to more than one area, it
maintains a separate topological database for each area to which it is connected.
The NSSA (0.0.0.1) consists of two routers: R1 and R2. An NSSA allows external
routes to be flooded within its area. These routes are then leaked to other areas
within the AS. However, external routes learned from other areas within the AS do
not enter the NSSA.
The stub area (0.0.0.2) consists of two routers: R4 and R5. A stub area does not
allow external routes to be flooded within its area. A stub area is useful when much
of the AS consists of external LSAs because it reduces the size of the topological
database within the stub area and subsequently the amount of memory required by
the routers in the area.
External Routers A and B reside outside the AS. When an OSPF router exchanges
routing information with routers in other ASs, that router is called an autonomous
system boundary router (ASBR). The ASBRs shown in Figure 10 are R1 and R6.
Figure 11 provides interface and IP address information for the example OSPF
network topology used for the procedures in this section.
R1 R2 R4 R5
lo0: .1 lo0: .2 lo0: .4 lo0: .5
so-0/0/0 so-0/0/3 so-0/0/3 so-0/0/2
.12.2 .24.1 .24.2 .45.1
so-0/0/0 so-0/0/2
so-0/0/1
.12.1 so-0/0/0 .45.2
so-0/0/2 .23.1
.34.2
.13.1 R3
lo0: .3 so-0/0/0
so-0/0/2 so-0/0/1
.34.1
.13.2 .23.2
so-0/0/3
.36.1
External so-0/0/3
Router A .36.2
lo0: .100
so-0/0/0 so-0/0/0
.56.2 .56.1
R6 External
g003253
Steps To Take To verify that OSPF is configured correctly on routers in different areas of the
network, follow these steps:
Sample Output The following sample output is for an OSPF configuration on R1, an ASBR router
shown in Figure 11:
protocols {
ospf {
export export-to-ospf;
area 0.0.0.1 {
nssa;
interface so-0/0/0.0;
interface lo0.0 {
passive;
}
}
}
}
policy-options {
policy-statement export-to-ospf {
term external-router {
from {
route-filter 10.0.0.100/32 exact;
}
then accept;
}
}
}
The following sample output is for an OSPF configuration on R6, an ASBR router
shown in Figure 11:
routing-options {
static {
[...Output truncated...]
route 10.0.0.101/32 next-hop 10.1.56.1;
}
router-id 10.0.0.6;
}
protocols {
ospf {
export export-to-ospf;
area 0.0.0.3 {
interface so-0/0/3.0;
interface lo0.0 {
passive;
}
}
}
}
policy-options {
policy-statement export-to-ospf {
term external-router {
from {
route-filter 10.0.0.101/32 exact;
}
then accept;
}
}
}
What It Means The sample output shows a basic OSPF configuration at the [edit protocols ospf] and
[edit interfaces] hierarchy levels on the R1 and R6 ASBR routers. In addition, both
routers have an export policy, export-to-ospf, configured. The export policy allows
external routes to be injected into the OSPF database and communicated
throughout the AS.
R1 has two interfaces included at the [edit protocols ospf] hierarchy level: so-0/0/0
and the loopback interface (lo0). Both interfaces have the family inet statement
included at the [edit interfaces] hierarchy level and are in area 0.0.0.1. Area 0.0.0.1
is attached to the backbone through R2, an ABR.
In addition, R1 has the nssa statement included at the [edit protocols ospf]
hierarchy level indicating that it is an ASBR running in an NSSA. An NSSA allows
external routes from outside the AS to be flooded within it. In this instance, the
routes learned from external router B through the export policy export-to-ospf are
injected into the R1 OSPF database and communicated throughout the AS. For
more information on OSPF routes, see “Examine OSPF Routes” on page 148.
R6 has two interfaces included at the [edit protocols ospf] hierarchy level: so-0/0/3
and the loopback interface (lo0). Both interfaces have the family inet statement
included at the [edit interfaces] hierarchy level and are in area 0.0.0.3. Area 0.0.0.3
is attached to the backbone through R3, an ABR. In addition, external router B is
attached to R6 which has the export policy export-to-ospf configured. The export
policy allows external routes to be injected into the R6 OSPF database and
communicated throughout the AS.
Both routers (R1 and R6) have the router ID configured manually to avoid possible
problems when the OSPF router ID (RID) changes: for example, when multiple
loopback addresses are configured. The RID uniquely identifies the router within
the OSPF network. It is transmitted within the LSAs used to populate the link-state
database and calculate the shortest-path tree. In a link-state network, it is important
that two routers do not share the same RID value, otherwise IP routing problems
may occur.
See the JUNOS Routing Protocols Configuration Guide for more information on
configuring OSPF on a router.
Sample Output The following sample output is for an OSPF configuration on R2, an NSSA ABR
shown in Figure 11:
}
routing-options {
}
router-id 10.0.0.2;
}
protocols {
ospf {
area 0.0.0.1 {
nssa {
default-lsa default-metric 10;
}
interface so-0/0/0.0;
}
area 0.0.0.0 {
interface so-0/0/3.0;
interface so-0/0/1.0;
interface lo0.0 {
passive;
}
}
}
}
The following sample output is for an OSPF configuration on R3, an ABR shown in
Figure 11:
}
}
routing-options {
router-id 10.0.0.3;
}
protocols {
ospf {
area 0.0.0.0 {
interface so-0/0/0.0;
interface so-0/0/1.0;
interface lo0.0 {
passive;
}
}
area 0.0.0.3 {
interface so-0/0/3.0;
}
}
The following sample output is for an OSPF configuration on R4, an ABR shown in
Figure 11:
router-id 10.0.0.4;
}
protocols {
ospf {
area 0.0.0.0 {
interface so-0/0/0.0;
interface so-0/0/3.0;
interface lo0.0 {
passive;
}
}
area 0.0.0.2 {
stub default-metric 10;
interface so-0/0/2.0;
}
}
}
What It Means The sample output shows a basic OSPF configuration at the [edit protocols ospf] and
[edit interfaces] hierarchy levels on the R2, R3, and R4 ABR routers.
R2 has four interfaces included at the [edit protocols ospf] hierarchy level, and those
interfaces have the family inet statement included at the [edit interfaces] hierarchy
level. Three interfaces—so-0/0/1.0, so-0/0/3.0, and the loopback (lo0)
interface—are in the backbone (0.0.0.0). One interface, so-0/0/0.0, is in the NSSA
(0.0.0.1). Because R2 has one interface configured for an NSSA, external routes
learned from outside the AS (through R1) are redistributed throughout the network.
For more information on OSPF routes, see “Examine OSPF Routes” on page 148.
R3 has four interfaces included at the [edit protocols ospf] hierarchy level, and those
interfaces have the family inet statement included at the [edit interfaces] hierarchy
level. Three interfaces—so-0/0/0.0, so-0/0/1.0, and the loopback (lo0) interface—
are in the backbone (0.0.0.0). One interface, so-0/0/3.0, is in a non-backbone area
(0.0.0.3).
R4 has four interfaces included at the [edit protocols ospf] hierarchy level, and those
interfaces have the family inet statement included at the [edit interfaces] hierarchy
level. Two interfaces, so-0/0/0.0 and so-0/0/3.0, are in the backbone (0.0.0.0).
One interface, so-0/0/2.0, is in the stub area (0.0.0.2). Because internal routers
within a stub area do not receive external LSA information, they must rely on either
direct static routes or a default route to get to external destinations. A default route
can be statically configured on the internal router or learned from the stub ABR. To
advertise a default LSA from the stub ABR, include the stub default-metric statement
at the [edit protocols ospf area area-id] hierarchy level to activate the default route.
All routers (R2, R3, and R4) have the router ID configured manually to avoid
possible problems when the OSPF router ID (RID) changes; for example, when
multiple loopback addresses are configured. The RID uniquely identifies the router
within the OSPF network. It is transmitted within the LSAs used to populate the
link-state database and calculate the shortest-path tree. In a link-state network, it is
important that two routers do not share the same RID value, otherwise IP routing
problems may occur.
An ABR belongs to more than one area and maintains a separate topological
database for each area to which it is connected. For more information on the OSPF
database, see “Examine the OSPF Link-State Database” on page 144.
See the JUNOS Routing Protocols Configuration Guide for more information on
configuring OSPF on a router.
Sample Output The following sample output is for an OSPF configuration on R5, a stub router
shown in Figure 11:
What It Means The sample output shows a basic OSPF configuration at the [edit protocols ospf] and
[edit interfaces] hierarchy levels on R5, a stub router.
R5 has two interfaces included at the [edit protocols ospf] hierarchy level, and those
interfaces have the family inet statement included at the [edit interfaces] hierarchy
level. Both interfaces, so-0/0/2.0 and the loopback interface (lo0), are in the stub
area (0.0.0.2).
R5 has the router ID configured manually to avoid possible problems when the
OSPF router ID (RID) changes; for example, when multiple loopback addresses are
configured. The RID uniquely identifies the router within the OSPF network. It is
transmitted within the LSAs used to populate the link-state database and calculate
the shortest-path tree. In a link-state network, it is important that two routers do not
share the same RID value, otherwise IP routing problems may occur.
A stub area does not allow AS external advertisements to flood within that area. R5
relies on a default route (0.0.0.0/0) to reach destinations outside the AS. The
default route can be statically configured on R5 or advertised by an ABR (R4). In this
network, the default LSA is advertised by R4.
A stub area is useful if you want to reduce the size of the topological database and
therefore the amount of memory required from the routers in the stub area.
However, some restrictions apply to a stub area. You cannot create a virtual link
through a stub area, and a stub area cannot contain an ASBR.
Purpose Assuming that all the routers are correctly configured for OSPF, you can verify
which neighbors are adjacent and what type of LSAs are contained in the OSPF
link-state database. In addition, you can examine the set of routes installed in the
forwarding table to verify that the routing protocol process (rpd) has relayed the
correct information into the forwarding table.
R1 R2 R4 R5
lo0: .1 lo0: .2 lo0: .4 lo0: .5
so-0/0/0 so-0/0/3 so-0/0/3 so-0/0/2
.12.2 .24.1 .24.2 .45.1
so-0/0/0 so-0/0/2
so-0/0/1
.12.1 so-0/0/0 .45.2
so-0/0/2 .23.1
.34.2
.13.1 R3
lo0: .3 so-0/0/0
so-0/0/2 so-0/0/1
.34.1
.13.2 .23.2
so-0/0/3
.36.1
External so-0/0/3
Router A .36.2
lo0: .100
so-0/0/0 so-0/0/0
.56.2 .56.1
R6 External
g003253
Key: lo0: .6 Router B
so-0/0/X: 10.1.xx.x/30 lo0: .101
lo0: 10.0.0.x/32 Area: 0.0.0.3
The network consists of various types of routers that form adjacencies with
neighboring OSPF routers. Once these adjacencies are in place, each router
generates and floods LSAs into the network. The LSAs are placed into the link-state
database on each router where the shortest path first (SPF) algorithm is calculated
to find the best path to each router in the network. The network in Figure 12 should
have the following adjacencies and LSA distribution:
! ABR routers R2, R3, and R4 should form adjacencies with routers in all areas to
which they are connected (0.0.0.0, 0.0.0.1, 0.0.0.2, and 0.0.0.3). See “Check
OSPF on an ABR” on page 135.
! Internal routers (R1, R5, and R6) should form adjacencies with routers inside
their local area only. See “Check OSPF on a Stub Router” on page 139 and
“Check OSPF on an ASBR” on page 132.
! Backbone area 0.0.0.0 should have Type 1, Type 3, Type 4, and Type 5 LSAs.
! NSSA area 0.0.0.1 should have Type 1, Type 3, and Type 7 LSAs.
! Area 0.0.0.3 should have Type 1, Type 3, Type 4, and Type 5 LSAs.
Steps To Take To verify that routers are adjacent and have the correct exchange of LSAs, follow
these steps:
Sample Output The following sample output shows the adjacencies that formed for all routers in
Figure 12 on page 141:
What It Means The sample output shows that ABR routers R2, R3, and R4 have formed adjacencies
with routers in all areas to which they are directly connected. Internal routers (R1,
R5, and R6) have formed an adjacency with the other router inside their local area.
Adjacencies are formed after OSPF hello packets are sent and received by
neighbors. Adjacencies determine the type of LSAs sent and received, and what
topological database updates are sent. When adjacencies are established, pairs of
adjacent routers synchronize their topological databases.
Table 33 lists and describes the fields in the show ospf neighbor command.
Table 33: Output Fields for the show ospf neighbor Command
Field Description
Address Address of the neighbor.
Interface Interface through which the neighbor is reachable.
State State of the neighbor. It can be Attempt, Down, Exchange, ExStart, Full, Init,
Loading, or 2 Way.
ID Router ID of the neighbor.
Pri Priority of the neighbor to become the designated router. Only used on
broadcast networks during designated router elections. By default, set to
128, indicating the highest priority and the most likely router to be elected
designated router.
Dead Number of seconds until the neighbor becomes unreachable.
Area: 0.0.0.0
Area: 0.0.0.1 Backbone Area: 0.0.0.2
NSSA Stub
Area 0 LSA 1
R1 R2 Area 1 LSA 3 R4 R5
ASBR NSSA-ABR Area 2 LSA 3 Stub-ABR Stub Router
Area 1 LSA 1 Area 3 LSA 3
Area 0 LSA 3 Area 2 LSA 1
Area 2 LSA 3 Area 1 LSA 4 Area 0 LSA 3
Area 3 LSA 3 Area 3 LSA 4 Area 1 LSA 3
Area 1 LSA 7 Area 1 LSA 5 Area 3 LSA 3
Area 3 LSA 5
R3
External route ABR
External route
R6 External
g003254
ASBR Router B
Area: 0.0.0.3
! Backbone area 0.0.0.0 should have Type 1, Type 3, Type 4, and Type 5 LSAs.
! NSSA area 0.0.0.1 should have Type 1, Type 3, and Type 7 LSAs.
! Area 0.0.0.3 should have Type 1, Type 3, Type 4, and Type 5 LSAs.
Because all routers in this network have SONET interfaces configured for
Point-to-Point (PPP) encapsulation, all OSPF adjacencies are point-to-point, which
results in Type 2 network LSAs not appearing in this network or being described in
the following sections. Type 2 network LSAs are only advertised by a designated
router, which is only present on broadcast or non-broadcast multiaccess (NBMA)
networks.
Action To determine if the correct LSAs appear in the different areas of the OSPF AS, enter
the following CLI operational mode command:
What It Means The sample output shows that all the ABRs have the correct distribution of LSAs.
Area 0.0.0.0 for all routers has Type 1 router, Type 3 summary, and Type 4 ASBR
summary LSAs. Each ABR has an OSPF AS scope link-state database that includes
Type 5 external LSAs.
Note that Type 2 network LSAs are not found in this topology because both
broadcast or NMBA network types are not present.
NSSA area 0.0.0.1, in the output for R2, has Type 1 router, Type 3 summary, and
Type 7 NSSA LSAs. Stub area 0.0.0.2, in the output for R4, has Type 1 router and
Type 3 summary LSAs. Non-backbone area 0.0.0.3, in the output for R3, has Type 1
router, Type 3 summary, Type 4 ASBR, and Type 5 external LSAs.
All areas have a Type 1 router LSA because the Type 1 LSA is generated for each
router that has interfaces in that area. Because this LSA has an area flooding scope,
it remains within its own particular area and is not seen in other areas. For
example, in the link-state database for area 0.0.0.2, there are two router LSAs: one
for R4 and one for R5.
The ABR for that area places the routing information contained within the Type 1
LSA into a Type 3 summary or Type 4 ASBR summary LSA and forwards it across
the area boundary. Whether the area receives a Type 3 or Type 4 summary LSA
depends on whether the area is a stub area. Type 3 summary LSAs appear in all
areas, but Type 4 LSAs only appear in non-stub areas as indicated in the link-state
databases for areas 0.0.0.1, 0.0.0.2, and 0.0.0.3.
Each ABR router has a Type 5 AS external LSA used to advertise any networks
external to the OSPF AS. This LSA is flooded by the ABRs to each non-stub router in
the entire AS. For example, within area 0.0.0.0, Type 5 LSAs exist for areas 0.0.0.1
and 0.0.0.3. Both of these areas are connected to routers (external router A and
external router B) from other ASs, which results in the injection of external routes
into the OSPF AS. However, there are no Type 5 LSAs in stub areas 0.0.0.1 and
0.0.0.2.
A Type 7 NSSA external LSA appears in NSSA area 0.0.0.1 and is used within the
NSSA to advertise an external router. This LSA is flooded to each router in the NSSA
and is not sent to other adjacent areas. For example, only area 0.0.0.1 has a Type 7
LSA. Because a Type 7 LSA does not traverse area boundaries, the ABR in the NSSA
(R2) translates the Type 7 LSA into a Type 5 LSA that is forwarded to all areas (with
the exception of stub areas).
The sample output shows that each router has two databases, indicating that it is an
ABR between the backbone and a non-backbone, stub, or NSSA area. All of the
addresses preceded by an asterisk (*) are LSAs that originated with the router from
which the output was taken.
Action To examine a route in an OSPF AS, enter one or all of the following CLI commands:
Sample Output 1 The following sample output shows the path from R5 to external router A:
Sample Output 2 The following sample output shows the route from R6 to external router A:
Sample Output 3 The following sample output shows the route from R4 to R6:
What It Means Sample output 1 shows an OSPF default route (0.0.0.0/0) with a preference value of
10. In the area 0.0.0.2 link-state database, a Type 3 summary LSA advertises the
default route.
Sample output 2 shows an OSPF route with a preference value of 150. In the AS
scope link-state database, an external Type 5 LSA indicates that the route from R6 to
external router A is through R2, the advertising router. By default, routes resulting
from OSPF external LSAs are installed with a preference value of 150.
Sample output 3 shows an OSPF route with a preference value of 10. In the area
0.0.0.0 link-state database, a summary Type 3 LSA indicates that the route from R4
to R6 is through R3, the advertising router.
The LSAs placed into the link-state database are used by the router to run the
Dijkstra algorithm (also called the shortest path first algorithm). This computation
uses the link-state database as a source, resulting in a loop-free topology using the
best metric from the local router to all nodes in the OSPF network.
Action To examine the forwarding table, enter the following CLI commands:
What It Means The sample output shows that the same next hop appears in the output for the show
route destination-prefix extensive and the show route forwarding-table destination
destination-prefix commands, indicating that the routing protocol process (rpd) is
relaying the correct next hop to the forwarding table.
The show route destination-prefix extensive command displays very detailed route
information about the active entries for the specified address or range of addresses.
For more information about the show route command, see the JUNOS Routing
Protocols and Policies Command Reference.
What It Means The sample output shows the details of two router LSAs: the first for R1 (*10.0.0.1)
and the second for R2 (10.0.0.2). The asterisk (*) indicates that the LSA was
generated by R1. You can also determine ownership of the LSA by the last line of
the output in this case, ours.
Each time the LSA is updated, the sequence (seq) field increments, indicating that
the router has the most recent version of the LSA. Values range from 0x80000001
to 0x7FFFFFFF. If the sequence field is not incrementing, there may be problems
with the connection.
The bits field is set to 0x2 in the first LSA and 0x3 in the second LSA. When the bits
field is set to 0x2,the originating router (R1) is an ASBR. When the bits field is set to
0x3, the originating router (R2) is both ABR and ASBR.
R1 has three links connected to area 0.0.0.1 shown by the link count field that is set
to a value of 3. The Type field shows that R1 has a single point-to-point link to R2
and two links advertised as stub networks.
Each OSPF router generates a single Type 1 LSA to describe the status and cost
(metric) of all links on the router. This LSA is flooded to each router in the OSPF
area. It is defined as having an area scope, so it is not flooded across an area
boundary.
What It Means The sample output shows that R2 is an ABR because it contains two databases: one
for the backbone area 0.0.0.0 and one for area 0.0.0.1. Within the backbone area,
the summary LSA *10.0.0.1 is generated from R2 as indicated by the asterisk (*)
next to the link-state ID field, and ours in the last line of the LSA. The cost to
transmit data out of the interface is 1, as indicated by the metric field.
Within area 0.0.0.1, the summary LSA *10.0.0.5 is generated by R2 and has a
metric of 2, which is the cost to R5 from R2. Before calculating the SPF algorithm,
the local router (R2) must add an additional metric of 1 to the existing metric of 1.
The additional metric of 1 must be added because there is another router between
R2 and R5 (R4).
Each time the LSA is updated, the sequence (seq) field increments, indicating that
the router has the most recent version of the LSA. Values range from 0x80000001
to 0x7FFFFFFF. If the sequence field is not incrementing, there may be problems
with the connection.
What It Means The sample output shows that an LSA within the backbone area, *10.0.0.6, is
generated by ASBR R3, as indicated by the asterisk (*) next to the link-state ID field
and ours in the last line of the LSA.
Each time the LSA is updated, the sequence (seq) field increments, indicating that
the router has the most recent version of the LSA. Values range from 0x80000001
to 0x7FFFFFFF. If the sequence field is not incrementing, there may be problems
with the connection.
Because the router ID of all the ASBR summary LSAs is a full 32-bit value, the
network mask is not needed and is set to a value of 0.0.0.0. The metric for the LSA
within the backbone area is set to 1, which is the cost to the advertising router (R3)
from the originating router (R6). The metric is calculated before the SPF algorithm is
calculated.
In general, each ABR that must transmit information about an ASBR from one OSPF
area into another generates a Type 4 LSA. This LSA is flooded to each router in the
OSPF area. A Type 4 LSA is defined as having an area scope so that another ABR
does not reflood it across the area boundary.
What It Means The sample output shows one Type 5 external LSA, *10.0.0.100. The status of the
router represented by this LSA is indicated by the fwd addr field, which shows that it
does not belong to any particular OSPF area. The forwarding address provides the
address toward which packets should be sent to reach the external router
(10.0.0.1). R1 is the ASBR with the connection to external router A.
The mask field represents the subnet mask associated with the advertised router. It
is used with the link-state ID field (10.0.0.100), which encapsulates the network
address in a Type 5 LSA. This LSA has a metric value of 0, the default value,
indicating that this is a Type 2 external metric. Thus, any local router should use the
default metric (0) when performing an SPF algorithm.
Each time the LSA is updated, the sequence (seq) field increments, indicating that
the router has the most recent version of the LSA. Values range from 0x80000001
to 0x7FFFFFFF. If the sequence field is not incrementing, there may be problems
with the connection.
In general, each ASBR generates a Type 5 LSA to advertise any routers external to
the OSPF AS. This LSA is flooded to each non-stub router in the entire AS.
What It Means The sample output shows that the LSA belongs to a single NSSA, 0.0.0.1, and was
generated by R1. This router has a metric value of 0, which is the default, and is
listed as a Type 2 external metric. Any local router must use the default metric as
the total cost for the route when performing an SPF calculation. The default metric
of the route must be added to the cost to reach the advertising ASBR. This value
then represents the total cost for the route.
In general, each ASBR within the NSSA generates a Type 7 LSA to advertise any
routers external to the OSPF AS. This LSA is flooded to each router within the NSSA
(R2). Because the LSA has only an area flooding scope, it is not sent into other
adjacent areas. For each Type 7 LSA received, the ABR (R2) translates the
information into a Type 5 LSA and sends the information into the backbone. The
other backbone routers do not know that the original information came from an
NSSA. The Type 5 LSA is then flooded to each non-stub router in the entire AS.
This chapter describes how to check whether the Border Gateway Protocol (BGP) is
configured correctly on a Juniper Networks router in your network, the internal
Border Gateway Protocol (IBGP) and exterior Border Gateway Protocol (EBGP)
sessions are properly established, the external routes are advertised and received
correctly, and the BGP path selection process is working properly. (See Table 34.)
Table 34: Checklist for Verifying the BGP Protocol and Peers
2. Verify That a Neighbor is Advertising a Particular Route on show route advertising-protocol bgp neighbor-address
page 169
3. Verify That a Particular BGP Route Is Received on Your Router on show route receive-protocol bgp neighbor-address
page 170
Examine BGP Routes and Route Selection on page 171
1. Examine the Local Preference Selection on page 173 show route destination-prefix < detail >
2. Examine the Multiple Exit Discriminator Route Selection on show route destination-prefix < detail >
page 174
3. Examine the EBGP over IBGP Selection on page 175 show route destination-prefix < detail >
4. Examine the IGP Cost Selection on page 176 show route destination-prefix < detail >
Examine Routes in the Forwarding Table on page 177 show route forwarding-table
! 157
JUNOS Baseline Network Operations Guide
Purpose For BGP to run on a router in your network, you must define the local autonomous
system (AS) number, configure at least one group, and include information about at
least one peer in the group. If the peer is an EBGP peer, include the peer’s AS
number. For all peers, include either the peer’s interface IP address or loopback
(lo0) IP address. When configuring BGP on an interface, you must also include the
family inet statement at the [edit interfaces interface-name unit logical-unit-number]
hierarchy level.
Multiple Customer
Aggregate Routes:
AS 65001 100.100.1.0/24 AS 65002
100.100.2.0/24
100.100.3.0/24
R1 100.100.4.0/24 R2 R3
lo0: .1 lo0: .2 lo0: .3
so-0/0/0–.12.1 so-0/0/0–.12.2 so-0/0/1–.23.1
so-0/0/1–.23.2
MED 5
so-0/0/3–.24.1 so-0/0/3–.36.1
so-0/0/3–.24.2 so-0/0/3–.36.2
MED 10 so-0/0/1–.46.1
Key:
so-0/0/X: 10.1.x.x/30
lo0: 10.0.0.x/32 Physical Connection
E-BGP
I-BGP
All routers within each AS maintain an IBGP session between each router in that AS.
R1 and R5 have an IBGP session through their loopback (lo0) interfaces: 10.0.0.1
and 10.0.05. R2, R3, R4, and R6 maintain IBGP sessions between each other
through their loopback (lo0) interfaces: 10.0.0.2, 10.0.0.3, 10.0.0.4, and 10.0.0.6.
The two routers in AS 65001 each contain one EBGP link to AS 65002 (R2 and R4)
over which they announce aggregated prefixes: 100.100/16. Routers at the edge of
a network that communicate directly with routers in other networks are called
border routers. Border routers use EBGP to exchange routing information between
networks.
Adjacent BGP routers are referred to as neighbors or peers. Peers can be internal or
external to the AS. Internal and external peers are configured slightly differently. In
general, internal peers communicate using the loopback (lo0) interface, and
external peers communicate through the shared interface. See Figure 14 for the
loopback (lo0) and interface information.
Steps To Take To verify the BGP configuration of a router in your network, follow these steps:
Sample Output The following sample output is for a BGP configuration on R3 in the network shown
in Figure 14:
}
}
so-0/0/3 {
unit 0 {
family inet {
address 10.1.36.1/30;
}
family iso;
}
}
lo0 {
unit 0 {
family inet {
address 10.0.0.3/32;
}
family iso {
address 49.0002.1000.0000.0003.00;
}
}
}
}
routing-options {
[...Output truncated...]
router-id 10.0.0.3;
autonomous-system 65002;
}
protocols {
bgp {
group internal {
type internal;
local-address 10.0.0.3;
neighbor 10.0.0.2;
neighbor 10.0.0.4;
neighbor 10.0.0.6;
}
}
isis {
level 1 disable;
interface all {
level 2 metric 10;
}
interface lo0.0;
}
}
}
lo0 {
unit 0 {
family inet {
address 10.0.0.6/32;
}
family iso {
address 49.0003.1000.0000.0006.00;
}
}
}
}
routing-options {
[Output truncated...]
router-id 10.0.0.6;
autonomous-system 65002;
}
protocols {
bgp {
group internal {
type internal;
local-address 10.0.0.6;
neighbor 10.0.0.2;
neighbor 10.0.0.3;
neighbor 10.0.0.4;
}
}
isis {
level 1 disable;
interface all {
level 2 metric 10;
}
interface lo0.0;
}
}
What It Means The sample output shows a basic BGP configuration on routers R3 and R6. The local
AS (65002) and one group (internal) are configured on both routers. R3 has three
internal peers—10.0.0.2, 10.0.0.4, and 10.0.0.6—included at the [protocols bgp
group group] hierarchy level. R6 also has three internal peers: 10.0.0.2, 10.0.0.3,
and 10.0.0.4. The underlying IGP protocol is Intermediate System-to-Intermediate
System (IS-IS), and relevant interfaces are configured to run IS-IS.
Note that in this configuration the router ID is manually configured to avoid any
duplicate router ID problems.
Sample Output The following sample output is for a BGP configuration on two border routers from
AS 65002 (R2 and R4) shown in Figure 14:
}
group toR1 {
type external;
import import-toR1;
peer-as 65001;
neighbor 10.1.12.1;
}
}
isis {
level 1 disable;
interface all {
level 2 metric 10;
}
interface lo0.0;
}
}
policy-options {
policy-statement next-hop-self {
term change-next-hop {
from neighbor 10.1.12.1;
then {
next-hop self;
}
}
}
policy-statement import-toR1 {
term 1 {
from {
route-filter 100.100.1.0/24 exact;
}
then {
local-preference 200;
}
}
}
lo0 {
unit 0 {
family inet {
address 10.0.0.4/32;
}
family iso {
address 49.0001.1000.0000.0004.00;
}
}
}
}
routing-options {
[...Output truncated...]
router-id 10.0.0.4;
autonomous-system 65002;
}
protocols {
bgp {
group internal {
type internal;
local-address 10.0.0.4;
export next-hop-self;
neighbor 10.0.0.2;
neighbor 10.0.0.3;
neighbor 10.0.0.6;
}
group toR5 {
type external;
peer-as 65001;
neighbor 10.1.45.2;
}
}
isis {
level 1 disable;
interface all {
level 2 metric 10;
}
interface lo0.0;
}
}
policy-options {
policy-statement next-hop-self {
term change-next-hop {
from neighbor 10.1.45.2;
then {
next-hop self;
}
}
}
What It Means The sample output shows a basic BGP configuration on border routers R2 and R4.
Both routers have the AS (65002) included at the [routing-options] hierarchy level.
Each router has two groups included at the [protocols bgp group group] hierarchy
level. External peers are included in the external group, either toR1 or toR5,
depending on the router. Internal peers are included in the internal group. The
underlying IGP protocol is IS-IS on both routers, and relevant interfaces are
configured to run IS-IS.
Note that in the configuration on both routers, the router ID is manually configured
to avoid duplicate router ID problems, and the next-hop-self statement is included to
avoid any BGP next-hop reachability problems.
Purpose Assuming that all the routers are correctly configured for BGP, you can verify if IBGP
and EBGP sessions are properly established, external routes are advertised and
received correctly, and the BGP path selection process is working properly.
Multiple Customer
Aggregate Routes:
AS 65001 100.100.1.0/24 AS 65002
100.100.2.0/24
100.100.3.0/24
R1 100.100.4.0/24 R2 R3
lo0: .1 lo0: .2 lo0: .3
so-0/0/0–.12.1 so-0/0/0–.12.2 so-0/0/1–.23.1
so-0/0/1–.23.2
MED 5
so-0/0/3–.24.1 so-0/0/3–.36.1
so-0/0/3–.24.2 so-0/0/3–.36.2
MED 10 so-0/0/1–.46.1
g003251
Key:
so-0/0/X: 10.1.x.x/30
lo0: 10.0.0.x/32 Physical Connection
E-BGP
I-BGP
The network consists of two directly connected ASs consisting of external and
internal peers. The external peers are directly connected through a shared interface
and are running EBGP. The internal peers are connected through their loopback
(lo0) interfaces through IBGP. AS 65001 is running OSPF and AS 65002 is running
IS-IS as its underlying IGP. IBGP routers do not have to be directly connected, the
underlying IGP allows neighbors to reach one another.
The two routers in AS 65001 each contain one EBGP link to AS 65002 (R2 and R4)
over which they announce aggregated prefixes: 100.100.1.0, 100.100.2.0,
100.100.3.0, and 100.100.4.0. Also, R1 and R5 are injecting multiple exit
discriminator (MED) values of 5 and 10, respectively, for some routes.
The internal routers in both ASs are using a full mesh IBGP topology. A full mesh is
required because the networks are not using confederations or route reflectors, so
any routes learned through IBGP are not distributed to other internal neighbors. For
example, when R3 learns a route from R2, R3 does not distribute that route to R6
because the route is learned through IBGP, so R6 must have a direct BGP connection
to R2 to learn the route.
In a full mesh topology, only the border router receiving external BGP information
distributes that information to other routers within its AS. The receiving router does
not redistribute that information to other IBGP routers in its own AS.
From the point of view of AS 65002, the following sessions should be up:
! The four routers in AS 65002 should have IBGP sessions established with each
other.
3. Verify That a Particular BGP Route Is Received on Your Router on page 170
Sample Output 1 The following sample output from R2 shows four peers that are not established:
Sample Output 2 The following sample output shows that all peers are established:
What It Means Sample output 1 shows a peer that is not established, while sample output 2 shows
that all IBGP and EBGP sessions shown in the network diagram in Figure 15 are
established.
Sample output 1 shows one peer (10.0.0.6) is not established, as indicated by the
Down Peers: 1 field. The State|#Active/Received/Damped column also displays
Active, indicating that the peer is in the Active state and not yet established.
If the BGP neighbor session is not established, use the ping and show route
commands to verify network connectivity to the BGP neighbor. Also, use the show
log messages command to look for any errors pertaining to the peer in question.
Sample output 2 shows that all IBGP and EBGP sessions shown in the network
diagram in Figure 15 are established, as indicated by the Down Peers: 0 field and
the last column that shows the number of routes.
Following is a description of the output for all established BGP peers, R2, R3, R4,
and R6.
! 0/0/0 for internal peers 10.0.0.3 and 10.0.0.6, indicating that no BGP routes
are received or active in the routing table from those peers. No BGP routes are
damped.
! 0/2/0 for internal peer 10.0.0.4, indicating that two received BGP routes are
not active in the routing table. No BGP routes are damped.
! 4/4/0 for external peer 10.1.12.1, indicating that four received BGP routes are
active in the routing table. No BGP routes are damped.
! 0/0/0 for internal peer 10.0.0.6, indicating that no BGP routes are received or
active in the routing table from that peer. No BGP routes are damped.
! 0/2/0 for internal peer 10.0.0.4, indicating that two received BGP routes are
not active in the routing table. No BGP routes are damped.
! 4/4/0 for internal peer 10.0.0.2, indicating that four received BGP routes are
active in the routing table. No BGP routes are damped.
! 0/0/0 for internal peers 10.0.0.3 and 10.0.0.6, indicating that no BGP routes
are received or active in the routing table from those peers. No BGP routes are
damped.
! 2/4/0 for internal peer 10.0.0.2 and external peer 10.1.45.1, indicating that
two BGP routes are active in the routing table, but four are received. No BGP
routes are damped.
! 0/0/0 for internal peer 10.0.0.3, indicating that no BGP routes are received or
active in the routing table from that peer. No BGP routes are damped.
! 2/4/0 for internal peers 10.0.0.2,and 10.0.0.4, indicating that of the four
received BGP routes, two are active in the routing table. No BGP routes are
damped.
! Number of configured BGP groups: R2 has two groups configured (internal and
toR1), and R4 also has two BGP groups configured (internal and toR5).
! Number of BGP peers to which the router is linked: R2 and R4 have four (one
EBGP and three IBGP), and R3 and R6 have three IBGP. One peer is down (R6)
in sample output 1.
! The name of the routing table storing the BGP routes, all routers are using
inet.0.
! The total number of BGP paths, for example, R4 has a total of eight BGP paths
from all of its peers.
! The number of active BGP routes, for example, R4 has a total of four active BGP
routes from all of its peers.
Action To verify that a neighbor is advertising a particular route, enter the following JUNOS
CLI operational mode command:
What It Means The sample output shows the BGP routes advertised from R2 to its neighbor,
10.0.0.4 (R4). Out of 22 total routes in the inet.0 routing table, 20 are active
destinations . No routes are hidden or in the hold-down state. Routes reside in the
hold-down state prior to being declared active, and routes rejected by a routing
policy can be placed into the hidden state. The information displayed reflects the
routes that the routing table exported to the BGP routing protocol.
Action To verify that a particular BGP route is received on your router, enter the following
JUNOS CLI operational mode command:
What It Means The sample output shows four BGP routes from R2 and two from R4. Of the four
routes from R2, only two are active in the routing table, as indicated by the asterisk
(*), while both routes received from R4 are active in the routing table. All BGP
routes came through AS 65001.
Purpose You can examine the BGP path selection process to determine the single, active
path when BGP receives multiple routes to the same destination prefix.
Multiple Customer
Aggregate Routes:
AS 65001 100.100.1.0/24 AS 65002
100.100.2.0/24
100.100.3.0/24
R1 100.100.4.0/24 R2 R3
lo0: .1 lo0: .2 lo0: .3
so-0/0/0–.12.1 so-0/0/0–.12.2 so-0/0/1–.23.1
so-0/0/1–.23.2
MED 5
so-0/0/3–.24.1 so-0/0/3–.36.1
so-0/0/3–.24.2 so-0/0/3–.36.2
MED 10 so-0/0/1–.46.1
g003251
Key:
so-0/0/X: 10.1.x.x/30
lo0: 10.0.0.x/32 Physical Connection
E-BGP
I-BGP
The network in Figure 16 shows that R1 and R5 announce the same aggregate
routes to R2 and R4, which results in R2 and R4 receiving two routes to the same
destination prefix. The route selection process on R2 and R4 determines which of
the two BGP routes received is active and advertised to the other internal routers
(R3 and R6).
Before the router installs a BGP route, it must make sure that the BGP next-hop
attribute is reachable. If the BGP next hop cannot be resolved, the route is not
installed. When a BGP route is installed in the routing table, it must go through a
path selection process if multiple routes exist to the same destination prefix. The
BGP path selection process proceeds in the following order:
1. Route preference in the routing table is compared. For example, if an OSPF and
a BGP route exist for a particular destination, the OSPF route is selected as the
active route because the OSPF route has a default preference of 10, while the
BGP route has a default preference of 170.
2. Routes are compared for local preference. The route with the highest local
preference is preferred. For example, see “Examine the Local Preference
Selection” on page 173.
4. The origin code is evaluated. The lowest origin code is preferred ( I (IGP) < E
(EGP) < ? (Incomplete)).
5. The MED value is evaluated. By default, if any of the routes are advertised from
the same neighboring AS, the lowest MED value is preferred. The absence of a
MED value is interpreted as a MED of 0. For an example, see “Examine the
Multiple Exit Discriminator Route Selection” on page 174.
7. If the route is learned from IBGP, the route with the lowest IGP cost is preferred.
For an example, see “Examine the IGP Cost Selection” on page 176. The
physical next hop to the IBGP peer is installed according to the following three
rules:
a. After BGP examines the inet.0 and inet.3 routing tables, the physical next
hop of the route with the lowest preference is used.
b. If the preference values in the inet.0 and the inet.3 routing tables are a tie,
the physical next hop of the route in the inet.3 routing table is used.
c. When a preference tie exists in the same routing table, the physical next
hop of the route with more paths is installed.
8. The route reflection cluster list attribute is evaluated. The shortest length cluster
list is preferred. Routes without a cluster list are considered to have a cluster list
length of 0.
9. The router ID is evaluated. The route from the peer with the lowest router ID is
preferred (usually the loopback address).
10. The peer address value is examined. The peer with the lowest peer IP address is
preferred.
Steps To Take To determine the single, active path when BGP receives multiple routes to the same
destination prefix, enter the following JUNOS CLI operational mode command:
The following steps illustrate the inactive reason displayed when BGP receives
multiple routes to the same destination prefix and one route is selected as the
single, active path:
What It Means The sample output shows that R4 received two instances of the 100.100.1.0 route:
one from 10.0.0.2 (R2) and one from 10.1.45.2 (R5). R4 selected the path from R2
as its active path, as indicated by the asterisk (*). The selection is based on the local
preference value contained in the Localpref field. The path with the highest local
preference is preferred. In the example, the path with the higher local preference
value is the path from R2, 200.
The reason that the route from R5 is not selected is in the Inactive reason field, in
this case, Local Preference.
Note that the two paths are from the same neighboring network: AS 65001.
What It Means The sample output shows that R4 received two instances of the 100.100.2.0 route:
one from 10.0.0.2 (R2), and one from 10.1.45.2 (R5). R4 selected the path from R2
as its active route, as indicated by the asterisk (*). The selection is based on the
MED value contained in the Metric: field. The path with the lowest MED value is
preferred. In the example, the path with the lowest MED value (5) is the path from
R2. Note that the two paths are from the same neighboring network: AS 65001.
The reason that the inactive path is not selected is displayed in the Inactive reason:
field, in this case, Not Best in its group. The wording is used because the JUNOS
software uses the process of deterministic MED selection, by default.
What It Means The sample output shows that R4 received two instances of the 100.100.3.0 route:
one from 10.1.45.2 (R5) and one from 10.0.0.2 (R2). R4 selected the path from R5
as its active path, as indicated by the asterisk (*). The selection is based on a
preference for routes learned from an EBGP peer over routes learned from an IBGP.
R5 is an EBGP peer.
You can determine if a path is received from an EBGP or IBGP peer by examining
the Local As and Peer As fields. For example, the route from R5 shows the local AS is
65002 and the peer AS is 65001, indicating that the route is received from an EBGP
peer. The route from R2 shows that both the local and peer AS is 65002, indicating
that it is received from an IBGP peer.
The reason that the inactive path is not selected is displayed in the Inactive reason
field, in this case, Interior > Exterior > Exterior via Interior. The wording of this reason
shows the order of preferences applied when the same route is received from two
routers. The route received from a strictly internal source (IGP) is preferred first, the
route received from an external source (EBGP) is preferred next, and any route
which comes from an external source and is received internally (IBGP) is preferred
last.
What It Means The sample output shows that R6 received two instances of the 100.100.4.0 route:
one from 10.0.0.4 (R4) and one from 10.0.0.2 (R2). R6 selected the path from R4
as its active route, as indicated by the asterisk (*). The selection is based on the IGP
metric, displayed in the Metric2 field. The route with the lowest IGP metric is
preferred. In the example, the path with the lowest IGP metric value is the path
from R4, with an IGP metric value of 10, while the path from R2 has an IGP metric
of 20. Note that the two paths are from the same neighboring network: AS 65001.
The reason that the inactive path was not selected is displayed in the Inactive reason
field, in this case, IGP metric.
Purpose When you run into problems, such as connectivity problems, you may need to
examine routes in the forwarding table to verify that the routing protocol process
has relayed the correct information into the forwarding table.
Action To display the set of routes installed in the forwarding table, enter the following
JUNOS CLI operational mode command:
What It Means The sample output shows the network-layer prefixes and their next hops installed in
the forwarding table. The output includes the same next-hop information as in the
show route detail command (the next-hop address and interface name). Additional
information includes the destination type, the next-hop type, the number of
references to this next hop, and an index into an internal next-hop database. (The
internal database contains additional information used by the Packet Forwarding
Engine to ensure proper encapsulation of packets sent out an interface. This
database is not accessible to the user.
For detailed information about the meanings of the various flags and types fields,
see the JUNOS Routing Protocols and Policies Command Reference.
This chapter describes how to verify the Routing Engine CPU memory on your
Juniper Networks router. (See Table 35.)
Table 35: Checklist for Verifying the Routing Engine CPU Memory
! 179
JUNOS Baseline Network Operations Guide
Purpose Software processes on the router can consume a considerable amount of CPU and
memory. The routing protocol process (rpd) can consume enormous amounts of
memory to store information needed for the operation of routing and related
protocols, such as Border Gateway Protocol (BGP), Open Shortest Path First (OSPF),
Intermediate System-to-Intermediate System (ISIS), Resource Reservation Protocol
(RSVP), Label Distribution Protocol (LDP), and Multiprotocol Label Switching
(MPLS).
Steps To Take To verify the traffic passing through the router and check memory utilization, follow
these steps:
Action To check overall CPU and memory usage, enter the following JUNOS command-line
interface (CLI) command:
Mem: 57M Active, 54M Inact, 17M Wired, 184K Cache, 35M Buf, 118M Free
Swap: 512M Total, 512M Free
PID USERNAME PRI NICE SIZE RES STATE TIME WCPU CPU COMMAND
4480 root 2 0 3728K 1908K select 231:17 2.34% 2.34% chassisd
4500 root 2 0 1896K 952K select 0:36 0.00% 0.00% fud
4505 root 2 0 1380K 736K select 0:35 0.00% 0.00% irsd
4481 root 2 0 1864K 872K select 0:32 0.00% 0.00% alarmd
4488 root 2 0 8464K 4600K kqread 0:28 0.00% 0.00% rpd
4501 root 2 -15 1560K 968K select 0:21 0.00% 0.00% ppmd
4510 root 2 0 1372K 812K select 0:13 0.00% 0.00% bfdd
5 root 18 0 0K 0K syncer 0:09 0.00% 0.00% syncer
4485 root 2 0 3056K 1776K select 0:07 0.00% 0.00% snmpd
4499 root 2 0 3688K 1676K select 0:05 0.00% 0.00% kmd
4486 root 2 0 3760K 1748K select 0:05 0.00% 0.00% mib2d
4493 root 2 0 1872K 928K select 0:03 0.00% 0.00% pfed
4507 root 2 0 1984K 1052K select 0:02 0.00% 0.00% fsad
4518 root 2 0 3780K 2400K select 0:02 0.00% 0.00% dcd
8 root -18 0 0K 0K psleep 0:02 0.00% 0.00% vmuncachedaemo
What It Means The sample output shows the amount of virtual memory used by the Routing
Engine and software processes. For example, 118 MB of physical memory is free
and 512 MB of the swap file is free, indicating that the router is not short of
memory. The processes field shows that most of the 58 processes are in the
sleeping state, with 1 in the running state. The process or command that is running
is the top command.
The commands column lists the processes that are currently running. For example,
the chassis process (chassisd) has a process identifier (PID) of 4480, with a current
priority (PRI) of 2. A lower priority number indicates a higher priority.
The processes are listed according to level of activity, with the most active process
at the top of the output. For example, the chassis (chassisd) process is consuming
the largest amount of CPU resource at 2.34 percent.
The memory field (Mem) shows the virtual memory managed by the Routing
Engine and used by processes. The value in the memory field is in KB and MB, and
is broken down as follows:
! Inact—Memory that is either allocated but not recently used or memory that
was freed by programs. Inactive memory is still mapped in the address space of
one or more processes and, therefore, counts toward the resident set size of
those processes.
! Cache—Memory that is not associated with any program and does not need to
be swapped before being reused.
! Buf—The size of the memory buffer used to hold data recently called from disk.
When the system is under memory pressure, the pageout process reuses memory
from the free, cache, inactive and, if necessary, active pages.
The Swap field shows the total swap space available and how much is unused. In
the example, the output shows 512 MB of total swap space and 512 MB of free swap
space.
Finally, the memory usage of each process is listed. The SIZE field indicates the size
of the virtual address space, and the RES field indicates the amount of the program
in physical memory, which is also known as RSS or Resident Set Size. In the sample
output, the chassis (chassisd) process has 3728 KB of virtual address space and
1908 KB of physical memory.
For additional information about the show system processes extensive command,
see “Stop and Start JUNOS Software” on page 37.
Action To check routing process memory usage, enter the following JUNOS CLI operational
mode commands:
inet.0: 179783 destinations, 898393 routes (179771 active, 146 holddown, 157
hidden)
Direct: 17 routes, 17 active
Local: 18 routes, 18 active
BGP: 896632 routes, 178010 active
Static: 32 routes, 31 active
IS-IS: 1694 routes, 1694 active
inet.2: 8766 destinations, 22700 routes (8766 active, 124 holddown, 73 hidden)
Direct: 17 routes, 17 active
Local: 18 routes, 18 active
BGP: 20939 routes, 7006 active
Static: 32 routes, 31 active
IS-IS: 1694 routes, 1694 active
What It Means The sample output shows summary statistics about the entries in the routing table
(show route summary command) and the memory usage breakdown (show task
memory detail command) for the routing process (rpd). The two commands provide
a comprehensive picture of the memory utilization of the routing protocol process.
The show route summary command shows the number of routes in the various
routing tables. In the sample output, the routing tables represented are inet.0,
inet.2, inet.3, iso.0, and mpls.0. Within each routing table, all of the active,
hold-down, and hidden destinations and routes are summarized for all the protocols
from which routes are learned. Routes are in the hold-down state prior to being
declared inactive, and hidden routes are not used because of routing policy. Routes
in the hold-down and hidden states are still using memory because they appear in
the routing table.
The show task memory detail command lists the data structures within the tasks run
by the routing protocol process (rpd). Tasks are enabled depending on the router’s
configuration. For example, isis_area_addr is a data structure resulting from the
IS-IS configuration. The AllocBytes field indicates the highest amount of memory
used by the data structure. For example, the isis_area_addr data structure has 544
blocks of allocated memory, each block is allocated a value of 16 bytes, resulting in
allocated bytes of 8704. The maximum allocated blocks and bytes are high-water
marks for a data structure. For more information on displaying task-related
information, see “Display Tasks” on page 185.
The Total bytes in use field shows the total amount of memory used by the routing
protocol process (rpd).
Action To display a list of tasks that are enabled on the router, enter the following JUNOS
CLI operational mode commands:
20 Aggregate
20 RT
30 ICMP 1
30 Router-Advertisement
30 ICMPv6 58 9 <>
39 OSPFv2 I/O./var/run/ppmd_control 12 <>
40 l2vpn global task
40 BGP RT Background <LowPrio>
40 BGP.::+179 179 23 <Accept LowPrio>
40 BGP.0.0.0.0+179 179 22 <Accept LowPrio>
40 BFD I/O./var/run/bfdd_control 11 <>
40 OSPF 89
50 BGP_65001.10.0.0.5+3531 3531 18 <LowPrio>
50 BGP_65002.10.1.12.2+1224 1224 25 <LowPrio>
50 BGP_Group_internal <LowPrio>
50 BGP_Group_toR2 <LowPrio>
50 TED
50 ASPaths
51 Resolve inet.0 <LowPrio>
60 KStat 13 <>
60 KRT Request 7 <>
60 KRT Ifstate 255 6 <>
60 KRT 255 5 <>
60 Redirect
70 MGMT.local 24 <>
70 MGMT_Listen./var/run/rpd_mgmt 14 <Accept>
70 SNMP Subagent./var/run/snmpd_stream 10 <>
80 IF Delete
BGP_Group_toR2 0 0 0 0 0
TED 0 0 0 0 0
ASPaths 0 0 0 0 0
Resolve inet.0 0 0 0 0 0
KStat 0 0 0 0 0
KRT Request 0 0 57 0 0
KRT Ifstate 18 0 16 0 0
KRT 0 0 2 0 0
Redirect 0 0 0 0 0
MGMT.local 0 0 0 0 0
MGMT_Listen./var/run/rpd_mgmt 23 0 0 0 0
SNMP Subagent./var/run/snmpd_s 23 0 0 0 0
IF Delete 0 0 0 0 0
What It Means The sample output shows a list of routing, routing protocol, and interface tasks that
are currently running on the router (show task), a summary of memory utilization
(show task memory), and the memory utilization of a particular task (show task io).
Tasks can be baseline tasks performed regardless of the router configuration, and
other tasks that depend on the router configuration. For example, the
BGP_Group_internal task is the result of the configuration of BGP on the router, while
the INET6 task is a base task associated with the routing process (rpd).
Each task in the show task command output has a priority and a task name. For
example, the current priority is 10 for LMP Client and 80 for IF Delete. A lower
number indicates a higher priority.
Some tasks have flags attached to them. For example, the BGP.0.0.0.0+179 task has
two flags, Accept and LowPrio. The Accept flag indicates that the task is waiting for
incoming connections, and the LowPrio flag indicates that the task will be
dispatched to read its socket after other, higher priority tasks. Two additional flags
are Connect, which indicates that a task is waiting for a connection to complete, and
Delete, which indicates that a task has been deleted and is being cleaned up.
The show task io command shows the statistics gathered for each IO operation. The
counters show the following:
! Rcvd—This counter increments when the task calls the Routing Engine to read a
datagram from a socket which may or may not be connected.
This chapter describes how to verify traffic and packets entering and passing
through your Juniper Networks router. (See Table 36.)
Table 36: Checklist for Verifying Traffic and Packets through the Router
3. Show Packet Count When a Firewall Filter Is Configured with the show firewall filter filter-name
Count Option on page 195
4. Display Traffic from the Point of View of the Packet Forwarding show pfe statistics traffic
Engine on page 196
! 189
JUNOS Baseline Network Operations Guide
Purpose To continue your diagnosis of a problem, display real-time statistics about the traffic
passing through physical interfaces on the router.
Steps To Take To display real-time statistics about physical interfaces, follow these steps:
1. Display Real-Time Statistics about All Interfaces on the Router on page 190
What It Means The sample output displays traffic data for active interfaces and the amount that
each field has changed since the command started or since the counters were
cleared by using the C key. In this example, the monitor interface command has
been running for 15 seconds since the command was issued or since the counters
last returned to zero.
What It Means The sample output shows the input and output packets for a particular SONET
interface (so-0/0/1). The information can include common interface failures, such
as SONET/SDH and T3 alarms, loopbacks detected, and increases in framing errors.
For more information, see “Track Error Conditions” on page 273.
To control the output of the command while it is running, use the keys shown in
Table 37.
Action Key
Display information about the next interface. The monitor interface command N
scrolls through the physical or logical interfaces in the same order that they
are displayed by the show interfaces terse command.
Display information about a different interface. The command prompts you I
for the name of a specific interface.
Freeze the display, halting the display of updated statistics. F
See the JUNOS System Basics and Services Command Reference for details on using
match conditions with the monitor traffic command.
Verify Packets
Purpose You can check the flow of packets to and from the router to further your
investigation of issues on the router.
1. Monitor Packets Sent from and Received by the Routing Engine on page 193
3. Show Packet Count When a Firewall Filter Is Configured with the Count Option
on page 195
4. Display Traffic from the Point of View of the Packet Forwarding Engine on
page 196
Step 1: Monitor Packets Sent from and Received by the Routing Engine
Action To print packet headers transmitted through network interfaces sent from or
received by the Routing Engine, enter the following JUNOS CLI operational mode
command:
What It Means The sample output shows the actual packets entering and leaving the Routing
Engine, not the transit packets passing through the router. You can use this
information to diagnose issues such as Point-to-Point Protocol negotiation, Border
Gateway Protocol negotiation, and Open Shortest Path First hellos.
The monitor traffic command is similar to the UNIX tcpdump command. For more
information about the monitor traffic command, see the JUNOS System Basics and
Services Command Reference.
CAUTION: Use the monitor traffic command to diagnose problems on your router.
Do not to leave this command on because it consumes Routing Engine resources.
What It Means The sample output shows key IP header information about firewall filters on the
router. The source and destination addresses of packets provide important
information when you investigate problems on the router.
The Filter field contains information about how a packet traveled through the router
before it was handled by either the Routing Engine or the Packet Forwarding
Engine.
! If the filter name appears in the Filter field, the Routing Engine handled the
packet. For example, sample-test is a firewall filter configured at the [edit
firewall] hierarchy level.
! If the word pfe appears in the Filter field, the Packet Forwarding Engine handled
the packet. The Packet Forwarding Engine receives information about the name
of the firewall filter.
All packets were accepted (A). Other actions are discard (D) and reject (R).
The Interface column shows that all packets came through so-1/1/0.0, and icm or
osp are the represented protocols. Other possible protocol names are: egp, gre, ipip,
pim, resp, tcp, or udp.
Step 3: Show Packet Count When a Firewall Filter Is Configured with the Count Option
Action To show the packet count when a firewall filter is configured with the count option,
enter the following JUNOS CLI operational mode command:
Sample Output 1 The following sample output shows the icmp filter incrementing:
Sample Output 2 The following sample output shows a configuration of the count option:
[edit]
user@R1# show firewall filter icmp
term a {
from {
protocol icmp;
}
then count count-icmp;
}
term b {
then accept;
}
What It Means The sample output shows that the packet matched a criteria in the icmp filter and
the filter had a count action applied to it.
Step 4: Display Traffic from the Point of View of the Packet Forwarding Engine
Action To display traffic from the point of view of the Packet Forwarding Engine, enter the
following JUNOS CLI operational mode command:
Sample Output 1 The following sample output was taken before packets were sent:
Sample Output 2 The following sample output was taken after 100 packets were sent to router R2:
What It Means The sample output shows the number and rate of packets entering and leaving the
Packet Forwarding Engine. For example, the 100 packets sent to R2 were discarded
due to a route that had a discard next hop configured, as shown in the PFE Hardware
Discard statistics field. All counters increased as a result of the 100 packets.
This chapter describes how to use the ping command to check the availability of
various routers in a network topology, and how to use the traceroute command to
check the path that packets travel between routers. (See Table 38.)
Table 38: Checklist for Using the ping and traceroute Commands
! 199
JUNOS Baseline Network Operations Guide
Purpose This section provides examples of how to use the ping command to check the
reachability of various routers in a network topology, and how to use the traceroute
command to check the path that packets travel between routers. The topology
shown in Figure 17 illustrates these commands.
AS 65001 AS 65002
Aggregate Routes:
100.100.1.0/24
100.100.2.0/24
R1 100.100.3.0/24 R2 R3
lo0: .1 100.100.4.0/24 lo0: .2 lo0: .3
so-0/0/0–.12.2 so-0/0/1–.23.1
so-0/0/0–.12.1 so-0/0/1–.23.2
g003255
R5 R6
lo0: .5 lo0: .6
Key: I-BGP
so-0/0/X: 10.1.x.x/30
E-BGP
lo0: 10.0.0.x/32
Steps To Take To check the reachability of routers and the path to the routers, follow these steps:
Action To ping and traceroute between R5 and R6, enter the following JUNOS
command-line interface (CLI) operational mode commands:
Sample Output The following sample output is from R6 to R5, as shown in the network topology in
Figure 17:
What It Means The sample output shows a successful ping and traceroute between the R6 and R5
loopback (lo0) addresses. The ping is successful because the loopback addresses of
both routers are advertised to their directly connected neighbors.
The output for the traceroute command shows the path from R6 to R5, which is
through R2.
NOTE: A ping command might lose packets due to rate limiting of Internet
Message Control Protocol (ICMP) packets on the specified host.
Action To ping and traceroute between R5 and R6, enter the following JUNOS CLI
operational mode commands:
What It Means The sample output shows a successful ping and traceroute between the interfaces
on R6 and R5. The ping is successful because the interface addresses of both
routers are advertised to their directly connected neighbors.
The output for the traceroute command shows the path from R6 to R5, which is
through R2.
NOTE: A ping command might loose packets due to rate limiting of ICMP packets
on the specified host.
Purpose When the ping or traceroute commands are unsuccessful, it is useful to understand
the output.
Action To ping and traceroute between R5 and R6, enter the following JUNOS CLI
operational mode commands:
^C
--- 10.1.15.2 ping statistics ---
3 packets transmitted, 0 packets received, 100% packet loss
What It Means Sample output 1 shows three instances of the ping command not succeeding. In the
first instance, the packets exceed the time-to-live value, which is decremented to 1,
indicating that packets are being rejected possibly because of a loop. In the second
instance, the local router does not know the route to the host. In the third instance,
there is no route to the IP address, which might be due to packets being lost on a
remote router.
Sample output 2 shows two instances of the traceroute command not succeeding.
In the first instance, there is a loop between shared interfaces on R6 and R2, as
indicated by the 10.1.26.1 and 10.1.26.2 appearing repeatedly. In the second
instance, the path goes through R3 (10.1.36.1) to R2 (10.1.23.1) when it times out,
as indicated by the asterisk (*). The timeout might be due to the absence of a route
to the remote interface.
3. Display the Output for SNMP Trace Operations on page 211 show log snmp
Monitor Memory Usage on a Router on page 212
1. Check Memory Utilization on Chassis Components on page 212 snmpwalk [common arguments] hostname community
object-id
show chassis routing-engine
2. Check Memory Utilization per Process on page 215 snmpwalk [common arguments] hostname community
object-id
Monitor CPU Utilization on page 218
1. Check CPU Utilization on page 218 snmpwalk [common arguments] hostname community
object-id
2. Check CPU Utilization per Process on page 220 snmpwalk [common arguments] hostname community
object-id
Retrieve Version Information about Router Software Components snmpwalk [common arguments] hostname community
on page 223 object-id
! 205
JUNOS Baseline Network Operations Guide
Purpose When you update the router software, you might also want to update the
corresponding MIBs. Links to the MIBs related to a release are located in the JUNOS
Internet Software Network Management Configuration Guide. This guide lists the
Juniper-specific enterprise MIBs, and provides a link to Simple Network
Management Protocol (SNMP) standards that list the standard MIBs supported by
the JUNOS software.
In addition, a tar file that contains all the Juniper Networks enterprise-specific MIBs
is included in the JUNOS software package for each release.
1. Enter the following URL into the address line of your browser:
http://www.juniper.net/techpubs/software/index.html
Purpose Snmpwalk is an SNMP application that you can use to query a MIB for
information about the functioning of a router in your network. Snmpwalk uses
GetNext requests to retrieve the specified information. Object identifiers (OIDs) are
used to query the MIB. If the OID argument is not present, Snmpwalk searches
MIB-2.
Action To run Snmpwalk for a specific OID, from a management station that has access to
the router, and using a tool such as Snmpwalk, enter the following command:
Sample Output user-nms % snmpwalk -Os -M /volume/~/mibs -m all tp1 public .1.3.6.1.2.1.4
ipForwarding.0 = forwarding(1)
ipDefaultTTL.0 = 64
ipInReceives.0 = Counter32: 9262713
ipInHdrErrors.0 = Counter32: 0
ipInAddrErrors.0 = Counter32: 0
ipForwDatagrams.0 = Counter32: 614171
ipInUnknownProtos.0 = Counter32: 0
ipInDiscards.0 = Counter32: 0
ipInDelivers.0 = Counter32: 8648408
ipOutRequests.0 = Counter32: 1226483
ipOutDiscards.0 = Counter32: 0
ipOutNoRoutes.0 = Counter32: 0
ipReasmTimeout.0 = 60
ipReasmReqds.0 = Counter32: 0
ipReasmOKs.0 = Counter32: 0
ipReasmFails.0 = Counter32: 0
ipFragOKs.0 = Counter32: 0
ipFragFails.0 = Counter32: 0
ipFragCreates.0 = Counter32: 0
ipAdEntAddr.10.0.0.1 = IpAddress: 10.0.0.1
ipAdEntAddr.10.1.12.1 = IpAddress: 10.1.12.1
ipAdEntAddr.10.1.15.1 = IpAddress: 10.1.15.1
ipAdEntAddr.10.168.70.143 = IpAddress: 10.168.70.143
[...Output truncated...]
What It Means The sample output shows that the user is on a network management station
(user-nms %) that has access to the router, tp1. In the command, the following
options are used:
! Os—Deletes all but the last symbolic part of the OID sysUpTime.0. For example,
Timeticks: (14096763) 1 day, 15:09:27.63.
In addition, the command includes the hostname tp1, the community string public,
and the OID .1.3.6.1.2.1.4.
The OID in this example is from RFC 2096, IP Forwarding Table MIB, which displays
multipath IP routes that have the same network number but different network
masks.
Before you can retrieve SNMP information from a router, you must have the
minimum SNMP configuration for that router. Following is the minimum SNMP
configuration required:
[edit]
snmp {
community public {
authorization read-only;
}
}
With this configuration, the system responds to SNMP Get, GetNext, and GetBulk
commands that contain the community string public.
For more detailed information on configuring SNMP on a router, see the JUNOS
Network Management Configuration Guide.
Purpose Tracing operations record more detailed messages about the operation of SNMP,
such as the various types of routing protocol packets sent and received, and routing
policy actions. In this section, traceoptions are configured on a router, a MIB object
is queried through a network management station, and the action of the query is
verified with a log file on the router.
Steps To Take To use SNMP traceoptions to monitor a router, follow these steps:
[edit]
user@R1# edit snmp
[edit snmp]
user@R1# set traceoptions flag pdu
community private {
view system;
authorization read-write;
}
traceoptions {
flag pdu;
}
What It Means The sample output shows a configuration for SNMP that includes traceoptions. The
pdu flag is configured, which results in the generation of SNMP request and
response packets. The output for the tracing operation is placed into various log files
in the /var/log directory.
What It Means The sample output shows a query from a network management station (nms) for
the description of the system running on the router tp1. The OID is entered in
numerical form in the command line, and a description (sysDescr.0) is obtained in
the output. You can also use sysDescr.0 in the command line to obtain the same
output.
Action To display the output for trace operations, enter the following JUNOS command-line
interface operational mode command:
What It Means The sample output shows the contents of the snmpd log file, with all of the packets
sent and received through SNMP. The Get-Request packet is sent from a network
management station and the Get-Response packet is sent from tp1. The value in the
Get-response packet is the same as that returned to the network management
station in Step 2, m7i internet router, kernel 6.0R1.5.
Purpose From a management station that has access to the router, you can monitor memory
usage of components, applications, and associated elements that have run or are
currently running on a router.
Steps To Take From a management station that has access to the router and using a tool, such as
Snmpwalk, follow these steps:
After each object description is a value in parenthesis, such as (1). This value can be
used to enter an OID for the specific object. For example, to gather information on
memory utilization, you can type the object description (jnxOperatingBuffer) or the
OID (.1.3.6.1.4.1.2636.3.1.13.1.11).
Action To check memory utilization using the Juniper enterprise chassis MIB, from a
management station that has access to the router, and using a tool such as
Snmpwalk, enter the following commands:
Sample Output user-nms % snmpwalk -Os -M /volume/~/mibs -m all tp1 public jnxOperatingBuffer
jnxOperatingBuffer.1.1.1.0 = Gauge32: 0
jnxOperatingBuffer.1.1.2.0 = Gauge32: 0
jnxOperatingBuffer.1.1.3.0 = Gauge32: 0
jnxOperatingBuffer.2.1.0.0 = Gauge32: 0
jnxOperatingBuffer.4.1.1.0 = Gauge32: 0
jnxOperatingBuffer.4.1.2.0 = Gauge32: 0
jnxOperatingBuffer.4.1.3.0 = Gauge32: 0
jnxOperatingBuffer.4.1.4.0 = Gauge32: 0
jnxOperatingBuffer.6.1.1.0 = Gauge32: 6
jnxOperatingBuffer.6.1.2.0 = Gauge32: 6
jnxOperatingBuffer.7.1.0.0 = Gauge32: 8
jnxOperatingBuffer.7.2.0.0 = Gauge32: 8
jnxOperatingBuffer.8.1.1.0 = Gauge32: 0
jnxOperatingBuffer.8.2.3.0 = Gauge32: 0
jnxOperatingBuffer.8.2.4.0 = Gauge32: 0
jnxOperatingBuffer.9.1.0.0 = Gauge32: 28
jnxOperatingBuffer.9.1.1.0 = Gauge32: 0
What It Means The sample output shows the percentage of utilization for the FPC and Routing
Engine. The first object, jnxOperatingBuffer, shows that the Routing Engine (9.1.0.0)
has 28 percent memory utilization, the two CFEB processors are using 6 percent,
and the FPCs have 8 percent memory utilization.
The output for the show chassis routing-engine command shows similar information
to that displayed in the output of the jnxOperatingBuffer object, with 28 percent
memory utilization for the Routing Engine.
Action To check memory utilization per process, from a management station that has
access to the router, and using a tool such as Snmpwalk, enter the following
command:
Sample Output use-nms % snmpwalk -Os -M /volume/~/mibs -m all tp1 public sysApplElmtRunMemory
sysApplElmtRunMemory.0.0.0 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.2 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.3 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.4 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.5 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.6 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.7 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.8 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.9 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.10 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.11 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.12 = Gauge32: 0 Kbytes
sysApplElmtRunMemory.0.0.116 = Gauge32: 526164 Kbytes
sysApplElmtRunMemory.0.0.2023 = Gauge32: 416 Kbytes
sysApplElmtRunMemory.0.0.2131 = Gauge32: 1100 Kbytes
sysApplElmtRunMemory.0.0.2160 = Gauge32: 984 Kbytes
sysApplElmtRunMemory.0.0.2161 = Gauge32: 1100 Kbytes
sysApplElmtRunName.3.4.2194 = /sbin/dcd
sysApplElmtRunName.3.7.2168 = /usr/sbin/snmpd
sysApplElmtRunName.3.9.2169 = /usr/sbin/mib2d
sysApplElmtRunName.3.12.2172 = /usr/sbin/apsd
sysApplElmtRunName.3.13.2173 = /usr/sbin/vrrpd
sysApplElmtRunName.3.14.2164 = /usr/sbin/alarmd
sysApplElmtRunName.3.15.2175 = /usr/sbin/pfed
sysApplElmtRunName.3.16.2165 = /usr/sbin/craftd
sysApplElmtRunName.3.17.2176 = /usr/sbin/sampled
sysApplElmtRunName.3.19.2177 = /usr/sbin/ilmid
sysApplElmtRunName.3.20.2178 = /usr/sbin/rmopd
sysApplElmtRunName.3.21.2179 = /usr/sbin/cosd
sysApplElmtRunName.3.23.2188 = /usr/sbin/fsad
sysApplElmtRunName.3.25.2186 = /usr/sbin/irsd
sysApplElmtRunName.3.26.2180 = /usr/sbin/nasd
sysApplElmtRunName.3.27.2181 = /usr/sbin/fud
sysApplElmtRunName.3.30.2187 = /usr/sbin/rtspd
sysApplElmtRunName.3.31.2184 = /usr/sbin/smartd
sysApplElmtRunName.3.34.2171 = /usr/sbin/inetd
sysApplElmtRunName.3.35.2047 = syslogd
sysApplElmtRunName.3.36.2189 = /usr/sbin/spd
sysApplElmtRunName.3.37.2191 = /usr/sbin/eccd
sysApplElmtRunName.5.5.7495 = /usr/sbin/rpd
sysApplElmtRunName.5.6.2167 = /usr/sbin/mgd
sysApplElmtRunName.5.6.26829 = mgd: (mgd) (user)/dev/ttyp0
sysApplElmtRunName.5.8.26828 = -cli
sysApplElmtRunName.5.28.2182 = /usr/sbin/ppmd
sysApplElmtRunName.5.29.2183 = /usr/sbin/lmpd
What It Means The sample output shows the total amount of real system memory, measured in
kilobytes, currently allocated to the processes retrieved by the
sysApplElmtRunMemory object.
Purpose You can monitor CPU utilization using the Juniper specific enterprise chassis MIB
and the standard system application MIB (RFC 2287, Definitions of System-Level
Managed Objects for Applications).
Steps To Take From a management station that has access to the router, and using a tool such as
Snmpwalk, follow these steps:
After each object description is a value in parenthesis, such as (1). This value can be
used to enter an OID for the specific object. For example, to gather information on
the CPU, you can type the object description (jnxOperatingCPU) or the OID
(.1.3.6.1.4.1.2636.3.1.13.1.8).
Action To check CPU utilization using the Juniper enterprise chassis MIB, from a
management station that has access to the router, and using a tool such as
Snmpwalk, enter the following command:
Sample Output user-nms % snmpwalk -Os -M /volume/~/mibs -m all tp1 public jnxOperatingCPU
jnxOperatingCPU.1.1.1.0 = Gauge32: 0
jnxOperatingCPU.1.1.2.0 = Gauge32: 0
jnxOperatingCPU.1.1.3.0 = Gauge32: 0
jnxOperatingCPU.2.1.0.0 = Gauge32: 0
jnxOperatingCPU.4.1.1.0 = Gauge32: 0
jnxOperatingCPU.4.1.2.0 = Gauge32: 0
jnxOperatingCPU.4.1.3.0 = Gauge32: 0
jnxOperatingCPU.4.1.4.0 = Gauge32: 0
jnxOperatingCPU.6.1.1.0 = Gauge32: 224
jnxOperatingCPU.6.1.2.0 = Gauge32: 224
jnxOperatingCPU.7.1.0.0 = Gauge32: 2
jnxOperatingCPU.7.2.0.0 = Gauge32: 2
jnxOperatingCPU.8.1.1.0 = Gauge32: 0
jnxOperatingCPU.8.2.3.0 = Gauge32: 0
jnxOperatingCPU.8.2.4.0 = Gauge32: 0
jnxOperatingCPU.9.1.0.0 = Gauge32: 6
jnxOperatingCPU.9.1.1.0 = Gauge32: 0
What It Means The sample output shows the percentage CPU utilization on router, tp1. The Routing
Engine (9.1.0.0) has 6 percent CPU utilization, the two CFEB Internet Processors
IIv1 (6.1.1.0 and 6.1.2.0) have 22 percent each, and the FPCs (7.1.0.0 and 7.2.0.0)
have 2 percent each. Components with a value of zero indicate that the
information is either unavailable or inapplicable.
The output for the jnxOperatingDesc object provides a description of the separate
instances in the jnxOperatingCPU object. For example, 9.1.0.0 represents the
Routing Engine.
Action To check CPU utilization per process, from a management station that has access to
the router, and using a tool such as Snmpwalk, enter the following command:
Sample Output use-nms % snmpwalk -Os -M /volume/~/mibs -m all tp1 public sysApplElmtRunCPU
sysApplElmtRunCPU.0.0.0 = Timeticks: (278) 0:00:02.78
sysApplElmtRunCPU.0.0.2 = Timeticks: (487) 0:00:04.87
sysApplElmtRunCPU.0.0.3 = Timeticks: (0) 0:00:00.00
sysApplElmtRunCPU.0.0.4 = Timeticks: (1742) 0:00:17.42
sysApplElmtRunCPU.0.0.5 = Timeticks: (13899) 0:02:18.99
sysApplElmtRunCPU.0.0.6 = Timeticks: (79) 0:00:00.79
sysApplElmtRunCPU.0.0.7 = Timeticks: (0) 0:00:00.00
sysApplElmtRunCPU.0.0.8 = Timeticks: (0) 0:00:00.00
sysApplElmtRunCPU.0.0.9 = Timeticks: (0) 0:00:00.00
sysApplElmtRunCPU.0.0.10 = Timeticks: (2229) 0:00:22.29
sysApplElmtRunCPU.0.0.11 = Timeticks: (0) 0:00:00.00
sysApplElmtRunCPU.0.0.12 = Timeticks: (0) 0:00:00.00
sysApplElmtRunCPU.0.0.116 = Timeticks: (25) 0:00:00.25
sysApplElmtRunCPU.0.0.2023 = Timeticks: (0) 0:00:00.00
sysApplElmtRunCPU.0.0.2131 = Timeticks: (1103) 0:00:11.03
sysApplElmtRunCPU.0.0.2160 = Timeticks: (1599) 0:00:15.99
sysApplElmtRunCPU.0.0.2161 = Timeticks: (4) 0:00:00.04
sysApplElmtRunCPU.0.0.2174 = Timeticks: (1168) 0:00:11.68
sysApplElmtRunName.3.7.2168 = /usr/sbin/snmpd
sysApplElmtRunName.3.9.2169 = /usr/sbin/mib2d
sysApplElmtRunName.3.12.2172 = /usr/sbin/apsd
sysApplElmtRunName.3.13.2173 = /usr/sbin/vrrpd
sysApplElmtRunName.3.14.2164 = /usr/sbin/alarmd
sysApplElmtRunName.3.15.2175 = /usr/sbin/pfed
sysApplElmtRunName.3.16.2165 = /usr/sbin/craftd
sysApplElmtRunName.3.17.2176 = /usr/sbin/sampled
sysApplElmtRunName.3.19.2177 = /usr/sbin/ilmid
sysApplElmtRunName.3.20.2178 = /usr/sbin/rmopd
sysApplElmtRunName.3.21.2179 = /usr/sbin/cosd
sysApplElmtRunName.3.23.2188 = /usr/sbin/fsad
sysApplElmtRunName.3.25.2186 = /usr/sbin/irsd
sysApplElmtRunName.3.26.2180 = /usr/sbin/nasd
sysApplElmtRunName.3.27.2181 = /usr/sbin/fud
sysApplElmtRunName.3.30.2187 = /usr/sbin/rtspd
sysApplElmtRunName.3.31.2184 = /usr/sbin/smartd
sysApplElmtRunName.3.34.2171 = /usr/sbin/inetd
sysApplElmtRunName.3.35.2047 = syslogd
sysApplElmtRunName.3.36.2189 = /usr/sbin/spd
sysApplElmtRunName.3.37.2191 = /usr/sbin/eccd
sysApplElmtRunName.5.5.7495 = /usr/sbin/rpd
sysApplElmtRunName.5.6.2167 = /usr/sbin/mgd
sysApplElmtRunName.5.6.26829 = mgd: (mgd) (user)/dev/ttyp0
sysApplElmtRunName.5.8.26828 = -cli
sysApplElmtRunName.5.28.2182 = /usr/sbin/ppmd
sysApplElmtRunName.5.29.2183 = /usr/sbin/lmpd
What It Means The sample output shows the number of centi-seconds of total system CPU
resources consumed by a particular process. For example, the chassis process
(chassisd, 3.2.2163) has consumed 3 days, or 33,548,776 centi-seconds of total
system CPU resources.
The sysApplElmtRunName object retrieves the name of the OID. For example,
sysApplElmtRunCPU.3.2.2163 represents the chassis process.
Purpose RFC 2790, Host Resources MIB, describes a set of managed objects that are useful
for managing host systems, including routers.
Action To retrieve version information about software components on the router, from a
management station that has access to the router and using a tool, such as
Snmpwalk, enter the following command:
Sample Output user-nms % snmpwalk -Os -M /volume/~/mibs -m all tp1 public .1.3.6.1.2.1.25.6.3
hrSWInstalledIndex.2 = 2
hrSWInstalledIndex.3 = 3
hrSWInstalledIndex.4 = 4
hrSWInstalledIndex.5 = 5
hrSWInstalledIndex.6 = 6
hrSWInstalledIndex.9 = 9
hrSWInstalledName.2 = "JUNOS Base OS Software Suite [6.0R1.5]"
hrSWInstalledName.3 = "JUNOS Kernel Software Suite [6.0R1.5]"
hrSWInstalledName.4 = "JUNOS Packet Forwarding Engine Support (M7i/M10i)
[6.0R1.5]"
hrSWInstalledName.5 = "JUNOS Routing Software Suite [6.0R1.5]"
hrSWInstalledName.6 = "JUNOS Online Documentation [6.0R1.5]"
hrSWInstalledName.9 = "JUNOS Support Tools Package [6.0-20031122-unocM2]"
hrSWInstalledID.2 = OID: zeroDotZero
hrSWInstalledID.3 = OID: zeroDotZero
hrSWInstalledID.4 = OID: zeroDotZero
hrSWInstalledID.5 = OID: zeroDotZero
hrSWInstalledID.6 = OID: zeroDotZero
hrSWInstalledID.9 = OID: zeroDotZero
hrSWInstalledType.2 = operatingSystem(2)
hrSWInstalledType.3 = operatingSystem(2)
hrSWInstalledType.4 = operatingSystem(2)
hrSWInstalledType.5 = operatingSystem(2)
hrSWInstalledType.6 = application(4)
hrSWInstalledType.9 = operatingSystem(2)
hrSWInstalledDate.2 = 2003-8-10,20:34:45.0,-7:0
hrSWInstalledDate.3 = 2003-8-10,20:35:21.0,-7:0
hrSWInstalledDate.4 = 2003-8-10,20:36:30.0,-7:0
hrSWInstalledDate.5 = 2003-8-10,20:36:47.0,-7:0
hrSWInstalledDate.6 = 2003-8-10,20:36:51.0,-7:0
hrSWInstalledDate.9 = 2003-11-22,4:8:47.0,-8:0al
What It Means The sample output shows the version information for various software components
on the router.
This chapter describes how to obtain basic system information, including a list of all
Flexible PIC Concentrators (FPCs) and Physical Interface Cards (PICs) installed in
the router chassis, the hardware version level, and the serial number. (See Table 40.)
! 227
JUNOS Baseline Network Operations Guide
Purpose Before you return a router component to Juniper Networks, you must contact the
Juniper Networks Technical Assistance Center (JTAC) with the serial number of the
failed component and failure information. JTAC will then grant a Return Materials
Authorization (RMA).
Action To display a list of the serial numbers of components installed in the router chassis,
use the following JUNOS command-line interface (CLI) operational mode command:
What It Means The sample output is for an M20 and an M40 router. It shows a list of all FPCs and
PICs installed in the router chassis, including the hardware version level and serial
number.
The detail option displays detailed information about hardware, including memory,
hardware version level, serial number, and additional information about memory.
If the Routing Engine is identified by a 10- and 16-digit serial number, both
numbers are displayed in the output for the detail option, and are especially
important when processing an RMA for such a Routing Engine. In addition, when
you request an RMA for the M40 router, include the maxicab serial number.
Table 41 provides a description of all the output fields for the show chassis hardware
command.
Table 41: Output fields for the show chassis hardware command
(For T-series platforms) Chassis component. Information is displayed about the backplane,
power supplies, midplane, Control Board (CB), Connector Interface Panel (CIP), FPC, Front
Panel Module (FPM) (craft interface), Power Entry Module (PEM), PIC, SONET Clock
Generator (SCG), Small Form-factor Pluggable (SFP) modules, Switch Interface Board (SIB),
and Switch Processor Mezzanine Board (SPMB).
Version Revision level of the chassis component.
Part number Part number of the chassis component.
Serial number Serial number of the chassis component. For all RMAs, the chassis serial number must be
provided to JTAC. If the RMA is for the chassis itself, you must obtain the backplane or
midplane serial number as well.
Description Brief description of the hardware item.
NOTE: When you request an RMA, you must also include output from the show
chassis environment command, the show version command, and the
troubleshooting output used to identify the failure.
This chapter describes how to display and locate files and directories on a router.
(See Table 42.)
Table 42: Checklist for Displaying and Locating Files and Directories on a Router
2. Copy Files between the Local Router and a Remote System on file copy filename ftp://hostname/path/filename
page 232 file copy filename ftp://user:password@hostname/filename
file copy filename ftp://user@hostname/filename
file copy filename scp://user@hostname/path/filename
Maintain a Single Configuration File for Both Routing Engines on
page 234
1. Configure the New Group on page 234 [edit groups]
set group-name
[edit groups re0]
set interfaces interface name unit unit family inet address
address
[edit groups re0 system]
set host-name hostname
show
commit
2. Apply the New Group on page 236 [edit]
set apply-groups group-name
show
commit
List Files and Directories on a Router on page 237 file list filename or directory
Display File Contents on page 237 file show filename
Rename a File on a Router on page 238 file rename source destination
Delete a File on a Router on page 238 file delete filename
! 231
JUNOS Baseline Network Operations Guide
Purpose When you configure one Routing Engine and another Routing Engine needs to have
a similar configuration, or when you upgrade the JUNOS software version on one
Routing Engine, you can simplify the process by copying files from one Routing
Engine to another.
2. Copy Files between the Local Router and a Remote System on page 232
Action To copy a configuration file from Routing Engine 0 to Routing Engine 1, use the
following JUNOS command-line interface (CLI) operational mode command:
What It Means In this case, source is the name of the configuration file on Routing Engine 0.
Configuration files are stored in the directory /config. The active configuration is
/config/juniper.conf, and older configurations are in /config/juniper.conf {1...9 }.
destination is a file on Routing Engine 1.
NOTE: Refer to “Maintain a Single Configuration File for Both Routing Engines” on
page 234 for details about naming the Routing Engines correctly.
Step 2: Copy Files between the Local Router and a Remote System
Action You can copy a configuration file from a Routing Engine to a remote system in the
network using the File Transfer Protocol (FTP) or secure copy protocol (scp) in any
one of the following ways:
! To use anonymous FTP to copy a local file to a remote system, enter the
following command:
! To use FTP where a valid username and password are required, enter the
following command:
! To use FTP where you require more privacy and are prompted for a password,
enter the following command:
! To use scp to copy a local file to a remote system, enter the following
command:
NOTE: You cannot use scp or ssh to copy a file in the worldwide version of the
JUNOS software.
Purpose For routers that support multiple Routing Engines, you can specify re0 and re1 as
group names to ensure that the correct IP addresses are used for each Routing
Engine and to maintain a single configuration file for both Routing Engines. It is
important that the names of the Routing Engines correspond to a slot position
because the names re0 and re1 are special group names that you must use for the
Routing Engines to recognize which configuration statement to use. Routing Engine
0 must be in slot position 0 and must be named re0, and Routing Engine 1 must be
in slot position 1 and must be named re1.
Steps to Take To maintain a single configuration file for both Routing Engines, follow these steps:
Action To configure the re0 and re1 groups, follow these steps:
[edit]
user@host# edit groups
[edit groups]
user@host# set group-name
For example:
[edit groups]
user@host# set re0
[edit groups]
user@host# edit groups re0
For example:
For example:
user@host# commit
What It Means The sample output in Step 7 shows that the re0 group contains the minimum
configuration for a group, the hostname, and the management interface (fxp0). If
each Routing Engine uses a different management interface, the group must also
contain the configuration for the backup router and static routes.
1. In configuration mode, go to the top hierarchy level and include the following
statement:
user@host# [edit]
user@host# set apply-groups group-name
For example:
user@host# [edit]
user@host# set apply-groups re0
user@host# show
groups {
re0 {
system {
host-name foo-re0;
}
interfaces {
fxp0 {
unit 0 {
family inet {
address 1.1.1.1/24;
}
}
}
}
}
re1 {
system {
host-name foo-re1;
}
interfaces {
fxp0 {
unit 0 {
family inet {
address 1.1.1.2/24;
}
}
}
}
}
}
apply-groups [ re0 re1 ];
user@host# commit
What It Means The sample output shows that each group, re0 and re1, has its own IP address that
is used for each Routing Engine to maintain a single configuration file.
Purpose If a system board crashes, you must check that certain files are in specific
directories.
Action To display files in the /var/tmp and var/crash directories, use the following CLI
operational mode command:
What It Means The sample output shows the files in the /var/tmp/ and /var/crash/ directories. The
Juniper Networks Technical Assistance Center (JTAC) can ask you to verify the
existence of similar files.
Action To display the contents of a file on the local router, use the following CLI operational
mode command:
What It Means The sample output shows the contents of the /var/log/messages file.
Action To rename a file on the local router, use the following CLI operational mode
command:
What It Means The sample output shows that the dcd.core file was renamed to dcd.core.990413.
The original name of the file is the source and the new name for the file is the
destination.
Action To delete a file on the local router, use the following CLI operational mode
command:
What It Means The sample output shows that the snmpd.core file was deleted.
This chapter describes how to display the current time on the router, determine
whether router components failed during a problem, and check that the local clock
time on the router is synchronized with the time on the Network Time Protocol
(NTP) server. (See Table 43.)
Check How Long Router Components Have Been Up on page 240 show chassis fpc detail
show chassis routing-engine
show chassis feb
show chassis scb
show chassis sfm
show chassis ssb
Check the NTP Peers on page 243 show ntp associations
Check the NTP Status on page 244 show ntp status
! 239
JUNOS Baseline Network Operations Guide
Purpose Display the current time on a router and display information about how long the
router, router software, and routing protocols have been running.
Action To check time on a router, use the following JUNOS command-line interface (CLI)
operational mode command:
What It Means The sample output shows the current system time in UTC, the date and time when
the router was last booted and how long it has been running, when the routing
protocols were last started and how long they have been running, when a
configuration was last committed, and the name of the user who issued the last
commit command. If a different time zone is configured, the output shows that time
zone. For information on configuring the time zone, see the JUNOS System Basics
Configuration Guide.
The sample output shows that the current time is 12:45 PM, the router has been
operational for 22:54 hours, and two users are logged in to the router. The output
also shows that the load average is 0.07 seconds for the last minute, 0.02 seconds
for the last 5 minutes, and 0.01 seconds for the last 15 minutes.
Purpose When a problem occurs and you check the system to see how long it has been up,
you may find that the show system uptime command displays the current time and
information about how long the router, router software, and routing protocols have
been running, but does not tell you if a component failed. Determining whether a
component failed when a problem occurred with the router is an important step in
the diagnosis of a problem.
Action To check how long router components have been up, issue the show chassis
command for the components on your router:
Model RE-2.0
Serial ID d800000734745701
Start time 2003-06-17 16:37:33 PDT
Uptime 93 days, 20 hours, 58 minutes, 14 seconds
What It Means The sample output shows the time when the component started running and how
long the component has been running. A short uptime can indicate a problem with
the component.
Purpose Ensure that the clock time on the router is synchronized with the time on the NTP
server.
Action To check NTP peers, enter the following JUNOS CLI operational mode command:
What It Means Sample output 1 is synchronized with the NTP server because there is an asterisk
(*) at the beginning of the output. Also, the router with the asterisk (*) is the master
router and the system is synchronizing with this NTP server.
Sample output 2 shows that the time on the server and router is so far apart that
NTP will not attempt to synchronize. The offset value of 1830 is too large a
difference and the jitter value of 917.667 is also too large to provide reliability to the
offset value.
As a general rule, if the time difference between the server and the router is less
than 100 seconds, NTP adjusts the router’s clock speed so that it drifts towards the
server’s time. For instance, if the router clock is running fast, NTP slows the clock
down so that the time of day only advances 900 milliseconds every time the
server’s clock advances a full second. The time on the two clocks gradually
becomes identical. When the clock time is the same, NTP adjusts the clock on the
router to keep in step with the server’s time.
For more detailed information on configuring the NTP server, see the JUNOS System
Basics Configuration Guide.
Purpose View the configuration of the NTP server and the status of the system.
Action To check NTP status, enter the following JUNOS CLI operational mode command:
What It Means The sample output shows when the clock was last adjusted (reftime), together with
its status and most recent exception event. Table 44 lists and describes the fields in
the output of the show ntp status command.
Table 44: Sample Output Fields for the show ntp status Command
This chapter describes how to check user accounts and permissions. (See Table 45.)
! 247
JUNOS Baseline Network Operations Guide
In this chapter, it is assumed that user accounts and permissions are configured on
the router. For more detailed information about creating a user account and
configuring permissions, see the JUNOS Network Management Configuration Guide.
Purpose You may need to take note of the users currently logged in to a router.
Action To list all users who are currently logged in to a router, enter the following JUNOS
command-line interface (CLI) operational mode command:
What It Means The sample output lists information about the users who are currently logged in to a
router. There are three users, one of whom has not recently accessed the router.
Two of the users are running the CLI, and one is working from the UNIX-level shell
(csh). Figure 45 lists and describes the fields in the output of the show system users
command.
Table 46: Description of Output Fields for the show system users Command
Field Description
time and up Current time, in the local time zone, and how long the router has been
operational.
users Number of users logged in to the router.
load averages Load averages for the last 1 minute, 5 minutes, and 15 minutes.
USER Username.
TTY Terminal through which the user is logged in.
FROM System from which the user is logged in. A hyphen indicates that the user is
logged in through the console.
LOGIN@ Time when the user logged in.
IDLE How long the user has been idle.
WHAT Processes that the user is running.
Action To display users currently editing the configuration, follow these steps:
user@host> edit
For example:
user@host> edit
Entering configuration mode
[edit]
user@host# status
For example:
What It Means The sample output lists the users who are currently logged in to the router. Five
users are logged in to the router, with one user logged in twice, jgchan. Each user is
logged in through a different terminal (TTY—p0, p1, p2, p3, and p4) from the
system bigpunk.juniper.net. A hyphen in the FROM field indicates that the user
logged in through the console.
Additional information includes the time when the user logged in (LOGIN), the
amount of time the user is not active on the router (IDLE), and the processes that
the user is running (WHAT). In this example, the users are running the
command-line interface (cli) and the UNIX-level shell (csh).
Purpose A common set of operations you can check is when users log in to the router and
the CLI commands they issue.
Steps To Take To check the commands that users are entering, follow these steps:
1. Configure the Log File for Tracking CLI Commands on page 250
[edit]
user@host# edit system syslog
For example:
user@host# commit
What It Means The configuration example shows that the log file cli-commands is configured with
the interactive-commands facility at the info severity level. Table 47 lists and
describes the severity levels.
For example:
What It Means The sample output shows the CLI commands that were entered since the log file
was configured.
Purpose Disconnect a user session when that session does not terminate after the user logs
out.
Action To log a user out of all terminal sessions on a router, enter the following JUNOS CLI
operational mode command:
What It Means The sample output for the first show system users command shows there were two
users on the router, harry and wizard. The request system logout user command was
issued to log out user harry. Because there is no output to indicate that harry was
logged out, the show system users command was issued again to verify that user
harry was actually logged out of the router.
Purpose When a problem occurs on a router, it is a good idea to check when the last
configuration change was made because it may have had some influence on the
problem.
Action To check when the last configuration change occurred, follow these steps:
[edit]
user@host# edit system syslog
For example:
user@host# commit
For example:
What It Means The sample output shows the contents of the log file and that the last configuration
change was on September 17 at 07:07:22.
Purpose You have a scheduled maintenance window or have other important information to
convey to users logged in to the router.
Action To force a message to the terminals of logged-in users, enter the following JUNOS
CLI operational mode command:
Sample Output user@host> request message all message "This is an experiment, please be
patient"
What It Means The sample output shows that the message “This is an experiment, please be
patient” was sent to the consoles of all logged-in users, and the message
“Maintenance window in 10 minutes” was sent to the console of the logged-in user,
maria. For more detailed information about this command, see the JUNOS Network
Management Configuration Guide.
Action To ensure that you can ping the RADIUS server, follow these steps:
[edit]
user@host# edit system
[edit system]
user@host# show
For example:
[edit system]
user@host# show
host-name nut;
domain-name englab.company.net;
[...Output truncated...]
radius-server {
10.10.10.5 {
secret "$9$14bhlM-VYJGDX7-w2gUD"; # SECRET-DATA
timeout 5;
retry 3;
}
10.10.10.240 {
secret "$9$hMKrMXwYoDik-VwgaJHk"; # SECRET-DATA
timeout 5;
retry 3;
}
}
[...Output truncated...]
For example:
What It Means The sample output shows that the RADIUS server is connected and that the
connection is running at a reasonable speed.
This chapter describes how to configure system logging to monitor system-wide, high-level
operations. (See Table 48.)
! 261
JUNOS Baseline Network Operations Guide
262 !
Chapter 22: Track Normal Operations
Purpose System logging operations use a system logging mechanism to record system-wide,
high-level operations, such as interfaces going up or down and users logging in to or
out of a router.
[edit]
user@host# edit system syslog
For example:
user@host# show
For example:
user@host# commit
Table 49 lists the JUNOS system logging facilities. Each message is assigned to a
facility, which is a group of messages that are either generated by the same
software process or concern a similar condition or activity (such as authentication
attempts).
Table 50 lists the system log message severity levels supported by the JUNOS
software. Each message is assigned a severity level, which indicates how seriously it
affects router functioning.
[edit]
user@host# edit system syslog
For example:
user@host# show
For example:
user@host# commit
See Also For information on logging facilities and severity levels supported by the JUNOS
software, see Table 49 on page 264 and Table 50 on page 265.
[edit]
user@host# edit system syslog
For example:
user@host# show
For example:
user@host# commit
See Also For information on logging facilities and security levels supported by the JUNOS
software, see Table 49 on page 264 and Table 50 on page 265.
[edit]
user@host# edit system syslog
For example:
user@host# show
For example:
user@host# commit
See Also For information on logging facilities and security levels supported by the JUNOS
software, see Table 49 on page 264 and Table 50 on page 265.
Action To configure the number and size of the log files, follow these steps:
[edit]
user@host# edit system syslog
or
[edit]
user@host# edit system syslog filename
For example:
user@host# show
For example:
user@host# commit
See Also See the JUNOS System Basics Configuration Guide for more detailed explanations and
examples of log file configurations.
Action To log BGP state transition events to the system log, follow these steps:
[edit]
user@host# edit protocol bgp
user@host# show
user@host# commit
What It Means Log messages from BGP state transition events are sufficient to diagnose most BGP
session problems. Table 51 lists and describes the six states of a BGP session.
See Also For more detailed BGP protocol packet information, configure BGP-specific tracing.
See “Track Error Conditions” on page 273 for more information.
What It Means The sample output shows the rpd log messages in the messages file for September
10 from 7:00 to 7:21 AM.
What It Means The sample output shows the routing protocol log messages in the messages file for
September 10.
or
This chapter describes how to configure routing protocol daemon tracing, Border
Gateway Protocol (BGP), Intermediate System-to-Intermediate System (IS-IS)
protocol, and Open Shortest Path First (OSPF) protocol tracing to diagnose error
conditions. (See Table 52.)
! 273
JUNOS Baseline Network Operations Guide
274 !
Chapter 23: Track Error Conditions
Purpose Routing protocol process (rpd) tracing tracks all general routing operations and
records them in a log file.
Steps To Take To configure routing protocol process (rpd) tracing and monitor trace file messages,
follow these steps:
2. Configure Routing Protocol Tracing for a Specific Routing Protocol on page 278
[edit]
user@host# edit routing-options traceoptions
For example:
user@host# show
For example:
user@host# commit
For example:
What It Means Table 53 lists tracing flags and example output for JUNOS-supported routing
protocol daemon tracing.
[edit]
user@host# edit protocol protocol-name traceoptions
For example:
user@host# show
For example:
user@host# commit
For example:
What It Means Table 54 lists standard tracing options that are available globally or that can be
applied to specific protocols. You can also configure tracing for a specific BGP peer
or peer group. For more information, see the JUNOS System Basics Configuration
Guide.
user@host>
*** isis ***
Sep 15 18:32:21 Updating LSP isis5.02-00 in database
Sep 15 18:32:21 Updating L2 LSP isis5.02-00 in TED
Sep 15 18:32:21 Adding a half link from isis5.02 to isis6.00
Sep 15 18:32:21 Adding a half link from isis5.02 to isis5.00
Sep 15 18:32:21 Adding a half link from isis5.02 to isis6.00
Sep 15 18:32:21 Adding a half link from isis5.02 to isis5.00
Sep 15 18:32:21 Scheduling L2 LSP isis5.02-00 sequence 0xd87 on interface fxp2.3
Sep 15 18:32:21 Updating LSP isis5.00-00 in database
Sep 15 18:32:21 Updating L1 LSP isis5.00-00 in TED
Sep 15 18:32:21 Sending L2 LSP isis5.02-00 on interface fxp2.3
Sep 15 18:32:21 sequence 0xd87, checksum 0xc1c8, lifetime 1200
user@host>
*** isis ***
Sep 15 18:32:21 Updating LSP isis5.02-00 in database
Sep 15 18:32:21 Updating L2 LSP isis5.02-00 in TED
Sep 15 18:32:21 Adding a half link from isis5.02 to isis6.00
Sep 15 18:32:21 Adding a half link from isis5.02 to isis5.00
Sep 15 18:32:21 Adding a half link from isis5.02 to isis6.00
Sep 15 18:32:21 Adding a half link from isis5.02 to isis5.00
Sep 15 18:32:21 Scheduling L2 LSP isis5.02-00 sequence 0xd87 on interface fxp2.3
Sep 15 18:32:21 Updating LSP isis5.00-00 in database
Sep 15 18:32:21 Updating L1 LSP isis5.00-00 in TED
Sep 15 18:32:21 Sending L2 LSP isis5.02-00 on interface fxp2.3
Sep 15 18:32:21 sequence 0xd87, checksum 0xc1c8, lifetime 1200
monitor stop isis
user@host>
Purpose When unexpected events or problems occur, or if you want to diagnose BGP
establishment issues, you can view more detailed information by configuring
options specific to BGP. You can also configure tracing for a specific BGP peer or
peer group. For more information, see the JUNOS System Basics Configuration
Guide.
[edit]
user@host# edit protocol bgp traceoptions
user@host# show
For example:
user@host# commit
For example:
What It Means Table 55 lists tracing flags specific to BGP and presents example output for some of
the flags. You can also configure tracing for a specific BGP peer or peer group. For
more information, see the JUNOS System Basics Configuration Guide.
[edit]
user@host# edit protocol bgp traceoptions
2. Configure the flag to display sent, received, or both sent and received packet
information:
or
or
user@host# show
For example:
or
user@host# show
file bgplog size 10k files 10;
flag update receive;
or
user@host# commit
For example:
[edit]
user@host# edit protocol bgp
user@host# show
For example:
user@host# commit
For example:
Purpose When unexpected events or problems occur, or if you want to diagnose IS-IS
adjacency establishment issues, you can view more detailed information by
configuring options specific to IS-IS.
[edit]
user@host# edit protocols isis traceoptions
user@host# show
For example:
user@host# commit
For example:
What It Means Table 56 lists tracing flags that can be configured specific to IS-IS and presents
example output for some of the flags.
[edit]
user@host# edit protocol isis traceoptions
2. Configure the flag to display sent, received, or both sent and received packets:
or
or
user@host# show
For example:
or
or
user@host# commit
For example:
[edit]
user@host# edit protocols isis traceoptions
user@host# show
For example:
user@host# commit
For example:
Purpose When unexpected events or problems occur, or if you want to diagnose OSPF
neighbor establishment issues, you can view more detailed information by
configuring options specific to OSPF.
[edit]
user@host# edit protocols ospf traceoptions
user@host# show
For example:
user@host# commit
For example:
What It Means Table 57 lists OSPF tracing flags and presents example output for some of the flags.
[edit]
user@host# edit protocols ospf traceoptions
user@host# show
For example:
user@host# commit
For example:
This chapter explains the crashes that can occur in different areas of the JUNOS
software, and provides procedures you use to collect the crash data necessary for
troubleshooting by the Juniper Networks Technical Assistance Center (JTAC). (See
Table 58.)
! 299
JUNOS Baseline Network Operations Guide
300 !
Chapter 24: Collect Crash Data
Software Architecture
SNMP and Management Processes CLI
Forwarding Routing
table JUNOS kernel Engine
Packet
Packet Forwarding Engine microkernel Forwarding
Engine
1992
table process ASICs process
Purpose When a Routing Engine kernel crashes, the Routing Engine automatically reboots.
By default, the Juniper Networks router does not attempt to dump a core if the
Routing Engine kernel crashes. As a result, there is no crash data on the router to
help investigate the crash. In addition, the system log messages are similar to those
generated when the router is powered down and restarted, so you cannot tell if the
Routing Engine restart was caused by a kernel crash or a normal power restart.
Steps To Take To collect crash data for a Routing Engine kernel crash, follow these steps:
Action To check the /var/crash directory, use the following JUNOS command-line interface
(CLI) operational mode command:
What It Means The sample output lists the contents of the /var/crash/ directory. Check the date
and timestamp for any kernel core files created around the time of the crash. In the
example above, two core files are listed: kernel.0 and vmcore.0.
Steps To Take To collect and send crash data to JTAC, follow these steps:
1. Exit from the CLI environment and create a UNIX-level shell by entering the
start shell command:
2. Type su and the root password when prompted. You are now in the shell and
the prompt is % instead of >, for example:
% su
Password: ****
root@host% cd /var/crash
root@host% ls -l
4. Look for any core files created around the time of the crash.
What It Means The sample output lists the contents of the /var/crash directory and shows the
current core files kernel.0 and vm.core.0.
NOTE: Use lowercase for the gzip command when you are in the shell.
Action To compress the vmcore file with gzip, use the following command from the shell:
To unzip the vmcore file with gzip, use the following command from the shell:
What It Means The contents of the vmcore file are compressed into a single compressed file named
vmcore.number.gz. The gzip command preserves the mode, ownership, and
timestamps of files when compressing or decompressing them.
What It Means The sample output shows the hostname, router model, and the different JUNOS
software packages, processes, and documents.
e. Enter the mkdir case-number command, where the case-number is the value
of the case you opened with JTAC, for example, 1999-1231-9999. If a
directory has already been created, continue with the next step.
g. Enter the binary command so that the file transfer is in binary and not
ASCII.
Sample Output The following output is an example of copying a core file from the shell to an ftp
directory at ftp.juniper.net:
What It Means The sample output shows that there is a connection to ftp.juniper.net, that the login
name and password were entered, and that the core file was successfully copied
from the shell to an ftp directory at ftp.juniper.net.
Steps To Take To collect crash data for Routing Engine daemons, follow these steps:
Action To check the /var/tmp directory, use the following JUNOS CLI operational mode
command:
What It Means The sample output lists the contents of the /var/tmp/ directory. Look for any
daemon core files created around the time of the crash. In the example above, two
core files are listed: rpd.core.0 and rpd.core.1.
Table 59 lists the major Routing Engine daemons supported by the JUNOS software.
Executable
Name Definition Description
rpd Routing protocol daemon Provides routing protocol intelligence (Border Gateway Protocol [BGP],
Intermediate System-to-Intermediate System [ISIS], Open Shortest Path First
[OSPF], and so on).
dcd Device control daemon Manages all interface devices.
mgd Management daemon Provides user configuration access to the system. The CLI is a client of mgd.
snmpd Simple Network Provides remote network management information to the network management
Management Protocol system.
daemon
chassisd Chassis daemon Monitors and manages Flexible PIC Concentrator (FPC) slots and other
environmental components.
alarmd Alarm daemon Manages system alarm notifications.
Executable
Name Definition Description
apsd Automatic protection Provides SONET Automatic Protection Switching (APS) functionality.
switching daemon
sampled Traffic sampling daemon Gathers traffic sampling information.
vrrpd Virtual Router Redundancy Provides Virtual Router Redundancy Protocol (VRRP) functionality.
Protocol daemon
syslogd System log daemon Manages the router system logging operation.
mib2d MIB2 daemon Management Information Base (MIB) subagent for MIB2.
Steps To Take To collect and send crash data to JTAC, follow these steps:
1. Exit from the CLI environment and create a UNIX-level shell by entering the
start shell command:
2. Type su and the root password when prompted. You are now in the shell and
the prompt is % instead of >, for example:
% su
Password: ****
root@host% cd /var/tmp
root@host% ls -l
4. Look for any daemon core files created around the time of the crash.
What It Means The sample output lists the contents of the /var/tmp directory and shows the
current core file (rpd.core.1) and one previous core file (rpd.core.0) for the routing
protocol daemon (rpd). For each daemon, you can have a total of five core files in
the /var/tmp directory: the current core file and the four previous core files
numbered 0 through 4 (from oldest to newest).
NOTE: Use lowercase for the gzip command when you are in the shell.
You only need to compress the daemon core files when the tarball file is not
created.
Action To compress the daemon core file with gzip, use the following command from the
shell:
What It Means The contents of the daemon core file are compressed into a single compressed file
named daemon.number.gz. The gzip command preserves the mode, ownership, and
timestamps of files when compressing or decompressing them.
What It Means The output shows the hostname, router model, and the different JUNOS software
packages, processes, and documents.
e. Enter the mkdir case-number command, where the case-number is the value
of the case you opened with JTAC, for example, 1999-1231-9999. If a
directory has already been created, continue with the next step.
g. Enter the binary command so that the file transfer is in binary and not
ASCII.
Sample Output The following output is an example of copying a core file from the shell to an ftp
directory at ftp.juniper.net:
What It Means The sample output shows that there is a connection to ftp.juniper.net, that the login
name and password were entered, and that the core file was successfully copied
from the shell to an ftp directory at ftp.juniper.net.
Purpose Each of the following Packet Forwarding Engine components of a Juniper Networks
router runs a microkernel:
! Flexible PIC Concentrator (FPC) on M-series platforms except for the M5 and
M10 Internet routers
! Gibson Flexible PIC Concentrator (GFPC) on T640 and T320 Internet routing
nodes
! Switched Printed Mezzanine Board (SPMB) on T640 and T320 Internet routing
nodes
! Switching and Forwarding Module (SFM) on M160 and M40e Internet routers
When a crash occurs, crash stack traceback and registration information is placed
into nonvolatile random access memory (NVRAM) on the different components.
Table 60 shows where the NVRAM is located for the components for each router.
Table 60: NVRAM Location on the Microkernel of the Packet Forwarding Engine
Components
310 ! Collect Crash Data for the Packet Forwarding Engine Microkernel
Chapter 24: Collect Crash Data
Steps To Take To collect crash data for the Packet Forwarding Engine microkernel, follow these
steps:
1. Display the Crash Stack Traceback and Registration Information on page 311
1. Exit from the CLI environment and create a UNIX-level shell by entering the
start shell command:
2. Type su and the root password when prompted. You are now in the shell and
prompt is % instead of >, for example:
% su
Password: ****
3. Establish a vty session to the appropriate component. Use the vty command
followed by the executable name for the component; for example, scb, ssb0,
ssb1, fpc0, or fpc1:
NOTE: For the M40e and M160 routers, you can also create a cty session to the
components if the components are not online.
5. Type the show syslog messages command to view the system log messages.
SFM platform (266Mhz PPC 603e processor, 64Mb memory, 512Kb flash)
Collect Crash Data for the Packet Forwarding Engine Microkernel ! 311
JUNOS Baseline Network Operations Guide
Registers:
R00: 0x06f5f81c R01: 0x06f5f9cc R02: 0x00003344 R03: 0x00000000
R04: 0x00008000 R05: 0x00000000 R06: 0x0010052c R07: 0x06f637e4
R08: 0x06f5f81c R09: 0x00169810 R10: 0x000000e8 R11: 0x00000001
R12: 0x00046cdf R13: 0xffffffff R14: 0xffffffff R15: 0xffffffff
R16: 0xffffffff R17: 0xffffffff R18: 0xffffffff R19: 0xffffffff
R20: 0xffffffff R21: 0xffffffff R22: 0xffffffff R23: 0xffffffff
R24: 0x00000003 R25: 0x00000000 R26: 0x00000001 R27: 0x0000fc78
R28: 0x00150000 R29: 0x0016c4b0 R30: 0x06f5eb7c R31: 0x97cb1d36
MSR: 0x0008b030 CTR: 0x000ac008 Link:0x06f5f81c SP: 0x06f5f9cc
CCR: 0x22200024 XER: 0x20000000 PC: 0x06f5f81c
DSISR: 0x00000000 DAR: 0xffffffff K_MSR: 0x00001030
Stack Traceback:
Frame 01: sp = 0x06f5f9cc, pc = 0x06f5f81c
Frame 02: sp = 0x06f5f9e4, pc = 0x000c7e28
Frame 03: sp = 0x06f5fa04, pc = 0x00026620
ROM NVRAM:
0 available bytes, 0 used, 0 free
312 ! Collect Crash Data for the Packet Forwarding Engine Microkernel
Chapter 24: Collect Crash Data
Oct 26 12:05:58 router tnp_sfm_3 mpc106 PCI status reg: parity error
Oct 26 12:05:58 router tnp_sfm_3 ^B
Oct 26 12:05:58 router tnp_sfm_3 last message repeated 7 times
Oct 26 12:05:58 router tnp_sfm_3 Registers:
Oct 26 12:05:58 router tnp_sfm_3 R00: 0x06f5f81c R01: 0x06f5f9cc
R02: 0x00003344 R0
3: 0x00000000
Oct 26 12:05:58 router tnp_sfm_3 R04: 0x00008000 R05: 0x00000000
R06: 0x0010052c R0
7: 0x06f637e4
Oct 26 12:05:58 router tnp_sfm_3 R08: 0x06f5f81c R09: 0x00169810
R10: 0x000003b4 R1
1: 0x00000001
Oct 26 12:05:58 router tnp_sfm_3 R12: 0x00017b97 R13: 0xffffffff
R14: 0xffffffff R1
5: 0xffffffff
Oct 26 12:05:58 router tnp_sfm_3 R16: 0xffffffff R17: 0xffffffff
R18: 0xffffffff R1
9: 0xffffffff
Oct 26 12:05:58 router tnp_sfm_3 R20: 0xffffffff R21: 0xffffffff
R22: 0xffffffff R2
3: 0xffffffff
Oct 26 12:05:58 router tnp_sfm_3 R24: 0x00000003 R25: 0x00000000
R26: 0x00000001 R2
7: 0x0000fc78
Oct 26 12:05:58 router tnp_sfm_3 R28: 0x00150000 R29: 0x0016c4b0
R30: 0x06f5eb7c R3
1: 0x97c9c35e
Oct 26 12:05:58 router tnp_sfm_3 MSR: 0x0008b030 CTR: 0x000ac008
Link:0x06f5f81c SP
: 0x06f5f9cc
Oct 26 12:05:58 router tnp_sfm_3 CCR: 0x22200024 XER: 0x20000000
PC: 0x06f5f81c
Oct 26 12:05:58 router tnp_sfm_3 DSISR: 0x00000000 DAR: 0xffffffff
K_MSR: 0x0000103
0
Sample Output 2 The following sample output is another example of displaying the crash stack
traceback and registration information:
Collect Crash Data for the Packet Forwarding Engine Microkernel ! 313
JUNOS Baseline Network Operations Guide
Stack Traceback:
Frame 01: sp = 0x01baba34, pc = 0x000308c8
Frame 02: sp = 0x01babac4, pc = 0x0002647c
Frame 03: sp = 0x01babad4, pc = 0x00026590
Frame 04: sp = 0x01babadc, pc = 0x00106fcc
Frame 05: sp = 0x01babafc, pc = 0x00026620
ROM NVRAM:
0 available bytes, 0 used, 0 free
What It Means Sample output 1 and 2 show the stack trace from the microkernel crash. Save the
output from the show nvram and show syslog commands so that you can send them
to JTAC when you open a case.
Action To clear the content of the NVRAM after you have captured the necessary
information, follow these steps:
1. Exit from the CLI environment and create a UNIX-level shell by entering the
start shell command:
2. Type su and the root password when prompted. You are now in the shell and
the prompt is % instead of >, for example:
% su
Password: ****
3. Establish a vty session to the appropriate component. Use the vty command
followed by the abbreviation for the component, for example:
The vty prompt will vary depending on the component, for example:
SFM3(host vty)#
FPC1(host vty)#
314 ! Collect Crash Data for the Packet Forwarding Engine Microkernel
Chapter 24: Collect Crash Data
Action To check the /var/crash directory, use the following JUNOS CLI operational mode
command:
What It Means The sample output lists the contents of the /var/crash/ directory. Check the date
and timestamp for any core files created around the time of the crash. In the
example above, four core files are listed.
Steps To Take To collect and send crash data to JTAC, follow these steps:
1. Exit from the CLI environment and create a UNIX-level shell by entering the
start shell command:
2. Type su and the root password when prompted. You are now in the shell and
the prompt is % instead of >, for example:
% su
Password: ****
Collect Crash Data for the Packet Forwarding Engine Microkernel ! 315
JUNOS Baseline Network Operations Guide
root@host% cd /var/crash
root@host% ls -l
4. Look for any core files created around the time of the crash.
What It Means The sample output shows the current core files for the different components on the
router; for example, core-FPC4.100111808032 and core-SCB.100111004570.
Action To compress the core files with gzip, use the following command from the shell:
What It Means The contents of the core file are compressed into a single compressed file named
core-SCB.10101092045.gz. The gzip command preserves the mode, ownership, and
timestamps of files when compressing or decompressing them.
316 ! Collect Crash Data for the Packet Forwarding Engine Microkernel
Chapter 24: Collect Crash Data
What It Means The sample output shows the hostname, router model, and the different JUNOS
software packages, processes, and documents.
e. Enter the mkdir case-number command, where the case-number is the value
of the case you opened with JTAC, for example, 1999-1231-9999. If a
directory has already been created, continue with the next step.
g. Enter the binary command so that the file transfer is in binary and not
ASCII.
Collect Crash Data for the Packet Forwarding Engine Microkernel ! 317
JUNOS Baseline Network Operations Guide
Sample Output The following output is an example of copying a core file from the shell to an ftp
directory at ftp.juniper.net:
What It Means The sample output shows that there is a connection to ftp.juniper.net, that the login
name and password were entered, and that the core file was successfully copied
from the shell to an ftp directory at ftp.juniper.net.
318 ! Collect Crash Data for the Packet Forwarding Engine Microkernel
Part 6
Appendix
Appendix ! 319
JUNOS Baseline Network Operations Guide
320 ! Appendix
Appendix 1
Command-Line Interface Overview
The CLI is the interface to the software that you use whenever you access the
router—whether from the console or through a remote network connection. The
CLI, which automatically starts after the router finishes booting, provides
commands that you use to perform various tasks, including configuring the JUNOS
software, and monitoring and troubleshooting the software, network connectivity,
and the router hardware.
! 321
JUNOS Baseline Network Operations Guide
Command Description
clear Clear statistics and protocol database information.
Syntax: clear (arp | bgp | chassis | firewall | igmp | interfaces | isis | ldp | log | mpls | msdp | multicast | ospf | pim |
rip | route | rsvp | snmp | system | vrrp)
configure Enter CLI configuration mode. Alternative commands: configure exclusive | configure private
file Perform file manipulation operations, such as copy, delete, list, rename, and show.
Syntax: file (compare | copy | delete | list | rename | show)
help Provide help information.
Syntax: help (reference | topic)
monitor Monitor a log file or interface traffic in real time.
Syntax: monitor (start | stop | interface | list | traffic)
mtrace Display trace information about a multicast path from a source to a receiver.
Syntax: mtrace (from-source | to-gateway | monitor)
ping Try to connect to a remote target.
pipe Filter the output of an operational mode or configuration mode command.
Syntax: | (compare | count | display <detail | inheritance | xml> | except pattern | find pattern | hold | match pattern
| no-more | resolve <full-names> | save filename | trim columns)
quit Exit from the CLI to a UNIX shell.
request Make system-level requests, such as stop or reboot the router, load software packages, and back up the
router’s file systems.
Syntax: request system (reboot | halt | software | snapshot)
restart Restart the router software processes.
Syntax: restart (fpc | interface-control | mib-process | routing | sampling | sfm | snmp | soft)
set Set CLI properties, the router’s date and time, and the craft interface display text.
Syntax: set (chassis | cli | date)
show Show information about all aspects of the software, including interfaces and routing protocols.
Syntax: (aps | arp | as-path | bgp | chassis | cli | configuration | connections | dvmrp | firewall | host | igmp |
interfaces | isis | ldp | log | mpls | msdpl | multicast | ntp | ospf | pfe | pim | policy | ripl | route | rsvp | sap | snmp |
system | task | ted | version | vrrp)
ssh Open a secure shell to another host.
start Start a software process.
Syntax: start shell
telnet Start a telnet session to another host.
test Run various diagnostic debugging commands.
Syntax: test (configuration | interface | msdp | policy)
traceroute Trace the route to a remote host.
% cli
You are in the CLI when you see the > prompt, which is preceded by a string that
defaults to the name of the user and the name of the router. For example:
user@host>
To get help while in the CLI, type ?. You do not need to press Enter after typing the
question mark. You have the following options:
! If you type the question mark at the command-line prompt, the CLI lists the
available commands and options.
! If you type the question mark after entering the complete name of a command
or command option, the CLI lists the available commands and options, then
redisplays the command names and options that you typed.
! If you type the question mark in the middle of a command name, the CLI lists
possible command completions that match the letters you have entered so far,
then redisplays the letters that you typed.
! List CLI Commands that Start with a Particular Letter on page 324
user@host> ?
Possible completions:
clear Clear information in the system
configure Manipulate software configuration information
file Perform file operations
help Provide help information
mtrace Trace mtrace packets from source to receiver.
monitor Real-time debugging
ping Ping a remote target
quit Exit the management session
request Make system-level requests
restart Restart a software process
set Set CLI properties, date, time, craft display text
show Show information about the system
ssh Open a secure shell to another host
start Start a software process
telnet Telnet to another host
test Diagnostic debugging commands
traceroute Trace the route to a remote host
user@host>
user@host> c?
Possible completions:
clear Clear information in the system
configure Manipulate software configuration information
user@host> c
user@host> clear ?
Possible completions:
arp Clear address-resolution information
bgp Clear BGP information
chassis Clear chassis information
firewall Clear firewall counters
igmp Clear IGMP information
interfaces Clear interface information
ilmi Clear ILMI statistics information
isis Clear IS-IS information
ldp Clear LDP information
log Clear contents of a log file
mpls Clear MPLS information
msdp Clear MSDP information
multicast Clear Multicast information
ospf Clear OSPF information
pim Clear PIM information
rip Clear RIP information
route Clear routing table information
rsvp Clear RSVP information
snmp Clear SNMP information
system Clear system status
vrrp Clear VRRP statistics information
user@host> clear
To complete a command or option that you have partially typed, press the Tab key
or the spacebar. If the partially typed letters begin a string that uniquely identifies a
command, the complete command name appears. Otherwise, a beep indicates that
you have entered an ambiguous command, and the possible completions are
displayed.
To display a list of all log files whose names start with the string “messages,” and
then display the contents of one of the files, do the following:
Possible completions:
<filename> Log file to display
messages Size: 1417052, Last changed: Mar 3 00:33
messages.0.gz Size: 145575, Last changed: Mar 3 00:00
messages.1.gz Size: 134253, Last changed: Mar 2 23:00
messages.10.gz Size: 137022, Last changed: Mar 2 14:00
messages.2.gr Size: 137112, Last changed: Mar 2 22:00
messages.3.gz Size: 121633, Last changed: Mar 2 21:00
messages.4.gz Size: 135715, Last changed: Mar 2 20:00
messages.5.gz Size: 137504, Last changed: Mar 2 19:00
messages.6.gz Size: 134591, Last changed: Mar 2 18:00
messages.7.gz Size: 132670, Last changed: Mar 2 17:00
messages.8.gz Size: 136596, Last changed: Mar 2 16:00
messages.9.gz Size: 136210, Last changed: Mar 2 15:00
By default, this command displays the last 100 commands issued in the CLI. Specify
a number with the command to display that number of recent commands. For
example:
Table 62 explains each CLI configuration mode command. The commands are
organized alphabetically.
Command Description
activate Remove the inactive: tag from a statement, effectively reading the statement or identifier to the
configuration. Statements or identifiers that have been activated take effect when you next issue the commit
command.
Syntax: activate (statement | identifier)
annotate Add comments to a configuration. You can add comments only at the current hierarchy level.
Syntax: annotate statement "comment-string"
commit Commit the set of changes to the database and cause the changes to take operational effect.
Syntax: commit << at <string>> <and-quit> <check> <confirmed <minutes>> <synchronize>
copy Make a copy of an existing statement in the configuration.
Syntax: copy existing-statement to new-statement
deactivate Add the inactive: tag to a statement, effectively commenting out the statement or identifier from the
configuration. Statements or identifiers marked as inactive do not take effect when you issue the commit
command.
Syntax: deactivate (statement | identifier)
delete Delete a statement or identifier. All subordinate statements and identifiers contained within the specified
statement path are deleted with it.
Syntax: delete <statement-path> <identifier>
edit Move inside the specified statement hierarchy. If the statement does not exist, it is created.
Syntax: edit statement-path
exit Exit the current level of the statement hierarchy, returning to the level prior to the last edit command, or
exit from configuration mode. The quit and exit commands are synonyms.
Syntax: exit <configuration-mode>
help Display help about available configuration statements.
Syntax: help (apropos | topic | reference) <string >
insert Insert an identifier into an existing hierarchy.
Syntax: insert <statement-path> identifier1 (before | after) identifier2
load Load a configuration from an ASCII configuration file or from terminal input. Your current location in the
configuration hierarchy is ignored when the load operation occurs.
Syntax: load (replace | merge | override) (filename | terminal)
Command Description
quit Exit the current level of the statement hierarchy, returning to the level prior to the last edit command, or
exit from configuration mode. The quit and exit commands are synonyms.
Syntax: quit <configuration-mode>
rename Rename an existing configuration statement or identifier.
Syntax: rename <statement-path> identifier1 to identifier2
rollback Return to a previously committed configuration. The software saves the last 10 committed configurations,
including the rollback number, date, time, and name of the user who issued the commit configuration
command.
The currently operational JUNOS software configuration is stored in the file juniper.conf, and the last three
committed configurations are stored in the files juniper.conf.1, juniper.conf.2, and juniper.conf.3. These four
files are located in the directory /config, which is on the router’s flash drive. The remaining six previous
committed configurations, the files juniper.conf.4 through juniper.conf.9, are stored in the directory
/var/db/config, which is on the router’s hard disk.
Syntax: rollback <number>
run Run a top-level CLI command without exiting from configuration mode.
Syntax: run command
save Save the configuration to an ASCII file. The contents of the current level of the statement hierarchy (and
below) are saved, along with the statement hierarchy containing it. This allows a section of the configuration
to be saved, while fully specifying the statement hierarchy.
Syntax: save filename
set Create a statement hierarchy and set identifier values. This is similar to edit except that your current level in
the hierarchy does not change.
Syntax: set <statement-path> identifier
show Display the current configuration.
Syntax: show <statement-path> <identifier>
status Display the users currently editing the configuration.
top Return to the top level of configuration command mode, which is indicated by the [edit] banner.
Syntax: top <configuration-command>
up Move up one level in the statement hierarchy.
Syntax: up <number> <configuration-command>
update Update a private database.
The following list shows the statements available at the top level of the
configuration mode (that is, the trunk of the hierarchy tree). Table 63 on page 330
describes each statement.
user@host# set ?
Possible completions:
> accounting-options Accounting data configuration
+ apply-groups Groups from which to inherit configuration data
> chassis Chassis configuration
> class-of-service Class-of-service configuration
> firewall Define a firewall configuration
> forwarding-options Configure options to control packet sampling
> groups Configuration groups
> interfaces Interface configuration
> policy-options Routing policy option configuration
> protocols Routing protocol configuration
> routing-instances Routing instance configuration
> routing-options Protocol-independent routing option configuration
> snmp Simple Network Management Protocol
> system System parameters
An angle bracket ( > ) before the statement name indicates that it is a container
statement and you can define other statements at levels below it.
If there is no angle bracket ( > ) before the statement name, the statement is a leaf
statement; you cannot define other statements at hierarchy levels below it.
A plus sign ( + ) before the statement name indicates that it can contain a set of
values. To specify a set, include the values in brackets. For example:
[edit]
user@host# set policy-options community my-as1-transit members [65535:10
65535:11]
In some statements, you can include an identifier. For some identifiers, such as
interface names, you must specify the identifier in a precise format. For example,
the interface name so-0/0/0 refers to a SONET/SDH interface that is on the Flexible
PIC Concentrator (FPC) in slot 0, in the first Physical Interface Card (PIC) location,
and in the first port on the PIC. For other identifiers, such as interface descriptive
text, policy, and firewall term names, you can specify any name, including special
characters, spaces, and tabs.
You must enclose in quotation marks (double quotes) identifiers and any strings
that include the following characters: space tab ( ) [ ] { } ! @ # $% ^ & | ’ = ?
Statement Description
accounting-options Configure accounting statistics data collection for interfaces and firewall filters. For information about the
statements in this hierarchy, see the JUNOS Network Management Configuration Guide.
chassis Configure properties of the router chassis, including the clock source, conditions that activate alarms, and
SONET/SDH framing and concatenation properties. For information about the statements in this hierarchy,
see the JUNOS System Basics Configuration Guide.
class-of-service Configure class-of-service parameters. For information about the statements in this hierarchy, see the
JUNOS Class of Service Configuration Guide.
firewall Define filters that select packets based on their contents. For information about the statements in this
hierarchy, see the JUNOS Policy Framework Configuration Guide.
forwarding-options Define forwarding options, including traffic sampling options. For information about the statements in this
hierarchy, see the JUNOS Network Interfaces Configuration Guide.
groups Configure configuration groups. For information about statements in this hierarchy, see JUNOS System
Basics Configuration Guide.
interfaces Configure interface information, such as encapsulation, interfaces, virtual channel identifiers (VCIs), and
data-link channel identifiers (DLCIs). For information about the statements in this hierarchy, see the JUNOS
Network Interfaces Configuration Guide.
policy-options Define routing policies, which allow you to filter and set properties in incoming and outgoing routes. For
information about the statements in this hierarchy, see the JUNOS Routing Protocols Configuration Guide.
protocols Configure routing protocols, including Border Gateway Protocol (BGP), Intermediate
System-to-Intermediate System (IS-IS), Open Shortest Path First (OSPF), Routing Information Protocol
(RIP), Multiprotocol Label Switching (MPLS), Label Distribution Protocol (LDP), and Resource Reservation
Protocol (RSVP). For information about the statements in this hierarchy, see the chapters that discuss how
to configure the individual routing protocols in the JUNOS Routing Protocols Configuration Guide and the
JUNOS MPLS Applications Configuration Guide.
routing-instances Configure multiple routing instances. For information about the statements in this hierarchy, see the JUNOS
Routing Protocols Configuration Guide.
routing-options Configure protocol-independent routing options, such as static routes, autonomous system (AS) numbers,
confederation members, and global tracing (debugging) operations to log. For information about the
statements in this hierarchy, see the JUNOS Routing Protocols Configuration Guide.
snmp Configure Simple Network Management Protocol (SNMP) community strings, interfaces, traps, and
notifications. For information about the statements in this hierarchy, see the JUNOS Network Management
Configuration Guide.
system Configure systemwide properties, including the hostname, domain name, Domain Name System (DNS)
server, user logins and permissions, mappings between hostnames and addresses, and software processes.
Protocols bgp
dvmrp
icmp dead-interval
igmp hello-interval
isis interface-type
mpis area-range metric
ospf area interface mtu
rip traceoptions stub poll-interval
router-discovery virtual-link priority
rsvp retransmit-interval
sap transit-delay
1412
transmit-interval
Each statement at the top level of the configuration hierarchy resides at the trunk
(or root level) of a hierarchy tree. The top-level statements are container statements,
containing other statements that form the tree branches. The leaf statements are
the leaves of the hierarchy tree. An individual hierarchy of statements, which starts
at the trunk of the hierarchy tree, is called a statement path. Figure 23 illustrates the
hierarchy tree, showing a statement path for the portion of the protocol
configuration hierarchy that configures the hello interval on an interface in an OSPF
area.
The CLI represents the statement path shown in Figure 23 on page 331as [protocols
ospf area area-number interface interface-name], and displays the configuration as
follows:
protocols {
ospf {
area 0.0.0.0 {
interface so-0/0/0 {
hello-interval 5;
}
interface so-0/0/1 {
hello-interval 5;
}
}
}
}
The CLI indents each level in the hierarchy to indicate each statement’s relative
position in the hierarchy and generally sets off each level with braces, using an
open brace at the beginning of each hierarchy level and a closing brace at the end.
If the statement at a hierarchy level is empty, the braces are not printed. Each leaf
statement ends with a semicolon. If the hierarchy does not extend as far as a leaf
statement, the last statement in the hierarchy ends with a semicolon.
The CLI uses this indented representation when it displays the current system
configuration, and you use this format when creating ASCII files that contain the
software configuration. However, the format of ASCII configuration files is not as
strict as the CLI output of the configuration. Although the braces and semicolons are
required, the indentation and use of new lines, as shown above, are not required in
ASCII configuration files.
! Run Operational Mode CLI Commands from Configuration Mode on page 337
user@host> configure
! If, when you enter configuration mode, the configuration contains changes that
have not been committed, a message appears:
user@host> configure
! If, while in configuration mode, you try to make a change while the
configuration is locked by another user, a message indicates that the
configuration database is locked, who the user is, and what portion of the
configuration the user is viewing or editing:
! If you enter configuration mode with the configure exclusive command, you
lock the candidate configuration for as long as you remain in configuration
mode, allowing you to make changes without interference from other users. If
another user is also in configuration mode and has the configuration locked, a
message indicates who the user is and what portion of the configuration the
user is viewing or editing:
[edit]
user@host# exit
To exit with uncommitted changes without having to respond to a prompt, use the
exit configuration-mode command.
Command Description
edit To move down through an existing configuration command hierarchy, or to create a hierarchy and move
down to that level, use the edit configuration mode command, specifying the hierarchy level at which you
want to be.
exit To move up the hierarchy, use the exit configuration mode command. This command is, in effect, the
opposite of the edit command.
up To move up the hierarchy one level at a time, use the up configuration mode command.
top To move directly to the top level, use the top configuration mode command.
The configuration statements appear in a fixed order. The CLI indents each level in
the hierarchy to indicate each statement’s relative position in the hierarchy and
generally sets off each level with braces, using an open brace at the beginning of
each hierarchy level and a closing brace at the end. If the statement at a hierarchy
level is empty, the braces are not printed. Each leaf statement ends with a
semicolon. If the hierarchy does not extend as far as a leaf statement, the last
statement in the hierarchy ends with a semicolon. Interfaces appear alphabetically
by type, and then in numerical order by slot number, PIC number, and port number.
user@host# status
The system displays who is editing the configuration (user), how the user is logged
in (terminal p0), the date and time the user logged in (2002-03-12 18:24:27 PST),
and what level of the hierarchy the user is editing ([edit protocols]).
! set—Creates a statement hierarchy and sets identifier values. After you issue a
set command, you remain at the same level in the hierarchy. The set command
has the following syntax:
statement-path is the hierarchy to the configuration statement and the statement itself.
If you have already moved to the statement’s hierarchy level, you omit this. statement is
the configuration statement itself. identifier is a string that identifies an instance of a
statement.
! edit—Moves to a particular hierarchy level. If that hierarchy level does not exist,
the edit command creates it and then moves to it. The edit command has the
following syntax:
Remove a Statement
To delete a statement or identifier, use the delete configuration mode command.
Deleting a statement or an identifier effectively “unconfigures” the functionality
associated with that statement or identifier, returning that functionality to its default
condition. When you delete a statement, the statement and all its subordinate
statements and identifiers are removed from the configuration.
To delete the entire hierarchy starting at the current hierarchy level, do not specify a
statement or an identifier in the delete command:
[edit]
user@host# delete
[edit]
user@host# run operational-mode-command
12:40:08 -- show
12:40:17 -- edit protocols
12:40:27 -- set isis
12:40:29 -- edit isis
12:40:40 -- run show cli history
Commit a Configuration
To commit a configuration, you can do the following:
user@host# commit
commit complete
The configuration is checked for syntax errors. If the syntax is correct, the
configuration is activated and becomes the current, operational router
configuration. If the configuration contains syntax errors, a message indicates the
location of the error and the configuration is not activated. You must correct the
error before recommitting the configuration.
[edit]
user@host# commit and-quit
commit complete
exiting configuration mode
user@host>
[edit]
user@host# save filename
[edit]
user@host# rollback
load complete
[edit]
user@host# rollback
load complete
[edit]
user@host# commit
[edit]
user@host# rollback number
load complete
[edit]
user@host# rollback ?
Possible completions:
<[Enter]> Execute this command
<number> Numeric argument
0 2001-02-27 12:52:10 PST by abc via cli
1 2001-02-26 14:47:42 PST by cde via cli
2 2001-02-14 21:55:45 PST by fgh via cli
3 2001-02-10 16:11:30 PST by hij via cli
4 2001-02-10 16:02:35 PST by klm via cli
| Pipe through a command
[edit]
You can also display help based on a text string contained in a statement name
using the help topic and help reference commands. The help topic command
displays usage guidelines for the statement, whereas the help reference command
displays summary information about the statement.
If you do not type an option for a statement that requires one, a message indicates
the type of information expected. In this example, you need to type an area
number to complete the command:
[edit]
user@host# set protocols ospf area<Enter>
In this example, you need to type a value for the hello interval to complete the
command:
[edit]
user@host# set protocols ospf area 45 interface so-0/0/0
hello-interval<Enter>
If you have omitted a required statement at a particular hierarchy level, when you
attempt to move from that hierarchy level or when you issue the show command in
configuration mode, a message indicates which statement is missing. For example:
Index ! 341
JUNOS Baseline Network Operations Guide
342 ! Index
Index
Index ! 343
JUNOS Baseline Network Operations Guide
344 ! Index
Index
components messages
alarms, displaying .....................................................97 locked database................................................333
CLI commands for monitoring, common...................14 uncommitted changes ......................................333
craft interface, checking ............................................93 user editing locked configuration......................334
detailed operational status, CLI commands ...............96 navigation commands, table....................................334
environmental status, CLI commands .......................95 operational mode commands, running within .........337
error messages statement
in chassisd log file ..............................................98 characters requiring quotation marks...............329
in messages log file ............................................97 container ..........................................................331
LED status, checking .................................................94 deleting ............................................................336
problems description .......................................................329
solving................................................................99 leaf ...................................................................331
verifying.............................................................98 statement hierarchy, figure......................................331
router, returning ......................................................100 statement path, example .........................................332
compress statements, top-level
daemon core files ....................................................308 accounting-options ...........................................330
utility ...............................................................304, 316 chassis..............................................................330
config, file system...........................................63, 71, 82, 87 class-of-service .................................................330
configuration details, displaying........................................54 firewall .............................................................330
configuration mode commands, table...............................20 forwarding-options ...........................................330
configuration mode, CLI groups ..............................................................330
+, statement value indicator...................................329 interfaces .........................................................330
>, statement container indicator ............................329 policy-options...................................................330
command history, displaying ..................................337 protocols ..........................................................330
commands routing-instances ..............................................330
activate ......................................................20, 327 routing-options .................................................330
annotate.....................................................20, 327 snmp................................................................330
commit ......................................................20, 327 system..............................................................330
copy ...........................................................20, 327 table .................................................................330
deactivate...................................................20, 327 uncommitted changes, exiting with.........................334
delete .........................................................20, 327 configuration, router
edit.............................................................20, 327 activating.................................................................338
exit.............................................................20, 327 active, logging......................................................21, 80
help............................................................20, 327 at a specific level, displaying....................................335
insert..........................................................20, 327 at current hierarchy level, displaying .......................335
load............................................................20, 327 backup, copying ........................................................86
paste ..........................................................21, 328 changing while configuration is locked ....................333
quit ............................................................21, 328 committed, most recent, returning to and loading
rollback ......................................................21, 328 without activating ................................................338
run .............................................................21, 328 currently running on the router, displaying .............335
save............................................................21, 328 edit command, using...............................................336
set ..............................................................21, 328 entire hierarchy, deleting from current hierarchy level ..
show ..........................................................21, 328 336
status .........................................................21, 328 example ..................................................................332
table ...........................................................20, 327 file, saving ...............................................................338
top .............................................................21, 328 format .....................................................................335
top-level, table..................................................329 group.......................................................................235
up...............................................................21, 328 hostname ................................................................235
update........................................................21, 328 last current committed, displaying ..........................335
configuration hierarchy, description ........................331 management interface.............................................235
configuration See configuration, router modifying ................................................................336
description ........................................................20, 327 previous, displaying.................................................339
displaying current configuration ................................50 prior to most recently committed, returning to .......339
entering...................................................................333 saving and activating ...............................................337
example configuration.............................................332 saving to a text file ..................................................338
help about statements, getting ................................339 saving, activating, and exiting .................................338
hierarchy tree, description.......................................331 set command, using ................................................336
identifier, description ..............................................329 statement, deleting..................................................336
syntax checking.......................................................337
tracking changes......................................................253
Index ! 345
JUNOS Baseline Network Operations Guide
uncommitted changes, exiting with ........................ 334 database-description, OSPF protocol tracing flag ............294
users currently editing the configuration, displaying335 date, checking.................................................................302
configurations dcd, Routing Engine daemon..........................................306
configuration details, displaying ................................ 54 deactivate command
current configuration, displaying............................... 50 usage guidelines ................................................20, 327
configure command debug, severity level .......................................................265
backup configurations, copying................................. 86 delete command
names and addresses ................................................ 84 usage guidelines ................................................20, 327
usage guidelines ................................................ 18, 322 delete routing-options static route command....................33
conflict-log, system logging facility ................................. 264 detail statement
connect, BGP protocol session state................................ 269 BGP protocol ...................................................281, 284
console, logging to .......................................................... 267 IS-IS protocol ...................................................286, 291
conventions, documentation ............................................ xv OSPF protocol .................................................293, 297
cooling system, overview.................................................. 13 detailed operational status commands, table ....................96
copy command directories, checklist for displaying .................................231
usage guidelines ................................................ 20, 327 disk space, displaying .................................................63, 82
copying, JUNOS software packages................................... 69 display detail command
core files usage guidelines ........................................................54
checking.................................................................. 302 documentation conventions ............................................. xv
compressing.................................................... 304, 316 domain name, configuring................................................84
listing .............................................................. 303, 315 downgrade software, from 5.0 to 4.x ................................68
cost, IS-IS route selection................................................ 121 download JUNOS software ..........................................64–66
CPU utilization
checking with snmpwalk command ........................ 219 E
per process, snmpwalk command........................... 220 edit command
craft interface, table.......................................................... 93 usage guidelines ........................................20, 327, 336
crash data edit groups command.....................................................234
checklist for collecting ............................................. 299 edit protocol bgp command....................................268, 284
opening a case with JTAC ........................ 305, 309, 317 edit protocol bgp traceoptions command ...............281, 283
overview ................................................................. 301 edit protocol traceoptions command ..............................278
sending to JTAC....................................... 303, 307, 315 edit protocols isis traceoptions command.......286, 289, 291
crash stack traceback...................................... 310, 311, 313 edit protocols ospf traceoptions command .............293, 297
critical, severity level ...................................................... 265 edit routing-options traceoptions command ...................275
cron, system logging facility ........................................... 264 edit snmp command ......................................................209
csn, IS-IS protocol tracing flag......................................... 288 edit system command ....................................................256
current configuration, displaying ...................................... 50 edit system syslog command..........250, 253, 265, 266, 267
current daemon core file ................................................ 308 edit system syslog statement ..........................................263
customer support emergency, severity level ................................................265
contacting ................................................................ xix environment, logging information ....................................78
environmental status commands, table ............................95
D error
daemon conditions, checklist for tracking .............................273
core files OSPF protocol tracing flag .......................................294
checking .......................................................... 306 severity level ...........................................................265
compressing .................................................... 308 established, BGP protocol session state...........................270
current ............................................................. 308 establishment issues
previous ........................................................... 308 BGP protocol ...................................................281, 284
run show log command........................................... 276 OSPF protocol .........................................................293
set file size command.............................................. 275 Ethernet interface, configuring..........................................84
system logging facility ............................................. 264 events
tracing BGP protocol state transition ...................................268
flags, table................................................ 276, 306 OSPF protocol tracing flag .......................................295
set flag command ............................................ 275 exit command
damping, BGP protocol tracing flag................................. 282 from configuration mode ..........................................85
data flow usage guidelines ................................................20, 327
M-series routers........................................................... 6 exit configuration-mode command
Packet Forwarding Engine........................................... 5 usage guidelines ......................................................334
T-series platforms........................................................ 7
database link-state, examining........................................ 124
346 ! Index
Index
F H
facility, configuring .................................263, 265, 266, 267 halting router software......................................................38
fans, showing environmental information.........................78 hard drives, backup file system.........................................63
FEB...........................................................................14, 310 hardware
file command, usage guidelines................................18, 322 components
file copy command .............................................69, 86, 232 overview ..............................................................9
file copy ftp command....................................................232 router monitoring, table .....................................14
file delete command .......................................................238 logging router chassis version..............................60, 77
file list command............................................................237 hello
daemon core files ....................................................306 IS-IS protocol tracing flag .........................................288
Packet Forwarding Engine core files, checking ........315 OSPF protocol tracing flag .......................................295
Routing Engine kernel .............................................302 statement
file rename command ....................................................238 IS-IS protocol ............................................286, 289
file system OSPF protocol ..................................................293
/altconfig .................................................63, 71, 82, 87 help
/altroot.....................................................63, 71, 82, 87 command, usage guidelines ................18, 20, 322, 327
/config .......................................................................63 reference command, usage guidelines.....................339
backing up.....................................................63, 71, 82 topic command, usage guidelines............................339
disk space..................................................................63 hierarchy level...................................................................53
hard drive, backup file system...................................63 host, configuring.............................................................265
root, backing up ........................................................63 host-name command......................................................235
filenames, listing.............................................................326 hostname, logging.......................................59, 76, 304, 309
files
checklist for displaying ............................................231 I
log, configuring .......................................................263 icons defined, notice......................................................... xv
firewalls idle, BGP protocol state ...................................................269
filter, show firewall filter command.........................195 insert command
show firewall log command.....................................194 usage guidelines ................................................20, 327
system logging facility .............................................264 interactive-commands, system logging facility ................264
flag statements interface address
BGP protocol ...................................................283, 284 ping command ........................................................202
IS-IS protocol ...........................................286, 289, 291 traceroute command ...............................................202
OSPF protocol .................................................293, 297 interfaces
routing options ........................................................275 checking for problems .............................................102
specific protocol ......................................................278 detailed information, displaying ..............................103
flash drive, internal ...........................................................82 monitor interface command....................................107
Flexible PIC Concentrator See FPC monitor interface traffic command..................190, 191
flooding, OSPF protocol tracing flag................................295 monitor traffic interface command..........................193
Forwarding Engine Board See FEB output control keys, table ........................................108
forwarding tables router, logging .....................................................61, 80
figure...........................................................................5 show interfaces terse command ..............................102
IS-IS route, verifying ................................................123 summary information, displaying............................102
Packet Forwarding Engine...........................................4 system logging.........................................................109
FPC internal flash drive ............................................................63
definition.................................................................310 IS-IS protocol...................................................................116
M-series and T-series platforms .................................10 adjacencies
framing errors.................................................................107 status................................................................119
free disk space, displaying ................................................63 verifying ...........................................................120
ftp command..................................................305, 309, 318 checklist for verifying ..............................................111
configuration
G Level 1 router ...................................................116
general, tracing flag ........................................................276 Level 1/Level 2 router .......................................114
GFPC ..............................................................................310 Level 2 router ...................................................117
Gibson Flexible PIC Concentrator See GFPC detail statement...............................................286, 291
global tracing flags..........................................................279 displaying details .....................................................286
groups statement ............................................................234 edit protocols isis traceoptions command286, 289, 291
groups, configuring .........................................................234 flag statement..........................................286, 289, 291
gzip command................................................304, 308, 316 hello statement........................................................289
isis traceoptions statement ......................................286
Index ! 347
JUNOS Baseline Network Operations Guide
348 ! Index
Index
Index ! 349
JUNOS Baseline Network Operations Guide
350 ! Index
Index
Index ! 351
JUNOS Baseline Network Operations Guide
352 ! Index
Index
severity levels, table ................................................251, 265 show route command .............................31, 33, 34, 85, 121
SFM, Packet Forwarding Engine component ...................310 BGP protocol
shell prompts..................................................................317 EBGP over IBGP................................................175
show bgp summary command .....................62, 81, 87, 166 IGP cost ............................................................176
show chassis alarms command ..................................14, 97 local preference................................................173
show chassis command ......................................14, 96, 240 MED .................................................................174
table ..........................................................................96 OSPF protocol..........................................................148
show chassis craft-interface command .................14, 93, 94 show route extensive command .....................................151
show chassis environment command.............14, 78, 87, 95 show route forwarding-table command...........................177
show chassis firmware command.....................................14 show route forwarding-table destination command 123, 151
show chassis hardware command ..14, 60, 77, 87, 100, 228 show route receive-protocol bgp command.....................170
show chassis hardware command output fields, table.....230 show route summary command .....................................183
show chassis routing-engine command ..........................213 show syslog messages command............................311, 317
show cli history command show system boot-messages command ......................78, 87
usage guidelines ......................................................337 show system processes extensive command ......40, 42, 180
show command output, table ..............................................................41
usage guidelines ....................19, 21, 50, 322, 328, 335 show system storage command............................63, 82, 87
show configuration command ..............................32, 50, 54 show system uptime command ......................................240
ABR .........................................................................135 show system users command .........................................248
ASBR .......................................................................132 output fields, table ...................................................248
BGP protocol show task command.......................................................185
border router....................................................162 show task memory command ........................................185
internal router ..................................................159 show task memory detail command ...............................183
log active .......................................................61, 80, 87 show version brief command, JUNOS software packages..47
OSPF protocol .........................................132, 135, 139 show version command............................................76, 305
stub router...............................................................139 compare information.................................................87
usage guidelines ................................................50, 335 core files, Packet Forwarding Engine ...............316, 317
show configuration snmp command...............................209 daemon core files, Routing Engine ..........................308
show firewall filter command .........................................195 definition ...................................................................14
show firewall log command ............................................194 JUNOS software .........................................................46
show interface terse command.............................61, 80, 87 reinstalling software ..................................................76
show interfaces extensive command ..............................103 Routing Engine ........................................................304
show interfaces terse command .....................................102 upgrading software....................................................59
show isis adjacency brief command .....................62, 81, 87 single area border router, OSPF.......................................130
show isis adjacency command........................................120 SNMP, show chassis routing-engine command................213
show isis database command .........................................124 snmpd, Routing Engine daemon.....................................306
show isis database extensive command..........................126 snmpget command
show isis route command ...............................................121 MIB, querying ..........................................................210
show log chassisd command ......................................15, 98 snmpwalk command
show log command ................................................254, 270 CPU utilization .........................................................219
show log messages command ............................14, 97, 109 CPU utilization per process, checking ......................220
show log snmpd command memory utilization
MIB, querying..........................................................211 checking...........................................................213
show ntp associations command ....................................243 checking per process ........................................215
show ntp status command..............................................244 specific OID .............................................................207
output fields, table...................................................244 version information .................................................223
show nvram command...........................................311, 317 software processes, restarting ...........................................40
show ospf database asbrsummary extensive command .154 software, JUNOS................................................................69
show ospf database command ...............................145, 148 architecture, figure ..................................................301
show ospf database extern extensive command.............155 backing up...........................................................71, 87
show ospf database netsummary extensive command ...153 checklist for reinstalling .............................................73
show ospf database nssa extensive command ................156 comparing before and after upgrade .........................71
show ospf database router extensive command .............152 downloading........................................................64–66
show ospf interface command........................132, 135, 139 logging hardware version ....................................60, 77
show ospf neighbor brief command .....................62, 81, 87 logging software version ......................59, 76, 304, 316
show ospf neighbor command .......................................142 packages
output fields, table...................................................143 adding new ..................................................67, 69
show pfe statistics traffic command................................196 copying ..............................................................69
show route advertising-protocol bgp command ..............169 list of ..................................................................67
logging .........................................................59, 76
Index ! 353
JUNOS Baseline Network Operations Guide
354 ! Index
Index
U
up command
usage guidelines ................................................21, 328
update command
usage guidelines ................................................21, 328
update statement, BGP protocol..............................281, 283
update, BGP protocol tracing flag ....................................283
upgrade JUNOS software
backing up.................................................................71
checklist for upgrading ..............................................57
comparing software.............................................71, 87
copying, adding and starting .....................................69
from 4x to 5.0 ...........................................................68
reinstalling.................................................................73
saving log information...............................................75
user
accounts, checklist ..................................................247
configuring ..............................................................266
currently editing the configuration, checking...........249
forcing messages to all ............................................255
system logging facility .............................................264
terminal, logging messages to .................................266
utility, gzip ..............................................................304, 316
V
version information
JUNOS software...............................................304, 316
snmpwalk command...............................................223
vmcore file, compressing ................................................304
vrrpd, Routing Engine daemon .......................................307
vty command .................................................................314
vty session..............................................................311, 314
W
warning, severity level ....................................................265
Index ! 355
JUNOS Baseline Network Operations Guide
356 ! Index