Cisco Router Cisco IOS XR, IOS XR 3.4 Getting Started Manual

Americas Headquarters

Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]

800 553-NETS (6387)

Fax: [phone]

Cisco IOS XR Getting Started Guide

Cisco IOS XR Software Release 3.4

Text Part Number: OL-10957-02

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the
document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

Cisco IOS XR Getting Started Guide

© 2007 Cisco Systems, Inc. All rights reserved.

CCVP, the Cisco Logo, and the Cisco Square Bridge logo are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems,
Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco
Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing,
FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream,
Linksys, MeetingPlace, MGX, Networking Academy, Network Registrar, Pac k et , PIX, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StackWise, The Fastest Way
to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship
between Cisco and any other company. (0612R)

iii

Cisco IOS XR Getting Started Guide

OL-10957-02

CONTENTS

Preface ix

Changes to This Document ix

About This Document ix

Intended Audience x
Organization of the Document x
Related Documents x
Conventions xi

Obtaining Documentation xi

Cisco.com xi
Product Documentation DVD xii
Ordering Documentation xii

Documentation Feedback xii

Cisco Product Security Overview xii

Reporting Security Problems in Cisco Products xiii

Product Alerts and Field Notices xiii

Obtaining Technical Assistance xiv

Cisco Technical Support & Documentation Website xiv
Submitting a Service Request xv
Definitions of Service Request Severity xv

Obtaining Additional Publications and Information xv

CHAPTER

1 Introduction to Cisco IOS XR Software 1-1

Contents 1-1

Supported Standalone System Configurations 1-1

Cisco CRS-1 Multishelf System Overview 1-2

Router Management Interfaces 1-6

Command-Line Interface 1-6
Craft Works Interface 1-6
Extensible Markup Language API 1-6
Simple Network Management Protocol 1-7

Selecting and Identifying the Designated Shelf Controller 1-7

Selecting and Identifying the DSC on Cisco CRS-1 Routers 1-8
Selecting and Identifying the DSC on Cisco CRS-1 Multishelf Systems 1-8
Selecting and Identifying the DSC on Cisco XR 12000 and 12000 Series Routers 1-9

Contents

iv

Cisco IOS XR Getting Started Guide

OL-10957-02

Connecting to the Router Through the Console Port 1-9

Where to Go Next 1-14

CHAPTER

2 Bringing Up the Cisco IOS XR Software on a Standalone Router 2-1

Contents 2-1

Prerequisites 2-1

Software Requirements 2-1
Hardware Prerequisites and Documentation 2-2

Bringing Up and Configuring a Standalone Router 2-2

Verifying the System After Initial Bring-Up 2-4

Where to Go Next 2-8

CHAPTER

3 Bringing Up the Cisco IOS XR Software on a Multishelf System 3-1

Contents 3-1

Prerequisites 3-1

Software Requirements 3-1
Hardware Requirements 3-2

Restrictions 3-2

Information About Bringing Up a Multishelf System 3-3

Bringup Overview 3-3
Preparing a Rack Number Plan 3-3

Configuring the External Cisco Catalyst 6509 Switches 3-8

Prerequisites 3-9
Restrictions 3-10
Before You Begin 3-10
Information About the Catalyst Switch Configuration 3-11
Configuring the Catalyst Switches 3-11
Verifying the Catalyst Switch 3-18

Integrated Switch System 3-20

Prerequisites for an Integrated Switch System 3-20
Restrictions for an Integrated Switch System 3-21
Before You Begin 3-21
Information About the Integrated Switch Implementation 3-21
Implementing the Integrated Switch System 3-23
Verifying the Connections of the Integrated Switch Control Network 3-25

Bringing Up and Configuring Rack 0 3-28

Bringing Up and Verifying FCCs 3-34

Bringing Up and Verifying the Non-DSC LCC 3-37

Contents

v

Cisco IOS XR Getting Started Guide

OL-10957-02

Verifying the Spanning Tree 3-39

Verifying Fabric Cabling Connections 3-43

Where to Go Next 3-47

CHAPTER

4 Configuring General Router Features 4-1

Contents 4-1

Secure Domain Routers 4-1

Connecting and Communicating with the Router 4-2

Establishing a Connection Through the Console Port 4-6
Establishing a Connection Through a Terminal Server 4-8
Establishing a Connection Through the Management Ethernet Interface 4-10

Logging In to a Router or an SDR 4-11

CLI Prompt 4-12

User Access Privileges 4-13

User Groups, Task Groups, and Task IDs 4-13
Predefined User Groups 4-14
Displaying the User Groups and Task IDs for Your User Account 4-14

Navigating the Cisco IOS XR Command Modes 4-17

Identifying the Command Mode in the CLI Prompt 4-18
Summary of Common Command Modes 4-19
Entering EXEC Commands from a Configuration Mode 4-21
Command Mode Navigation Example 4-22

Managing Configuration Sessions 4-23

Displaying the Active Configuration Sessions 4-24
Starting a Configuration Session 4-25
Starting an Exclusive Configuration Session 4-26
Displaying Configuration Details with show Commands 4-26
Saving the Target Configuration to a File 4-33
Loading the Target Configuration from a File 4-33
Loading an Alternative Configuration at System Startup 4-33
Clearing All Changes to a Target Configuration 4-34
Committing Changes to the Running Configuration 4-34
Reloading a Failed Configuration 4-36
Exiting a Configuration Submode 4-37
Returning Directly to Configuration Mode from a Submode 4-37
Ending a Configuration Session 4-37
Aborting a Configuration Session 4-38

