Cisco ios xr system monitoring command reference (433 pages)
Summary of Contents for Cisco XR 12000 Series
Page 1
Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router Cisco IOS XR Software Release 4.1 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883...
Page 2
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.
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 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router OL-24755-01...
Page 4
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 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router OL-24755-01...
Page 5
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 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router OL-24755-01...
Page 6
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 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router OL-24755-01...
Page 7
Pattern Alternation A-140 Anchor Characters A-140 Underscore Wildcard A-140 Parentheses Used for Pattern Recall A-141 L O S S A R Y N D E X Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router OL-24755-01...
Page 8
Contents Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router viii OL-24755-01...
OL-24755-01 April 2011 Initial release of this document. 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 •...
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 •...
Obtaining Documentation and Submitting a Service Request For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html...
Page 12
Preface Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router OL-24755-01...
Cisco XR 12410 Router Cisco XR 12416 Router • Many cards operate in both Cisco XR 12000 Series Routers and in Cisco 12000 Series Internal Routers. Note 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 Internal Routers, see Release Notes for Command Cisco IOS XR Software Release 4.0.
Cisco XR 12000 Series Router Overview Cisco XR 12000 Series Router Overview The Cisco XR 12000 Series Router is powered by Cisco IOS XR software, allowing service providers to isolate public and private services through the virtualization of a single router into separate physical and logical partitions.
Page 15
This feature supports the Cisco IOS XR Software goal of continuous system availability and allows for quick recovery from process or protocol failures with minimal disruption to customers or traffic.
ACL, Mac Accounting, IPv6, PIMv6, uRPF, MVPN, L2VPN, BFD, and Unequal BW. For more information on link bundling phase 3, see the Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco XR 12000 Series Router.
Page 17
L3 re-routing during a failure. Layer 3 Routing The router runs Cisco IOS XR Software, which supports Layer 3 routing and a range of IPv4 services and routing protocols, including the following: Intermediate System-to-Intermediate System (IS-IS)—Integrated Intermediate IS-IS, Internet •...
Page 18
Static Routing—Static routes are user-defined routes that cause packets moving between a source • and a destination to take a specified path. For more information on static routing, see Cisco IOS XR Routing Configuration Guide for the Cisco XR 12000 Series Router.
RSVP-TE Label Switched Path (LSP) from being disabled when a router in that path has its Intermediate System-to-Intermediate System (IS-IS) overload bit set. For more information on IS-IS overload bit aviodance, see the Cisco IOS XR MPLS Configuration Guide for the Cisco XR 12000 Series Router.
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.
Throughout this guide, the term PRP is used to refer to the PRP cards supported on Cisco XR 12000 Series Routers. Cisco XR 12000 Series Routers, support both the PRP-2 and the PRP-3 cards. If a feature or an issue applies to only one platform, the accompanying text specifies the platform.
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, you must configure the console port for your LAN before it can be used.
Page 23
PRP-2 connections on the Cisco XR 12000 Series Router. Figure 1-2 shows the PRP-3 connections on the Cisco XR 12000 Series Router. Cisco IOS XR software does not support PRP-1. Note Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 1-11 OL-24755-01...
Page 24
RJ-45 cable Modem connection Remote terminal for CLI communication Terminal connection RJ-45 cable Local terminal or terminal server for CLI communication LED status displays (alphanumeric) Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 1-12 OL-24755-01...
Page 25
Communication Ports on the PRP-3 RESET ETH 0 ETH 1 BITS 0 BITS 1 CONSOLE PERFORMANCE RP 3 Ejector Lever Handle External Compact Flash Reset button Alphanumeric LEDs Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 1-13 OL-24755-01...
Page 26
Flow control: None – For information on the cable requirements for the • Console port, see the hardware documentation listed in “Related Documents” section on page Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 1-14 OL-24755-01...
Page 27
Displays the DSC information for the router or router show dsc all system so that you can verify that you have connected to the Example: DSC console port. RP/0/0/CPU0:router(admin)# show dsc all Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 1-15 OL-24755-01...
If the router is prompting you to enter a root-system username, bring up the router. For more information, Bringing Up the Cisco IOS XR Software on a Standalone Router. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 1-16 OL-24755-01...
Bringing Up the Cisco IOS XR Software on a Standalone Router This chapter provides instructions for bringing up the Cisco IOS XR software on a standalone router for the first time. This section applies to standalone routers that are delivered with Cisco IOS XR software installed.
For instructions to overcome a boot block in the standby RP in a single-chassis system, see Cisco IOS XR ROM Monitor Guide for the Cisco XR 12000 Series Router. If a boot block occurs in a multishelf system, contact your Cisco Technical Support representative for assistance. See the “Related...
Enter the root-system username and password that were created earlier in this procedure. After you log in, the router displays the CLI prompt, • which is described in the Prompt. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 2-19 OL-24755-01...
Verifying the System After Initial Boot To verify the status of the router, perform the following procedure: SUMMARY STEPS show version admin show platform [node-id] exit show redundancy show environment Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 2-20 OL-24755-01...
Page 33
Partner node row displays standby role, and the Standby node row displays Ready. Step 6 Displays information about the hardware attributes and status. show environment Example: RP/0/0/CPU0:router# show environment Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 2-21 OL-24755-01...
V 4.1.0[DT_IMAGE], Cisco Systems, at disk0:c12k-fwding-4.1.0.15 Built on Thu May 6 17:07:57 DST 2010 By sjc-lds-364 in /auto/ioxbuild6/production/4.1.0.DT_IMAGE/c12k/workspa ce for pie c12k-doc, V 4.1.0[DT_IMAGE], Cisco Systems, at disk0:c12k-doc-4.1.0 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 2-22 OL-24755-01...
Page 35
LCs in Cisco CRS routers are called modular services cards (MSCs). Note For more information on node IDs, see Cisco IOS XR System Management Configuration Guide for the Cisco XR 12000 Series Router. For more information on the show platform command, see Cisco IOS XR Interface and Hardware Component Command Reference for the Cisco XR 12000 Series Router.
Page 36
PRP reloaded Mon May 10 16:47:10 2010: 2 weeks, 6 days, 9 hours, 35 minutes ago Active node booted Mon May 10 16:47:10 2010: 2 weeks, 6 days, 9 hours, 35 minutes ago Active node reload "Cause: Turboboot completed successfully" Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 2-24 OL-24755-01...
EXEC or administration EXEC mode. The show environment [options] command syntax is used. Enter the show environment ? command to display the command options: RP/0/0/CPU0:router# show environment temperatures The following example shows temperature information for a Cisco XR 12000 Series Router: Mon May 31 02:27:06.397 DST R/S/I Modules Sensor Temp.
Page 38
Chapter 2 Bringing Up the Cisco IOS XR Software on a Standalone Router Where to Go Next Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 2-26 OL-24755-01...
• Secure Domain Routers Cisco XR 12000 Series Routers can be partitioned into multiple, independent routers known as secure domain routers (SDRs). Every router is shipped with a default SDR, which is called the owner SDR, by default, owns all RPs and Line Cards (LCs) installed in the routing system. To build additional SDRs,...
• Router or multishelf system hardware. Connect to the DSC. • Named SDR. For Cisco XR 12000 Series Routers, connect to the RP that serves as the DSDRSC for • that named SDR. Connections are made either through a direct physical connection to the console port of the DSC or DSDRSC or from a remote location using a modem or an Ethernet connection that leads to the DSC or DSDRSC.
Page 41
You can use the modem connection for remote communications with the router. If the Management Ethernet interface fails, the modem connection serves as the alternate remote communications path. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-29...
Page 42
Ethernet CPU1 CPU1 Console CPU1 AUX connection connection Ethernet Network Management Ethernet connections for out-of-band network communication Remote CLI, CWI, XML, or SNMP communication 4-10GE Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-30 OL-24755-01...
Page 43
RJ-45 cable Modem connection Remote terminal for Terminal connection CLI communication RJ-45 cable Local terminal or terminal server for CLI communication LED status displays (alphanumeric) Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-31 OL-24755-01...
Connect a terminal to the Console port of the active RP or DRP. Start the terminal emulation program. Press Enter. Log in to the router. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-32 OL-24755-01...
Page 45
Identifies the RP or DRP to which you must connect in the next step. This step is not required when the router hosts only one RP. • On a Cisco XR 12000 Series Router, the active RP is identified by the • alphanumeric display: ACTV RP.
Connect the terminal server to the Console port of the target RP or DRP. Power on the router. Identify the target RP or DRP. telnet access-server-address port Press Enter. Log in to the router. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-34 OL-24755-01...
Page 47
Identifies the RP or DRP to which you connect in the next step. This step is not required when the router hosts only one RP or DRP. • On a Cisco XR 12000 Series Router, the active RP is identified by the • alphanumeric display: ACTV RP.
After it is configured, the network connection takes place between client software on a workstation computer and a server process within the router. The type of client software you use depends on the server process to use. The Cisco IOS XR software supports the following client and server services: •...
Configuration Guide for the Cisco XR 12000 Series Router. CLI Prompt After you log in, you see the CLI prompt for the Cisco IOS XR software. This prompt identifies the router or SDR to which you are issuing commands. The CLI prompt represents the path, through the router, to the CPU that executes the commands you enter.
Slot in which the RP or DRP is installed. In a Cisco XR 12000 Series Router, the physical slot number can be 0 to 15, and there can be multiple SDRs, each of which is represented by an RP.
User Access Privileges User Groups, Task Groups, and Task IDs The Cisco IOS XR software ensures security by combining tasks a user wants to perform (task IDs) into groups, defining which router configuration and management functions users can perform. This policy is enabled by the definition of: User groups—Collection of users that share similar authorization rights on a router.
(The root-lr user has the highest level of privileges in an SDR. In previous releases, SDRs were called logical routers [LRs].) Predefined User Groups Cisco IOS XR software includes a set of predefined user groups that meets the needs of most organizations. Table 3-2 describes predefined user groups.
: READ WRITE EXECUTE DEBUG Task: boot : READ WRITE EXECUTE DEBUG Task: bundle : READ WRITE EXECUTE DEBUG Task: : READ WRITE EXECUTE DEBUG Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-41 OL-24755-01...
Page 54
To display the rights assigned to a user group, enter the show aaa usergroup group-name command: RP/0/0/CPU0:router# show aaa usergroup root-system Mon May 31 02:56:45.975 DST User group 'root-system' Inherits from task group 'root-system' Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-42 OL-24755-01...
Navigating the Cisco IOS XR Command Modes The Cisco IOS XR Software has different command modes. Each mode provides access to a subset of commands used to configure, monitor, and manage the router. Access to a mode is determined by your user group assignments.
RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# When the router enters interface configuration submode, the prompt changes to include “(config-if)” after the router name: RP/0/0/CPU0:router(config)# interface POS 0/2/0/0 RP/0/0/CPU0:router(config-if)# Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-44 OL-24755-01...
EXEC mode enables a basic set of commands to display the operational state of an SDR and the Cisco IOS XR software. Most CLI commands in EXEC mode do not change the SDR operation. The most common EXEC commands are show commands (to display SDR configuration or operational data) and clear commands (to clear or reset SDR counters).
Page 58
In the following example, the router enters the router configuration mode for BGP: RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# router bgp 140 RP/0/0/CPU0:router(config-bgp)# Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-46 OL-24755-01...
RP, a terminal-modem connection to the AUX port, or through a terminal server. For information and instructions on using ROM Monitor mode, see Cisco IOS XR ROM Monitor Guide for the Cisco XR 12000 Series Router.
Add ? at the end of the prompt, or after a command, to display the available options: Step 2 RP/0/0/CPU0:router# show ? MgmtMultilink Show trace data for the multilink controller component Show AAA configuration and operational data Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-48 OL-24755-01...
To return to EXEC mode, enter the end command. Managing Configuration Sessions In the Cisco IOS XR software, you cannot change the running (active) configuration directly. Enter configuration changes into an inactive target configuration. When the target configuration is ready for use, you can apply that configuration to the router with the commit command.
Page 62
Global configuration mode is used to configure SDR features, such as routing protocols and interfaces. Administration configuration mode is used to assign hardware components to SDRs. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-50...
To view the active SDR configuration sessions, connect to the appropriate SDR and enter the show configuration sessions command in EXEC mode, as shown in the following example: RP/0/0/CPU0:router# show configuration sessions Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-51 OL-24755-01...
Note commands entered during the target configuration session. While in configuration mode, you can enter all Cisco IOS XR software commands supported in that configuration mode. Each command is added to the target configuration. You can view the target configuration by entering the show configuration command in configuration mode. The target configuration is not applied until you enter the commit command, as described in the “Committing...
The running configuration is unlocked when the user who started the exclusive configuration session exits the configuration mode, as described in the “Ending a Configuration Session” section on page 3-65. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-53 OL-24755-01...
Page 68
7 <removed> group root-system group cisco-support interface Loopback99 broadcast interface Loopback999 broadcast interface Loopback9999 broadcast authenticate max-associations 2000 interface Loopback0 ipv4 address 10.0.0.0 255.0.0.0 load-interval 0 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-56 OL-24755-01...
Page 69
RP/0/0/CPU0:router(admin)# show running-config sanitized Mon May 31 21:35:14.902 DST Building configuration... !! IOS XR Admin Configuration 4.1.0 sdr <removed> location 0/1/* location 0/4/* primary Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-57 OL-24755-01...
Page 70
Note The merge option does not appear in command help until the target configuration contains at least one configuration change. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-58 OL-24755-01...
Page 71
% Failed to commit one or more configuration items. Please use 'show configuration failed' to view the errors RP/0/0/CPU0:router(config-tg)# show configuration failed !! CONFIGURATION FAILED DUE TO SEMANTIC ERRORS taskgroup alr !!% Usergroup/Taskgroup names cannot be taskid names Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-59 OL-24755-01...
This suffix is not required, but it can help locate target configuration files, for example: myconfig.cfg The following example shows a target configuration file saved to the usr/cisco directory of disk0: RP/0/0/CPU0:router(admin-config)# save configuration disk0: Mon May 31 21:52:13.237 DST Destination file name (control-c to abort): [/running-config]?/usr/cisco/test.cfg...
You can load an alternative configuration during system boot. For information and instructions on this process, see Cisco IOS XR ROM Monitor Guide for the Cisco XR 12000 Series Router. Clearing All Changes to a Target Configuration To clear changes made to the target configuration without terminating the configuration session, enter the clear command in global configuration mode or administration configuration mode.
[detail] command instead of the numeric label. The line argument is the text for the optional comment or label. • Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-62 OL-24755-01...
Page 75
RP/0/0/CPU0:router(admin-config)# sdr test RP/0/0/CPU0:router(admin-config-sdr:test)# location 0/1/* primary RP/0/0/CPU0:router(admin-config-sdr:test)# commit label test comment This is a test RP/0/0/CPU0:router(admin-config)# show configuration commit list detail 1) CommitId: 2000000018 Label: test Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-63 OL-24755-01...
If you use the exit command to exit global configuration or administration configuration mode, the Note router prompts you to save changes, discard changes, or cancel the action, as described in the next section. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-64 OL-24755-01...
EXEC mode. To abort a configuration session, enter the abort command, as shown in the following example: RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# hostname host1 RP/0/0/CPU0:router(config)# interface POS 0/2/0/2 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-65 OL-24755-01...
Specifying the Management Ethernet Interface Name in CLI Commands, page 3-67 • Displaying the Available Management Ethernet Interfaces, page 3-67 • Configuring the Management Ethernet Interface, page 3-68 • Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-66 OL-24755-01...
“0”. slot Physical slot of the RP or DRP on which the interface is located. For a Cisco XR 12000 Series Router, the PRPs may be installed in slots 0 through 15, depending on the router model. module On an RP, the module is “CPU0”. DRPs have two processors, so the module is either “CPU0”...
(such as remote management stations or TFTP servers), you need to configure a default route for the router. For information on additional configuration options for the Management Ethernet interface, see Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco XR 12000 Series Router. Prerequisites To configure the Ethernet Management port for network communications, you must enter the interface network addresses and subnet mask.
Page 81
Configuring General Router Features Displaying the Available Management Ethernet Interfaces ipv4 address ipv4-address subnet-mask no shutdown exit router static address-family ipv4 unicast 0.0.0.0/0 default-gateway commit show interfaces MgmtEthrack/slot/CPU0/port Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-69 OL-24755-01...
Page 82
Cisco IOS XR Routing Configuration Guide for the Cisco XR 12000 Series Router. Step 7 Commits the target configuration to the running commit configuration. Example: RP/0/0/CPU0:(config)# commit Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-70 OL-24755-01...
Page 83
12 runts, 0 giants, 0 throttles, 0 parity 61 input errors, 27 CRC, 12 frame, 0 overrun, 0 ignored, 0 abort 12869 packets output, 878236 bytes, 0 total output drops Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-71 OL-24755-01...
To manually set the router clock, follow these steps: SUMMARY STEPS configure clock timezone zone hours-offset commit clock set hh:mm:ss dd mm yyyy clock update-calendar show clock Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-72 OL-24755-01...
Page 85
RP/0/0/CPU0:router# show clock Examples The following example shows how the manual system clock is configured: RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# clock timezone pst -8 RP/0/0/CPU0:router(config)# commit RP/0/0/CPU0:router(config)# end Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-73 OL-24755-01...
For information on using the Cisco IOS XR software more efficiently, see CLI Tips, Techniques, and Shortcuts • For information on configuring interfaces, see the hardware documents listed in the “Related Documents” section on page Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 3-74 OL-24755-01...
Page 87
Configure a domain name and Domain Name Server (DNS) for your router to contact other devices on your network efficiently. Use the following guidelines: To define a default domain name that the Cisco IOS XR software uses to complete unqualified •...
Step 5 Displays all configured name servers. show hosts Example: RP/0/0/CPU0:router(config)# show hosts Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-76 OL-24755-01...
To enable the Secure Socket Layer (SSL) of the HTTP and XML services, the security package must • be installed and activated on the router. See Cisco IOS XR System Management Configuration Guide for the Cisco XR 12000 Series Router for information on installing and activating packages. Note This process enables the Telnet, HTTP, and XML host services on the Management Ethernet interfaces.
RP/0/0/CPU0:router(config-if)# exit Step 3 Defines an IPv4 virtual address for the Management ipv4 virtual address ipv4-address subnetmask Ethernet interface. RP/0/0/CPU0:router(config)# ipv4 virtual address 172.29.52.77 255.255.255.0 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-78 OL-24755-01...
Page 91
Example: RP/0/0/CPU0:router(config)# telnet ipv4 server max-servers 5 Step 8 Enables HTTP server on the router. http server Example: RP/0/0/CPU0:router(config)# http server Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-79 OL-24755-01...
Page 92
RP/0/0/CPU0:router(config)# ipv4 virtual address 172.29.52.77 255.255.255.0 RP/0/0/CPU0:router(config)# commit RP/0/0/CPU0:router(config)# exit RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# telnet ipv4 server max-servers 5 RP/0/0/CPU0:router(config)# http server RP/0/0/CPU0:router(config)# xml agent RP/0/0/CPU0:router(config)# commit Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-80 OL-24755-01...
If the system finds an incompatible configuration during rollback, the operation fails and an error • appears. The Cisco IOS XR software automatically saves up to 100 of the most recent commit IDs. The following sections describe how to manage configuration changes and roll back to a previously committed configuration: Displaying the Commit IDs, page 4-82 •...
Changes made since (and including) a specific commit 2000000020 Commit ID 2000000021 Commit ID 2000000022 Commit ID RP/0/0/CPU0:router(admin)# show configuration commit changes 2000000020 Building configuration... username cisco secret 5 $1$MgUH$xzUEW6jLfyAYLKJE.3p440 group root-system Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-82 OL-24755-01...
The rollback process also creates a new rollback point so that you can roll back the configuration to the previous configuration. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-83 OL-24755-01...
ID into the target configuration, modify the target configuration, and then commit the new configuration. Unlike the rollback process, the loaded changes are not applied until you commit them. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-84 OL-24755-01...
Unlike the rollback process, the loaded changes are not applied until you commit them. To display the rollback changes, enter the show configuration rollback changes command. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-85 OL-24755-01...
Configuring Logging and Logging Correlation System messages generated by the Cisco IOS XR software can be logged to a variety of locations based on the severity level of the messages. For example, you could direct information messages to the system console and also log debugging messages to a network server.
When you create correlation rules, a common root event that is generating larger volumes of Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-87...
An operator can extract all correlated messages for display later, should the need arise. For more information, see Cisco IOS XR System Management Configuration Guide for the Cisco XR 12000 Series Router.
XR Software module of Cisco IOS XR System Management Command Reference for the Cisco XR 12000 Series Router Retrieve logging events through an XML interface Cisco IOS XR XML API Guide for the Cisco XR 12000 Series Router Creating and Modifying User Accounts and User Groups In the Cisco IOS XR software, users are assigned individual usernames and passwords.
Configuring Additional Router Features Creating and Modifying User Accounts and User Groups System Security Command Reference for the Cisco XR 12000 Series Router. For instructions to activate software packages, see Cisco IOS XR System Management Configuration Guide for the Cisco XR 12000 Series Router.
Page 104
Chapter 4 Configuring Additional Router Features Creating and Modifying User Accounts and User Groups Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 4-92 OL-24755-01...
For example, the configure command can be abbreviated as config because the abbreviated form of the command is unique. The router accepts and executes the abbreviated command. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-93...
Show all local users with the usergroups each belong to usergroup Show all the local usergroups configured in the system Note Include a space between the keyword and question mark. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-94 OL-24755-01...
Page 107
Payload Compression Protocol Protocol Independent Multicast sctp Stream Control Transmission Protocol Transport Control Protocol User Datagram Protocol RP/0/0/CPU0:router(config)#ipv4 access-list list1 deny Generally, uppercase letters represent variables (arguments). Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-95 OL-24755-01...
In the following example, the caret appears where the character was typed incorrectly in the command: RP/0/0/CPU0:router# configure termiMal % Invalid input detected at '^' marker. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-96 OL-24755-01...
RP/0/0/CPU0:router(config)# $ccess-list 101 permit tcp 172.31.134.5 255.255.255.0 172.31.$ By default, the Cisco IOS XR software uses a terminal screen 80 columns wide. To adjust for a different screen width, use the terminal width command in EXEC mode.
Collects a large amount of system information for EXEC or troubleshooting. You can provide this output to technical support administration representatives when reporting a problem. EXEC mode Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-98 OL-24755-01...
EXEC mode. Command output is not paused if the length value is set to zero. The following example shows how to set the terminal length: Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-99...
Entering keywords and arguments in the show command limits the show output to a specific feature or interface. In the following example, only information about the static IP route configuration appears: RP/0/0/CPU0:router# show running-config router static Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-100 OL-24755-01...
0 drops for unrecognized upper-level protocol POS0/2/0/2 is administratively down, line protocol is administratively down 0 drops for unrecognized upper-level protocol POS0/2/0/3 is administratively down, line protocol is administratively down Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-102 OL-24755-01...
Page 115
On most systems, Ctrl-Z can be entered at any time to interrupt the output and return to EXEC mode. For more information, see Appendix A, “Understanding Regular Expressions, Special Characters, and Patterns.” Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-103 OL-24755-01...
In addition, if you want to give pipe character (|) as a pattern, you must give it in double quotes. For example: RP/0/0/CPU0:single8-hfr# show running-config|include “bgp|ospf”|file disk0:/usr/a.log Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-104 OL-24755-01...
!! Last configuration change at Mon Mar 21 06:35:17 2011 by lab service configuration display slot-order interface MgmtEth0/0/CPU0/0 ipv4 address 12.29.38.6 255.255.0.0 interface MgmtEth0/0/CPU0/1 shutdown interface POS0/2/0/0 shutdown Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-106 OL-24755-01...
RP/0/0/CPU0:router# show running-config interface mgmtEth 0/RP0/CPU0/0 Mon May 31 23:48:17.453 DST interface MgmtEth0/RP0/CPU0/0 description Connected to Lab LAN ipv4 address 172.29.52.70 255.255.255.0 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-108 OL-24755-01...
SUMMARY STEPS configure template template-name [($parameter $parameter...)] [config-commands] Enter the template commands. end-template commit show running-config template template-name Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-110 OL-24755-01...
Page 123
Applies the target configuration commands to the running commit configuration. Example: RP/0/0/CPU0:router(config-TPL)# commit Step 6 Displays the details of the template. show running-config template template-name Example: RP/0/0/CPU0:router# show running-config template tmplt_1 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-111 OL-24755-01...
In the following example, a simple template is defined. The template contents are then displayed with the show running-config template template-name command: RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# apply-template jbtest RP/0/0/CPU0:router(config)# show configuration Building configuration... hostname test Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-112 OL-24755-01...
Aliases With the Cisco IOS XR software, you can define command-line aliases for any physical or logical entity in a router. After you define the alias, it is used in the CLI to reference the real entity. To create a command alias, enter the alias command in global configuration or administration configuration mode: alias alias-name [(parameter1 parameter2...)] command-syntax [$parameter1] command-syntax...
Rollback. Displaying Previously Entered Commands The Cisco IOS XR software records the ten most recent commands issued from the command line in its history buffer. This feature is particularly useful for recalling long or complex commands or entries, including access lists.
Recalling Deleted Entries The Cisco IOS XR CLI also stores deleted commands or keywords in a history buffer. The buffer stores the last ten items that have been deleted using Ctrl-K, Ctrl-U, or Ctrl-X. Individual characters deleted using Backspace or Ctrl-D are not stored.
Ctrl indicates the Control key, which must be pressed simultaneously with its associated letter key. • Esc indicates the Escape key, which must be pressed first, followed by its associated letter key. • Keys are not case sensitive. • Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-116 OL-24755-01...
Makes the letter at the cursor uppercase. Esc, l Changes the word at the cursor to lowercase. Esc, u Makes letters from the cursor to the end of the word uppercase. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-117 OL-24755-01...
Word to the left of the cursor. Esc, d From the cursor to the end of the word. Transposing Mistyped Characters To transpose mistyped characters, use the Ctrl-T key combination. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 5-118 OL-24755-01...
Additional Sources of 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 IOS XR ROM Monitor Guidefor the Cisco XR 12000 Series Router.
Using debug Commands, page 6-123 • Using show Commands to Display System Status and Configuration Use the show commands to check the status of various Cisco IOS XR software subsystems and services. Table 6-1 lists some of the common show commands.
Each exclamation point (!) indicates receipt of a reply. A period (.) indicates the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-121 OL-24755-01...
(*). The traceroute command terminates when the destination responds, the maximum TTL is exceeded, or the user interrupts the trace with the escape sequence. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-122 OL-24755-01...
Turn on Accounting debug adjacency platform AIB information afmon-ea debug afmon-ea services afmon-lib debug afmon client library specific function calls afmon-ma Debug afmon-ma services AIB information Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-123 OL-24755-01...
Page 136
Debug app-obj services Address Pool Proxy Debugs IP Address Repository Manager IP ARP transactions arp-gmp ARP Global Management Process debugging async async messaging information ATM debugging --More-- Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-124 OL-24755-01...
'con0_RP1_CPU0' #### aaa all flag is ON ipv4 io icmp flag is ON RP/0/0/CPU0:router# no debug aaa all RP/0/0/CPU0:router# show debug Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-125 OL-24755-01...
ON On a Cisco XR 12000 Series Router, the slot number of the tty ID is 0 or 1 instead of RP0 or RP1. Enter the show debug conditions command to display the conditional debugging status. For example:...
Configuration Errors at Startup Configuration errors that occurred during system startup can be displayed with the show configuration failed startup command. For example: RP/0/0/CPU0:router# show configuration failed startup Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-127 OL-24755-01...
• Understanding Low-Memory Warnings in Configuration Sessions The Cisco IOS XR software monitors memory usage in the router. If system memory becomes low, an error message appears when you attempt to enter configuration mode. An “out-of-memory” error message appears during one of the following situations: When a user attempts to enter configuration mode.
Clearing a target configuration is a preventive measure to not let the system go into a worse memory state due to additional configuration. In addition, all other active configuration sessions can be closed to minimize the churn. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-130 OL-24755-01...
In the following example, the open configuration sessions are displayed with the show configuration sessions command. The clear configuration sessions command is then used to clear a configuration session. RP/0/0/CPU0:router# show configuration sessions Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-131 OL-24755-01...
Config State ----------------------------------------------------------------------------- 0/0/CPU0 PRP(Active) IOS XR RUN PWR,NSHUT,MON 0/1/CPU0 L3 Service Eng Admin Down PWR,SHUT,MON 0/2/CPU0 L3LC Eng 3 OC3-ATM-4 IOS XR RUN PWR,NSHUT,MON Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-132 OL-24755-01...
Page 145
RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# interface pos0/2/0/1 RP/0/0/CPU0:router(config-if)# ipv4 address 10.1.1.1 255.0.0.0 RP/0/0/CPU0:router(config-if)# no shutdown RP/0/0/CPU0:router(config-if)# commit RP/0/0/CPU0:router(config-if)# end RP/0/0/CPU0:router# RP/0/0/CPU0:router# configure Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-133 OL-24755-01...
Page 146
If the interface state is still displayed as “Down”, verify that the physical cable connections are correctly installed. The following message indicates that the interface has either a bad connection or no connection: Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-134 OL-24755-01...
Page 147
Shutdown Down MgmtEth0/RP0/CPU0/0 unassigned Shutdown Down Repeat these steps for every interface, until every interface shows both Status and Protocol as “Up.” Step 8 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-135 OL-24755-01...
Page 148
Chapter 6 Troubleshooting the Cisco IOS XR Software Interfaces Not Coming Up Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router 6-136 OL-24755-01...
Letters (A to Z and a to z), digits (0 to 9), and other keyboard characters (such as ! or ~) can be used as a single-character pattern. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router A-137...
Invert the matching of the range by including a caret (^) at the start of the range. The following example matches any letter except the ones listed: [^a–dqsv] The following example matches anything except a right square bracket (]) or the letter d: [^\\]d] Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router A-138 OL-24755-01...
For example: telebit 3107 v32bis. Complex Regular Expressions Using Multipliers Multipliers can be used to create more complex regular expressions that instruct Cisco IOS XR software to match multiple occurrences of a specified regular expression. Table A-2 lists the special characters that specify “multiples”...
The underscore can replace long regular expression lists. For example, instead of specifying ^1300( ) ( )1300$ {1300, ,1300, {1300} ,1300, (1300, simply specify _1300_. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router A-140 OL-24755-01...
Use parentheses with multiple-character regular expressions to multiply the occurrence of a pattern. The Cisco IOS XR software can remember a pattern for use elsewhere in the regular expression. To create a regular expression that recalls a previous pattern, use parentheses to indicate memory of a specific pattern and a backslash (\\) followed by a digit to reuse the remembered pattern.
Page 154
Appendix A Understanding Regular Expressions, Special Characters, and Patterns Parentheses Used for Pattern Recall Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router A-142 OL-24755-01...
A network security service that provides the primary framework to set up access control on a Cisco CRS router or access server. AAA is an architectural framework and modular means of configuring three independent but closely related security functions in a consistent manner.
Page 156
The type of the card inserted in a slot. card type Cisco Discovery Protocol. CDP runs on all Cisco devices so that these devices can learn about neighboring devices and exchange information. CDP uses a well-known multicast MAC address. During system initialization, the application-specific integrated circuit (ASIC) is configured to forward these packets to the Cisco IOS XR software CPU, which processes the packets.
Page 157
Chapter Name of the optional flash disk on which the Cisco IOS XR software can be stored in preparation for disk1 installation or upgrade. Domain Name System. Mechanism used in the Internet and on private intranets for translating names of host computers into addresses. The DNS also allows host computers not directly on the Internet to have a registered name in the same style.
Page 158
Internet Engineering Task Force. Task force consisting of over 80 working groups responsible for IETF developing Internet standards. The IETF operates under the auspices of ISOC Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router GL-146 OL-24755-01...
Page 159
The set of Cisco IOS XR software packages installed on a router. installed software The Cisco operating system used on the Cisco CRS router and Cisco XR 12000 Series Router. IOS XR Internet Protocol. Network layer protocol in the TCP/IP stack offering a connectionless internetwork service.
Page 160
A standard protocol between MPLS-enabled routers to negotiate the labels (addresses) used to forward packets. The Cisco proprietary version of this protocol is the Tag Distribution Protocol (TDP). Label Information Base. The table that contains the labels in use on the node.
Page 161
Module in which the ingress and egress packet processing and queueing functions are carried out in the Cisco CRS architecture. Up to 16 MSCs are installed in a line card chassis; each MSC must have an associated physical line interface module (PLIM) (of which there are several types to provide a variety of physical interfaces).
Page 162
An installable software file with the suffix pie. A PIE may be a package or a Software Maintenance Upgrade (SMU). A PIE is used to deliver Cisco IOS XR software. A PIE may contain a single component, group of components (called a package), or set of packages. When a PIE contains more than one component, it is called a “Composite PIE.”...
Page 163
Reverse Path Forwarding. Multicasting technique in which a multicast datagram is forwarded from all but the receiving interface if the receiving interface is the one used to forward unicast datagrams to the source of the multicast datagram. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router GL-151 OL-24755-01...
Page 164
Synchronous Optical Network. A standard format for transporting a wide range of digital SONET telecommunications services over optical fiber. SONET is characterized by standard line rates, optical interfaces, and signal formats. See also SDH. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router GL-152 OL-24755-01...
Page 165
A tar file is a file produced by the UNIX tar program, which packages multiple files in a single file for distribution as a single unit. Each tar file has a tar filename extension. A “two-stage” configuration of the Cisco IOS XR software running configuration. This allows users to target configuration make changes to the running configuration and accept these changes by entering the commit command.
Page 166
VCSEL A vm file is a Cisco IOS XR software file that can be installed from ROM Monitor mode. A vm file is typically used to install the Cisco IOS XR software when the software has not yet been installed or has been corrupted.
Page 167
The response to an XML request. XML response An XML document specifying the structure and possible contents of XML elements that can be XML schema contained in an XML document. Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router GL-155 OL-24755-01...
Page 168
Chapter Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router GL-156 OL-24755-01...
2-19 command mode verification administration EXEC 3-45 standalone router 2-20 configuration submodes 3-46 EXEC 3-45 global configuration 3-46 interface configuration 3-46 capitalization, keyboard shortcuts 5-117 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-157 OL-24755-01...
Page 170
3-63 disabling for a service 6-126 committing a configuration 3-62 displaying features 6-123 complex expressions A-139 displaying status 6-125 configuration enabling 6-125 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-158 OL-24755-01...
Page 171
3-64 5-97 load command 3-61 load commit changes command 4-85 load configuration failed commit command 3-64 load rollback changes command 4-86 global configuration mode 3-46 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-159 OL-24755-01...
Page 172
1-11 interface configuration 3-46 PRP-2, connections 1-11 ROM monitor 3-47 router configuration 3-46 router submode configuration 3-47 modem connection rack number DRP PLIM (illustration) 3-30 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-160 OL-24755-01...
Page 173
5-114 named 3-27 show hosts command 4-76 owner 3-27 show install command 6-120 secure domain router show interfaces brief command 3-67 See SDR Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-161 OL-24755-01...
Page 174
1-14, 3-33, 3-35 verification time, setting the router clock 3-72 standalone router 2-20 time zone, setting the router clock 3-72 stopping command output 5-100 traceroute command 6-122 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-162 OL-24755-01...
Page 175
IDs, displaying 3-41 user groups displaying 3-41 introduction 3-39 predefined 3-40 user interfaces SNMP XML API warning, low memory 6-128 wildcards 5-109 host service configuration 4-77 Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-163 OL-24755-01...
Page 176
Index Cisco IOS XR Getting Started Guide for the Cisco XR 12000 Series Router IN-164 OL-24755-01...
Need help?
Do you have a question about the XR 12000 Series and is the answer not in the manual?
Questions and answers