Cisco XR 12000 User 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 for the
Cisco XR 12000 Series Router
Cisco IOS XR Software Release 4.1
Text Part Number: OL-24755-01

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.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at
www.cisco.com/go/trademarks. Third party trademarks mentioned 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. (1005R)
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 for the Cisco XR 12000 Series Router
Copyright © 2010-2011Cisco Systems, Inc. All rights reserved.

iii
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01
CONTENTS
Preface ix
Changes to This Document ix
About This Document ix
Obtaining Documentation and Submitting a Service Request xi
Introduction to Cisco IOS XR Software 1-1
Contents 1-1
Supported Standalone System Configurations 1-1
Cisco XR 12000 Series Router Overview 1-2
Features and Capabilities 1-2
Router Management Interfaces 1-7
Command-Line Interface 1-7
Extensible Markup Language API 1-8
Simple Network Management Protocol 1-8
Selecting and Identifying the Designated Shelf Controller 1-9
Selecting and Identifying the DSC on Cisco XR 12000 and 12000 Series Routers 1-9
Verifying the DSC 1-9
Connecting to the Router Through the Console Port 1-10
Where to Go Next 1-16
Bringing Up the Cisco IOS XR Software on a Standalone Router 2-17
Contents 2-17
Prerequisites 2-17
Software Requirements 2-18
Hardware Prerequisites and Documentation 2-18
Bringing Up and Configuring a Standalone Router 2-19
Verifying the System After Initial Boot 2-20
Where to Go Next 2-25
Configuring General Router Features 3-27
Contents 3-27
Secure Domain Routers 3-27

Contents
iv
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01
Connecting and Communicating with the Router 3-28
Establishing a Connection Through the Console Port 3-32
Establishing a Connection Through a Terminal Server 3-34
Establishing a Connection Through the Management Ethernet Interface 3-36
Logging In to a Router or an SDR 3-36
CLI Prompt 3-37
User Access Privileges 3-38
User Groups, Task Groups, and Task IDs 3-39
Predefined User Groups 3-40
Displaying the User Groups and Task IDs for Your User Account 3-41
Navigating the Cisco IOS XR Command Modes 3-43
Identifying the Command Mode in the CLI Prompt 3-44
Summary of Common Command Modes 3-45
Entering EXEC Commands from a Configuration Mode 3-47
Command Mode Navigation Example 3-48
Managing Configuration Sessions 3-49
Displaying the Active Configuration Sessions 3-51
Starting a Configuration Session 3-52
Starting an Exclusive Configuration Session 3-53
Displaying Configuration Details with show Commands 3-54
Saving the Target Configuration to a File 3-60
Loading the Target Configuration from a File 3-61
Loading an Alternative Configuration at System Startup 3-61
Clearing All Changes to a Target Configuration 3-61
Committing Changes to the Running Configuration 3-62
Reloading a Failed Configuration 3-64
Exiting a Configuration Submode 3-64
Returning Directly to Configuration Mode from a Submode 3-65
Ending a Configuration Session 3-65
Aborting a Configuration Session 3-65
Configuring the SDR Hostname 3-66
Configuring the Management Ethernet Interface 3-66
Specifying the Management Ethernet Interface Name in CLI Commands 3-67
Displaying the Available Management Ethernet Interfaces 3-67
Configuring the Management Ethernet Interface 3-68
Manually Setting the Router Clock 3-72
Where to Go Next 3-74

Contents
v
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01
Configuring Additional Router Features 4-75
Contents 4-75
Configuring the Domain Name and Domain Name Server 4-75
Configuring Telnet, HTTP, and XML Host Services 4-77
Prerequisites 4-77
Managing Configuration History and Rollback 4-81
Displaying the Commit IDs 4-82
Displaying the Configuration Changes Recorded in a Commit ID 4-82
Previewing Rollback Configuration Changes 4-83
Rolling Back the Configuration to a Specific Rollback Point 4-83
Rolling Back the Configuration over a Specified Number of Commits 4-84
Loading Commit ID Configuration Changes to the Target Configuration 4-84
Loading Rollback Configuration Changes to the Target Configuration 4-85
Deleting Commit IDs 4-86
Configuring Logging and Logging Correlation 4-86
Logging Locations and Severity Levels 4-87
Alarm Logging Correlation 4-87
Configuring Basic Message Logging 4-88
Disabling Console Logging 4-90
Creating and Modifying User Accounts and User Groups 4-90
Displaying Details About User Accounts, User Groups, and Task IDs 4-91
CLI Tips, Techniques, and Shortcuts 5-93
Contents 5-93
CLI Tips and Shortcuts 5-93
Entering Abbreviated Commands 5-93
Using the Question Mark (?) to Display On-Screen Command Help 5-94
Completing a Partial Command with the Tab Key 5-96
Identifying Command Syntax Errors 5-96
Using the no Form of a Command 5-97
Editing Command Lines that Wrap 5-97
Displaying System Information with show Commands 5-98
Common show Commands 5-98
Browsing Display Output When the --More-- Prompt Appears 5-99
Halting the Display of Screen Output 5-100
Redirecting Output to a File 5-100