Configuring the SDR Hostname 4-38

Contents

vi

Cisco IOS XR Getting Started Guide

OL-10957-02

Configuring the Management Ethernet Interface 4-39

Specifying the Management Ethernet Interface Name in CLI Commands 4-39
Displaying the Available Management Ethernet Interfaces 4-40
Configuring the Management Ethernet Interface 4-41

Manually Setting the Router Clock 4-44

Where to Go Next 4-46

CHAPTER

5 Configuring Additional Router Features 5-1

Contents 5-1

Configuring the Domain Name and Domain Name Server 5-1

Configuring Telnet, HTTP, and XML Host Services 5-2

Prerequisites 5-2

Managing Configuration History and Rollback 5-3

Displaying the CommitIDs 5-4
Displaying the Configuration Changes Recorded in a CommitID 5-4
Previewing Rollback Configuration Changes 5-5
Rolling Back the Configuration to a Specific Rollback Point 5-6
Rolling Back the Configuration over a Specified Number of Commits 5-6
Loading CommitID Configuration Changes to the Target Configuration 5-7
Loading Rollback Configuration Changes to the Target Configuration 5-8
Deleting CommitIDs 5-8

Configuring Logging and Logging Correlation 5-9

Logging Locations and Severity Levels 5-9
Alarm Logging Correlation 5-10
Configuring Basic Message Logging 5-10
Disabling Console Logging 5-12

Creating and Modifying User Accounts and User Groups 5-13

Displaying Details About User Accounts, User Groups, and Task IDs 5-13
Configuring User Accounts 5-14
Creating Users and Assigning Groups 5-14

Configuration Limiting 5-16

Static Route Configuration Limits 5-16
IS-IS Configuration Limits 5-17
OSPFv2 and v3 Configuration Limits 5-17
BGP Configuration Limits 5-20
Routing Policy Language Line and Policy Limits 5-21
Multicast Configuration Limits 5-23
MPLS Configuration Limits 5-23
Other Configuration Limits 5-24

Contents

vii

Cisco IOS XR Getting Started Guide

OL-10957-02

CHAPTER

6 CLI Tips, Techniques, and Shortcuts 6-1

Contents 6-1

CLI Tips and Shortcuts 6-1

Entering Abbreviated Commands 6-2
Using the Question Mark (?) to Display On-Screen Command Help 6-2
Completing a Partial Command with the Tab Key 6-4
Identifying Command Syntax Errors 6-4
Using the no Form of a Command 6-5
Editing Command Lines that Wrap 6-5

Displaying System Information with show Commands 6-5

Common show Commands 6-6
Browsing Display Output when the --More-- Prompt Appears 6-7
Halting the Display of Screen Output 6-7
Redirecting Output to a File 6-8
Narrowing Output from Large Configurations 6-8
Filtering show Command Output 6-9

Wildcards, Templates, and Aliases 6-11

Using Wildcards to Identify Interfaces in show Commands 6-11
Creating Configuration Templates 6-12
Applying Configuration Templates 6-14
Aliases 6-15
Keystrokes Used as Command Aliases 6-16

Command History 6-16

Displaying Previously Entered Commands 6-16
Recalling Previously Entered Commands 6-17
Recalling Deleted Entries 6-17
Redisplaying the Command Line 6-17

Key Combinations 6-18

Key Combinations to Move the Cursor 6-18
Keystrokes to Control Capitalization 6-18
Keystrokes to Delete CLI Entries 6-19
Transposing Mistyped Characters 6-19

CHAPTER

7 Troubleshooting the Cisco IOS XR Software 7-1

Contents 7-1

Additional Sources for Information 7-1

Basic Troubleshooting Commands 7-1

Using show Commands to Display System Status and Configuration 7-2

Contents

viii

Cisco IOS XR Getting Started Guide

OL-10957-02

Using the ping Command 7-3
Using the traceroute Command 7-4
Using debug Commands 7-5

Configuration Error Messages 7-7

Configuration Failures During a Commit Operation 7-8
Configuration Errors at Startup 7-8

Memory Warnings in Configuration Sessions 7-9

Understanding Low-Memory Warnings in Configuration Sessions 7-9
Displaying System Memory Information 7-10
Removing Configurations to Resolve Low-Memory Warnings 7-11
Contacting TAC for Additional Assistance 7-13

Interfaces Not Coming Up 7-13

Verifying the System Interfaces 7-13

APPENDIX

A Understanding Regular Expressions, Special Characters, and Patterns A-1

Regular Expressions A-1

Special Characters A-2

Character Pattern Ranges A-2

Multiple-Character Patterns A-3

Complex Regular Expressions Using Multipliers A-3

Pattern Alternation A-4

Anchor Characters A-4

Underscore Wildcard A-4

Parentheses Used for Pattern Recall A-4

G

LOSSARY

I

NDEX

ix

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

