Manuals / Cisco Systems / Computer Equipment / Network Router

Cisco Systems ASR 9000 Troubleshooting the Cisco IOS XR Software, Basic Troubleshooting Commands

Models: A9KMOD80TR A9K24X10GETR ASR 9000

1 142

Download 142 pages 58.88 Kb

Page 123

Troubleshooting the Cisco IOS XR Software

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

C H A P T E R 6

Troubleshooting the Cisco IOS XR Software

This chapter offers tools and procedures that identify the source of hardware and software problems. This chapter also provides instructions on gathering data for further analysis by Cisco customer support .

Contents

•Additional Sources for Information, page 6-1

•Basic Troubleshooting Commands, page 6-1

•Configuration Error Messages, page 6-6

•Memory Warnings in Configuration Sessions, page 6-7

•Interfaces Not Coming Up, page 6-11

Additional Sources for Information

For additional information on troubleshooting, see the following sources:

•If the Cisco IOS XR Software does not start and display the EXEC mode prompt, see Cisco ASR 9000 Series Aggregation Series Router ROM Monitor Guide.

•The Cisco Technical Assistance Center (Cisco TAC) home page, containing 30,000 pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/public/support/tac/home.shtml

•The “Related Documents” section on page viii.

Basic Troubleshooting Commands

The following sections describe some basic techniques used to determine connectivity to another device and display information on the configuration and operation of a router.

•Using show Commands to Display System Status and Configuration, page 6-2

•Using the ping Command, page 6-2

•Using the traceroute Command, page 6-3

Cisco ASR 9000 Series Aggregation Services Router Getting Started Guide

	OL-17502-01	6-1

Image 123

Cisco Systems ASR 9000, A9KMOD80TR Troubleshooting the Cisco IOS XR Software, Additional Sources for Information, Contents

