F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Cisco IOS XR Software Release
Cisco Systems, Inc 170 West Tasman Drive San Jose, CA
800 553-NETS Fax 408
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, the Cisco logo, DCE, and Welcome to the Human Network are trademarks Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Contents
Features and Capabilities
Connecting to the Router Through the Console Port
Initial Router Configuration
Configuring Gigabit Ethernet and 10-Gigabit Ethernet Interfaces
Where to Go Next
Entering Configuration Changes
Prerequisites
Viewing Configuration Error Messages Without Descriptions
Specifying the Management Ethernet Interface Name in CLI Commands
Viewing Configuration Details
Viewing the Target Configuration
Previewing Rollback Configuration Changes
Configuring Basic Message Logging
Contents
Configuration Limiting
Using the Question Mark ? to Display On-Screen Command Help
Completing a Partial Command with the Tab Key
Filtering show Command Output
Command History
Contents A-1
Using the ping Command
Disabling Debugging for All Services Started at All Terminal Sessions
Configuration Error Messages
Complex Regular Expressions Using Multipliers A-3
Parentheses Used for Pattern Recall A-4
Pattern Alternation
Anchor Characters
Contents
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
OL-17502-01
Obtaining Documentation and Submitting a Service Request, page
Preface
Changes to This Document
About This Document
Chapter 3, “Configuring General Router Features”
Chapter 4, “Configuring Additional Router Features”
Chapter 6, “Troubleshooting the Cisco IOS XR Software”
Intended Audience
Option Network Preferences
Obtaining Documentation and Submitting a Service Request
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
boldface font
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Preface
OL-17502-01
Introducing to the Cisco ASR 9000 Series Aggregation Services Router
Contents
Features and Capabilities
Router Overview, page System Configurations, page
Command-Line Interface, page Extensible Markup Language API, page
Cisco IOS XR Software
Multicast, page OAM, page Layer 3 routing, page QoS, page
MPLS TE, page Manageability, page Security, page
Flexible Ethernet
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
L2VPN
Multicast
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Layer 3 routing
MPLS VPN
MPLS TE
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
System Configurations
High Availability
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
The router uses the following line cards 40x1GE Ethernet line card
Management and Security
Manageability
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Initial Router Configuration
Management Interfaces
Security
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Command-Line Interface
Extensible Markup Language API
Simple Network Management Protocol
1-10
Connecting to the Router Through the Console Port
6. admin 7. show dsc
SUMMARY STEPS
2. Connect a terminal to the Console port
DETAILED STEPS
Documents” section on page
1-12
Command or Action
Where to Go Next
Configuring Gigabit Ethernet and 10-Gigabit Ethernet Interfaces
page
1-13
1-14
Where to Go Next
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Prerequisites, page Bringing Up and Configuring the Router, page
Verifying the System After Initial Boot, page Where to Go Next, page
Bringing Up Cisco IOS XR Software on the Router
Prerequisites
Bringing Up and Configuring the Router
Software Requirements
Hardware Prerequisites and Documentation
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
the “Connecting to the Router Through the Console
Examples
Port” section on page
Enter
Verifying the System After Initial Boot
1. show version 2. admin 3. show platform node-id 4. exit
5. show redundancy 6. show environment
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Examples of show Commands
show version Command Example
show version Command Example, page
show platform Command Example, page
show platform Command Example
show redundancy Command Example
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
show environment Command Example
show environment options
Verifying the System After Initial Boot
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Where to Go Next
Where to Go Next
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Chapter 2 Bringing Up Cisco IOS XR Software on the Router
Configuring General Router Features
Connecting to and Communicating with the Router
Connecting to and Communicating with the Router, page
Navigating Cisco IOS XR Software Command Modes, page
Connecting Through the Console Port
Connecting Through the Console Port, page
Connecting Through a Terminal Server, page
Connecting Through the Management Ethernet Interface, page
Connecting Through a Terminal Server
5. telnet access-server-address port
a Router” section on page
described in the “CLI Prompt” section on page
Aggregation Services Router System Management Configuration
Guide
section on page
documentation listed in the “Related Documents” section on page
Connecting Through the Management Ethernet Interface
Logging In to a Router
telnet ManagementEthernetInterfaceIPaddress
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Slot in which the RSP is installed. In a Cisco ASR 9000 Series router
Entity on a card that executes user commands or communicates with
a port interface. For executing commands from the EXEC prompt
initial configuration of the router, as described in the “Configuring
User Access Privileges
User Groups, Task Groups, and Task IDs
User Groups, Task Groups, and Task IDs, page
Predefined User Groups, page
show user Command Example, page show user tasks Command Example, page
show user group Command Example, page
show user all Command Example, page
show aaa usergroup Command Example, page
show user Command Example
show user tasks Command Example
show user group Command Example
show user all Command Example
show aaa usergroup Command Example
3-10
Chapter 3 Configuring General Router Features Logging In to a Router
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Navigating Cisco IOS XR Software Command Modes
Identifying the Command Mode in the CLI Prompt, page
Common Command Modes, page
Entering EXEC Commands from a Configuration Mode, page
Identifying the Command Mode in the CLI Prompt
Common Command Modes
3-12
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
protocol protocoloptions
3-13
Command Mode
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Entering EXEC Commands from a Configuration Mode
3-14
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Command Mode Navigation Example
3-15
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Managing Configuration Sessions
3-16
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Entering Configuration Changes
Entering Configuration Changes, page
Viewing Active Configuration Sessions, page
Starting a Configuration Session, page
1. configure
3. end or commit
3. commit
3-18
Viewing Active Configuration Sessions
4. end
3-19
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Starting a Configuration Session
Simple RSP Configuration Example
Simple RSP Configuration Example, page
Simple Administration Configuration Session Example, page
Starting an Exclusive Configuration Session
Viewing Configuration Details
Simple Administration Configuration Session Example
Viewing the Running Configuration, page
Viewing the Running Configuration
Viewing a Sanitized Version of the Running Configuration, page
Viewing the Target Configuration, page
Viewing a Combined Target and Running Configuration, page
Viewing a Sanitized Version of the Running Configuration
3-23
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Viewing the Target Configuration
3-24
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Viewing a Combined Target and Running Configuration
3-25
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Saving the Target Configuration to a File
Viewing Configuration Error Messages and Descriptions
Viewing Configuration Error Messages Without Descriptions
3-26
Loading the Target Configuration from a File
Loading an Alternative Configuration at System Startup
Clearing All Changes to a Target Configuration
3-27
Committing Changes to the Running Configuration
commit
commit best-effort
3-28
Command
show configuration commit list detail command
The comment option must appear at the end of the command line. If
Optional Commits the configuration in global configuration mode on a
Reloading a Failed Configuration
Committing a Configuration from Global Configuration Mode Example
3-30
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Exiting a Configuration Submode
Returning Directly to Configuration Mode from a Submode
Ending a Configuration Session
3-31
Configuring the RSP Hostname
Aborting a Configuration Session
3-32
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Configuring the Management Ethernet Interface
Specifying the Management Ethernet Interface Name in CLI Commands
routerconfig# interface MgmtEth0/RSP0/CPU0/0
routerconfig# interface MgmtEth0/RSP1/CPU0/0
routerconfig# interface MgmtEth0/5/CPU0/0
routerconfig# interface MgmtEth0/5/CPU1/0
routerconfig# interface MgmtEth0/0/CPU0/0
routerconfig# interface MgmtEth0/0/CPU0/1
Configuring the Management Ethernet Interface
1. configure 2. interface MgmtEthrack/slot/CPU0/port
Prerequisites
3. ipv4 address ipv4-address subnet-mask
0.0.0.0/0 default-gateway
3-36
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
ipv4 address ipv4-address subnet-mask
3-37
Examples
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Manually Setting the Router Clock
Cisco ASR 9000 Series Aggregation Services Router
Interface and Hardware Component Configuration Guide
6. clock update-calendar 7. show clock
3-39
RP/0/RSP0/CPU0routerconfig# clock timezone
Examples
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Cisco ASR 9000 Series Aggregation Services Router System
Management Command Reference
Management Configuration Guide
3-40
Configuring Additional Router Features
Configuring the Domain Name and Domain Name Server
Configuring the Domain Name and Domain Name Server, page
Configuring Telnet and XML Host Services, page
2. domain name domain-name-of-organization
3. domain name-server ipv4-address 4. commit or end 5. show hosts
1. configure
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Configuring Telnet and XML Host Services
Configuring Telnet and XML Host Services
Examples
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
1. configure 2. telnet ipv4 server max-servers limit 3. end or commit
Prerequisites
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
SUMMARY STEPS
Examples
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
DETAILED STEPS
Managing Configuration History and Rollback
Viewing Configuration Changes Recorded in a CommitID, page
Previewing Rollback Configuration Changes, page
Rolling Back the Configuration to a Specific Rollback Point, page
Viewing Configuration Changes Recorded in a CommitID
Viewing CommitIDs
RP/0/RSP1/CPU0router# show configuration commit list
RP/0/RSP1/CPU0routeradmin# show configuration commit changes ?
Previewing Rollback Configuration Changes
Rolling Back the Configuration to a Specific Rollback Point
RP/0/RSP1/CPU0router# show configuration rollback changes to ?
RP/0/RSP1/CPU0router# show configuration rollback changes to
Rolling Back the Configuration over a Specified Number of Commits
Loading CommitID Configuration Changes to the Target Configuration
rollback changes command
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Loading Rollback Configuration Changes to the Target Configuration
4-10
RP/0/RSP1/CPU0router# show configuration commit changes ?
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Deleting CommitIDs
4-11
RP/0/RSP0/CPU0routerconfig# load rollback changes to
RP/0/RSP0/CPU0routerconfig# load rollback changes
Configuring Logging and Logging Correlation
Alarm Logging Correlation, page
Configuring Basic Message Logging, page
Logging Locations and Severity Levels
Alarm Logging Correlation
Configuring Basic Message Logging
2. logging ip-address hostname
3. logging trap severity 4. logging console severity
4-14
RP/0/RSP0/CPU0routerconfig# logging buffered
Examples
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Cisco ASR 9000 Series Aggregation Services Router System Monitoring
Configuration Guide
Command Reference
Cisco ASR 9000 Series Aggregation Services Router XML API Guide
command without a username
group. To display all groups on the system, type the command
Viewing Details About User Accounts, User Groups, and Task IDs
show aaa userdb username
Configuring User Accounts
1. configure 2. username user-name 3. password 0 7 password or
secret 0 5 password
Creating Users and Assigning Groups
Cisco ASR 9000 Series Aggregation Services Router System Security
4-18
Configuration Guide
Related Documents
Configuring Software Entitlement
Configuration Limiting
Static Route Configuration Limits, page
IS-IS Configuration Limits, page
Static Route Configuration Limits
IS-IS Configuration Limits
show running-config router static
Maximum static IPv4 routes
OSPFv2 and v3 Configuration Limits
show running-config router ospf
Maximum Interfaces for Each OSPF Instance Example
maximum interfaces n
Maximum Routes Redistributed into OSPF Example
4-22
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Routing Policy Language Line and Policy Limits
Number of Parallel Links max-paths Example
Maximum number of RPL lines
65,536
Multicast Configuration Limits
maximum groups n
show igmp summary
maximum groups-per-interface n
MPLS Configuration Limits
Other Configuration Limits
Global Configuration
Default
4-26
Chapter 4 Configuring Additional Router Features
Configuration Limiting
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Entering Abbreviated Commands
Viewing System Information with show Commands, page
Wildcards, Templates, and Aliases, page Command History, page
Entering Abbreviated Commands, page
Using the Question Mark ? to Display On-Screen Command Help
partial-command?
Note Do not include a space between the command and question mark
Lists all commands available for a particular command mode
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
The number ranges within the angle brackets are inclusive ranges
Completing a Partial Command with the Tab Key
Identifying Command Syntax Errors
Using the no Form of a Command
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Viewing System Information with show Commands
Editing Command Lines that Wrap
Common show Commands, page
Browsing Display Output when the --More-- Prompt Appears, page
Common show Commands
Browsing Display Output when the --More-- Prompt Appears
show configuration
show running-config EXEC or
Halting the Display of Screen Output
Redirecting Output to a File
show command file filename
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Narrowing Output from Large Configurations
Limiting show Command Output to a Specific Feature or Interface
Using Wildcards to Display All Instances of an Interface
Limiting show Command Output to a Specific Feature or Interface, page
Filtering show Command Output
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Adding a Filter at the --More-- Prompt
5-10
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Show Parser Dump Enhancement Feature
Using Wildcards to Identify Interfaces in show Commands, page
Creating Configuration Templates, page Aliases, page
Keystrokes Used as Command Aliases, page
Using Wildcards to Identify Interfaces in show Commands
Example
gi0/1
gi0/3/4
Creating Configuration Templates
2. template template-name $parameter $parameter... config-commands
6. show running-config template template-name
4. end-template 5. commit
5-14
$parameter... config-commands
RP/0/RSP0/CPU0routerconfig# template tmplt1
RP/0/RSP0/CPU0routerconfig-TPL# end-template
Applying Configuration Templates
5-15
Examples
Examples
Name of the command alias. An alias name can be a single word or
command-syntax
Original command syntax. Valid abbreviations of the original
command syntax can be entered for the command-syntax argument
Command History
Keystrokes Used as Command Aliases
Viewing Previously Entered Commands
Recalling Previously Entered Commands
Redisplaying the Command Line
Key Combinations
Recalling Deleted Entries
Key Combinations to Move the Cursor, page
Key Combinations to Move the Cursor
Keystrokes to Control Capitalization
5-19
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Keystrokes to Delete CLI Entries
Transposing Mistyped Characters
5-20
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Troubleshooting the Cisco IOS XR Software
Basic Troubleshooting Commands
Basic Troubleshooting Commands, page
Configuration Error Messages, page
Using show Commands to Display System Status and Configuration
Using the ping Command
Using debug Commands, page
Examples
Using the traceroute Command
Using debug Commands
Viewing a List of Debug Features, page
Enabling Debugging for a Feature, page Viewing Debugging Status, page
Viewing a List of Debug Features
Enabling Debugging for a Feature
AAA Authentication, Authorization and Accounting
DRP Pairing debug Display debugging messages of drppairing
Disabling Debugging for a Service
Viewing Debugging Status
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Configuration Error Messages
Configuration Failures During a Commit Operation
Disabling Debugging for All Services Started at All Terminal Sessions
Configuration Failures During a Commit Operation, page
Memory Warnings in Configuration Sessions
Configuration Errors at Startup
Understanding Low-Memory Warnings in Configuration Sessions
Understanding Low-Memory Warnings in Configuration Sessions, page
“ERROR! MEMORY IS IN SEVERE or CRITICAL STATE”
Viewing System Memory Information
“WARNING! MEMORY IS IN MINOR STATE”
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Removing Configurations to Resolve Low-Memory Warnings
Clearing a Target Configuration, page
Removing Committed Configurations to Free System Memory, page
Rolling Back to a Previously Committed Configuration, page
Clearing a Target Configuration
Removing Committed Configurations to Free System Memory
Rolling Back to a Previously Committed Configuration
6-10
Clearing Configuration Sessions
show configuration sessions
Displays the active configuration sessions
clear configuration sessions session-id
Verifying System Interfaces
6-12
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
6-13
Chapter 6 Troubleshooting the Cisco IOS XR Software
RP/0/RSP0/CPU0router# show running-config interface gi0/2/0/3
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
6-14
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
connection
Complex Regular Expressions Using Multipliers, page A-3
Understanding Regular Expressions, Special Characters, and Patterns
Regular Expressions
A P P E N D I X A
Special Characters
Character Pattern Ranges
\$ \ \+
a-dA-D
Complex Regular Expressions Using Multipliers
Multiple-Character Patterns
ba?b
A-Za-z0-9+
Pattern Alternation
Anchor Characters
Underscore Wildcard
Parentheses Used for Pattern Recall
a.bc.\1\2
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
F I N A L D R A F T - C i s c o C o n f i d e n t i a l
Parentheses Used for Pattern Recall