This guide describes how to create the initial configuration for a router using the
Cisco IOS XR software. This guide also describes how to complete additional administration,
maintenance, and troubleshooting tasks that may be required after initial configuration.

This preface contains the following sections:

• Changes to This Document, page ix

• About This Document, page ix

• Obtaining Documentation, page xi

• Documentation Feedback, page xii

• Cisco Product Security Overview, page xii

• Product Alerts and Field Notices, page xiii

• Obtaining Technical Assistance, page xiv

• Obtaining Additional Publications and Information, page xv

Changes to This Document

Table 1 lists the technical changes made to this document since it was first printed.

About This Document

The following sections provide information about Cisco IOS XR Getting Started Guide and related
documents:

Table 1 Changes to This Document

Revision Date Change Summary

OL-10957-02 February 2007 Chapter 3, “Bringing Up the Cisco IOS XR Software on a

Multishelf System” was modified as follows:

• Added the 22-port shelf controller Gigabit Ethernet (22-port

SCGE) card. See “Integrated Switch System” section on

page 20.

OL-10957-01 October 2006 Initial release of the document.

x

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

About This Document

• Intended Audience, page x

• Organization of the Document, page x

• Related Documents, page x

• Conventions, page xi

Intended Audience

This document is intended for the following people:

• Experienced service provider administrators

• Cisco telecommunications management engineers

• Third-party field service technicians who have completed the Cisco IOS XR software training

sessions

• Customers who daily use and manage routers running Cisco IOS XR software

Organization of the Document

This document contains the following chapters:

• Chapter 1, “Introduction to Cisco IOS XR Software”

• Chapter 2, “Bringing Up the Cisco IOS XR Software on a Standalone Router”

• Chapter 3, “Bringing Up the Cisco IOS XR Software on a Multishelf System”

• Chapter 4, “Configuring General Router Features”

• Chapter 5, “Configuring Additional Router Features”

• Chapter 6, “CLI Tips, Techniques, and Shortcuts”

• Chapter 7, “Troubleshooting the Cisco IOS XR Software”

• Appendix A, “Understanding Regular Expressions, Special Characters, and Patterns”

Related Documents

For a complete listing of available documentation for the Cisco IOS XR software and the routers on
which it operates, see the following Web pages:

• Cisco IOS XR Software Documentation

http://www.cisco.com/univercd/cc/td/doc/product/ioxsoft/index.htm

• Cisco CRS-1 Carrier Routing System Documentation

http://www.cisco.com/univercd/cc/td/doc/product/core/crs/

• Cisco 12000 Series Router Documentation

http://www.cisco.com/univercd/cc/td/doc/product/lan/cat6000/index.htm

• Cisco Catalyst 6509 Switch Documentation

http://www.cisco.com/en/US/products/hw/switches/ps708/
tsd_products_support_series_home.html

xi

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

Obtaining Documentation

Note Cisco IOS XR software runs only on the Cisco XR 12000 Series Routers listed in the “Supported

Standalone System Configurations” section on page 1 in Chapter 1, “Introduction to Cisco IOS XR
Software.”

Conventions

This document uses the following conventions:

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the

publication.

Tip Means the following information will help you solve a problem. The information in tips might not be

troubleshooting or an action, but contains useful information.

Caution Means reader be careful. In this situation, you might do something that could result in equipment

damage or loss of data.

Obtaining Documentation

Cisco documentation and additional literature are available on Cisco.com. This section explains the
product documentation resources that Cisco offers.

Cisco.com

You can access the most current Cisco documentation at this URL:

http://www.cisco.com/techsupport

Item Convention

Commands and keywords boldface font

Variable for which you supply values italic font

Displayed session and system information

screen font

Commands and keywords you enter in an
interactive environment

boldface screen font

Variables you enter in an interactive environment

italic screen

font

Menu items and button names boldface font

Menu navigation Option > Network Preferences

xii

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

Documentation Feedback

You can access the Cisco website at this URL:

http://www.cisco.com

You can access international Cisco websites at this URL:

http://www.cisco.com/public/countries_languages.shtml

Product Documentation DVD

The Product Documentation DVD is a library of technical product documentation on a portable medium.
The DVD enables you to access installation, configuration, and command guides for Cisco hardware and
software products. With the DVD, you have access to the HTML documentation and some of the
PDF files found on the Cisco website at this URL:

http://www.cisco.com/univercd/home/home.htm

The Product Documentation DVD is created monthly and is released in the middle of the month. DVDs
are available singly or by subscription. Registered Cisco.com users can order a Product Documentation
DVD (product number DOC-DOCDVD= or DOC-DOCDVD=SUB) from Cisco Marketplace at the
Product Documentation Store at this URL:

http://www.cisco.com/go/marketplace/docstore

Ordering Documentation

You must be a registered Cisco.com user to access Cisco Marketplace. Registered users may order
Cisco documentation at the Product Documentation Store at this URL:

http://www.cisco.com/go/marketplace/docstore

If you do not have a user ID or password, you can register at this URL:

http://tools.cisco.com/RPF/register/register.do

Documentation Feedback

You can provide feedback about Cisco technical documentation on the Cisco Technical Support &
Documentation site area by entering your comments in the feedback form available in every online
document.

Cisco Product Security Overview

Cisco provides a free online Security Vulnerability Policy portal at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