Contents

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 lCisco IOS XR Software Release Cisco Systems, Inc 170 West Tasman Drive San Jose, CAF 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 countriesInitial Router Configuration ContentsFeatures and Capabilities Connecting to the Router Through the Console PortPrerequisites Configuring Gigabit Ethernet and 10-Gigabit Ethernet InterfacesWhere to Go Next Entering Configuration ChangesViewing the Target Configuration Viewing Configuration Error Messages Without DescriptionsSpecifying the Management Ethernet Interface Name in CLI Commands Viewing Configuration DetailsConfiguration Limiting Previewing Rollback Configuration ChangesConfiguring Basic Message Logging ContentsCommand History Using the Question Mark ? to Display On-Screen Command HelpCompleting a Partial Command with the Tab Key Filtering show Command OutputConfiguration Error Messages Contents A-1Using the ping Command Disabling Debugging for All Services Started at All Terminal SessionsAnchor Characters Complex Regular Expressions Using Multipliers A-3Parentheses Used for Pattern Recall A-4 Pattern AlternationContents 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 lOL-17502-01 About This Document Obtaining Documentation and Submitting a Service Request, pagePreface Changes to This DocumentIntended Audience Chapter 3, “Configuring General Router Features”Chapter 4, “Configuring Additional Router Features” Chapter 6, “Troubleshooting the Cisco IOS XR Software”boldface font Option Network PreferencesObtaining 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 lF 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 PrefaceOL-17502-01 Router Overview, page System Configurations, page Introducing to the Cisco ASR 9000 Series Aggregation Services RouterContents Features and CapabilitiesMPLS TE, page Manageability, page Security, page Command-Line Interface, page Extensible Markup Language API, pageCisco IOS XR Software Multicast, page OAM, page Layer 3 routing, page QoS, pageF 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 EthernetL2VPN MulticastF 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 Layer 3 routingMPLS VPN MPLS TESystem Configurations High AvailabilityF 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 lManagement and Security ManageabilityF 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 Initial Router ConfigurationManagement Interfaces Security1-10 Command-Line InterfaceExtensible Markup Language API Simple Network Management Protocol2. Connect a terminal to the Console port Connecting to the Router Through the Console Port6. admin 7. show dsc SUMMARY STEPSCommand or Action DETAILED STEPSDocuments” section on page 1-121-13 Where to Go NextConfiguring Gigabit Ethernet and 10-Gigabit Ethernet Interfaces page1-14 Where to Go NextF 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 Prerequisites, page Bringing Up and Configuring the Router, pageVerifying the System After Initial Boot, page Where to Go Next, page Bringing Up Cisco IOS XR Software on the RouterF 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 Bringing Up and Configuring the RouterSoftware Requirements Hardware Prerequisites and DocumentationEnter the “Connecting to the Router Through the ConsoleExamples Port” section on pageF 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 Boot1. show version 2. admin 3. show platform node-id 4. exit 5. show redundancy 6. show environmentshow platform Command Example, page Examples of show Commandsshow version Command Example show version Command Example, pageshow platform Command Example show redundancy Command ExampleF 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 show environment Command Exampleshow environment options Verifying the System After Initial BootChapter 2 Bringing Up Cisco IOS XR Software on the Router Where to Go NextWhere 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 lNavigating Cisco IOS XR Software Command Modes, page Configuring General Router FeaturesConnecting to and Communicating with the Router Connecting to and Communicating with the Router, pageConnecting Through the Management Ethernet Interface, page Connecting Through the Console PortConnecting Through the Console Port, page Connecting Through a Terminal Server, pagedescribed in the “CLI Prompt” section on page Connecting Through a Terminal Server5. telnet access-server-address port a Router” section on pagedocumentation listed in the “Related Documents” section on page Aggregation Services Router System Management ConfigurationGuide section on pageF 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 Connecting Through the Management Ethernet InterfaceLogging In to a Router telnet ManagementEthernetInterfaceIPaddressinitial configuration of the router, as described in the “Configuring Slot in which the RSP is installed. In a Cisco ASR 9000 Series routerEntity on a card that executes user commands or communicates with a port interface. For executing commands from the EXEC promptPredefined User Groups, page User Access PrivilegesUser Groups, Task Groups, and Task IDs User Groups, Task Groups, and Task IDs, pageshow aaa usergroup Command Example, page show user Command Example, page show user tasks Command Example, pageshow user group Command Example, page show user all Command Example, pageshow user all Command Example show user Command Exampleshow user tasks Command Example show user group Command ExampleF 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 aaa usergroup Command Example3-10 Chapter 3 Configuring General Router Features Logging In to a RouterEntering EXEC Commands from a Configuration Mode, page Navigating Cisco IOS XR Software Command ModesIdentifying the Command Mode in the CLI Prompt, page Common Command Modes, pageF 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 PromptCommon Command Modes 3-12F 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 protocoloptions3-13 Command ModeEntering EXEC Commands from a Configuration Mode 3-14F 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-15F 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-16F 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, page Entering Configuration ChangesEntering Configuration Changes, page Viewing Active Configuration Sessions, page3-18 1. configure3. end or commit 3. commitF 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 Active Configuration Sessions4. end 3-19Simple Administration Configuration Session Example, page Starting a Configuration SessionSimple RSP Configuration Example Simple RSP Configuration Example, pageViewing the Running Configuration, page Starting an Exclusive Configuration SessionViewing Configuration Details Simple Administration Configuration Session ExampleViewing a Combined Target and Running Configuration, page Viewing the Running ConfigurationViewing a Sanitized Version of the Running Configuration, page Viewing the Target Configuration, pageViewing a Sanitized Version of the Running Configuration 3-23F 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-24F 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-25F 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-26 Saving the Target Configuration to a FileViewing Configuration Error Messages and Descriptions Viewing Configuration Error Messages Without Descriptions3-27 Loading the Target Configuration from a FileLoading an Alternative Configuration at System Startup Clearing All Changes to a Target Configuration3-28 Committing Changes to the Running Configurationcommit commit best-effortOptional Commits the configuration in global configuration mode on a Commandshow configuration commit list detail command The comment option must appear at the end of the command line. IfF 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 Reloading a Failed ConfigurationCommitting a Configuration from Global Configuration Mode Example 3-303-31 Exiting a Configuration SubmodeReturning Directly to Configuration Mode from a Submode Ending a Configuration SessionF 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 RSP HostnameAborting a Configuration Session 3-32routerconfig# interface MgmtEth0/RSP1/CPU0/0 Configuring the Management Ethernet InterfaceSpecifying the Management Ethernet Interface Name in CLI Commands routerconfig# interface MgmtEth0/RSP0/CPU0/0routerconfig# interface MgmtEth0/0/CPU0/1 routerconfig# interface MgmtEth0/5/CPU0/0routerconfig# interface MgmtEth0/5/CPU1/0 routerconfig# interface MgmtEth0/0/CPU0/03. ipv4 address ipv4-address subnet-mask Configuring the Management Ethernet Interface1. configure 2. interface MgmtEthrack/slot/CPU0/port Prerequisitesipv4 address ipv4-address subnet-mask 0.0.0.0/0 default-gateway3-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 l3-37 ExamplesF 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. clock update-calendar 7. show clock Manually Setting the Router ClockCisco ASR 9000 Series Aggregation Services Router Interface and Hardware Component Configuration GuideF 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-39RP/0/RSP0/CPU0routerconfig# clock timezone Examples3-40 Cisco ASR 9000 Series Aggregation Services Router SystemManagement Command Reference Management Configuration GuideConfiguring Telnet and XML Host Services, page Configuring Additional Router FeaturesConfiguring the Domain Name and Domain Name Server Configuring the Domain Name and Domain Name Server, pageF 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 2. domain name domain-name-of-organization3. domain name-server ipv4-address 4. commit or end 5. show hosts 1. configureF 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 ServicesConfiguring Telnet and XML Host Services ExamplesSUMMARY STEPS 1. configure 2. telnet ipv4 server max-servers limit 3. end or commitPrerequisites 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 lExamples 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 lDETAILED STEPS Rolling Back the Configuration to a Specific Rollback Point, page Managing Configuration History and RollbackViewing Configuration Changes Recorded in a CommitID, page Previewing Rollback Configuration Changes, pageRP/0/RSP1/CPU0routeradmin# show configuration commit changes ? Viewing Configuration Changes Recorded in a CommitIDViewing CommitIDs RP/0/RSP1/CPU0router# show configuration commit listRP/0/RSP1/CPU0router# show configuration rollback changes to Previewing Rollback Configuration ChangesRolling Back the Configuration to a Specific Rollback Point RP/0/RSP1/CPU0router# show configuration rollback changes to ?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 Rolling Back the Configuration over a Specified Number of CommitsLoading CommitID Configuration Changes to the Target Configuration rollback changes commandF 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 Configuration4-10 RP/0/RSP1/CPU0router# show configuration commit changes ?RP/0/RSP0/CPU0routerconfig# load rollback changes Deleting CommitIDs4-11 RP/0/RSP0/CPU0routerconfig# load rollback changes toLogging Locations and Severity Levels Configuring Logging and Logging CorrelationAlarm Logging Correlation, page Configuring Basic Message Logging, page3. logging trap severity 4. logging console severity Alarm Logging CorrelationConfiguring Basic Message Logging 2. logging ip-address hostnameF 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-14RP/0/RSP0/CPU0routerconfig# logging buffered ExamplesCisco ASR 9000 Series Aggregation Services Router XML API Guide Cisco ASR 9000 Series Aggregation Services Router System MonitoringConfiguration Guide Command Referenceshow aaa userdb username command without a usernamegroup. To display all groups on the system, type the command Viewing Details About User Accounts, User Groups, and Task IDsCreating Users and Assigning Groups Configuring User Accounts1. configure 2. username user-name 3. password 0 7 password or secret 0 5 passwordRelated Documents Cisco ASR 9000 Series Aggregation Services Router System Security4-18 Configuration GuideIS-IS Configuration Limits, page Configuring Software EntitlementConfiguration Limiting Static Route Configuration Limits, pageMaximum static IPv4 routes Static Route Configuration LimitsIS-IS Configuration Limits show running-config router staticmaximum interfaces n OSPFv2 and v3 Configuration Limitsshow running-config router ospf Maximum Interfaces for Each OSPF Instance ExampleMaximum Routes Redistributed into OSPF Example 4-22F 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 65,536 Routing Policy Language Line and Policy LimitsNumber of Parallel Links max-paths Example Maximum number of RPL linesmaximum groups-per-interface n Multicast Configuration Limitsmaximum groups n show igmp summaryDefault MPLS Configuration LimitsOther Configuration Limits Global ConfigurationF 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-26Chapter 4 Configuring Additional Router Features Configuration LimitingEntering Abbreviated Commands, page Entering Abbreviated CommandsViewing System Information with show Commands, page Wildcards, Templates, and Aliases, page Command History, pageLists all commands available for a particular command mode Using the Question Mark ? to Display On-Screen Command Helppartial-command? Note Do not include a space between the command and question markThe 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 lF 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 Completing a Partial Command with the Tab KeyIdentifying Command Syntax Errors Using the no Form of a CommandBrowsing Display Output when the --More-- Prompt Appears, page Viewing System Information with show CommandsEditing Command Lines that Wrap Common show Commands, pageshow running-config EXEC or Common show CommandsBrowsing Display Output when the --More-- Prompt Appears show configurationF 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 Halting the Display of Screen OutputRedirecting Output to a File show command file filenameLimiting show Command Output to a Specific Feature or Interface, page Narrowing Output from Large ConfigurationsLimiting show Command Output to a Specific Feature or Interface Using Wildcards to Display All Instances of an InterfaceF 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 OutputAdding a Filter at the --More-- Prompt 5-10F 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 Used as Command Aliases, page Show Parser Dump Enhancement FeatureUsing Wildcards to Identify Interfaces in show Commands, page Creating Configuration Templates, page Aliases, pagegi0/3/4 Using Wildcards to Identify Interfaces in show CommandsExample gi0/14. end-template 5. commit Creating Configuration Templates2. template template-name $parameter $parameter... config-commands 6. show running-config template template-nameRP/0/RSP0/CPU0routerconfig-TPL# end-template 5-14$parameter... config-commands RP/0/RSP0/CPU0routerconfig# template tmplt1Examples Applying Configuration Templates5-15 Examplescommand syntax can be entered for the command-syntax argument Name of the command alias. An alias name can be a single word orcommand-syntax Original command syntax. Valid abbreviations of the originalRecalling Previously Entered Commands Command HistoryKeystrokes Used as Command Aliases Viewing Previously Entered CommandsKey Combinations to Move the Cursor, page Redisplaying the Command LineKey Combinations Recalling Deleted EntriesF 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 Key Combinations to Move the CursorKeystrokes to Control Capitalization 5-19F 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 EntriesTransposing Mistyped Characters 5-20Configuration Error Messages, page Troubleshooting the Cisco IOS XR SoftwareBasic Troubleshooting Commands Basic Troubleshooting Commands, pageExamples Using show Commands to Display System Status and ConfigurationUsing the ping Command Using debug Commands, pageEnabling Debugging for a Feature, page Viewing Debugging Status, page Using the traceroute CommandUsing debug Commands Viewing a List of Debug Features, pageDRP Pairing debug Display debugging messages of drppairing Viewing a List of Debug FeaturesEnabling Debugging for a Feature AAA Authentication, Authorization and AccountingDisabling Debugging for a Service Viewing Debugging StatusF 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, page Configuration Error MessagesConfiguration Failures During a Commit Operation Disabling Debugging for All Services Started at All Terminal SessionsUnderstanding Low-Memory Warnings in Configuration Sessions, page Memory Warnings in Configuration SessionsConfiguration Errors at Startup Understanding Low-Memory Warnings in Configuration SessionsF 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 “ERROR! MEMORY IS IN SEVERE or CRITICAL STATE”Viewing System Memory Information “WARNING! MEMORY IS IN MINOR STATE”Rolling Back to a Previously Committed Configuration, page Removing Configurations to Resolve Low-Memory WarningsClearing a Target Configuration, page Removing Committed Configurations to Free System Memory, page6-10 Clearing a Target ConfigurationRemoving Committed Configurations to Free System Memory Rolling Back to a Previously Committed Configurationclear configuration sessions session-id Clearing Configuration Sessionsshow configuration sessions Displays the active configuration sessionsVerifying System Interfaces 6-12F 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 6-13Chapter 6 Troubleshooting the Cisco IOS XR Software RP/0/RSP0/CPU0router# show running-config interface gi0/2/0/36-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 lconnection A P P E N D I X A Complex Regular Expressions Using Multipliers, page A-3Understanding Regular Expressions, Special Characters, and Patterns Regular Expressionsa-dA-D Special CharactersCharacter Pattern Ranges \$ \ \+A-Za-z0-9+ Complex Regular Expressions Using MultipliersMultiple-Character Patterns ba?bParentheses Used for Pattern Recall Pattern AlternationAnchor Characters Underscore WildcardF 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\2Parentheses 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