Cisco IOS XR Software Release
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 Systems, Inc 170 West Tasman Drive San Jose, CA
800 553-NETS Fax 408
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
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
Features and Capabilities
Contents
Connecting to the Router Through the Console Port
Initial Router Configuration
Where to Go Next
Configuring Gigabit Ethernet and 10-Gigabit Ethernet Interfaces
Entering Configuration Changes
Prerequisites
Specifying the Management Ethernet Interface Name in CLI Commands
Viewing Configuration Error Messages Without Descriptions
Viewing Configuration Details
Viewing the Target Configuration
Configuring Basic Message Logging
Previewing Rollback Configuration Changes
Contents
Configuration Limiting
Completing a Partial Command with the Tab Key
Using the Question Mark ? to Display On-Screen Command Help
Filtering show Command Output
Command History
Using the ping Command
Contents A-1
Disabling Debugging for All Services Started at All Terminal Sessions
Configuration Error Messages
Parentheses Used for Pattern Recall A-4
Complex Regular Expressions Using Multipliers A-3
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
Preface
Obtaining Documentation and Submitting a Service Request, page
Changes to This Document
About This Document
Chapter 4, “Configuring Additional Router Features”
Chapter 3, “Configuring General Router Features”
Chapter 6, “Troubleshooting the Cisco IOS XR Software”
Intended Audience
Obtaining Documentation and Submitting a Service Request
Option Network Preferences
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
Contents
Introducing to the Cisco ASR 9000 Series Aggregation Services Router
Features and Capabilities
Router Overview, page System Configurations, page
Cisco IOS XR Software
Command-Line Interface, page Extensible Markup Language API, page
Multicast, page OAM, page Layer 3 routing, page QoS, page
MPLS TE, page Manageability, page Security, page
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
Flexible Ethernet
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
MPLS VPN
Layer 3 routing
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
The router uses the following line cards 40x1GE Ethernet line card
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
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
Management Interfaces
Initial Router Configuration
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
Extensible Markup Language API
Command-Line Interface
Simple Network Management Protocol
1-10
6. admin 7. show dsc
Connecting to the Router Through the Console Port
SUMMARY STEPS
2. Connect a terminal to the Console port
Documents” section on page
DETAILED STEPS
1-12
Command or Action
Configuring Gigabit Ethernet and 10-Gigabit Ethernet Interfaces
Where to Go Next
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
Verifying the System After Initial Boot, page Where to Go Next, page
Prerequisites, page Bringing Up and Configuring the Router, page
Bringing Up Cisco IOS XR Software on the Router
Prerequisites
Software Requirements
Bringing Up and Configuring the Router
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
Examples
the “Connecting to the Router Through the Console
Port” section on page
Enter
1. show version 2. admin 3. show platform node-id 4. exit
Verifying the System After Initial Boot
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
show version Command Example
Examples of show Commands
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 options
show environment Command Example
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
Connecting to and Communicating with the Router
Configuring General Router Features
Connecting to and Communicating with the Router, page
Navigating Cisco IOS XR Software Command Modes, page
Connecting Through the Console Port, page
Connecting Through the Console Port
Connecting Through a Terminal Server, page
Connecting Through the Management Ethernet Interface, page
5. telnet access-server-address port
Connecting Through a Terminal Server
a Router” section on page
described in the “CLI Prompt” section on page
Guide
Aggregation Services Router System Management Configuration
section on page
documentation listed in the “Related Documents” section on page
Logging In to a Router
Connecting Through the Management Ethernet Interface
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
Entity on a card that executes user commands or communicates with
Slot in which the RSP is installed. In a Cisco ASR 9000 Series router
a port interface. For executing commands from the EXEC prompt
initial configuration of the router, as described in the “Configuring
User Groups, Task Groups, and Task IDs
User Access Privileges
User Groups, Task Groups, and Task IDs, page
Predefined User Groups, page
show user group Command Example, page
show user Command Example, page show user tasks Command Example, page
show user all Command Example, page
show aaa usergroup Command Example, page
show user tasks Command Example
show user Command Example
show user group Command Example
show user all Command Example
3-10
show aaa usergroup Command Example
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
Identifying the Command Mode in the CLI Prompt, page
Navigating Cisco IOS XR Software Command Modes
Common Command Modes, page
Entering EXEC Commands from a Configuration Mode, page
Common Command Modes
Identifying the Command Mode in the CLI Prompt
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
3-13
protocol protocoloptions
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, page
Entering Configuration Changes
Viewing Active Configuration Sessions, page
Starting a Configuration Session, page
3. end or commit
1. configure
3. commit
3-18
4. end
Viewing Active Configuration Sessions
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
Simple RSP Configuration Example
Starting a Configuration Session
Simple RSP Configuration Example, page
Simple Administration Configuration Session Example, page
Viewing Configuration Details
Starting an Exclusive Configuration Session
Simple Administration Configuration Session Example
Viewing the Running Configuration, page
Viewing a Sanitized Version of the Running Configuration, page
Viewing the Running Configuration
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
Viewing Configuration Error Messages and Descriptions
Saving the Target Configuration to a File
Viewing Configuration Error Messages Without Descriptions
3-26
Loading an Alternative Configuration at System Startup
Loading the Target Configuration from a File
Clearing All Changes to a Target Configuration
3-27
commit
Committing Changes to the Running Configuration
commit best-effort
3-28
show configuration commit list detail command
Command
The comment option must appear at the end of the command line. If
Optional Commits the configuration in global configuration mode on a
Committing a Configuration from Global Configuration Mode Example
Reloading a Failed Configuration
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
Returning Directly to Configuration Mode from a Submode
Exiting a Configuration Submode
Ending a Configuration Session
3-31
Aborting a Configuration Session
Configuring the RSP Hostname
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
Specifying the Management Ethernet Interface Name in CLI Commands
Configuring the Management Ethernet Interface
routerconfig# interface MgmtEth0/RSP0/CPU0/0
routerconfig# interface MgmtEth0/RSP1/CPU0/0
routerconfig# interface MgmtEth0/5/CPU1/0
routerconfig# interface MgmtEth0/5/CPU0/0
routerconfig# interface MgmtEth0/0/CPU0/0
routerconfig# interface MgmtEth0/0/CPU0/1
1. configure 2. interface MgmtEthrack/slot/CPU0/port
Configuring the Management Ethernet Interface
Prerequisites
3. ipv4 address ipv4-address subnet-mask
3-36
0.0.0.0/0 default-gateway
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
Cisco ASR 9000 Series Aggregation Services Router
Manually Setting the Router Clock
Interface and Hardware Component Configuration Guide
6. clock update-calendar 7. show clock
RP/0/RSP0/CPU0routerconfig# clock timezone
3-39
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
Management Command Reference
Cisco ASR 9000 Series Aggregation Services Router System
Management Configuration Guide
3-40
Configuring the Domain Name and Domain Name Server
Configuring Additional Router Features
Configuring the Domain Name and Domain Name Server, page
Configuring Telnet and XML Host Services, page
3. domain name-server ipv4-address 4. commit or end 5. show hosts
2. domain name domain-name-of-organization
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
Prerequisites
1. configure 2. telnet ipv4 server max-servers limit 3. end or commit
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
Viewing Configuration Changes Recorded in a CommitID, page
Managing Configuration History and Rollback
Previewing Rollback Configuration Changes, page
Rolling Back the Configuration to a Specific Rollback Point, page
Viewing CommitIDs
Viewing Configuration Changes Recorded in a CommitID
RP/0/RSP1/CPU0router# show configuration commit list
RP/0/RSP1/CPU0routeradmin# show configuration commit changes ?
Rolling Back the Configuration to a Specific Rollback Point
Previewing Rollback Configuration Changes
RP/0/RSP1/CPU0router# show configuration rollback changes to ?
RP/0/RSP1/CPU0router# show configuration rollback changes to
Loading CommitID Configuration Changes to the Target Configuration
Rolling Back the Configuration over a Specified Number of Commits
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
4-10
Loading Rollback Configuration Changes to the Target Configuration
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
4-11
Deleting CommitIDs
RP/0/RSP0/CPU0routerconfig# load rollback changes to
RP/0/RSP0/CPU0routerconfig# load rollback changes
Alarm Logging Correlation, page
Configuring Logging and Logging Correlation
Configuring Basic Message Logging, page
Logging Locations and Severity Levels
Configuring Basic Message Logging
Alarm Logging Correlation
2. logging ip-address hostname
3. logging trap severity 4. logging console severity
RP/0/RSP0/CPU0routerconfig# logging buffered
4-14
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
Configuration Guide
Cisco ASR 9000 Series Aggregation Services Router System Monitoring
Command Reference
Cisco ASR 9000 Series Aggregation Services Router XML API Guide
group. To display all groups on the system, type the command
command without a username
Viewing Details About User Accounts, User Groups, and Task IDs
show aaa userdb username
1. configure 2. username user-name 3. password 0 7 password or
Configuring User Accounts
secret 0 5 password
Creating Users and Assigning Groups
4-18
Cisco ASR 9000 Series Aggregation Services Router System Security
Configuration Guide
Related Documents
Configuration Limiting
Configuring Software Entitlement
Static Route Configuration Limits, page
IS-IS Configuration Limits, page
IS-IS Configuration Limits
Static Route Configuration Limits
show running-config router static
Maximum static IPv4 routes
show running-config router ospf
OSPFv2 and v3 Configuration Limits
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
Number of Parallel Links max-paths Example
Routing Policy Language Line and Policy Limits
Maximum number of RPL lines
65,536
maximum groups n
Multicast Configuration Limits
show igmp summary
maximum groups-per-interface n
Other Configuration Limits
MPLS Configuration Limits
Global Configuration
Default
Chapter 4 Configuring Additional Router Features
4-26
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
Viewing System Information with show Commands, page
Entering Abbreviated Commands
Wildcards, Templates, and Aliases, page Command History, page
Entering Abbreviated Commands, page
partial-command?
Using the Question Mark ? to Display On-Screen Command Help
Note Do not include a space between the command and question mark
Lists all commands available for a particular command mode
The number ranges within the angle brackets are inclusive ranges
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
Identifying Command Syntax Errors
Completing a Partial Command with the Tab Key
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
Editing Command Lines that Wrap
Viewing System Information with show Commands
Common show Commands, page
Browsing Display Output when the --More-- Prompt Appears, page
Browsing Display Output when the --More-- Prompt Appears
Common show Commands
show configuration
show running-config EXEC or
Redirecting Output to a File
Halting the Display of Screen Output
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
Limiting show Command Output to a Specific Feature or Interface
Narrowing Output from Large Configurations
Using Wildcards to Display All Instances of an Interface
Limiting show Command Output to a Specific Feature or Interface, page
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
Filtering show Command Output
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
Using Wildcards to Identify Interfaces in show Commands, page
Show Parser Dump Enhancement Feature
Creating Configuration Templates, page Aliases, page
Keystrokes Used as Command Aliases, page
Example
Using Wildcards to Identify Interfaces in show Commands
gi0/1
gi0/3/4
2. template template-name $parameter $parameter... config-commands
Creating Configuration Templates
6. show running-config template template-name
4. end-template 5. commit
$parameter... config-commands
5-14
RP/0/RSP0/CPU0routerconfig# template tmplt1
RP/0/RSP0/CPU0routerconfig-TPL# end-template
5-15
Applying Configuration Templates
Examples
Examples
command-syntax
Name of the command alias. An alias name can be a single word or
Original command syntax. Valid abbreviations of the original
command syntax can be entered for the command-syntax argument
Keystrokes Used as Command Aliases
Command History
Viewing Previously Entered Commands
Recalling Previously Entered Commands
Key Combinations
Redisplaying the Command Line
Recalling Deleted Entries
Key Combinations to Move the Cursor, page
Keystrokes to Control Capitalization
Key Combinations to Move the Cursor
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
Transposing Mistyped Characters
Keystrokes to Delete CLI Entries
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
Basic Troubleshooting Commands
Troubleshooting the Cisco IOS XR Software
Basic Troubleshooting Commands, page
Configuration Error Messages, page
Using the ping Command
Using show Commands to Display System Status and Configuration
Using debug Commands, page
Examples
Using debug Commands
Using the traceroute Command
Viewing a List of Debug Features, page
Enabling Debugging for a Feature, page Viewing Debugging Status, page
Enabling Debugging for a Feature
Viewing a List of Debug Features
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 Failures During a Commit Operation
Configuration Error Messages
Disabling Debugging for All Services Started at All Terminal Sessions
Configuration Failures During a Commit Operation, page
Configuration Errors at Startup
Memory Warnings in Configuration Sessions
Understanding Low-Memory Warnings in Configuration Sessions
Understanding Low-Memory Warnings in Configuration Sessions, page
Viewing System Memory Information
“ERROR! MEMORY IS IN SEVERE or CRITICAL STATE”
“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
Clearing a Target Configuration, page
Removing Configurations to Resolve Low-Memory Warnings
Removing Committed Configurations to Free System Memory, page
Rolling Back to a Previously Committed Configuration, page
Removing Committed Configurations to Free System Memory
Clearing a Target Configuration
Rolling Back to a Previously Committed Configuration
6-10
show configuration sessions
Clearing 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
Chapter 6 Troubleshooting the Cisco IOS XR Software
6-13
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
Understanding Regular Expressions, Special Characters, and Patterns
Complex Regular Expressions Using Multipliers, page A-3
Regular Expressions
A P P E N D I X A
Character Pattern Ranges
Special Characters
\$ \ \+
a-dA-D
Multiple-Character Patterns
Complex Regular Expressions Using Multipliers
ba?b
A-Za-z0-9+
Anchor Characters
Pattern Alternation
Underscore Wildcard
Parentheses Used for Pattern Recall
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
a.bc.\1\2
Parentheses Used for Pattern Recall
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