From this site, you will find information about how to do the following:

• Report security vulnerabilities in Cisco products

• Obtain assistance with security incidents that involve Cisco products

• Register to receive security information from Cisco

xiii

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

Product Alerts and Field Notices

A current list of security advisories, security notices, and security responses for Cisco products is
available at this URL:

http://www.cisco.com/go/psirt

To see security advisories, security notices, and security responses as they are updated in real time, you
can subscribe to the Product Security Incident Response Team Really Simple Syndication (PSIRT RSS)
feed. Information about how to subscribe to the PSIRT RSS feed is found at this URL:

http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

Reporting Security Problems in Cisco Products

Cisco is committed to delivering secure products. We test our products internally before we release them,
and we strive to correct all vulnerabilities quickly. If you think that you have identified a vulnerability
in a Cisco product, contact PSIRT:

• For emergencies only— [e-mail]

An emergency is either a condition in which a system is under active attack or a condition for which
a severe and urgent security vulnerability should be reported. All other conditions are considered
nonemergencies.

• For nonemergencies —[e-mail]

In an emergency, you can also reach PSIRT by telephone:

• 1 877 228-7302

• 1 408 525-6532

Tip We encourage you to use Pretty Good Privacy (PGP) or a compatible product (for example, GnuPG) to

encrypt any sensitive information that you send to Cisco. PSIRT can work with information that has been
encrypted with PGP versions 2.x through 9.x.

Never use a revoked encryption key or an expired encryption key. The correct public key to use in your
correspondence with PSIRT is the one linked in the Contact Summary section of the Security
Vulnerability Policy page at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

The link on this page has the current PGP key ID in use.

If you do not have or use PGP, contact PSIRT to find other means of encrypting the data before sending
any sensitive material.

Product Alerts and Field Notices

Modifications to or updates about Cisco products are announced in Cisco Product Alerts and Cisco Field
Notices. You can receive Cisco Product Alerts and Cisco Field Notices by using the Product Alert Tool
on Cisco.com. This tool enables you to create a profile and choose those products for which you want to
receive information.

xiv

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

Obtaining Technical Assistance

To access the Product Alert Tool, you must be a registered Cisco.com user. (To register as a Cisco.com
user, go to this URL: http://tools.cisco.com/RPF/register/register.do) Registered users can access the
tool at this URL: http://tools.cisco.com/Support/PAT/do/ViewMyProfiles.do?local=en

Obtaining Technical Assistance

Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The
Cisco Technical Support & Documentation website on Cisco.com features extensive online support
resources. In addition, if you have a valid Cisco service contract, Cisco Technical Assistance Center
(TAC) engineers provide telephone support. If you do not have a valid Cisco service contract, contact
your reseller.

Cisco Technical Support & Documentation Website

The Cisco Technical Support & Documentation website provides online documents and tools for
troubleshooting and resolving technical issues with Cisco products and technologies. The website is
available 24 hours a day at this URL:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com
user ID and password. If you have a valid service contract but do not have a user ID or password, you
can register at this URL:

http://tools.cisco.com/RPF/register/register.do

Note Use the Cisco Product Identification Tool to locate your product serial number before submitting a

request for service online or by phone. You can access this tool from the Cisco Technical Support &
Documentation website by clicking the Tools & Resources link, clicking the All Tools (A-Z) tab, and
then choosing Cisco Product Identification Tool from the alphabetical list. This tool offers three search
options: by product ID or model name; by tree view; or, for certain products, by copying and pasting
show command output. Search results show an illustration of your product with the serial number label
location highlighted. Locate the serial number label on your product and record the information before
placing a service call.

Tip Displaying and Searching on Cisco.com

If you suspect that the browser is not refreshing a web page, force the browser to update the web page
by holding down the Ctrl key while pressing F5.

To find technical information, narrow your search to look in technical documentation, not the entire
Cisco.com website. On the Cisco.com home page, click the Advanced Search link under the Search box
and then click the Technical Support & Documentation.radio button.

To provide feedback about the Cisco.com website or a particular technical document, click Contacts &
Feedback at the top of any Cisco.com web page.

xv

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

Obtaining Additional Publications and Information

Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and
S4 service requests are those in which your network is minimally impaired or for which you require
product information.) After you describe your situation, the TAC Service Request Tool provides
recommended solutions. If your issue is not resolved using the recommended resources, your service
request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:

http://www.cisco.com/techsupport/servicerequest

For S1 or S2 service requests, or if you do not have Internet access, contact the Cisco TAC by telephone.
(S1 or S2 service requests are those in which your production network is down or severely degraded.)
Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business
operations running smoothly.

To open a service request by telephone, use one of the following numbers:

Asia-Pacific: [phone]
Australia: 1 800 805 227
EMEA: [phone]
USA: 1 800 553 2447

For a complete list of Cisco TAC contacts, go to this URL:

http://www.cisco.com/techsupport/contacts

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity
definitions.

Severity 1 (S1)—An existing network is “down” or there is a critical impact to your business operations.
You and Cisco will commit all necessary resources around the clock to resolve the situation.

Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your
business operations are negatively affected by inadequate performance of Cisco products. You and
Cisco will commit full-time resources during normal business hours to resolve the situation.