Contents
vi
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01
Narrowing Output from Large Configurations 5-100
Filtering show Command Output 5-102
show parser dump command 5-105
Accessing Admin Commands from Secure Domain Router Mode 5-105
Location Keyword for the File Command 5-105
vty / Console Timestamp 5-106
Displaying Interfaces by Slot Order 5-106
Displaying Unconfigured Interfaces 5-107
Displaying Subnet Mask in CIDR Format 5-108
Wildcards, Templates, and Aliases 5-109
Using Wildcards to Identify Interfaces in show Commands 5-109
Creating Configuration Templates 5-110
Applying Configuration Templates 5-112
Aliases 5-113
Keystrokes Used as Command Aliases 5-114
Command History 5-114
Displaying Previously Entered Commands 5-114
Recalling Previously Entered Commands 5-114
Recalling Deleted Entries 5-115
Redisplaying the Command Line 5-115
Displaying Persistent CLI History 5-115
Key Combinations 5-116
Key Combinations to Move the Cursor 5-116
Keystrokes to Control Capitalization 5-117
Keystrokes to Delete CLI Entries 5-118
Transposing Mistyped Characters 5-118
Troubleshooting the Cisco IOS XR Software 6-119
Contents 6-119
Additional Sources of Information 6-119
Basic Troubleshooting Commands 6-119
Using show Commands to Display System Status and Configuration 6-120
Using the ping Command 6-121
Using the traceroute Command 6-122
Using debug Commands 6-123
Configuration Error Messages 6-127
Configuration Failures During a Commit Operation 6-127

Contents
vii
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01
Configuration Errors at Startup 6-127
Memory Warnings in Configuration Sessions 6-128
Understanding Low-Memory Warnings in Configuration Sessions 6-128
Displaying System Memory Information 6-129
Removing Configurations to Resolve Low-Memory Warnings 6-130
Contacting TAC for Additional Assistance 6-132
Interfaces Not Coming Up 6-132
Verifying the System Interfaces 6-132
Understanding Regular Expressions, Special Characters, and Patterns A-137
Contents A-137
Regular Expressions A-137
Special Characters A-138
Character Pattern Ranges A-138
Multiple-Character Patterns A-139
Complex Regular Expressions Using Multipliers A-139
Pattern Alternation A-140
Anchor Characters A-140
Underscore Wildcard A-140
Parentheses Used for Pattern Recall A-141
G LOSSARY
I NDEX

Contents
viii
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01

ix
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01
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 and Submitting a Service Request, page xi
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 for the Cisco XR
12000 Series Router and related documents:
•Intended Audience, page x
•Organization of the Document, page x
•Related Documents, page x
•Conventions, page xi
Table 1 Changes to This Document
Revision Date Change Summary
OL-24755-01 April 2011 Initial release of this document.

Preface
x
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router
OL-24755-01
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:
•Introduction to Cisco IOS XR Software
•Bringing Up the Cisco IOS XR Software on a Standalone Router
•Configuring General Router Features
•Configuring Additional Router Features
•CLI Tips, Techniques, and Shortcuts
•Troubleshooting the Cisco IOS XR Software
•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 URLs:
•Cisco IOS XR Software Documentation
http://www.cisco.com/en/US/products/ps5845/tsd_products_support_series_home.html
– Cisco IOS XR ROM Monitor Guide
Cisco IOS XR System Management Configuration Guide
Cisco IOS XR System Security Configuration Guide
Cisco IOS XR Routing Configuration Guide
Cisco IOS XR Interface and Hardware Component Configuration Guide
http://www.cisco.com/en/US/products/ps5845/
products_installation_and_configuration_guides_list.html
– Cisco IOS XR Interface and Hardware Component Command Reference
Cisco IOS XR Routing Command Reference
http://www.cisco.com/en/US/products/ps5845/prod_command_reference_list.html
•Cisco XR 12000 Series Router Documentation
http://www.cisco.com/en/US/products/ps6342/tsd_products_support_series_home.html
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-1.