Severity 3 (S3)—Operational performance of the network is impaired while most business operations
remain functional. You and Cisco will commit resources during normal business hours to restore service
to satisfactory levels.

Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or
configuration. There is little or no effect on your business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online
and printed sources.

• The Cisco Product Quick Reference Guide is a handy, compact reference tool that includes brief

product overviews, key features, sample part numbers, and abbreviated technical specifications for
many Cisco products that are sold through channel partners. It is updated twice a year and includes
the latest Cisco channel product offerings. To order and find out more about the Cisco Product Quick
Reference Guide, go to this URL:

http://www.cisco.com/go/guide

xvi

Cisco IOS XR Getting Started Guide

OL-10957-02

Preface

Obtaining Additional Publications and Information

• Cisco Marketplace provides a variety of Cisco books, reference guides, documentation, and logo

merchandise. Visit Cisco Marketplace, the company store, at this URL:

http://www.cisco.com/go/marketplace/

• Cisco Press publishes a wide range of general networking, training, and certification titles. Both new

and experienced users will benefit from these publications. For current Cisco Press titles and other
information, go to Cisco Press at this URL:

http://www.ciscopress.com

• Packet magazine is the magazine for Cisco networking professionals. Each quarter, Packet delivers

coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions,
as well as network deployment and troubleshooting tips, configuration examples, customer case
studies, certification and training information, and links to scores of in-depth online resources. You
can subscribe to Packet magazine at this URL:

http://www.cisco.com/packet

• Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering

professionals involved in designing, developing, and operating public and private internets and
intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/ipj

• Networking products offered by Cisco Systems, as well as customer support services, can be

obtained at this URL:

http://www.cisco.com/en/US/products/index.html

• Networking Professionals Connection is an interactive website where networking professionals

share questions, suggestions, and information about networking products and technologies with
Cisco experts and other networking professionals. Join a discussion at this URL:

http://www.cisco.com/discuss/networking

• “What’s New in Cisco Documentation” is an online publication that provides information about the

latest documentation releases for Cisco products. Updated monthly, this online publication is
organized by product category to direct you quickly to the documentation for your products. You
can view the latest release of “What’s New in Cisco Documentation” at this URL:

http://www.cisco.com/univercd/cc/td/doc/abtunicd/136957.htm

• World-class networking training is available from Cisco. You can view current offerings at

this URL:

http://www.cisco.com/en/US/learning/index.html

CHA PTER

1-1

Cisco IOS XR Getting Started Guide

OL-10957-02

1

Introduction to Cisco IOS XR Software

This chapter introduces the routers that support Cisco IOS XR software and the user interfaces you can
use to manage routers that run Cisco IOS XR software.

Contents

This chapter contains the following sections:

• Supported Standalone System Configurations, page 1-1

• Cisco CRS-1 Multishelf System Overview, page 1-2

• Router Management Interfaces, page 1-6

• Selecting and Identifying the Designated Shelf Controller, page 1-7

• Connecting to the Router Through the Console Port, page 1-9

• Where to Go Next, page 1-14

Supported Standalone System Configurations

The Cisco IOS XR software runs on the following standalone systems:

• Cisco CRS-1 4-Slot Line Card Chassis (LCC)

• Cisco CRS-1 8-Slot LCC

• Cisco CRS-1 16-Slot LCC

• Cisco XR 12006 Router

• Cisco XR 12008 Router

• Cisco XR 12010 Router

• Cisco XR 12012 Router

• Cisco XR 12016 Router

• Cisco XR 12404 Router

• Cisco XR 12406 Router

• Cisco XR 12410 Router

• Cisco XR 12416 Router

1-2

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Cisco CRS-1 Multishelf System Overview

Note Many cards operate in both Cisco XR 12000 Series routers and in Cisco 12000 Series routers. For the

latest information on which cards are supported by the Cisco IOS XR software in Cisco XR 12000 Series
routers and Cisco 12000 Series routers, see Release Notes for Cisco IOS XR Software Release 3.4.

The Cisco IOS XR software also runs on Cisco CRS-1 Multishelf Systems, which are described in the
following section.

Cisco CRS-1 Multishelf System Overview

The multishelf system enables multiple Cisco CRS-1 LCCs to act as a single system. This release of the
multishelf system supports two 16-slot LCCs and one, two, or four fabric card chassis (FCCs) to provide
a total switching capacity of up to 1.28 terabits per second (Tbps). Two external Cisco Catalyst switches
provide control-plane connectivity between the chassis.

Figure 1-1 shows the single-FCC multishelf system, Figure 1-2 shows the two-FCC multishelf system,

and Figure 1-3 shows the four-FCC multishelf system.

1-3

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Cisco CRS-1 Multishelf System Overview

Figure 1-1 Single-FCC Multishelf System

1 Cisco CRS-1 16-Slot Line Card Chassis (two

required)

3 Cisco Catalyst 6509 Switch (two suggested)

2 Cisco CRS-1 Fabric Card Chassis (one

required)

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

129492

1 2 1 3

3

1-4

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Cisco CRS-1 Multishelf System Overview

Figure 1-2 Two-FCC Multishelf System

1 Cisco CRS-1 16-Slot Line Card Chassis (two

required)

3 Cisco Catalyst 6509 Switch (two suggested)

2 Cisco CRS-1 Fabric Card Chassis (two

required)

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

158260

1 2 1 3

3

1-5

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Cisco CRS-1 Multishelf System Overview

Figure 1-3 Four-FCC Multishelf System

For more information on multishelf systems, see Chapter 3, “Bringing Up the Cisco IOS XR Software

on a Multishelf System.”

1 Cisco CRS-1 16-Slot Line Card Chassis (two

required)

3 Cisco Catalyst 6509 Switch (two suggested)

2 Cisco CRS-1 Fabric Card Chassis (four

required)

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

OUTPUT

FAIL

FANOKINPUT

OK

149632

1 2 1 3

3

1-6

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Router Management Interfaces

Router Management Interfaces

Because new routers are not yet configured for your environment, you must start configuration using the
command-line interface (CLI). This guide provides instructions on using the CLI to configure basic
router features. The Cisco IOS XR software supports the following router management interfaces, which
are described in the following sections:

• Command-Line Interface, page 1-6

• Craft Works Interface, page 1-6

• Extensible Markup Language API, page 1-6

• Simple Network Management Protocol, page 1-7

Command-Line Interface

The CLI is the primary user interface for configuring, monitoring, and maintaining routers that run the
Cisco IOS XR software. The CLI allows you to directly and simply execute Cisco IOS XR commands.

All procedures in this guide use the CLI. Before you can use other router management interfaces, you
must first use the CLI to install and configure those interfaces. Guidelines for using the CLI are
presented in the following chapters:

• Chapter 4, “Configuring General Router Features”

• Chapter 5, “Configuring Additional Router Features”

• Chapter 6, “CLI Tips, Techniques, and Shortcuts”

For information on CLI procedures for other tasks, such as hardware interface and software protocol
management, see the Cisco IOS XR software documents listed in the “Related Documents” section on

page x.

Craft Works Interface

The Craft Works Interface (CWI) is a client-side application used to configure and manage routers that
run the Cisco IOS XR software. CWI includes advanced CLI features and a graphical user interface, and
it is included with the Cisco IOS XR Manageability package.

The CWI is a desktop used to launch management and configuration applications. The management and
configuration features include fault management, configuration management, performance management,
security management, and inventory management, with an emphasis on speed and efficiency. For more
information, see the Cisco IOS XR software documents listed in the “Related Documents” section on

page x.

Extensible Markup Language API

The Extensible Markup Language (XML) application programming interface (API) is an XML interface
used for rapid development of client applications and perl scripts to manage and monitor the router.
Client applications can be used to configure the router or request status information from the router by
encoding a request in XML API tags and sending it to the router. The router processes the request and

1-7

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Selecting and Identifying the Designated Shelf Controller

sends the response to the client in the form of encoded XML API tags. The XML API supports readily
available transport layers, including Telnet, Secure Shell (SSH), and Common Object Request Broker
Architecture (CORBA). The Secure Socket Layer (SSL) transport is also supported by the XML API.

For more information, see the Cisco IOS XR software documents listed in the “Related Documents”

section on page x.

Simple Network Management Protocol

Simple Network Management Protocol (SNMP) is an application-layer protocol designed to facilitate
the exchange of management information between network devices. By using SNMP-transported data
(such as packets per second and network error rates), network administrators can more easily manage
network performance, find and solve network problems, and plan for network growth.

The Cisco IOS XR software supports SNMP v1, v2c, and v3. SNMP is part of a larger architecture called
the Internet Network Management Framework (NMF), which is defined in Internet documents called
RFCs. The SNMPv1 NMF is defined by RFCs 1155, 1157, and 1212, and the SNMPv2 NMF is defined
by RFCs 1441 through 1452.

SNMP is a popular protocol for managing diverse commercial internetworks and those used in
universities and research organizations. SNMP-related standardization activity continues even as
vendors develop and release state-of-the-art, SNMP-based management applications. SNMP is a
relatively simple protocol, yet its feature set is sufficiently powerful to handle the difficult problems
presented in trying to manage the heterogeneous networks of today.

For more information, see the Cisco IOS XR software documents listed in the “Related Documents”

section on page x.

Selecting and Identifying the Designated Shelf Controller

The designated shelf controller (DSC) controls a standalone router or a multishelf System. A DSC is a
role that is assigned to one route processor (RP) card or performance route processor (PRP) card in each
router or multishelf system. RP cards operate in Cisco CRS-1 routers, and PRP cards operate in
Cisco XR 12000 and 12000 Series routers.

Note Throughout this guide, the term RP is used to refer to the RP cards supported on Cisco CRS-1 routers

and the PRP cards supported on Cisco XR 12000 Series Routers. If a feature or an issue applies to only
one platform, the accompanying text specifies the platform.

Although each router or multishelf system can have multiple RP cards, only one can serve as the DSC
and control the router or multishelf system. The DSC provides system-wide administrative functions,
including:

• User configuration using a terminal connection or network connection

• Distribution of software to each node in the router or system

• Coordination of software versioning and configurations for all nodes in the router or system

• Hardware inventory and environmental monitoring

The first step in setting up a new router is to select or identify the DSC because the initial router
configuration takes place through the DSC. The following sections describe how to select and identify
the DSC on different routers and the multishelf system:

1-8

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Selecting and Identifying the Designated Shelf Controller

• Selecting and Identifying the DSC on Cisco CRS-1 Routers, page 1-8

• Selecting and Identifying the DSC on Cisco CRS-1 Multishelf Systems, page 1-8

• Selecting and Identifying the DSC on Cisco XR 12000 and 12000 Series Routers, page 1-9

Selecting and Identifying the DSC on Cisco CRS-1 Routers

A Cisco CRS-1 router supports up to two RPs. If only one RP is installed, that RP automatically becomes
the DSC. If two RPs are installed, the default configuration selects RP0 as the DSC. To select RP1 to
become the DSC for a new installation, install RP1 first, apply power to the system, and wait for RP1 to
start up. When the Primary LED on the RP1 front panel lights, RP1 is operating as the DSC, and you can
install RP0.

Tip After the router starts for the first time, you can use the redundancy reddrv command to select which

RP becomes the DSC during a restart.

The active RP and DSC lights the Primary LED on the RP front panel. The alphanumeric LED display
on the active RP displays ACTV RP. By default, the other RP becomes the standby RP, displays STBY
RP on the alphanumeric display, and takes over if the DSC fails.

To visually determine which RP is operating as the DSC in a Cisco CRS-1 router, look for the RP on
which the Primary LED is lit. You can also look for the RP that displays the ACTV RP message on the
alphanumeric display.

Selecting and Identifying the DSC on Cisco CRS-1 Multishelf Systems

A Cisco CRS-1 Multishelf System supports up to two RPs in each LCC. Each LCC must have at least
one RP, so a multishelf system supports between two and four RPs. The RPs in a multishelf system
operate much like the RPs in a standalone router. The difference is that only one LCC can host the DSC.

During the initial startup of a multishelf system, the DSC is RP0 in the LCC with the lowest configured
rack number, which is usually Rack 0. If you want to select RP1 within Rack 0 to become the DSC,
install RP1 first, and wait for RP1 to start up. When the Primary LED on the RP1 front panel lights (or
the alphanumeric display shows ACTV RP), RP1 is operating as the DSC, and you can install RP0. If
you are setting up a new multishelf system, the instructions in Chapter 3, “Bringing Up the Cisco IOS

XR Software on a Multishelf System,” specify the appropriate time to bring up and configure the DSC.

Tip After the router starts for the first time, you can use the redundancy reddrv command to select which

Rack 0 RP becomes the DSC during a restart.

The active RP and DSC lights the Primary LED on the RP front panel. The alphanumeric LED display
on the active RP displays ACTV RP. By default, the other RP becomes the standby RP, displays STBY
RP on the alphanumeric display, and takes over if the DSC fails.

After the DSC starts up in Rack 0, the DSC remains in Rack 0 while at least one RP in Rack 0 is operating
properly. If both RPs in Rack 0 fail, the active RP in the other rack becomes the DSC. The process of
moving the DSC function from one rack to another is called DSC migration. For more information on
DSC migration, see the Cisco IOS XR System Management Configuration Guide, Release 3.4.

1-9

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Connecting to the Router Through the Console Port

Note Any LCC can host the DSC. The FCC cannot host the DSC function.

Selecting and Identifying the DSC on Cisco XR 12000 and 12000 Series Routers

A Cisco XR 12000 or 12000 Series router supports multiple PRPs. When the router is started for the first
time, the PRP in the lowest-numbered slot becomes the active PRP and is identified by the alphanumeric
display: ACTV RP. The active PRP serves as the DSC. If another PRP is configured as a standby PRP
for the DSC, that PRP can assume the DSC role if the DSC fails.

To have a PRP in a higher-numbered slot become the DSC, you must bring up the router with only that
PRP installed. After the chosen PRP becomes the DSC, it remains the DSC after subsequent restarts and
you can add the other PRPs.

Note Additional PRPs can be installed to host secure domain routers (SDRs), which are introduced in

Chapter 4, “Configuring General Router Features.” To configure general router features, you must

connect to the DSC. To configure SDR features, you must connect to the PRP for the appropriate SDR.

Connecting to the Router Through the Console Port

The first time you connect to a new router with Cisco IOS XR software, you must connect through the
Console port on the DSC. Although typical router configuration and management take place using an
Ethernet port on the DSC, this port must be configured for your local area network before it can be used.

Figure 1-4 shows the RP connections on the Cisco CRS-1 16-Slot Line Card Chassis, and Figure 1-5

shows the RP connections on the Cisco CRS-1 4-Slot Line Card Chassis and Cisco CRS-1 8-Slot Line
Card Chassis. Figure 1-6 shows the PRP-2 connections on the Cisco XR 12000 Series Router.

Note Cisco IOS XR software does not support the PRP-1.

1-10

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Connecting to the Router Through the Console Port

Figure 1-4 Communication Ports on the RP for a Cisco CRS-1 16-Slot LCC

Console

AUX

PC Card

(disk1:)

MGMT ETH

CNTL ETH 1

CNTL ETH 0

Primary

Status

HDD

RP

Local terminal or

terminal server for

CLI communication

Remote terminal for

CLI communication

RJ-45 cable

Remote CLI, CWI,

XML, or SNMP
communication

RJ-45 cable

Optical Gigabit Ethernet for control
plane: (not user configurable)

116547

Network

Management Ethernet connection

for out-of-band network communciation

1-11

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Connecting to the Router Through the Console Port

Figure 1-5 Communication Ports on the RP for Cisco CRS-1 4-slot and 8-Slot LCCs

Primary
Status

Console

AUX

CRITICAL
MAJOR
MINOR

149693

Optical Gigabit Ethernet for control
plane: (not user configurable)

Terminal connection

Modem connection

Primary RP (on=primary)
Card status (green=OK)

User-removable flash disk1
stores installation PIE files

A second internal flash disk0
stores installed software and
active configurations

Management Ethernet connection
for out-of-band network communication

LED status
displays
(alphanumeric)

ALARM
PID/VID

MGMT
ETH

CNTL
ETH 0

PC
CARD

CNTL
ETH 1

EXT
CLK 1

EXT
CLK 2

Remote terminal for

CLI communication

RJ-45 cable

Local terminal or

terminal server for

CLI communication

RJ-45 cable

Remote CLI, CWI, XML,

or SNMP communication.

Remote file storage

Ethernet cable

Network

1-12

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Connecting to the Router Through the Console Port

Figure 1-6 Communication Ports on the PRP-2 for a Cisco XR 12000 Series Router

To connect to the router, perform the following procedure.

SUMMARY STEPS

1. Power on the standalone router, or power on Rack 0 in a multishelf system.

2. Identify the DSC.

3. Connect a terminal to the Console port of the DSC.

4. Start the terminal emulation program.

5. Press Enter.

ACT

SIG

ACT

SIG

SLOT-1

SLOT-0

CONSOLE ETH 2AUX

RESET

PERFORMANCE ROUTE PROCESSOR 2

BITS 1BITS 0

DATA

LINK

DATA

LINK

ETH 1ETH 0

149695

Terminal connection

Modem connection

User-removable flash disk1
stores installation PIE files

A second internal flash disk0
stores installed software and
active configurations

LED status
displays
(alphanumeric)

Remote CLI, CWI, XML,

or SNMP communication.

Remote file storage

Ethernet cable

Network

Local terminal or

terminal server for

CLI communication

RJ-45 cable

Remote terminal for

CLI communication

RJ-45 cable

Management Ethernet connection for
out-of-band network communication

1-13

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Connecting to the Router Through the Console Port

6. Log in to the router.

DETAILED STEPS

Command or Action Purpose

Step 1

Power on the standalone router, or power on Rack 0 in
a multishelf system.

Starts the router or Rack 0.

• This step is required only if the power is not on.

• For information on power installation and controls, see

the hardware documentation listed in the “Related

Documents” section on page x.

Step 2

Identify the DSC. Identifies the RP to which you must connect in the next step.

• For more information, see the “Selecting and

Identifying the Designated Shelf Controller” section on
page 1-7.

Step 3

Connect a terminal to the Console port of the DSC. Establishes a communications path to the router.

• During the initial setup, you can communicate with the

router only through the Console port of the DSC.

• The router Console port is designed for a serial cable

connection to a terminal or a computer that is running a
terminal emulation program.

• The terminal settings are:

–

Bits per second: 9600/9600

–

Data bits: 8

–

Parity: None

–

Stop bit: 2

–

Flow control: None

• For information on the cable requirements for the

Console port, see the hardware documentation listed in
the “Related Documents” section on page x.

Step 4

Start the terminal emulation program. (Optional.) Prepares a computer for router communications.

• The step is not required if you are connecting through a

terminal.

• Terminals send keystrokes to and receive characters

from another device. If you connect a computer to the
Console port, you must use a terminal emulation
program to communicate with the router. For
instructions on using the terminal emulation program,
see the documentation for that program.

1-14

Cisco IOS XR Getting Started Guide

OL-10957-02

Chapter 1 Introduction to Cisco IOS XR Software

Where to Go Next

Where to Go Next

If you have logged into the router or multishelf system, you are ready to perform general router
configuration as described in Chapter 4, “Configuring General Router Features.”

If the router is prompting you to enter a root-system username, bring up the router or multishelf system
as described in the appropriate chapter:

• Chapter 2, “Bringing Up the Cisco IOS XR Software on a Standalone Router”

• Chapter 3, “Bringing Up the Cisco IOS XR Software on a Multishelf System”

Step 5

Press Enter. Initiates communication with the router.

• If no text or router prompt appears when you connect to

the console port, press Enter to initiate
communications.

• If no text appears when you press Enter, give the router

more time to complete the initial boot procedure, then
press Enter.

• If the prompt gets lost among display messages, press

Enter again.

• If the router has no configuration, the router displays

the prompt:

Enter root-system username:

• If the router has been configured, the router displays the

prompt:

Username:

Step 6

Log in to the router. Establishes your access rights for the router management

session.

• Enter the root-system username and password or the

username and password provided by your system
administrator.

• After you log in, the router displays the CLI prompt,

which is described in the “CLI Prompt” section on

page 4-12.

• If the router prompts you to enter a root-system

username, the router is not configured, and you should
follow one of the bring up procedures mentioned in the
next section.

Command or Action Purpose