manualshive.com logo in svg

Cisco ASR 14000 Series, Management Command Reference

Share
Download
Cisco ASR 14000 Series Management Command Reference Download Page 754

C i s c o   C o n f i d e n t i a l   -   B e t a   R e v i e w   R 3 . 7. 1

Utility Commands on Cisco IOS XR Software

utility fgrep

SMR-752

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Command History

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper 
task IDs.  

The 

utility fgrep 

command searches files for a fixed character string (as opposed to grep and egrep 

which search for a a pattern that matches an expression).

The results are displayed to the standard output (terminal screen).

Note

Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The 
UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the 
keyword 

count

 can also be entered using the UNIX-equivalent (

-c

). To display the UNIX-equivalent 

syntax online, enter the keyword 

usage

.

Task ID

Examples

The following example, the 

utility fgrep 

command is used with the 

nocase

 and 

linenum

 keywords:

RP/0/RP0/CPU0:router# 

show version | utility fgrep expr uptime nocase linenum

 

7:router uptime is 5 days, 20 hours, 10 minutes

Related Commands

Release

Modification

Release 3.7.1

This command was introduced on the Cisco ASR 14000 Series Router. 

Task ID

Operations

universal

execute

Command

Description

utility egrep

Searches a file using full regular expressions.

Summary of Contents for ASR 14000 Series

Page 1: ...ters Cisco Systems Inc 170 West Tasman Drive San Jose CA 95134 1706 USA http www cisco com Tel 408 526 4000 800 553 NETS 6387 Fax 408 527 0883 Cisco ASR 14000 Series Router System Management Command Reference Cisco IOS XR Software Release 3 7 1 Text Part Number OL 17231 01 ...

Page 2: ... OF SUCH DAMAGES CCDE CCENT Cisco Eos Cisco Lumin Cisco Nexus Cisco StadiumVision Cisco TelePresence 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 ...

Page 3: ...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 Subscribe to the What s New in Cisco Product Documentat...

Page 4: ...C i sc o C o n f id en t ia l B et a R ev iew R 3 7 1 Preface iv Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 ...

Page 5: ...ing protocols to download the Multicast Routing Information Base MRIB entries to consumers managing the Multicast Forwarding Information Base MFIB on the various line cards and route processors RPs Multiprotocol Label Switching MPLS to download the Label Forwarding Information Base LFIB entries to the line card Local Packet Transport Services LPTS to maintain the Internal Forwarding Information Ba...

Page 6: ... agent jid 112 node 0 RP0 CPU0 pulse 23930 new mbr 0 sg lwg fd csmr hdlr act dnld act susp wait lck seq pulse tot pulse out 0 2053 16 6 no no no 0 23950 23926 0 Table 2 describes the significant fields shown in the display group_name Optional Displays information for a specific BCDL group Release Modification Release 3 7 1 This command was introduced on the Cisco ASR 14000 Series Router Task ID Op...

Page 7: ... BCDL agent tells the consumers to join this group to receive data fd The connection handle between the producer and the BCDL agent csmr Number of consumers hdlr act Specifies if there is a download in progress dnld act Indicates whether the convergence flag has been sent or not susp Indicates whether the download is suspended due to the queue filling up wait lck If non zero some thread is waiting...

Page 8: ...ers command RP 0 RP0 CPU0 router show bcdl consumers ipv4_rib group ipv4_rib gsp gid 2029 3 consumers agent jid 113 node 0 5 CPU0 expected 3 consumers to reply received 3 replies pid node asg csg lwg sus messages bytes errs name 823389 0 5 CPU0 0 0 2030 N 20559 1518476 0 fib_mgr 45129 0 1 CPU0 0 0 2030 N 1922 222892 496 fib_mgr 45129 0 3 CPU0 0 0 2030 N 1922 222892 498 fib_mgr Table 3 describes th...

Page 9: ...erence OL 17231 01 csg Subgroup to which the consumer thinks it belongs messages Number of messages processed by this particular consumer bytes Bytes processed by this particular consumer errors Errors encountered by the consumer This field indicates the number of times the connection was reset name Name of the consumer process Table 3 show bcdl consumers Field Descriptions continued Field Descrip...

Page 10: ...e following example shows sample output from the show bcdl queue command RP 0 RP0 CPU0 router show bcdl queues ipv4_rib group ipv4_rib gsp gid 2052 6 consumers agent jid 112 node 0 RP0 CPU0 expected 6 consumers to reply received 6 replies pid node asg csg lwg sus msgs_in_q bytes_in_q errs name 417925 0 RP0 CPU0 0 0 2053 N 0 0 0 fib_mgr 209029 0 RP1 CPU0 0 0 2053 N 0 0 0 fib_mgr 106595 0 4 CPU0 0 0...

Page 11: ...w bcdl tables command RP 0 RP0 CPU0 router show bcdl tables ipv4_rib grp ipv4_rib gid 2052 sg cnt 1 agent jid 112 node 0 RP0 CPU0 pulse 26587 new mbr 0 sg lwg fd csmr hdlr act dnld act susp wait lck seq pulse tot pulse out 0 2053 16 6 no no no 0 26607 26583 0 sgs 1 table_cnt 1 table_mid_cnt 6 buf size 124 Showing table info for 1 subgroups sg 0 has 1 tables messages 0 bytes 0 table 0xe0000000 6 me...

Page 12: ...group sg Specific subgroup for which information is provided has 1 tables Number of tables in this subgroup messages Messages sent that are not associated with a particular table ID bytes Bytes sent that are not associated with a particular table ID table Specific table ID for which information is provided 6 members Number of consumers associated with this table dnld act Indicates whether the conv...

Page 13: ...for a specific BCDL group event Displays event trace entries grpsnd Displays group send trace entries hexdump Displays traces in hexidecimal format last n Displays the last n number of traces only reverse Displays the most recent traces first stats Displays execution path statistics tailf Displays new traces as they are added unique Displays unique entries only along with the count of the number o...

Page 14: ...d 172153 node 0 0 CPU0 Jul 7 09 02 30 807 bcdl a ipv4_rib 0 0 CPU0 t3 E add new member pid 172153 node 0 0 CPU0 nmc 0 1 Jul 7 09 02 31 812 bcdl a ipv4_rib 0 0 CPU0 t5 E attempt open producer connection sg 0 Jul 7 09 02 31 895 bcdl a ipv4_rib 0 0 CPU0 t5 E bind sg 0 to producer fd 14 handle 0x48230e08 Jul 7 09 02 31 895 bcdl a ipv4_rib 0 0 CPU0 t5 E sbe gid 2055 lwg_s 0 lwg 2056 node 0 0 CPU0 ent 1...

Page 15: ...0 Series Router System Management Command Reference OL 17231 01 Boot Commands on Cisco IOS XR Software This chapter describes the commands used to boot or reset Cisco IOS XR software For more information about boot tasks see Cisco ASR 14000 Series Routers Getting Started Guide ...

Page 16: ...DSC The DSC is the primary RP of the router When setting the configuration register value for the config register command note the following conditions If both the primary and standby DSC are up and running when the configuration register value is set the configuration register value applies to both the primary and standby DSC By contrast if only the primary DSC is up and running when the configur...

Page 17: ...2 Successfully set config register to 0x2 on node 0 RP0 CPU0 Successfully set config register to 0x2 on node 0 RP1 CPU0 Related Commands Table 5 Common Configuration Register Settings Value Description 0x0 RP enters ROMMON mode rommon B1 on the next system boot 0x2 RP loads the Cisco IOS XR software and default configuration on the next system boot After logging in the user can access EXEC mode 0x...

Page 18: ... be partitioned using the format command If the primary boot device is not partitioned once mirroring is enabled and all data on the primary boot device is replicated to the secondary device the primary boot device is partitioned automatically This guarantees that only critical data on the primary boot device is mirrored to the secondary device Noncritical data such as logging data should not be m...

Page 19: ... shows how to configure disk mirroring from the primary boot device disk0 to the secondary storage device disk1 RP 0 RP0 CPU0 router config mirror location 0 rp0 cpu0 disk0 disk1 Related Commands Task ID Operations root lr read write Command Description format Formats a file system mirror pause Temporarily pauses disk mirroring on a node mirror resume Resumes disk mirroring on a node after it has ...

Page 20: ...s command is primarily useful during an installation operation to prevent significant performance degradation on single CPU boards The mirror pause command does not change the configured state of mirroring but rather causes the mirroring to be suspended until the mirror resume command is used The mirror pause command has no affect if the mirror configuration command is not enabled Task ID Examples...

Page 21: ...up that includes the proper task IDs The mirror resume command resumes the mirroring of the primary boot device after it has been temporarily paused with the mirror pause command The mirror resume command has no affect if the mirror configuration command is not enabled and the mirror pause command has not been used Task ID Examples The following example shows how to resume disk mirroring on the ac...

Page 22: ... that includes the proper task IDs The mirror verify command verifies the synchronization consistency between the primary and secondary media devices being used in mirroring The command verifies that the full contents are identical between the mirrored devices and reports any inconsistencies found Task ID Examples The following example shows how to verify the disk mirroring on the active RP RP 0 R...

Page 23: ...de If a standby DSDRSC is in the ready redundancy state the reload command also causes the router to fail over to the standby DSDRSC Use the show redundancy command in EXEC mode to display the status of the standby RP When the reload command is used and a failover occurs the running active software configuration is automatically maintained during failover Caution If a standby RP is not installed o...

Page 24: ...1 device 7 Vendor ID 0x1013 PCI1 device 8 Device ID 0x649 PCI1 device 8 Vendor ID 0x1095 PCI1 device 9 Device ID 0x5618 PCI1 device 9 Vendor ID 0x14e4 PCI1 device 10 Device ID 0x5618 PCI1 device 10 Vendor ID 0x14e4 System Bootstrap Version 1 15 20040120 002852 Copyright c 1994 2004 by cisco Systems Inc Board type is 0x100000 1048576 Enabling watchdog Broadcom 5618 0 Found on PCI Broadcom 5618 1 Fo...

Page 25: ... and attempt to recover from internal inconsistencies To reload a specific node on the router specify the reload command with the location node id keyword and argument The node id is expressed as rack slot module To ensure a graceful reload and ensure the sanity of the configuration file system enter the cfs check command on each SDR that has nodes impacted by the reload Task ID Examples The follo...

Page 26: ...ile corruptions or loss of config Proceed Y N Y Note To ensure the sanity of the configuration file system enter the cfs check command on the router Related Commands Command Description cfs check Verifies the Configuration File System CFS config register Defines the configuration register setting in administration EXEC mode reload Performs a reload of the route processor show redundancy Displays t...

Page 27: ...learly understand their temporal relationship to one another and the amount of time spent performing critical operations Task ID hexdump Displays traces in hexidecimal format last n Displays the last n number of traces only reverse Displays the most recent traces first stats Displays execution path statistics tailf Displays new traces as they are added unique Displays unique entries only along wit...

Page 28: ... CPU0 t1 00 00 32 sysmgr start Jul 12 21 17 55 315 epm boot 0 RP0 CPU0 t7 00 00 33 sysmgr start level start Jul 12 21 17 59 899 epm boot 0 RP0 CPU0 t9 00 00 37 sysmgr start level admin Jul 12 21 20 13 564 epm boot 0 RP0 CPU0 t15 00 02 51 sysmgr start level infra Jul 12 21 21 47 562 epm boot 0 RP0 CPU0 t11 00 04 25 sysmgr start level active Jul 12 21 22 09 132 epm boot 0 RP0 CPU0 t6 00 04 47 sysmgr...

Page 29: ...oper task IDs Task ID Examples The following is sample output from the show mirror command RP 0 RP0 CPU0 router show mirror Mirror Information for 0 0 CPU0 Mirroring Enabled Configured Primary disk0 Configured Secondary disk1 Current Mirroring State Syncing Files Current Physical Primary disk1 Current Physical Secondary disk0 Mirroring Logical Device disk0 Physical Device State Flags disk0 Availab...

Page 30: ...irroring Possible values are as follows Syncing files Files are being synchronized between the primary and secondary disks Not Configured Mirroring is not configured Mirroring Paused In this state no mirroring is being done to the secondary device and the disk redundancy has been removed The values of the BOOT_DEV_SEQ_OPER and MIRROR_ENABLE variables reflect this Redundant The primary and secondar...

Page 31: ...ary device in the mirroring process Note This variable is also shared by the disk backup feature This variable can also be set or unset using the system boot sequence command of the disk backup feature But the use of system boot sequence and system backup commands is blocked if mirroring is enabled BOOT_DEV_SEQ_OPER ROM Monitor environmental variable that reflects the state of the disk redundancy ...

Page 32: ... information crashinfo syslog and kernel dumper ltrace trace can be displayed for the first or last reboot if it is an ungraceful reboot Task ID first Displays information about the first ungraceful reboot last Displays information about the last ungraceful reboot crashinfo Displays crash information for an ungraceful reboot syslog Displays the syslogs related to an ungraceful reboot trace Display...

Page 33: ...820f928 48210654 48201cc0 06 Fri Jul 20 02 10 51 2007 0x00000001 Cause User Initiated reload Process reload Traceback fc15a1a0 fc15a290 fc0 45d90 48200624 48202120 0 07 Mon Jul 23 19 39 49 2007 0x00000045 Cause RP cold booted with incorrect software Process insthelper Traceback fc1941a0 fc194290 fc6 1a4a0 4820f8b0 48210fc8 48201cc0 08 Mon Jul 23 19 54 45 2007 0x00000002 Cause User Initiated Reboot...

Page 34: ...932 fc1944c8 cnd xer R36 44000094 20000006 SUPERVISOR REGISTERS Memory Management Registers Instruction BAT Registers Index Value IBAT0U 0x1ffe IBAT0L 0x12 IBAT1U 0 IBAT1L 0 IBAT2U 0x30000ffe IBAT2L 0xf0000032 IBAT3U 0xfffc0003 IBAT3L 0x40011 Data BAT Registers Index Value DBAT0U 0x1ffe DBAT0L 0x12 DBAT1U 0 DBAT1L 0x10000012 DBAT2U 0x30000ffe DBAT2L 0xf000006a DBAT3U 0xfffc0003 DBAT3L 0x40011 Segm...

Page 35: ... Router System Management Command Reference OL 17231 01 0xfc1944c4 0x2d932 Miscellaneous Registers Processor Id Reg 0 HID0 0x8410c0bc HID1 0x9001ac80 MSSCR0 0x88000 MSSSR0 0 STACK TRACE 0 0xfc194290 1 0x48200738 2 0x482013cc 3 0x48201c04 4 0xfc1d4fb0 Related Commands Command Description reload Performs a reload of the route processor ...

Page 36: ...erformed for the active RP to which you are logged in including the date time and status of the last backup Use the target device argument command to display backup information for a specified device on a RP node Use the details keyword to list information about the software packages and configuration files stored on the backup device Use the diff keyword to display the differences between the sof...

Page 37: ... with the details keyword to display additional information about the configuration and software package files stored on the backup device Because this command is entered in administration EXEC mode the backup information for both the administration and SDR configurations is displayed RP 0 RP0 CPU0 router admin show system backup details System Backup information for node0_0_CPU0 on disk1 Last Bac...

Page 38: ...t disk sequence This variable is defined by the system boot sequence command The first disk is the primary device the second disk is the backup secondary device The value listed in the secondary device is also used as the default backup target device for the system backup command BOOT_DEV_SEQ_OPER ROM Monitor environmental variable for the boot disks currently in use by the system Command Descript...

Page 39: ...he router This command displays the configuration register setting and boot file setting for the RPs in the system Use the location node id keyword and argument to display the configuration register setting for a specific card The configuration register setting is set with the command config register The boot variable is set in ROM Monitor mode Task ID Examples The following is sample output from ...

Page 40: ...eries Router System Management Command Reference OL 17231 01 Related Commands Command Description config register Defines the configuration register setting in administration EXEC mode show variables system Displays internal system environmental variables set on the router show version Displays information about the Cisco IOS XR software ...

Page 41: ...ciated with a task group that includes the proper task IDs Use the show variables system command to display system environmental variables for the router Task ID Examples The following is sample output from the show variables system command The output is meant to be interpreted by Cisco personnel RP 0 RP0 CPU0 router show variables system TERM vt220 GDB_PDEBUG P1 TERM vt100 DIR_PREFIX LOADPATH pkg...

Page 42: ...hema STARTUP_PATH pkg startup TCL_LIBRARY pkg lib tcl UCODE_PATH pkg gsr ucode UCODE_ROOT_PATH pkg ucode VCM_RULES_PATH pkg vcmrules JOB_ID 0 INSTANCE_ID 1 SYSMGR_TUPLE SYSMGR_NODE node0_RP0_CPU0 EXIT_STATUS 0 SYSMGR_RESTART_REASON 0 AAA_USER egran EXEC_PID 18280619 TASKID_MAP_SIZE 72 HOME disk0 usr TMPDIR disk0 var tmp PWD disk0 usr Related Commands Command Description config register Defines the...

Page 43: ...and configuration The supported storage devices are disk0 and disk1 if installed format Optional Formats a target disk that already contains a system backup By default the system backup command formats the target disk if that target disk does not contain a previous system backup If the target disk already contains a backup then the disk is not formatted again The format keyword forces a format of ...

Page 44: ...e for the system backup such as the standby DSDRSC use the system backup command with the location node id keyword and argument To perform the backup on all router processors RPs installed in a router use the system backup command with the location all keywords in EXEC mode Note Each RP impacted by the system backup command must contain the specified target device For example if the system backup ...

Page 45: ...1 Info node0_0_CPU0 formatting target device Info node0_0_CPU0 copying admin configuration Info node0_0_CPU0 copying SDR configuration Info node0_0_CPU0 copying installed software Info node0_0_CPU0 backup complete Info node0_0_CPU0 verifying admin configuration Info node0_0_CPU0 verifying installed software Info node0_0_CPU0 verify complete Info node0_0_CPU0 command succeeded Related Commands Task...

Page 46: ...of the secondary device argument defines the device used by the system backup command To back up system software and configurations This field is optional The secondary device can also be temporarily defined when the system backup command is executed with the target device argument Use the system boot sequence command with the secondary device argument to permanently define the secondary backup de...

Page 47: ... domain routers SDRs in the system Use the system boot sequence command in EXEC mode to define the boot sequence for a specific SDR Location Node Use the location node id keyword and argument to define the boot sequence for a specific route processor RP Use the location all keywords to define the boot sequence for all RPs in the router Disabling Automatic Recovery Use the system boot sequence comm...

Page 48: ...Software system boot sequence SMR 44 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description system backup Performs a backup of software and configuration files show system backup Displays the system backup settings and history ...

Page 49: ...47 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 CDP Commands on Cisco IOS XR Software This chapter describes the Cisco IOS XR software commands for monitoring the networking device and network using Cisco Discovery Protocol CDP ...

Page 50: ... IDs By default CDP is disabled globally To enable CDP CDP must be enabled globally and then enabled for each interface To enable CDP globally use the cdp command in global configuration mode To disable CDP globally use the no form of this command in global configuration mode To enable CDP on a specific interface use the cdp command in interface configuration mode To disable CDP on a specific inte...

Page 51: ...Management Command Reference OL 17231 01 The following example shows how to disable CDP on Packet over SONET SDH POS interface 0 0 0 1 RP 0 RP0 CPU0 router config interface POS 0 0 0 1 RP 0 RP0 CPU0 router config if no cdp Related Commands Command Description show cdp Displays global CDP information including timer and holdtime information ...

Page 52: ...story Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs CDPv2 packets are sent by default CDP also sends and receives CDPv1 packets if the device with which CDP is interacting does not process CDPv2 packets CDPv2 adds device information over CDPv1 The additional information that is contained in the CDPv2 messages relates...

Page 53: ...IOS XR Software cdp advertise v1 SMR 51 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description cdp Enables CDP on a supported interface show cdp Displays global CDP information including timer and holdtime information ...

Page 54: ... packets are sent with a time to live value or holdtime that is nonzero after an interface is enabled The CDP holdtime must be set to a higher number of seconds than the time between CDP transmissions which is set using the cdp timer command Task ID Examples The following example shows how to specify that the CDP packets sent from the networking device are held by the receiving device for 60 secon...

Page 55: ...oftware cdp holdtime SMR 53 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description cdp timer Specifies how often the software sends CDP updates show cdp Displays global CDP information including timer and holdtime information ...

Page 56: ...up that includes the proper task IDs When CDP adjacency table logging is enabled a syslog is generated each time a CDP neighbor is added or removed Task ID Examples The following example shows how to enable CDP adjacency table logging RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config cdp log adjacency changes When CDP adjacency table logging is enabled a syslog is generated each time a CD...

Page 57: ...mmands on Cisco IOS XR Software cdp log adjacency changes SMR 55 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description show cdp Displays global CDP information including timer and holdtime information ...

Page 58: ...his command you must be in a user group associated with a task group that includes the proper task IDs A lower timer setting causes CDP updates to be sent more frequently Task ID Examples The following example shows how to set the CDP timer to 80 seconds which is less frequent than the default setting of 60 seconds RP 0 RP0 CPU0 router config cdp timer 80 Related Commands seconds Frequency with wh...

Page 59: ...utput shows that all traffic counters have been reset to zero 0 RP 0 RP0 CPU0 router clear cdp counters RP 0 RP0 CPU0 router show cdp traffic CDP counters Packets output 0 Input 0 Hdr syntax 0 Chksum error 0 Encaps failed 0 No memory 0 Invalid packet 0 Truncated 0 CDP version 1 advertisements output 0 Input 0 CDP version 2 advertisements output 0 Input 0 Unrecognize Hdr version 0 File open failed ...

Page 60: ...sh table size as seen in the show cdp command output Task ID Examples The following example shows how to clears and resize the CDP table The output of the show cdp neighbors command before and after use of the clear cdp table command shows that all information has been deleted from the table RP 0 RP0 CPU0 router show cdp neighbors Capability Codes R Router T Trans Bridge B Source Route Bridge S Sw...

Page 61: ...orm Port ID The show cdp command shows that the table has been resized RP 0 RP0 CPU0 router show cdp Global CDP information Sending CDP packets every 60 seconds Sending a holdtime value of 180 seconds Sending CDPv2 advertisements is enabled Related Commands Command Description show cdp Displays global CDP information including timer and holdtime information show cdp neighbors Displays information ...

Page 62: ...IDs Use the show cdp command to display CDP version timer and holdtime information relative to CDP operations Task ID Examples The following example shows how to use the show cdp command to verify the CDP global settings RP 0 RP0 CPU0 router show cdp Global CDP information Sending CDP packets every 20 seconds Sending a holdtime value of 30 seconds Sending CDPv2 advertisements is not enabled Table ...

Page 63: ...ons continued Field Definition Command Description cdp advertise v1 Changes the version of CDP that is used to communicate with neighboring devices to CDPv1 cdp holdtime Specifies the time for which the receiving device should hold a CDP packet sent by your networking device before discarding it cdp timer Specifies how often the software sends CDP updates clear cdp table Clears and resizes the tab...

Page 64: ...k group that includes the proper task IDs Task ID Examples The following is sample output from the show cdp entry command Information about device ID address platform interface holdtime and version is displayed RP 0 RP0 CPU0 router show cdp entry TBA04341195 Device ID TBA04341195 sys 235 SysName sys 235 Entry address es IP address 172 16 23 9 Platform WS C6006 Capabilities Trans Bridge Switch Inte...

Page 65: ...his case the platform is a trans bridge switch Interface Interface location expressed as rack slot module port Port ID outgoing port Location of the port in use by the interface Holdtime Time in seconds for which the device directs the neighbor to hold a CDP advertisement before discarding it This field is controlled by the cdp holdtime command Version Software version advertisement version Versio...

Page 66: ... specified in the command syntax information is displayed about the specific interface Not specifying the interface displays information about all interfaces Task ID type Interface type For more information use the question mark online help function interface id Physical interface identifier Naming notation is rack slot module port and a slash between values is required as part of the notation rac...

Page 67: ...p Encapsulation ARPA Sending CDP packets every 120 seconds Holdtime is 240 seconds The following is sample output from the show cdp interface command with an interface specified Information about the status CDP timer and holdtime settings is displayed for Packet over SONET SDH POS interface 0 2 0 1 only RP 0 RP0 CPU0 router show cdp interface POS 0 2 0 1 POS0 2 0 1 is Up Encapsulation HDLC Sending...

Page 68: ...ated Commands Command Description show cdp Displays global CDP information including timer and holdtime information show cdp entry Displays information about a specific neighboring device or all neighboring devices discovered using CDP show cdp neighbors Displays information about neighboring devices discovered by CDP show cdp traffic Displays traffic information between devices gathered using CDP...

Page 69: ...he detail keyword to display additional information including IPv6 neighbors type Interface type For more information use the question mark online help function interface id Physical interface identifier Naming notation is rack slot module port and a slash between values is required as part of the notation rack Chassis number of the rack slot Physical slot number of the modular services card line ...

Page 70: ...t fields shown in the display The following is sample output for IPv4 and IPv6 neighbors from the show cdp neighbors detail command RP 0 RP0 CPU0 router show cdp neighbor detail Task ID Operations cdp read Table 11 show cdp neighbors Field Descriptions Field Description Capability Codes Type of device that can be discovered Device ID Name of the neighbor device Local Intrfce Protocol being used by...

Page 71: ...tionless Network Service CLNS protocol conventions Platform Product name and number of the neighbor device Capabilities Device type of the neighbor This device can be a router a bridge a transparent bridge a source routing bridge a switch a host an IGMP device or a repeater Interface Interface being used by the connectivity medium Port ID Port number of the port on the current device Holdtime Rema...

Page 72: ...with a task group that includes the proper task IDs Task ID Examples The following is sample output from the show cdp traffic command RP 0 RP0 CPU0 router show cdp traffic CDP counters Packets output 50662 Input 40414 Hdr syntax 0 Chksum error 0 Encaps failed 0 No memory 0 Invalid packet 0 Truncated 0 CDP version 1 advertisements output 0 Input 0 CDP version 2 advertisements output 50662 Input 404...

Page 73: ...advertisements on an interface because of a failure caused by the bridge port of the local device No memory Number of times that the local device did not have enough memory to store the CDP advertisements in the advertisement cache table when the device was attempting to assemble advertisement packets for transmission and parse them when receiving them Invalid packet Number of invalid CDP advertis...

Page 74: ...d Commands Command Description show cdp Displays global CDP information including timer and holdtime information show cdp entry Displays information about a specific neighboring device or all neighboring devices discovered using CDP show cdp interface Displays information about the interfaces on which CDP is enabled show cdp neighbors Displays information about neighboring devices discovered by CD...

Page 75: ...ent Command Reference OL 17231 01 Clock Commands on Cisco IOS XR Software This chapter describes the commands used to set and display the internal clock settings in the Cisco IOS XR software For more information about manually setting the router clock see Cisco ASR 14000 Series Router Getting Started Guide ...

Page 76: ... even if the router is powered off or rebooted The hardware system clock is separate from the software clock settings which are erased when the router is power cycled or rebooted Use the clock read calendar command to manually copy the hardware clock setting into the software clock Task ID Examples In the following example the hardware clock settings are copied to the software clock with the clock...

Page 77: ...ck Commands on Cisco IOS XR Software clock read calendar SMR 75 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 show clock Displays the clock settings update calendar Periodically updates the calendar from NTP Command Description ...

Page 78: ...ck Use the clock set command if no other time sources are available The time specified in this command is relative to the configured time zone Task ID Examples Setting the Software Clock This example shows how to set the software clock using the clock set hh mm ss day month year form of the command RP 0 RP0 CPU0 router clock set 14 12 00 10 feb 2005 14 12 00 114 JST Fri Feb 10 2005 This example sh...

Page 79: ...k 14 38 11 292 PST Tue Feb 10 2005 Displaying the Available Months This example shows how to display the available months using the online help system RP 0 RP0 CPU0 router clock set 06 10 00 12 january Month of the Year february march april may june july august september october november december Related Commands Command Description clock summer time Configures the system to switch automatically t...

Page 80: ...ation Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs zone Name of the time zone for example PDT to be displayed when summer time is in effect Table 14 on page 80 lists common time zone acronyms used for the zone argument recurring Indicates that summer time should start and end on the corresponding spe...

Page 81: ...ne The start time is relative to standard time The end time is relative to summer time If the starting month is after the ending month the system assumes that you are in the Southern Hemisphere Task ID Examples The following example specifies that summer time starts on the first Sunday in April at 02 00 and ends on the last Sunday in October at 02 00 The recurring keyword indicates that the rules ...

Page 82: ...o display the time zone when setting the time manually The system keeps time internally in UTC Table 14 lists common time zone acronyms used for the zone argument zone Name of the time zone to be displayed when standard time is in effect hours offset Hours offset from Coordinated Universal Time UTC Range is from 23 to 23 minutes offset Optional Minutes offset from UTC Release Modification Release ...

Page 83: ...and time of year EST Eastern Standard Time as UTC minus 5 hours EDT Eastern Daylight Saving Time as UTC minus 4 hours CT Central Time either as CST or CDT depending on place and time of year CST Central Standard Time as UTC minus 6 hours CDT Central Daylight Saving Time as UTC minus 5 hours MT Mountain Time either as MST or MDT depending on place and time of year MST Mountain Standard Time as UTC ...

Page 84: ...Zone Designators Letter Designator Word Designator Difference from UTC Y Yankee UTC minus 12 hours X Xray UTC minus 11 hours W Whiskey UTC minus 10 hours V Victor UTC minus 9 hours U Uniform UTC minus 8 hours T Tango UTC minus 7 hours S Sierra UTC minus 6 hours R Romeo UTC minus 5 hours Q Quebec UTC minus 4 hours P Papa UTC minus 3 hours O Oscar UTC minus 2 hours N November UTC minus 1 hour Z Zulu...

Page 85: ...000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description clock set Sets the software clock settings clock summer time Configures the system to switch automatically to summer time daylight saving time clock timezone Sets the time zone for display show clock Displays the clock settings ...

Page 86: ...ask group that includes the proper task IDs The hardware clock calendar runs continuously even if the router is powered off or rebooted If the software clock and calendar are not synchronized and the software clock is more accurate use this command to update the hardware calendar clock to the correct date and time Task ID Examples The following example shows how to copy the current time from the s...

Page 87: ...d you must be in a user group associated with a task group that includes the proper task IDs Note This command is not fully supported at this time To display a complete listing of the available country codes use the online help function RP 0 RP0 CPU0 router config locale country AD Andorra AE United Arab Emirates AF Afghanistan AG Antigua and Barbuda AI Anguilla AL Albania AM Armenia AN Netherland...

Page 88: ...0 Series Router System Management Command Reference OL 17231 01 More Task ID Examples The following example shows how to set the country of use to Australia RP 0 RP0 CPU0 router config locale country au Related Commands Task ID Operations host services read write Command Description locale language Sets the default language of use ...

Page 89: ... use this command you must be in a user group associated with a task group that includes the proper task IDs Note This command is not fully supported at this time To display a complete listing of the available language codes use the online help function RP 0 RP1 CPU0 router config locale language aa Afar ab Abkhazian af Afrikaans am Amharic ar Arabic as Assamese ay Aymara More Task ID Examples The...

Page 90: ... ev iew R 3 7 1 Clock Commands on Cisco IOS XR Software locale language SMR 88 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description locale country Sets the default country of use ...

Page 91: ...l the clock is authoritative and the authoritative flag is set the flag prevents peers from synchronizing to the clock when the peers have invalid times Table 16 describes the leading symbols that precede the show clock display Task ID Examples The following sample output shows the current clock settings RP 0 RP0 CPU0 router show clock 16 18 28 927 PST Tue Feb 10 2005 The following sample output s...

Page 92: ... a R ev iew R 3 7 1 Clock Commands on Cisco IOS XR Software show clock SMR 90 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description clock set Sets the software clock settings ...

Page 93: ...Reference OL 17231 01 Configuration Management Commands on Cisco IOS XR Software This chapter describes the Cisco IOS XR software commands used to manage your basic configuration For detailed information about configuration management concepts tasks and examples see Cisco ASR 14000 Series Router Getting Started Guide ...

Page 94: ...be discarded You will not be prompted to commit the changes Task ID This command requires the task ID for the feature or configuration submode impacted by the command Examples The following example shows how to use the abort command to discard all changes made during a configuration session RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config interface pos 0 2 0 0 RP 0 RP0 CPU0 router config...

Page 95: ...EXEC mode is used to execute various administration plane commands Note Administration commands can be run only by entering administration mode and not by prefixing the command with the admin keyword in EXEC mode Task ID Examples The following example shows how to enter administration EXEC mode RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin To use administration configuration mode use the c...

Page 96: ...d The alias can then be used in command lines in place of the defined entity Following is a list of properties for an alias An alias can be used anywhere in any mode or submode An alias can have zero one or many parameters An alias can refer to those parameters with the sign If an alias refers to more than one command the commands must be separated by a semicolon The size of the alias command is l...

Page 97: ... ipbr show ipv4 interface brief end RP 0 RP0 CPU0 router config commit RP 0 RP0 CPU0 Feb 21 04 42 57 017 config 65689 MGBL LIBTARCFG 6 COMMIT Co nfiguration committed by user lab Use show configuration commit changes 1000000022 to view the changes RP 0 RP0 CPU0 router config end RP 0 RP0 CPU0 Mar 27 22 19 05 config 65739 SYS 5 CONFIG_I Configured from console by lab RP 0 RP0 CPU0 router ipbr RP 0 ...

Page 98: ...both intname show interface intname show run interface intname The following example shows the use of the alias shint_both in EXEC mode RP 0 RP0 CPU0 router exec shint_both POS1 2 3 4 Two commands are issued as follows RP 0 RP0 CPU0 router exec show interface POS1 2 3 4 show run interface POS1 2 3 4 Related Commands Command Description show aliases Displays a summary of all command aliases ...

Page 99: ...that represents a group of configuration commands Use the template command to define a template Use the end template command to exit template configuration mode and return to global configuration mode Use the show running config command with the optional template keyword and template name argument to display the contents of a template Task ID Examples The following example shows how to define a te...

Page 100: ...late SMR 98 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description end template Exits template configuration mode show running config Displays the current running active configuration template Defines a template ...

Page 101: ...ts of a target configuration session without exiting configuration mode See the clear global command Task ID This command requires the task ID for the feature or configuration submode impacted by the command Examples The following example shows how to use a clear command In this example the clear logging command clears the logging buffer The show logging command verifies that the logging buffer ha...

Page 102: ...ar EXEC SMR 100 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description clear global Discards changes to the target configuration that have not yet been committed without exiting the configuration session ...

Page 103: ...inistration EXEC mode or EXEC mode to reset the contents of a feature See the clear EXEC command Task ID This command requires the task ID for the feature or configuration submode impacted by the command Examples The following example shows how to discard uncommitted changes to the target configuration without exiting the configuration session In the following example an IPv4 address is configured...

Page 104: ...lding configuration end Related Commands Command Description abort Ends a configuration session without saving changes to the target configuration clear EXEC Resets command functions in administration EXEC mode or in EXEC mode commit Merges the target configuration to the running configuration end Terminates a session and returns the router to EXEC mode from any configuration mode exit Exits from ...

Page 105: ...er the configuration for which you want to delete the comment on a separate line To enter configuration comments enter followed by the comment The comment you enter is associated with the next configuration entered For example RP 0 RP0 CPU0 router router1 is located in xxx RP 0 RP0 CPU0 router hostname router1 RP 0 RP0 CPU0 router commit The comment is displayed in the output for the show running ...

Page 106: ...iscarded and are no longer available for rollback operations Note The clear configuration commits command deletes commits from the commit database only The running configuration thus is not changed Note When a commit ID is deleted from the commit database it is no longer available for rollback and can no longer be used to display commit changes with the show configuration rollback changes command ...

Page 107: ...figuration command Task ID Examples The following example shows how to delete the oldest 16 commit IDs to free up disk space After entering this command you will be prompted to confirm the deletion RP 0 RP0 CPU0 router clear configuration commits oldest 16 Deleting 16 rollback points 1000000021 to 1000000036 256 KB of disk space will be freed Continue with deletion confirm y Related Commands Task ...

Page 108: ...the following example is displayed RP 0 RP0 CPU0 May 26 11 58 40 662 cfgmgr rp 130 MGBL CONFIGCLI 3 BATCH_CONFIG_FAIL 28 config s failed during startup To view failed config s use the command show configuration failed startup RP 0 RP0 CPU0 May 26 11 58 41 731 cfgmgr rp 130 MGBL CONFIG 3 ADMIN_INCONSISTENCY_ALARM Admin plane configuration inconsistency alarm has been raised Configuration commits wi...

Page 109: ...e Task ID Examples The following example shows how to clear the inconsistency alarms for the admin plane configuration by entering the configuration inconsistency command in administration EXEC mode RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin clear configuration inconsistency Creating any missing directories in Configuration File system OK Initializing Configuration Version Manager OK Sy...

Page 110: ...tency alarm raised Sat Jul 15 18 18 26 2006 6 alarm inconsistency alarm cleared Sat Jul 15 19 21 03 2006 Related Commands Command Description load configuration failed startup Populates the target configuration with the contents of the previous failed configuration from the startup configuration show configuration failed startup Displays information about a configuration that failed at startup sho...

Page 111: ...lica nodes are the route processors RPs or distributed route processors DRPs that can become the designated secure domain router system controller DSDRSC Use the clear configuration inconsistency replica command if there is a configuration inconsistency between the standby DSC and the current active DSC or alternatively if the configuration on any nodes that could become the DSC is not the same as...

Page 112: ... example shows how to clear any configuration inconsistencies for the DSC configuration by using the clear configuration inconsistency replica command in EXEC mode RP 0 RP0 CPU0 Router clear configuration inconsistency replica location 0 rp1 cpu0 The replica has been repaired Related Commands Command Description show configuration inconsistency replica Displays configuration inconsistencies on a s...

Page 113: ...s to a user s target configuration are discarded Use the show configuration sessions command to identify active configuration sessions When a configuration session is cleared a message is displayed on the terminal of the terminated user For example RP 0 RP0 CPU0 router config This configuration session was terminated by user user_a from line aux0_0_CPU0 Task ID Examples The following example shows...

Page 114: ...SR 14000 Series Router System Management Command Reference OL 17231 01 RP 0 RP0 CPU0 router clear configuration sessions 00000211 002c409b 00000000 session ID 00000211 002cb09b 00000000 terminated Related Commands Command Description show configuration sessions Displays the active configuration sessions ...

Page 115: ...any errors are found none of the configuration changes takes effect replace Optional Replaces the entire running configuration with the contents of the target configuration best effort Optional Merges the target configuration with the running configuration and commits only valid changes best effort Some configuration changes might fail due to semantic errors force Optional Forces a commit operatio...

Page 116: ...file To configure automatic saving of the configuration file on every commit use the configuration commit auto save command If automatic saving of the configuration file is already enabled specifying save running filename file_path with the commit command has no additional effect Caution Saving the running configuration to a file is CPU intensive Note If you use the commit command without previous...

Page 117: ...config hostname router3 RP 0 RP0 CPU0 router2 config commit label new_name RP 0 RP0 CPU0 Feb 21 04 42 57 017 config 65689 MGBL LIBTARCFG 6 COMMIT Co nfiguration committed by user user_a Use show configuration commit changes 1000000227 to view the changes RP 0 RP0 CPU0 router3 config end RP 0 RP0 CPU0 router3 show configuration commit list SNo Label ID User Line Client Time Stamp 1 new_name user_a ...

Page 118: ...saving of the running configuration to a specified file on every commit end Terminates a session and returns the router to EXEC mode from any configuration mode exit Exits from the current configuration mode to the next higher command mode or logs out of the terminal session load Populates the target configuration with the contents of a previously saved configuration file show configuration rollba...

Page 119: ...bal configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs The configuration commit auto save command configures the system to save the running configuration to the specified file and location every time a commit command is run Alternatively you can save the configuration on a one time basis by s...

Page 120: ...sco IOS XR Software configuration commit auto save SMR 118 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description commit Merges the target configuration to the running configuration ...

Page 121: ...tion A router running Cisco IOS XR software contains multiple configurations The configuration for the router This mode is used to configure router specific features such as routing protocols The administration configuration for system wide resources and settings Some features can be configured only in administration configuration mode Global Configuration Mode Use the configure command in EXEC mo...

Page 122: ... Returning to EXEC or Administration EXEC Mode Changes to the target configuration remain inactive until the commit command is entered To leave global configuration or administration configuration mode and return to the EXEC or administration EXEC prompt issue the end or exit command you are prompted to commit any uncommitted changes To leave configuration mode and return directly to EXEC or admin...

Page 123: ...rminates a session and returns the router to EXEC mode from any configuration mode exit Exits from the current configuration mode to the next higher command mode or logs out of the terminal session show configuration config Displays the contents of the target configuration show running config Displays the current running active configuration Command Description ...

Page 124: ...Use the description command to add a description to an interface configuration The maximum number of characters is 1022 Task ID Examples The following example shows how to add a description to an interface configuration In this example the description command names a Management Ethernet interface RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config interface mgmteth 0 rp1 cpu0 0 RP 0 RP0 CPU...

Page 125: ... commands that are available to execute with the do command use the online help function at the configuration mode prompt Note The configure and describe commands are not supported under the do command Task ID Examples The following example shows how to execute an EXEC command from interface configuration mode In this example the do command displays output from the show protocols command within in...

Page 126: ...ancel cancel Entering yes saves configuration changes to the running configuration file exits the configuration session and returns the router to EXEC or administration EXEC mode If errors are found in the running configuration the configuration session does not end To view the errors enter the show configuration config command with the failed keyword Entering no exits the configuration session an...

Page 127: ...committed changes found commit them before exiting yes no cancel cancel yes RP 0 RP0 CPU0 router Related Commands Command Description abort Ends a configuration session without saving changes to the target configuration commit Merges the target configuration to the running configuration clear global Discards changes to the target configuration that have not yet been committed without exiting the c...

Page 128: ...late definition To define a template use the template command To apply a template to the target configuration use the apply template command To view the contents of a template use the show running config command with the optional template keyword and template name argument Task ID Examples The following example shows how to enter template configuration mode define a template named hostname templat...

Page 129: ...C mode When exiting from global or administration configuration mode to EXEC or administration EXEC mode you are prompted to commit any uncommitted configuration changes Uncommitted changes found commit them before exiting yes no cancel cancel Entering yes saves configuration changes to the running configuration file exits the configuration session and returns the router to EXEC or administration ...

Page 130: ...he session RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config interface pos 0 2 0 0 RP 0 RP0 CPU0 router config if ipv4 address 1 1 1 1 255 0 0 0 RP 0 RP0 CPU0 router config if exit RP 0 RP0 CPU0 router config exit Uncommitted changes found commit them before exiting yes no cancel cancel yes The following example shows how to use the exit command from EXEC mode to log off from a terminal s...

Page 131: ...s used in prompts and default configuration filenames No blank or space characters are permitted as part of a name Do not expect case to be preserved Uppercase and lowercase characters look the same to many Internet software applications It may seem appropriate to capitalize a name the same way you might do in English but conventions dictate that computer names appear all lowercase For more inform...

Page 132: ...filename of the configuration file Use the commit command in conjunction with the load command Load a new configuration with the load command and use the commit command with the replace keyword to have the loaded configuration become the active running configuration Use the show configuration failed config command with the optional load keyword to display syntax errors that occurred during the las...

Page 133: ...anagement Command Reference OL 17231 01 description My Pos Interface ipv4 address 10 10 11 20 255 0 0 0 end Related Commands Command Description commit Merges the target configuration to the running configuration show configuration failed load Displays syntax errors that occurred during the last load operation ...

Page 134: ...ion with changes from previous configuration commits The changes are not applied until you enter the commit command Use the show configuration config command to display the target configuration Task ID Examples The following example shows how to populate the target configuration with changes from a previous configuration commit RP 0 RP0 CPU0 router config load commit changes since 1000000006 Build...

Page 135: ...ion with the contents of the previous failed configuration commit Task ID Examples The following example shows how to populate the target configuration with the contents of the previous failed configuration commit RP 0 RP0 CPU0 router config load configuration failed Related Commands commit Loads the failed configuration from the last commit startup Loads the failed configuration from the startup ...

Page 136: ... group associated with a task group that includes the proper task IDs Use the load configuration removed command to populate the target configuration with the contents of the removed configuration during installation operations Task ID Examples The following example shows how to populate the target configuration with the contents of the removed configuration during installation RP 0 RP0 CPU0 route...

Page 137: ...rence between the commands is that the load rollback changes command copies the rollback changes to the target configuration and does not commit the changes until the changes are explicitly committed with the commit command Use the show configuration rollback changes command to display rollback changes Task ID Examples The following example shows how to populate the target configuration with the c...

Page 138: ... found For information about installing optional software PIEs refer to the Upgrading and Managing Cisco IOS XR Software module in Cisco IOS XR System Management Configuration Guide Use the man command to display the manual pages for a specific command on the basis of the command name a feature or a keyword Each man page contains the command name syntax command mode usage examples and related comm...

Page 139: ...ION To specify how long dynamic entries learned on an interface remain in the Address Resolution Protocol ARP cache use the arp timeout command in interface configuration mode To remove the arp timeout command from the configuration file and restore the system to its default condition with respect to this command use the no form of this command arp timeout seconds no arp timeout seconds SYNTAX DES...

Page 140: ...lays the ARP timeout value in hours minutes seconds as follows START OF LISTING ARP type ARPA ARP Timeout 04 00 00 END OF LISTING EXAMPLES The following example shows how to set the ARP timeout to 3600 seconds to allow entries to time out more quickly than the default START OF LISTING RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config interface MgmtEth 0 RP1 CPU0 0 RP 0 RP0 CPU0 router con...

Page 141: ... more command can be filtered using the options shown in Table 17 ascii Optional Displays a binary file in ASCII format binary Optional Displays a file in hexadecimal or text format ebcdic Optional Displays a binary file in ebcdic format filesystem directory path File system location of the file to be displayed Include the file system alias for the filesystem argument followed by a colon and the d...

Page 142: ...mpt The first specified filter remains until the more command output finishes or until you interrupt the output The use of the begin keyword does not constitute a filter Task ID Examples The following is partial sample output from the more command The output displays a configuration file saved on the hard disk drive RP 0 RP0 CPU0 router more harddisk user alternate cfg Last configuration change at...

Page 143: ...0 CPU0 router more disk0 config backup begin ipv4 ipv4 address 2 2 2 2 255 255 255 255 interface pos0 3 1 0 shutdown interface pos0 3 1 2 shutdown interface POS0 2 1 0 ipv4 address 1 1 1 1 255 255 255 0 keepalive disable interface POS0 2 1 1 ipv4 address 1 1 1 1 255 255 255 0 keepalive disable interface POS0 2 1 2 ipv4 address 1 1 1 1 255 255 255 0 keepalive disable interface POS0 2 1 3 shutdown i...

Page 144: ...n alias In this example at the More prompt a new search is specified beginning with output lines that contain the regular expression ipv4 address RP 0 RP0 CPU0 router more disk0 myconfig file exclude alias Building configuration Last configuration change at 18 17 00 UTC Thu May 16 2004 by lab hostname router line console exec timeout 0 0 width 132 length 0 session timeout 0 ipv4 address filtering ...

Page 145: ...onfiguration mode Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the pwd command to determine within which configuration submode you are currently located Examples The following example shows how to use the pwd command from an interface configuration submode RP 0 RP0 CPU0 router configure RP 0 RP0 ...

Page 146: ...r of configuration commits specified with the number of commits argument were made Use show configuration commit list to display a list of the commit IDs available for rollback operations Note The most recent 100 commits are retained by the system As new commit IDs are added the oldest commit IDs are discarded and are no longer available for rollback operations Use the force keyword to override co...

Page 147: ...KNOWN con0_RP0_C CLI 23 51 30 UTC Fri Sep 24 2004 9 1000000001 UNKNOWN con0_RP0_C CLI 23 08 31 UTC Fri Sep 24 2004 RP 0 RP0 CPU0 router rollback configuration to 1000000008 Loading Rollback Changes Loaded Rollback Changes in 1 sec Committing 1 items committed in 1 sec 0 items sec Updating RP 0 RP0 CPU0 Sep 26 02 42 09 318 config_rollback 65707 LIBTARCFG 6 COMMIT Configuration committed by user lab...

Page 148: ...his command you must be in a user group associated with a task group that includes the proper task IDs Use the root command to return directly to configuration mode from any configuration submode Task ID Examples The following example shows how to use the root command to return to configuration mode from the interface configuration submode RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config...

Page 149: ...gement Command Reference OL 17231 01 RP 0 RP0 CPU0 router config un root RP 0 RP0 CPU0 router config show conf Building configuration template test username xyz end template end Tip The root command is not available from the template submode but is available in the submodes configurable under the template submode ...

Page 150: ...nd To save a configuration that failed to a file use the save configuration failed command Task ID Examples The following example shows the configuration saved to disk0 from EXEC mode RP 0 RP0 CPU0 router config save configuration disk0 sample3 Destination file name control c to abort sample3 Building configuration 1 lines built in 1 second OK RP 0 RP0 CPU0 router config The following example show...

Page 151: ...ation merge Saves the changes for a merged configuration to a file save configuration removed Saves the contents of a removed configuration to a file save rollback changes Saves rollback changes for a commit ID or a group of commits show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays info...

Page 152: ...ust be in a user group associated with a task group that includes the proper task IDs To save the configuration changes to be made during a replace operation to a file use the save configuration changes command Task ID Examples The following example shows the configuration saved to disk0 from EXEC mode RP 0 RP0 CPU0 router config save configuration changes disk0 sample3 Destination file name contr...

Page 153: ...he changes for a merged configuration to a file save configuration removed Saves the contents of a removed configuration to a file save rollback changes Saves rollback changes for a commit ID or a group of commits show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information about the c...

Page 154: ...commit changes command to save the changes made in a commit operation to a file You can specify a specific commit ID all the changes since a specified commit ID or the changes that occurred during the last n commits Task ID Examples The following example saves the changes from the last two commit operations to disk0 RP 0 RP0 CPU0 router admin config save configuration commit changes last 2 disk0 s...

Page 155: ...rge Saves the changes for a merged configuration to a file save configuration removed Saves the contents of a removed configuration to a file save rollback changes Saves rollback changes for a commit ID or a group of commits show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information ...

Page 156: ...ed to a file use the save configuration failed command To save a configuration that failed during startup to a file use the save configuration failed command with the startup keyword Task ID Examples The following example saves the failed configuration to disk0 RP 0 RP0 CPU0 router admin config save configuration failed disk1 configs load Optional Saves the failed configuration syntax errors in th...

Page 157: ...iguration to a file save configuration removed Saves the contents of a removed configuration to a file save rollback changes Saves rollback changes for a commit ID or a group of commits show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information about the configuration commits stored ...

Page 158: ...the proper task IDs To save a merged configuration to a file use the save configuration merge device directory path command Task ID Examples The following example shows the configuration saved to disk0 RP 0 RP0 CPU0 router admin config save configuration merge disk0 sample3 Destination file name control c to abort sample3 Building configuration 1 lines built in 1 second OK Related Commands device ...

Page 159: ... changes Saves rollback changes for a commit ID or a group of commits show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information about the configuration commits stored in the commit database show configuration history Display history of configuration changes show configuration rollba...

Page 160: ...ning configuration and saved to a file To save a copy of the removed configuration file use the save configuration removed removed configuration file device directory path command Task ID Examples To view a list of the available removed configuration files use the save configuration removed command followed by a question mark RP 0 RP0 CPU0 router config save configuration removed 20051208042507 cf...

Page 161: ...e configuration failed Saves the contents of a failed configuration save configuration merge Saves the changes for a merged configuration to a file save rollback changes Saves rollback changes for a commit ID or a group of commits show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays inform...

Page 162: ... rollback changes command to save the changes that would be made in a configuration rollback to a specific commit point or for a series of commits Task ID Examples The following example shows that the rollback changes for the commit point 5 are saved to the file sample4 on disk0 RP 0 RP0 CPU0 router admin config save rollback changes last 1 disk0 sample4 Destination file name control c to abort sa...

Page 163: ...n to a file show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information about the configuration commits stored in the commit database show configuration history Display history of configuration changes show configuration rollback changes Displays changes that would be made by the roll...

Page 164: ... default AFI setting is set to IPv4 then you would not have to specify the ipv4 keyword for show commands that support the ipv4 keyword For example if the AFI setting is set to IPv4 you could issue the show route command without specifying the ipv4 keyword to display IPv4 routes in the Routing Information Base RIB Use the show default afi safi vrf command to display the default AFI setting Task ID...

Page 165: ...System Management Command Reference OL 17231 01 Related Commands Command Description set default safi Sets the default SAFI for the current session set default vrf Sets the default VRF settings for the current session show default afi safi vrf Displays the default AFI SAFI and VRF settings for the current session ...

Page 166: ... unicast you would not have to specify the unicast keyword for show commands that support that keyword For example if the default SAFI setting is set to unicast you could issue the show route command without specifying the unicast keyword to display information about unicast address prefixes in the Routing Information Base RIB Use the show default afi safi vrf command to display the default SAFI s...

Page 167: ...tem Management Command Reference OL 17231 01 Related Commands Command Description set default afi Sets the default AFI settings for the current session set default vrf Sets the default VRF settings for the current session show default afi safi vrf Displays the default AFI SAFI and VRF settings for the current session ...

Page 168: ...onfigured you can issue the show route command without specifying the VRF name When the default VRF for the session is set to none then IPv4 routes for the system default VRF are displayed Note To override the default VRF setting specify the VRF name in the show command Use the show default afi safi vrf command to display the default VRF setting Task ID Examples In the following example the defaul...

Page 169: ...GRP external O OSPF IA OSPF inter area N1 OSPF NSSA external type 1 N2 OSPF NSSA external type 2 E1 OSPF external type 1 E2 OSPF external type 2 E EGP i ISIS L1 IS IS level 1 L2 IS IS level 2 ia IS IS inter area su IS IS summary null candidate default U per user static route o ODR L local Gateway of last resort is 12 29 0 1 to network 0 0 0 0 S 0 0 0 0 0 1 0 via 12 29 0 1 00 31 30 L 10 10 10 10 32...

Page 170: ... a list of the available show commands use the question mark online help function Filtering Output Table 18 shows the search options for the show command command Supported show command Vertical bar the pipe symbol indicates that an output processing specification follows regular expression Optional Regular expression found in show command output begin Optional Begins unfiltered output of the show ...

Page 171: ...ion protocol appears RP 0 RP0 CPU0 router show interface include protocol Null0 is up line protocol is up 0 drops for unrecognized upper level protocol POS0 2 0 0 is administratively down line protocol is administratively down 0 drops for unrecognized upper level protocol POS0 2 0 1 is administratively down line protocol is administratively down 0 drops for unrecognized upper level protocol POS0 2...

Page 172: ... The following is sample output from the show configuration running begin line command The output begins with unfiltered output from the first line that contains the regular expression line In this example at the More prompt a new search is specified that begins with output lines that contain the regular expression ipv4 Note The use of the keyword begin does not constitute a filter RP 0 RP0 CPU0 r...

Page 173: ...use this command you must be in a user group associated with a task group that includes the proper task IDs Use the show aliases command to display all aliases currently configured on the system Task ID Examples The following is sample output from the show aliases command The output displays a summary of all the command aliases configured RP 0 RP0 CPU0 router show aliases exec mode aliases ipv4_br...

Page 174: ...guration command with the running keyword to display the running active configuration Prior to committing the target configuration use the show configuration merge command from any configuration mode to display the result of merging the target configuration with the running configuration Task ID Examples In this example the show configuration command displays uncommitted changes made during a conf...

Page 175: ... 0 0 0 shutdown end Related Commands Command Description commit Merges the target configuration to the running configuration load Populates the target configuration with the contents of a previously saved configuration file show configuration running Displays the contents of the committed configuration show configuration running config Displays the contents of the committed configuration show conf...

Page 176: ...mmand you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows the changes to be made during a replace operation RP 0 RP0 CPU0 router config show configuration changes diff Building configuration hostname router hostname bla logging console telnet vrf default ipv4 server disable domain ipv4 host xhu u5 domain ipv4 host ...

Page 177: ...ce Loopback6 description interface MgmtEth0 0 CPU0 0 ipv4 address 10 0 0 1 255 255 255 224 interface GigabitEthernet0 2 0 0 shutdown interface GigabitEthernet0 2 0 1 shutdown interface GigabitEthernet0 2 0 2 shutdown interface POS0 3 0 0 description shutdown interface POS0 4 0 0 shutdown router static address family ipv4 unicast 0 0 0 0 0 255 255 255 224 xml agent corba hostname router end ...

Page 178: ...udes the proper task IDs Each time a configuration is committed with the commit command the configuration commit operation is assigned a commit ID The show configuration commit changes command displays the configuration changes made since the specified commit To display a list of the available commit IDs enter the show configuration commit list command You can also display the commit IDs by enteri...

Page 179: ...ion commit changes 1000000077 Building configuration alias exec shrun show configuration running alias exec shver show version end The following is sample output from the show configuration commit changes command with the since keyword and commit id argument In this example the output displays the configuration changes made since the configuration commit assigned commit ID 1000000077 was committed...

Page 180: ...tion interface Loopback1000 ipv4 address 190 190 180 1 255 255 255 255 end interface Loopback1000 ipv4 address 190 190 180 1 255 255 255 255 end Related Commands Command Description rollback configuration Rolls back the configuration to a previous commit show configuration rollback changes Displays changes that would be made by the rollback configuration command or displays the list of commit IDs ...

Page 181: ...uidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the show configuration commit list command to list the commit IDs up to 100 that are available for rollback Note The most recent 100 commits are retained by the system As new commit IDs are added the oldest commit IDs are discarded and are no longer available for rollback op...

Page 182: ... otherwise the autogenerated commit ID displays User User who executed the commit Line Line in which the user session was established In some cases this field may display UNKNOWN or SYSTEM These fields indicate that an internal commit was made by the system Client The management interface used to make the commit Time Stamp Time and date when the commit was executed Command Description show configu...

Page 183: ...r configure RP 0 RP0 CPU0 router config taskgroup bgp RP 0 RP0 CPU0 router config tg description this is an example of an invalid task group RP 0 RP0 CPU0 router config tg commit Failed to commit one or more configuration items Please use show configuration failed to view the errors The following is sample output from the show configuration command with the optional failed keyword The output displ...

Page 184: ... configuration running Displays the contents of the committed configuration show configuration running config Displays the contents of the committed configuration show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information about the configuration commits stored in the commit database ...

Page 185: ...guments or keywords Defaults No default behavior or values Command Modes EXEC Administration EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Any configurations in the running configuration that are not understood by new software being installed are removed from the running configuration To see whic...

Page 186: ... command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows a failed commit operation RP 0 RP0 CPU0 router show configuration failed remove SEMANTIC ERRORS This configuration was rejected by the system due to semantic errors The individual errors with each failed configuration command can be found below multicast ...

Page 187: ...guration show configuration running config Displays the contents of the committed configuration show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information about the configuration commits stored in the commit database show configuration history Display history of configuration changes...

Page 188: ...be in a user group associated with a task group that includes the proper task IDs Task ID Related Commands Release Modification Release 3 7 1 This command was introduced on the Cisco ASR 14000 Series Router Task ID Operations config services read root lr read Command Description show configuration config Displays the contents of the target configuration show configuration running Displays the cont...

Page 189: ...n failed config Displays information about a configuration that failed during the last commit show configuration rollback changes Displays changes that would be made by the rollback configuration command or displays the list of commit IDs show configuration sessions Displays the active configuration sessions show running config Displays the current running active configuration Command Description ...

Page 190: ...a task group that includes the proper task IDs Task ID Related Commands noerror Optional Displays the configuration that failed at startup without an error reason previous number Optional Displays the previous failed startup configuration or configurations The number argument is a value from 1 to 4 which displays the failed startup configurations in previous number of sessions Release Modification...

Page 191: ...base show configuration history Display history of configuration changes show configuration failed config Displays information about a configuration that failed during the last commit show configuration rollback changes Displays changes that would be made by the rollback configuration command or displays the list of commit IDs show configuration sessions Displays the active configuration sessions ...

Page 192: ...p associated with a task group that includes the proper task IDs Use the show configuration history command to display information about the last up to 1500 configuration events alarm Optional Displays alarm events backup Optional Displays configuration backup events cfs check Optional Displays CFS check events commit Optional Displays commit events detail Optional Displays detailed information in...

Page 193: ... 15 23 33 2006 5 OIR config restore Thu Jun 22 15 23 33 2006 6 OIR config restore Thu Jun 22 15 23 34 2006 7 OIR config restore Thu Jun 22 15 23 34 2006 8 OIR config restore Thu Jun 22 15 23 35 2006 9 OIR config restore Thu Jun 22 15 23 36 2006 10 OIR config restore Thu Jun 22 15 23 37 2006 11 OIR config restore Thu Jun 22 15 23 37 2006 12 OIR config restore Thu Jun 22 15 23 38 2006 13 OIR config ...

Page 194: ...r lab Line vty0 Client CLI Comment 5 Event commit Time Sat Jul 1 15 32 25 2006 Commit ID 1000000002 Label User lab Line vty0 More Table 20 describes the significant fields shown in the display Related Commands Table 20 show configuration history Field Descriptions Field Description SNo Serial number of the entry Event Type of configuration event Info Summary of the configuration action Time Stamp ...

Page 195: ...it list Displays information about the configuration commits stored in the commit database show configuration failed config Displays information about a configuration that failed during the last commit show configuration failed startup Displays information about a configuration that failed at startup show configuration rollback changes Displays changes that would be made by the rollback configurat...

Page 196: ...ica nodes are the route processors RPs or distributed route processors DRPs that can become the designated secure domain router system controller DSDRSC Use the show configuration inconsistency replica command before performing a manual failover or DSC migration to verify that the node in line to take over for the DSC or DSDRSC is in good shape If any problems are reported use the clear configurat...

Page 197: ...ration inconsistency replica SMR 195 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Replica is consistent Related Commands Command Description clear configuration inconsistency replica Resolves configuration inconsistencies on a replica node ...

Page 198: ...restored after the router is reloaded The running configuration should be the same as the persistent configuration Use this command with the diff argument if you want to check if due to a bug there is a difference between the running configuration and the persistent configuration Task ID Examples The following example shows that there is no difference between the running configuration and the pers...

Page 199: ...s Router System Management Command Reference OL 17231 01 interface TenGigE0 1 0 1 1 vrrp 1 preempt delay 300 interface TenGigE0 1 0 1 2 vrrp 1 preempt delay 300 interface TenGigE0 1 0 1 3 vrrp 1 preempt delay 300 Related Commands Command Description show running config Displays the current running active configuration ...

Page 200: ...cludes the proper task IDs Task ID Examples The following example shows a removed configuration RP 0 RP0 CPU0 router show configuration removed 20060301112919 cfg xml agent corba http server end Related Commands config id Name of removed configuration Type to see a list of the names of all removed configurations Release Modification Release 3 7 1 This command was introduced on the Cisco ASR 14000 ...

Page 201: ...mit database show configuration history Display history of configuration changes show configuration failed config Displays information about a configuration that failed during the last commit show configuration failed startup Displays information about a configuration that failed at startup show configuration rollback changes Displays changes that would be made by the rollback configuration comman...

Page 202: ... The most recent 100 commits are retained by the system As new commit IDs are added the oldest commit IDs are discarded and are no longer available for rollback operations Use the commit id argument without the to keyword to display the changes for a particular commit This can be useful for troubleshooting actions of the rollback configuration command commit id Name of configuration When a specifi...

Page 203: ...hanges command with last keyword and number of commits argument The output displays the configuration changes that would occur if the configuration were to be rolled back to the number of configuration commits specified for the number of commits argument RP 0 RP0 CPU0 router show configuration rollback changes last 2 Building configuration hostname orig_name interface POS0 1 0 1 shutdown end The f...

Page 204: ...ow configuration running command to display the currently active configuration Task ID Examples The following example shows the currently running committed configuration RP 0 RP0 CPU0 router admin show configuration running Building configuration username lab secret 5 1 XNWt j8RscNdncKSRoMSnqSpbj group root system end Related Commands config keyword Optional Specific configuration to display Relea...

Page 205: ... the configuration commits stored in the commit database show configuration history Display history of configuration changes show configuration failed config Displays information about a configuration that failed during the last commit show configuration failed startup Displays information about a configuration that failed at startup show configuration rollback changes Displays changes that would ...

Page 206: ...k IDs Use the config keyword argument to display the running configuration for a specific keyword only Task ID Examples The following example shows the currently running committed configuration RP 0 RP0 CPU0 router show configuration running config Building configuration Last configuration change at 15 36 31 UTC Thu Nov 17 2005 by lab sessions Users with active configuration sess n hostname router...

Page 207: ... target configuration show configuration running Displays the contents of the committed configuration show configuration commit changes Displays the changes made to the running configuration by previous configuration commits show configuration commit list Displays information about the configuration commits stored in the commit database show configuration history Display history of configuration c...

Page 208: ... the proper task IDs Use the show configuration sessions command to display the active configuration sessions Use the clear configuration sessions command to clear a configuration session The show configuration sessions command can be used with the clear configuration sessions command to verify that an active configuration session was cleared Task ID Examples The following is sample output from th...

Page 209: ...ration session ID number Line Line in which the user session was established In some cases this field may display UNKNOWN or SYSTEM These fields indicate that an internal commit was made by the system User User who initiated the configuration session Date Time and date the configuration session was started Lock Locked running configuration An asterisk displayed in this field means the session has ...

Page 210: ...uidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the show default afi safi vrf command to display the default AFI and SAFI settings for the current session The AFI and SAFI settings are controlled by the following commands set default afi set default safi set default vrf Task ID Examples The following is sample output from...

Page 211: ...ASR 14000 Series Router System Management Command Reference OL 17231 01 Command Description set default afi Sets the default AFI setting for the current session set default safi Sets the default SAFI setting for the current session set default vrf Sets the default VRF setting for the current session ...

Page 212: ...ommand displays a history of the command entered for the current command mode For example enter the show history command to display a history of commands entered in EXEC mode Enter the show history command in global configuration mode to display a history of the commands entered in global configuration mode Task ID Examples In the following example the show history command is run in EXEC mode to d...

Page 213: ... SMR 211 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 RP 0 RP0 CPU0 router config show history interface pos 0 1 0 0 ipv4 address 10 0 0 0 root end describe line default autocommand config line default autocommand configure end show history ...

Page 214: ...reset or power cycle The running configuration is the committed configuration Sanitized Output Use the show running config command with the sanitized keyword to display the contents of the active running configuration without installation specific parameters Some configuration details such as IP addresses are replaced with different addresses The sanitized configuration can be used to share a conf...

Page 215: ... entry community set Define a community set controller Controller configuration subcommands dhcp Dynamic Host Configuration Protocol domain Domain service related commands exception Coredump configuration commands exclude Exclude a feature or configuration item from display explicit path Explicit path config commands extcommunity set Define an extended communitiy set fault Fault related commands f...

Page 216: ...vers no limit snmp server ifindex persist snmp server host 10 0 0 1 traps version removed priv removed udp port 2555 snmp server view removed removed included snmp server community removed RO LROwner snmp server community removed RO LROwner snmp server group removed v3 priv read removed write removed snmp server traps snmp snmp server traps syslog interface Loopback10 interface Loopback1000 More R...

Page 217: ...up associated with a task group that includes the proper task IDs The show xml schema command runs the XML schema browser so that you can browse the XML schema and data Task ID Examples The following example shows how to enter the XML schema browser and the available commands RP 0 RP0 CPU0 router show xml schema Username xxxx Password Enter help or for help xml schema config config oper action adm...

Page 218: ...ds on Cisco IOS XR Software show xml schema SMR 216 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Command Description copy xml schema Copies the XML schema files on the router as a tar ball file tar gz ...

Page 219: ...te provides modularity and ease of use during user configuration Use the end template command to exit template configuration mode After defining a template use the apply template command to apply the template Use the show running config command with the optional template keyword and template name argument to display the contents of a template Task ID Examples The following example shows how to ent...

Page 220: ...ent The following is sample output from the show running config command with the template keyword and name argument In this example the output displays the contents of a template named pre pos RP 0 RP0 CPU0 router show running config template pre pos template pre pos interface preconfigure POS0 1 0 0 ipv4 address 10 3 32 154 255 0 0 0 end template Related Commands Command Description apply templat...

Page 221: ...ds used to manage file systems Caution The commands in this chapter should not be used to access or modify any Cisco IOS XR software or configuration files Use only the documented commands for installing and configuring the router Modifying deleting or moving configuration or software package files using the manual commands described in this chapter is not required and can result in router downtim...

Page 222: ...out specifying the filesystem argument the files in the present working directory are displayed Use the pwd command to display the present working directory Use the show filesystem command to display the available storage devices Enter the cd command without an argument to return the present working directory to disk0 usr Task ID Examples The following example shows how to change the present worki...

Page 223: ... to the default file directory by specifying the cd command without a location In this example the pwd command confirms that the present working directory has changed to the default file directory RP 0 RP0 CPU0 router cd RP 0 RP0 CPU0 router pwd disk0 usr Related Commands Command Description dir Displays the contents of a file system pwd Displays the current working directory of the cd command sho...

Page 224: ...e the cfs check command to check the sanity of the configuration file system and attempt to recover from internal inconsistencies one or more rollback points may be lost depending on the severity of the state of the file system Note While this command runs redundancy of the designated secure domain router system controller DSDRSC is disabled Task ID Examples The following example shows how to perf...

Page 225: ...e flash keyword is an alias for bootflash ftp Copies from an FTP network server The syntax is ftp username password location directory filename harddisk Copies from the hard disk drive file system if present harddiska Copies from the hard disk partition a harddiskb Copies from the hard disk partition b nvram Copies from the NVRAM file system prefix list ipv4 ipv6 Copies from a prefix list EXEC mod...

Page 226: ...haracter cannot be the first character cannot be the last character cannot be the filename without other characters The following characters cannot be used in filenames The maximum length allowed by the Cisco ASR 14000 Series Router router for a filename is 254 characters including the path If a filename longer than 254 characters is specified the filename is truncated to 254 characters To copy a ...

Page 227: ...target device location node id location all Example RP 0 RP0 CPU0 router copy tftp 1 1 1 1 images casr14k mcast p pie disk1 Note Some Cisco IOS XR software images may be larger than 32 MB and the TFTP services provided by some vendors may not support a file this large If you do not have access to a TFTP server that supports files larger than 32 MB download the software image using FTP or rcp as de...

Page 228: ...rname on the network server For example if the system image resides in the home directory of a user on the network server specify the name of that user as the remote username Refer to the documentation for your FTP server for more details Using rcp The rcp protocol requires a username upon each request When you copy a configuration file or image between the networking device and an rcp server the ...

Page 229: ...guration file to the running config destination the configuration in the file is applied to the running configuration of the system This is a configuration operation By default the copy is carried out in a best effort manner This means that if some configuration lines from the file cannot be applied the remaining configuration is still integrated into the system In this case a partial configuratio...

Page 230: ... example shows how to copy a file from a FTP server to disk1 RP 0 RP0 CPU0 router copy ftp john secret 10 1 1 1 images comp asr14k full pie disk1 Related Commands Task ID Operations filesystem execute Command Description cd Changes the default directory or file system dir Displays the contents of a file system show configuration failed config Displays information about a configuration that failed ...

Page 231: ...om the system and cannot be restored undeleted Use the dir command to display the list of files on a storage device Task ID Examples The following example shows how to delete a file RP 0 RP0 CPU0 router delete rbtest Delete disk1 rbtest confirm y noprompt Optional Causes no prompt for confirmation before deleting the specified files ena Optional Deletes all files from and below the current working...

Page 232: ...System Commands on Cisco IOS XR Software delete SMR 230 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description cd Changes the default directory or file system dir Displays the contents of a file system ...

Page 233: ...rd displays all files including deleted files The size associated with the directory name is the total size for all files in that directory Task ID all Optional Lists deleted files undeleted files and files with errors ena Optional Recognizes subdirectories recurse Optional Recursively lists subdirectories filesystem Optional Name of the directory containing the files to be displayed Include the f...

Page 234: ...og Directory of harddisk log 5527 drwx 4096 Thu Aug 28 11 21 48 2003 boot_28_Aug_2003_11_21_49 5533 drwx 4096 Thu Aug 28 11 38 54 2003 boot_28_Aug_2003_11_38_54 5538 drwx 4096 Fri Sep 5 13 28 54 2003 boot_05_Sep_2003_13_28_54 5543 drwx 4096 Mon Sep 8 08 55 52 2003 boot_08_Sep_2003_06_59_08 More Related Commands Command Description cd Changes the default directory or file system pwd Displays the cu...

Page 235: ...this command you must be in a user group associated with a task group that includes the proper task IDs Caution Using the erase nvram command permanently removes the files Task ID Examples The following example shows how to erase the NVRAM file system RP 0 RP0 CPU0 router erase nvram Erase operation will destroy IOS ENA files in nvram Continue confirm y Related Commands format Optional Formats the...

Page 236: ...two partitions The first partition consisting of 1 megabyte MB is used by the existing NVRAM file system partition The second partition consisting of 1 MB is a raw data partition and is used by the Kernel Dumper to store reboot historical logs critical crash information syslog and Kernel Dumper traces The erase nvram raw command formats the raw data partition of the NVRAM Task ID Examples The foll...

Page 237: ...ew R 3 7 1 File System Commands on Cisco IOS XR Software erase nvram raw SMR 235 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description delete Deletes a file from a flash memory device ...

Page 238: ...isk harddiska harddiskb compactflash and compactflasha partition Optional Creates a partition on a hard disk This option is not available when the bootflash keyword is entered for the filesystem argument monlib filename Optional Name of the ROM monitor library monlib file to use for formatting the file system The default monlib file is the one bundled with the system software Note The monlib is us...

Page 239: ...he size of the partitions are as indicated in Table 24 The size of the three hard disk partitions are as follows Primary partition harddisk 30 Secondary partition harddiska 60 Third partition harddiskb 10 Task ID Examples The following example shows how to format disk1 RP 0 RP0 CPU0 router format disk1 The following example shows how to format disk1 with instructions to recover any sectors on the ...

Page 240: ...R 3 7 1 File System Commands on Cisco IOS XR Software format SMR 238 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description fsck Checks a file system for a damage and repairs any problems ...

Page 241: ...the file system on flash disk0 for damage RP 0 RP0 CPU0 router fsck disk0 Phase 1 Read and compare FATs Phase 2 Check cluster chains Phase 3 Check directories Phase 4 Check for lost files 157280 kb used 843344 kb free 2541 files 190 directories Filesystem is clean Related Commands filesystem Name of the file system to check followed by a colon Possible values are disk0 disk0a disk1 disk1a harddisk...

Page 242: ...th where you want the new directory to reside If you do not specify a directory path the new directory is created in the usr directory of the file system specified for the filesystem argument Task ID Examples The following example shows how to create a directory named newdir The dir command is used to verify that the directory has been added RP 0 RP0 CPU0 router mkdir harddisk Create directory fil...

Page 243: ...c 24 11 20 52 2003 tracebacks 43035 drwx 4096 Thu Jan 8 18 59 18 2004 sau 51026 drwx 4096 Sat Dec 27 02 52 46 2003 tempA 51027 drwx 4096 Sat Dec 27 02 04 10 2003 dir not del 430307552 rwx 342 Fri Jan 16 10 47 38 2004 running config 430305504 rwx 39790 Mon Jan 26 23 45 56 2004 cf dat 39929724928 bytes total 39883231232 bytes free Related Commands Command Description dir Displays the contents of a f...

Page 244: ...Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the pwd command to show what directory or file system is specified as the default by the cd command Task ID Examples The following example shows how to display the present working directory RP 0 RP0 CPU0 router pwd disk0 usr Related Commands Releases Modifications Release 3...

Page 245: ... IOS XR software prompts you to specify the name of the directory to be deleted When a directory contains files you must remove the files before deleting the directory Use the delete command to remove files Task ID Examples The following example shows how to delete a subdirectory from the hard disk The dir command is used to verify that the directory has been deleted RP 0 RP0 CPU0 router rmdir har...

Page 246: ...u Jan 8 18 59 18 2004 sau 51026 drwx 4096 Sat Dec 27 02 52 46 2003 tempA 51027 drwx 4096 Sat Dec 27 02 04 10 2003 dir not del 430307552 rwx 342 Fri Jan 16 10 47 38 2004 running config 430305504 rwx 39790 Mon Jan 26 23 45 56 2004 cf dat 39929724928 bytes total 39883235328 bytes free Related Commands Command Description delete Deletes a file from a flash memory device dir Displays the contents of a ...

Page 247: ...command to learn the alias names prefixes of the file systems supported by your networking device Task ID Examples The following is sample output from the show filesystem command RP 0 RP0 CPU0 router show filesystem File Systems filesystem Name of the file system for which to display information followed by a colon Possible values are disk0 disk1 harddisk compactflash firmware Optional Displays th...

Page 248: ...ommand using the optional location keyword and node id argument RP 0 RP0 CPU0 router show filesystem location 0 rp0 cpu0 File Systems Size b Free b Type Flags Prefixes network rw qsm dev fs tftp tftp network rw qsm dev fs rcp rcp network rw qsm dev fs ftp ftp 39929724928 39883235328 harddisk rw harddisk 2092032 2019328 nvram rw nvram 1024606208 847888384 flash disk rw disk0 62390272 62153616 flash...

Page 249: ...edia on your system Task ID Examples The following sample output disk displays the disk storage media for the active RP RP 0 RP0 CPU0 router show media Media Information for 0 RP0 CPU0 Mountpoint FsType State DrvrPid Mirror Flags disk0 FAT16 Mounted 0024598 Enabled disk0a FAT16 Not Present disk1 FAT16 Mounted 0024599 disk1a FAT16 Not Present harddisk FAT32 Mounted 0143421 harddiska FAT32 Not Prese...

Page 250: ...r 0 RP0 CPU0 Mountpoint FsType State DrvrPid Mirror Flags disk0 FAT16 Mounted 0024598 Enabled disk0a FAT16 Not Present disk1 FAT16 Mounted 0024599 disk1a FAT16 Not Present harddisk FAT32 Mounted 0143421 harddiska FAT32 Not Present harddiskb FAT32 Not Present Media Information for 0 RP1 CPU0 Mountpoint FsType State DrvrPid Mirror Flags disk0 FAT16 Mounted 0024598 Enabled disk0a FAT16 Not Present di...

Page 251: ...Commands on Cisco IOS XR Software show media SMR 249 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description mirror Configures disk mirroring on a node mirror pause Temporarily pauses disk mirroring on a node ...

Page 252: ...itions and ensures that no further access is made to the device Use the undo option to remount the device if it is not removed and reinserted Task ID Examples The following example unmounts the disk0 file system so that it can be safely removed RP 0 RP0 CPU0 router unmount disk0 Related Commands filesystem File system to unmount followed by a colon Possible values are disk0 disk1 harddisk and comp...

Page 253: ... File System Commands on Cisco IOS XR Software unmount SMR 251 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 dir Displays the contents of a file system pwd Displays the current setting of the cd command Command Description ...

Page 254: ...C i sc o C o n f id en t ia l B et a R ev iew R 3 7 1 File System Commands on Cisco IOS XR Software unmount SMR 252 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 ...

Page 255: ...ter System Management Command Reference OL 17231 01 Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software This module describes the commands used to manage the hardware redundancy power and administrative status of the nodes on a router running Cisco IOS XR software ...

Page 256: ...s Administration configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to enable files to be written to the TFTP server RP 0 RP0 CPU0 router config ce tftp server write The following example shows how to enable TFTP on a specific directory In this...

Page 257: ...p associated with a task group that includes the proper task IDs For more information about identifying and selecting a DSC on the Cisco ASR 14000 Series Router refer to Cisco ASR 14000 Series Router Getting Started Guide Note The serial ID is the hardware serial number that identifies the chassis Use the show running config command to display and verify the defined serial ID for a rack Task ID se...

Page 258: ...rence OL 17231 01 Examples The following example shows how to define the serial ID for a rack RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin configure RP 0 RP0 CPU0 router admin config dsc serial TBC0610991700000 rack 1 Related Commands Command Description show dsc Displays the current DSC configuration for the shelf or for the system show running config Displays the current running active ...

Page 259: ...ion Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs By default environment monitoring related to temperature and voltage is enabled on a router running Cisco IOS XR software If environmental monitoring is disabled you are not alerted if the router overheats Task ID Examples The following example shows h...

Page 260: ...and has no arguments or keywords Defaults Power supply monitoring is enabled Command Modes Administration configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to disable power supply monitoring with the env power supply disable command RP 0 RP0 C...

Page 261: ...eywords Defaults No default behavior or values Command Modes Administration configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the show platform command to view a summary of the nodes in the router including status information Task ID Examples The following example shows how to boot the s...

Page 262: ...node id reload path warm Syntax Description Defaults No default behavior or values Command Modes EXEC Administration EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Note By default the node remains powered until you specify that you want it powered down with the hw module location node id power dis...

Page 263: ...he sanity of the configuration file system and attempt to recover from internal inconsistencies Task ID Examples The following example shows how to reset the hardware on a specific node from EXEC mode RP 0 RP0 CPU0 router hw module location 0 1 CPU0 reload The following example shows how to reset the hardware on a specific node from Administration EXEC mode RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0...

Page 264: ...t be in a user group associated with a task group that includes the proper task IDs Use the show platform command to view a summary of the nodes in the router including status information Task ID Examples The following example shows how to enable a SONET SDH port to be used for SRP RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config hw module port 1 srp location 0 1 CPU0 port id Number that...

Page 265: ...cy and Node Administration Commands on Cisco IOS XR Software hw module port SMR 263 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description show platform Displays information and status for each node in the system ...

Page 266: ...p that includes the proper task IDs The hw module power command is available for line cards only it is not available for router processor RP cards Use the show platform command to view a summary of the nodes in the router including status information Task ID Examples The following example shows how to power on a line card RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin configure RP 0 RP0 CPU...

Page 267: ...are hw module power SMR 265 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 RP 0 RP0 CPU0 router admin configure RP 0 RP0 CPU0 router admin config hw module power disable location 0 SM3 SP Related Commands Command Description show platform Displays information and status for each node in the system ...

Page 268: ...ciated with a task group that includes the proper task IDs The hw module reset auto command is used to reload Cisco IOS XR software on a specific node The node reloads with the current running configuration and active software set for that node Task ID Examples The following example shows how to reload a node RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin configure RP 0 RP0 CPU0 router admi...

Page 269: ...tration Commands on Cisco IOS XR Software hw module reset auto SMR 267 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description hw module power Powers on a specified node hw module shutdown Administratively shuts down a specified node ...

Page 270: ...you must be in a user group associated with a task group that includes the proper task IDs Nodes that are shut down still have power but cannot load or operate Cisco IOS XR software Note Route processors RPs cannot be administratively shut down Enter the show platform command in EXEC mode to display the results of the hw module shutdown command Task ID Examples The following example shows how to a...

Page 271: ...ement Command Reference OL 17231 01 The following example shows how to bring up a node using the no form of the hw module shutdown command RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin configure RP 0 RP0 CPU0 router admin config no hw module shutdown location 0 2 CPU0 Related Commands Command Description hw module power Powers on a specified node hw module reset auto Reloads a specified no...

Page 272: ...oup associated with a task group that includes the proper task IDs This command reloads Cisco IOS XR software on the specified shared port adapter SPA and restarts the SPA interfaces The SPA reloads with the current running configuration and active software set for the SPA Task ID Examples The following example shows how to restart the SPA in slot 2 subslot 1 RP 0 RP1 CPU0 router hw module subslot...

Page 273: ...group associated with a task group that includes the proper task IDs This command administratively shuts down the SPA in the specified subslot Subslots that are shut down still have power but cannot load or operate Cisco IOS XR software Task ID Examples The following example shows how to shut down the SPA in subslot 1 of the SPA interface processor SIP in slot 2 RP 0 RP1 CPU0 router configure RP 0...

Page 274: ... IDs Use the redundancy switchover command to trigger a failover from the primary RP to the standby RP When the redundancy switchover command is issued the running committed configuration is automatically saved and loaded during failover and the standby RP becomes the active primary RP while the original primary RP becomes the standby RP Note The redundancy switchover command can be used only if t...

Page 275: ... ready Tue Mar 28 09 25 51 2006 5 hours 18 minutes ago There has been 1 switch over since reload RP 0 RP0 CPU0 router redundancy switchover Initializing DDR SDRAM found 2048 MB Initializing ECC on bank 0 Turning off data cache using DDR for first time Initializing NVRAM Testing a portion of DDR SDRAM done Reading ID EEPROMs Initializing SQUID Initializing PCI PCI0 device 1 Vendor ID 0x10ee Configu...

Page 276: ...the proper task IDs For more information about identifying and selecting a DSC on the Cisco ASR 14000 Series Router refer to Cisco ASR 14000 Getting Started Guide Task ID Examples The following is sample output from the show dsc mine command RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin show dsc mine NODE ROLE PRIORITY TBEACON PRESENT MIGRATION 0 0 CPU0 DSC 3 2000 YES ENABLED Table 27 desc...

Page 277: ...own in the display Related Commands Table 27 show dsc Field Descriptions Field Description NODE Location of the node in the rack slot module notation ROLE Role this node is performing Because the show dsc command shows the DSC node the ROLE is always DSC PRIORITY DSC priority assigned to this node TBEACON Current DSC beacon timeout value PRESENT Indicates whether the node is present in the slot SE...

Page 278: ...e proper task IDs The show environment command displays information about the hardware that is installed in the system including fans LEDs power supply voltage and current information and temperatures all Optional Displays information for all environmental monitor parameters last Optional Displays information for prior environmental monitor parameters fans Optional Displays information about the f...

Page 279: ...following is sample output from the show environment command the with the leds keyword RP 0 RP0 CPU0 router show environment leds 0 2 Module host LED status says OK 0 2 Module plimasic LED status says OK 0 SM0 Module host LED status says OK Task ID Operations system read Table 28 show environment temperatures Field Descriptions Field Description R S I Rack number slot number and interface for whic...

Page 280: ...R 278 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Table 29 describes the significant fields shown in the display Table 29 show environment leds Field Descriptions Field Description rack_num slot_num Rack number and slot number where the node resides Module host LED status says Current LED status of the specified node ...

Page 281: ... Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs If there are multiple FPD images for your card use the show fpd package command to determine which FPD image to use if you only want to upgrade a specific FPD type Task ID Examples The following example shows partial sample output from the show fpd package command RP 0 R...

Page 282: ... 1 32 0 0 ROMMONA swv1 43 dsmp lc rommonA 1 32 0 0 ROMMONB swv1 43 asmp lc rommon 1 43 0 0 ROMMONB swv1 43 dsmp lc rommon 1 43 0 0 DRP ROMMONA swv1 43 asmp lc rommonA 1 32 0 0 ROMMONA swv1 43 dsmp lc rommonA 1 32 0 0 ROMMONA swv1 43 sp lc rommonA 1 32 0 0 ROMMONB swv1 43 asmp lc rommon 1 43 0 0 ROMMONB swv1 43 dsmp lc rommon 1 43 0 0 ROMMONB swv1 43 sp lc rommon 1 43 0 0 DRP_B ROMMONA swv1 43 asmp...

Page 283: ... sp lc rommonA 1 32 0 0 ROMMONB swv1 43 sp lc rommon 1 43 0 0 SPA 4XT3 E3 SPA E3 Subrate FPGA spa fpga2 1 4 0 0 SPA T3 Subrate FPGA spa fpga3 1 4 0 0 SPA I O FPGA spa fpga 1 0 0 0 SPA ROMMON spa rommon 2 12 0 0 SPA 2XT3 E3 SPA E3 Subrate FPGA spa fpga2 1 4 0 0 SPA T3 Subrate FPGA spa fpga3 1 4 0 0 SPA I O FPGA spa fpga 1 0 0 0 SPA ROMMON spa rommon 2 12 0 0 SPA OC192POS SPA FPGA swv1 3 spa fpga 1 ...

Page 284: ...pa shared port adapter lc line card Subtype FPD type Can be one of the following types fabldr fabric downloader fpga1 field programmable gate array fpga2 field programmable gate array 2 fpga3 field programmable gate array 3 fpga4 field programmable gate array 4 fpga5 field programmable gate array 5 rommon read only memory monitor rommon2 read only memory monitor 2 SW Version Currently running FPD ...

Page 285: ...t be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to display FPD compatibility for all modules in the router RP 0 RP0 CPU0 Router show hw module fpd location all Existing Field Programmable Devices HW Current SW Upg Location Card Type Version Type Subtype Inst Version Dng 0 0 SP YYY XXXIface 255 254 lc rommonA 0 1 4...

Page 286: ... 0 1 43 No 0 SM2 SP Fabric HS123 0 1 lc rommonA 0 1 43 No lc rommon 0 1 43 No 0 SM3 SP Fabric HS123 0 1 lc rommonA 0 1 43 No lc rommon 0 1 43 No Table 31 describes the significant fields shown in the display Table 31 show hw module fpd Field Descriptions Field Description Location Location of the module in the rack slot module notation Card Type Module part number HW Version Hardware model version...

Page 287: ...wngrade will be required in rare cases when the version of the FPD image has a higher major revision than the version of the FPD image in the current Cisco IOS XR software package Table 31 show hw module fpd Field Descriptions Field Description Command Description show fpd package Displays which FPD image package is needed for the router to properly support the modules for the running Cisco IOS XR...

Page 288: ... to digital converter information c2w Displays Cisco to wire bus device information fpga Displays SPA field programmable gate array information framer Displays SONET framer information Not applicable to Ethernet SPAs l2 tcam Displays SPA Layer 2 ternary content addressable memory information Not applicable to POS SPAs mac Displays SPA MAC information Not applicable to POS SPAs pluggable optics Dis...

Page 289: ...t a device on an interface on the SPA Task ID Examples The following is sample output for the show hw module subslot brief command RP 0 RP0 CPU0 router show hw module subslot 0 1 0 brief Subslot 0 1 0 brief info SPA inserted YES SPA type 4xOC3 POS SPA SPA operational state READY SPA cfg admin up YES Table 33 describes the significant fields shown in the display Task ID Operations root lr read Tabl...

Page 290: ... analog to digital converter information c2w Displays Cisco to wire bus device information fpga Displays SPA field programmable gate array information framer Displays SONET framer information Not applicable to Ethernet SPAs l2 tcam Displays SPA Layer 2 ternary content addressable memory information Not applicable to POS SPAs mac Displays SPA MAC information Not applicable to POS SPAs pluggable opt...

Page 291: ...terface on the SPA Task ID Examples The following is sample output for the show hw module subslot config command RP 0 RP0 CPU0 router show hw module subslot 0 2 cpu0 config BAY 0 config info SPA inserted YES SPA cfg admin up YES SPA cfg power up YES BAY 1 config info SPA inserted YES SPA cfg admin up YES SPA cfg power up YES Table 33 describes the significant fields shown in the display Related Co...

Page 292: ...nalog to digital converter information c2w Displays Cisco to wire bus device information fpga Displays SPA field programmable gate array information framer Displays SONET framer information Not applicable to Ethernet SPAs l2 tcam Displays SPA Layer 2 ternary content addressable memory information Not applicable to POS SPAs mac Displays SPA MAC information Not applicable to POS SPAs pluggable optic...

Page 293: ... SPA insertion time Fri Nov 19 01 49 07 2004 SPA last time ready Fri Nov 19 01 49 42 2004 SPA uptime HH MM SS 49 49 29 BAY 1 counts info SPA inserted YES SPA type 1xOC192 POS RPR HHSPA with XFP SPA operational state READY SPA insertion time Fri Nov 19 01 49 08 2004 SPA last time ready Fri Nov 19 01 49 35 2004 SPA uptime HH MM SS 49 49 36 Table 34 describes the significant fields shown in the displ...

Page 294: ... module subslot counters command with the framer option RP 0 RP0 CPU0 router show hw module subslot counters framer SPA device framer index 0 subindex 0 info Milan Framer counters STREAM 0 Rx Bytes 48 bit 0x381fa078 0x883c 163857232569448 Rx Good Bytes 48 bit 0x381fa080 0x8840 1964924 Rx Good Packets 48 bit 0x381fa040 0x8820 26234 Tx Byte Cnt Reg 48 bit 0x381fe070 0xa838 9375380 Tx Good Bytes Cnt ...

Page 295: ...ital converter information c2w Displays Cisco to wire bus device information fpga Displays SPA field programmable gate array information framer Displays SONET framer information Not applicable to Ethernet SPAs l2 tcam Displays SPA Layer 2 ternary content addressable memory information Not applicable to POS SPAs mac Displays SPA MAC information Not applicable to POS SPAs pluggable optics Displays p...

Page 296: ... partial sample output for the show hw module subslot errors command RP 0 RP0 CPU0 router show hw module subslot errors Subslot 0 1 0 errors info SPA inserted YES SPA type 4xOC3 POS SPA SPA operational state READY SPA last reset reason UNKNOWN SPA last failure reason UNKNOWN Subslot 0 1 1 errors info SPA inserted YES SPA type 1x10GE XFP SPA SPA operational state READY SPA last reset reason UNKNOWN...

Page 297: ...on is being displayed The location of the SPA is expressed in the rack slot module notation SPA inserted Indicates if a SPA is currently detected in the subslot SPA type Description of SPA including the technology type number of ports height of SPA HHSPA single height FHSPA double height and optics type SPA operational state Current operational state of the SPA module SPA last reset reason Display...

Page 298: ...m subblock command to display SPA firmware information both kernel and application information as well as heartbeat and keepalive information The show hw module subslot plim subblock command is mainly used for debugging purposes Task ID Examples The following example shows sample output for the show hw module subslot plim subblock command RP 0 RP0 CPU0 router show hw module subslot 0 5 0 plim subb...

Page 299: ...ode Administration Commands on Cisco IOS XR Software show hw module subslot plim subblock SMR 297 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description show controllers Displays the controller type and other information ...

Page 300: ...g to digital converter information c2w Displays Cisco to wire bus device information fpga Displays SPA field programmable gate array information framer Displays SONET framer information Not applicable to Ethernet SPAs l2 tcam Displays SPA Layer 2 ternary content addressable memory information Not applicable to POS SPAs mac Displays SPA MAC information Not applicable to POS SPAs pluggable optics Di...

Page 301: ... command to display register information for the specified internal hardware device on the SPA Task ID Examples The following example shows sample output for the show hw module subslot registers command RP 0 RP0 CPU0 router show hw module subslot 0 2 CPU0 registers BAY 0 registers info SPA hardware ID 0x1 SPA SW FPGA rev 0x10 BAY 1 registers info SPA hardware ID 0x90000000 SPA SW FPGA rev 0xD Tabl...

Page 302: ...gital converter information c2w Displays Cisco to wire bus device information fpga Displays SPA field programmable gate array information framer Displays SONET framer information Not applicable to Ethernet SPAs l2 tcam Displays SPA Layer 2 ternary content addressable memory information Not applicable to POS SPAs mac Displays SPA MAC information Not applicable to POS SPAs pluggable optics Displays ...

Page 303: ...sample output for the show hw module subslot status command with the temperature sensor option RP 0 RP1 CPU0 router show hw module subslot 0 2 CPU0 status temperature sensor SPA device temperature sensor index 0 subindex 0 info DS1631 0x0803c2e4 device status temperature 0x1c80 28 5 degree C SPA device temperature sensor index 0 subindex 0 info DS1631 0x08063bec device status temperature 0x1e00 30...

Page 304: ...k IDs If a Cisco entity is not assigned a product ID PID that entity is not retrieved or displayed Enter the show inventory command with the raw keyword to display every RFC 2737 entity installed in the router including those without a PID unique device identifier UDI or other physical identification node id Optional Identifies the location of a specific node whose inventory information you want t...

Page 305: ...EEPROM and NVRAM Use the show inventory command to display this information Task ID Examples The following is partial sample output from the show inventory command with the raw keyword RP 0 RP0 CPU0 router admin show inventory raw NAME 0 1 DESCR Cisco ASR 14000 Series Modular Services Card PID ASR14K MSC VID V02 SN SAD09280BS9 NAME 0 1 host DESCR host PID VID N A SN NAME 0 1 host Inlet0 DESCR Temp...

Page 306: ...played If you are displaying the chassis inventory this field shows chassis If you are displaying raw inventory or all inventory information for all nodes in the chassis this field shows the node name in partially qualified format For a node the NAME is expressed in node_type rack notation DESCR Describes the chassis or the node Chassis descriptions provide the name of the chassis and its Gbps Nod...

Page 307: ...ciated with a task group that includes the proper task IDs Task ID Examples The following is sample output from the show led location command with the all keyword RP 0 RP0 CPU0 router show led location all LOCATION MESSAGE MODE STATUS 0 1 IOS XR DEFAULT UNLOCKED 0 4 ACTVDRP DEFAULT UNLOCKED 0 6 IOS XR DEFAULT UNLOCKED 0 RP0 ACTV RP DEFAULT UNLOCKED 0 RP1 STBYRDY DEFAULT UNLOCKED location node id a...

Page 308: ...d RP 0 RP0 CPU0 router show led location all LOCATION MESSAGE MODE STATUS 0 0 CPU0 ACTVRP DEFAULT UNLOCKED 0 1 CPU0 PSC1 DEFAULT UNLOCKED 0 2 CPU0 IOX RUN DEFAULT UNLOCKED 0 3 CPU0 IOX RUN DEFAULT UNLOCKED 0 4 CPU0 IOX RUN DEFAULT UNLOCKED 0 5 CPU0 IOX RUN DEFAULT UNLOCKED Table 39 show led location Field Descriptions Field Description LOCATION Identifies the location of the node LOCATION is expre...

Page 309: ...es The following is sample output from the show operational command with the BGP DefaultVRF GlobalProcessInfo MDA class and descriptive keyword Not all the output is shown RP 0 RP0 CPU0 router show operational BGP DefaultVRF GlobalProcessInfo descriptive BGP DefaultVRF GlobalProcessInfo InStandaloneMode true Standalone or Distributed mode RouterID 0 0 0 0 Router ID for the local system ConfiguredR...

Page 310: ...shown RP 0 RP0 CPU0 router show operational Inventory Inventory RackTable Rack Number 0 SlotTable Slot Number 1 BasicAttributes BasicInfo Description Cisco ASR14K Line Card Distributed Route Processor card slot VendorType 1 3 6 1 4 1 9 12 3 1 5 144 Name 0 1 CompositeClassCode 196742 PhysicalLayerInterfaceModuleType 6291590 Inventory RackTable Rack Number 0 SlotTable Slot Number 1 BasicAttributes F...

Page 311: ...ter the show platform command in administration EXEC mode to display output for the entire system Enter the show platform command in EXEC mode to display output for only those nodes that belong to the SDR on which the command is executed Task ID Examples The following is sample output from the show platform command RP 0 RP0 CPU0 router show platform Node Type PLIM State Config State 0 1 CPU0 MSC J...

Page 312: ...d with the node id argument RP 0 RP0 CPU0 router show platform 0 1 0 Node Type PLIM State Config State 0 1 0 MSC SPA 4XOC3 POS OK PWR NSHUT MON Table 40 describes the significant fields shown in the display 1 physical layer interface module Related Commands Table 40 show platform Field Descriptions Field Description Node Identifies the node in the rack slot module format Type Type of node PLIM Typ...

Page 313: ...nstop routing NSR status of the standby RPs in the system use the summary keyword Task ID Examples The following is sample output from the show redundancy command RP 0 RP0 CPU0 router show redundancy location 0 rp0 cpu0 Node 0 RP0 CPU0 is in ACTIVE role Partner node 0 RP1 CPU0 is in STANDBY role Standby node in 0 RP1 CPU0 is ready location Optional Specifies the location of the node or nodes whose...

Page 314: ...y The status of the standby node is indicated in parentheses next to the node identifier The nonstop routing NSR status is indicated following NSR Possible values are Ready and Not ready Table 41 show redundancy Field Descriptions Field Description Node is in XXX role Current role of the primary route processor where is the route processor ID in the format rack slot module and XXX is the role of t...

Page 315: ...n Commands on Cisco IOS XR Software show redundancy SMR 313 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description redundancy switchover Causes the primary active RP to fail over to the redundant standby RP if the standby RP is available ...

Page 316: ...e proper task IDs Enter the show screddrv command without any of the optional parameters to display summarized SC redundancy and arbitration information for the router Task ID Examples The following is sample output from the show screddrv command with the all keyword RP 0 RP0 CPU0 router show screddrv all Redundancy Driver Info for slot 32 Slot 32 Role active role State ACTIVE STATE Prefer_slot 0 ...

Page 317: ... example it may be active standby and so forth State Current state of the card in the specified slot Prefer_slot Information about the preferred redundancy slot Registers Information about the following registers ICreg MSreg MPPReg Tx error count Number of transmit errors that have occurred on the card in the specified slot Rx error count Number of receive errors that have occurred on the card in ...

Page 318: ...ystem information including hardware and software version router uptime boot settings configuration register and active software Task ID Examples The following example shows partial output from the show version command RP 0 RP0 CPU0 router admin show version Cisco IOS XR Software Version 3 7 0 26I Default Copyright c 2008 by Cisco Systems Inc ROM System Bootstrap Version 1 150 20080604 125538 ASR ...

Page 319: ...r Memory Card Industry Association Table 43 show version Field Descriptions Field Description Cisco IOS XR software Version Cisco IOS XR software version number currently running on the router ROM System bootstrap version number currently running on the router router uptime Number of uninterrupted days hours minutes and seconds the system has been up and running System image file is Location and n...

Page 320: ...ctrl Internal Info for node 0 1 CPU0 Error Interrupts 0 Spurious Error Interrupts 0 PCI Error Overflows 0 PCI PM Error Overflows 0 PCIX Error Overflows 0 Internal Access PCI Overflows 0 Port Error Overflows 0 Error Log Overflows 0 cpuctrl Config Reg 0x8357ffff cpuctrl Physical Offset 0x80000000 cpuctrl Window Size 0x40000000 cpuctrl Port Window Size 0x04000000 cpuctrl SHMem Size 0x00800000 cpuctrl...

Page 321: ...ze 0x00800000 cpuctrl SHMem Used 0x00224fb0 cpuctrl version info SQUIRT v3 Task ID Examples The following example shows how to upgrade the CPU controller bits on all nodes in a router RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin upgrade cpucrtlbits all Please do not power cycle reload the router or reset any nodes until all upgrades are completed Please check the syslog to make sure that ...

Page 322: ...elected module fpga type Upgrades a specific field programmable gate array FPGA image on the module Use the show fpd package command to view all available FPGA images available for a specific module rommon Upgrades the ROMMON image on the module force Optional Forces the update of the indicated FPD image package on a shared port adapter SPA that meets the minimum version requirements Without this ...

Page 323: ...tion command will not display correct version information after the upgrade if the target module is not reloaded Continue confirm y SP 0 1 SP Dec 22 05 41 17 920 upgrade_daemon 125 programming with file ne t node0_RP1_CPU0 asr14k lc 3 3 83 fpd ucode fpga_gladiator_sw0 6 xsvf SP 0 1 SP Dec 22 05 41 28 900 upgrade_daemon 125 programming SP 0 1 SP Dec 22 05 41 28 906 upgrade_daemon 125 it will take a...

Page 324: ... en t ia l B et a R ev iew R 3 7 1 Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software upgrade hw module fpd SMR 322 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 ...

Page 325: ...ough Extensible Markup Language XML agent services and support the Common Object Request Broker Architecture CORBA infrastructure The XML Parser Infrastructure provides parsing and generation of XML documents with Document Object Model DOM Simple API for XML SAX and Document Type Definition DTD validation capabilities DOM allows customers to programmatically create manipulate and generate XML docu...

Page 326: ...x x x x where x x x x is the router IP address If a name has been set use http router name Use the http server ssl command to run HTTP over a secure socket This command enables the HTTP server to run SSL when accessing web pages or files provided by the HTTP server of the router and disables access through the regular HTTP port Use the no form of this command to disable the HTTP server Enabling th...

Page 327: ...outer config http server ssl The following example shows how to enable SSL to run HTTP over a secure socket and to enable access to the CWI from only IP address that meeting the conditions of the access group named test RP 0 RP0 CPU0 router config http server ssl access group test The following sample output from the show ipv4 access lists commands displays the IPv4 access list named test RP 0 RP0...

Page 328: ...st be in a user group associated with a task group that includes the proper task IDs For the xml agent corba command to work at least one interface on the router must be up and running Interfaces can be verified by pinging the host SSL enabled CORBA services can be activated using the xml agent corba ssl command These same services can be deactivated using the no xml agent corba command Task ID Ex...

Page 329: ...R 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description ping Checks host reachability and network connectivity on IP networks xml agent corba hostname Enables the use of a static hostname for XML CORBA agent services xml agent tty Enables XML requests over Secure Shell SSH and Telnet ...

Page 330: ...cludes the proper task IDs By default the router hostname is used To enable the use of static hostname regardless of configured hostname use the xml agent corba hostname string command The XML agent is restarted only if the effective hostname is changed Task ID Examples The following example shows how to enable a static hostname for XML CORBA agent services Use the xml agent corba hostname string ...

Page 331: ...tty Syntax Description This command has no arguments or keywords Defaults XML requests over SSH and Telnet are disabled Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to enable the tty agent for XML requests RP 0 RP0 CP...

Page 332: ...C i sc o C o n f id en t ia l B et a R ev iew R 3 7 1 Manageability Commands on Cisco IOS XR Software xml agent tty SMR 330 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 ...

Page 333: ...isco IOS XR Software This chapter describes the Cisco IOS XR commands used to add packages to a router storage device activate or deactivate packages upgrade or downgrade existing packages and display information about packages For detailed information about the concepts and tasks necessary to manage the Cisco IOS XR software see Cisco ASR 14000 Series Router Getting Started Guide ...

Page 334: ...e in a user group associated with a task group that includes the proper task IDs Use the clear install boot options command to clear boot options that were set using the install boot options command Task ID Examples The following example shows how to clear the boot options for all locations RP 0 RP0 CPU0 router admin clear install boot options Install operation 4 admin clear install boot options l...

Page 335: ...gement Commands on Cisco IOS XR Software clear install boot options SMR 333 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description install boot options Sets boot options show install boot options Displays boot options ...

Page 336: ...el command to remove a label associated with an installation rollback point Labels are assigned using the install label command Task ID Examples In the following example the label brians_smu is removed from the associated installation rollback point RP 0 RP0 CPU0 router clear install label brians_smu Install operation 6 clear install label brians_smu started by user usr on SDR Owner via CLI at 09 ...

Page 337: ...only for the current SDR user The log entries for the admin user are not cleared Enter the clear install log history oldest command in administration EXEC mode to clear the oldest installation history log entries for all users This command impacts all users when entered in administration EXEC mode Use the number argument to specify the number of the old log entries to be deleted Task ID Examples I...

Page 338: ...ntries for all secure domain router SDR users are deleted RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin clear install log history oldest 5 Install operation 6 admin clear install log history oldest 5 started by user user_b at 13 35 50 UTC Sat Aug 26 2006 Info Successfully deleted the following historylog points Info 1 2 3 4 5 Install operation 6 completed successfully at 13 35 50 UTC Sat A...

Page 339: ...ar install rollback oldest command in administration EXEC mode to delete the saved installation points for all secure domain routers SDRs Enter the clear install rollback oldest command in EXEC mode to delete the saved installation points for the SDR to which you are logged in Task ID Examples In the following example the command show install rollback is used to display the available rollback poin...

Page 340: ...r user_b at 18 11 19 UTC Sat Apr 08 2006 Info Successfully deleted the following rollback points Info 0 2 Install operation 11 completed successfully at 18 11 21 UTC Sat Apr 08 2006 RP 0 RP0 CPU0 router admin show install rollback 4 ID of the rollback point to show package information for 9 ID of the rollback point to show package information for 10 ID of the rollback point to show package informa...

Page 341: ...on deactivation and rollback operations can be aborted Specifically the operation install add cannot be aborted but the operation install add activate can be aborted Use the install abort command with the request id argument to halt a specific installation operation if the request id is currently in process Command Modes Enter the install abort command in administration EXEC mode to halt a softwar...

Page 342: ...tall abort request by pressing Enter or y or pressing n to cancel it Do you really want to abort install operation 15 confirm enter Abort confirmed Please check console to verify the operation is aborted Related Commands Command Description install add Adds the contents of a PIE file to a storage device install activate Adds a software package or SMU to the active software set install deactivate R...

Page 343: ...ted in the syslog displayed during the operation and in the output of the show install log command device package Device and package expressed in concatenated form for example disk0 asr14k mgbl 3 7 1 For the device argument the value is a specified storage device typically disk0 This is the local storage device where the package was added with the install add command Press after a partial package ...

Page 344: ...ile Optional Administration EXEC mode only Activates the package only for the admin plane nodes Admin plane nodes provide system wide functionality and do not belong to a specific SDR Examples of admin plane nodes are fabric cards and service processor modules SPs The admin profile keyword is used to update admin plane resources without impacting the routing nodes in any SDRs if active Optional Ad...

Page 345: ...on ID all the packages that were added by the specified operation must still be on the router Upgrading and Downgrading Packages To upgrade a package activate the newer version of the package the older version is automatically deactivated To downgrade a package activate the older version of the package the newer version is automatically deactivated Actual activation is performed only after the com...

Page 346: ...onous mode the system may stay in synchronous mode for a short period of time while the system checks for questions to ask the user Press Ctrl C during a synchronous operation to abort the operation or make the operation asynchronous Test Option Use the test keyword to verify the effects of the proposed operations and determine whether the installation can be completed After previewing the effects...

Page 347: ... The changes made to software configurations will not be persistent Info across system reloads Use the command admin install commit to Info make changes persistent Info Please verify that the system is consistent following the software Info change using the following commands Info show system verify Info install verify packages Install operation 3 completed successfully at 01 11 30 UTC Thu Jan 03 ...

Page 348: ...d secure domain router shelf controller DSDRSC reloads RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin install activate disk0 asr14k mcast 3 7 1 10I synchronous sdr Owner user_a Install operation 7 admin install activate disk0 asr14k mcast 3 7 1 10I synchronous sdr Owner user_a started by user abc via CLI at 11 32 29 UTC Mon Sep 25 2006 Info This operation will reload the following node Info...

Page 349: ...The changes made to software configurations will not be persistent across system reloads Use the command admin Info install commit to make changes persistent Info Please verify that the system is consistent following the software change using the following commands Info show system verify Info install verify packages Install operation 2 completed successfully at 04 32 01 PST Fri Dec 28 2007 The wa...

Page 350: ...ss directory path tftp hostname or ip address directory path tar Indicates that the PIE file is contained in a tar file file Name and location of the PIE file composite package to install If a source path location is specified using the source keyword the file argument can be either a fully specified PIE file path or a path to the PIE file relative to the source path Note Up to 32 PIE files can be...

Page 351: ...node If a version of the MPLS package is already active on all nodes an MPLS package then could be upgraded or downgraded on a single node asynchronous Optional Performs the command in asynchronous mode In asynchronous mode this command runs in the background and the EXEC prompt is returned as soon as possible This is the default mode synchronous Optional Performs the command in synchronous mode T...

Page 352: ...enance Upgrades SMUs Packages that do not support SDR specific activation can be activated for all SDRs simultaneously only from administration EXEC mode Note If a software activation requires a node reload the config register for that node should be set to autoboot If the config register for the node is not set to autoboot then the system automatically changes the setting and the node reloads A m...

Page 353: ...all the PIE filenames as necessary This alleviates the need to repeat the directory location for each PIE file Following is an example of the install add command using the source keyword RP 0 RP0 CPU0 router admin install add source tftp 192 168 201 1 images myimages comp asr14k mini pie asr14k mgbl p pie asr14k mpls p pie asr14k mcast p pie The following example also illustrates a valid use of th...

Page 354: ...isk1 asr14k mgbl p pie 3 7 1 activate Install operation 4 install add disk1 asr14k mgbl p pie 3 7 1 activate started by user user_b at 07 58 56 UTC Wed Mar 01 2006 The install operation will continue asynchronously router admin Part 1 of 2 add software Started Info The following package is now available to be activated Info Info disk0 asr14k mgbl 3 7 1 Info Part 1 of 2 add software Completed succe...

Page 355: ... the following reasons To change an asynchronous installation operation to a synchronous installation operation The installation operation is asynchronous but the terminal that ran the command has been lost due to a failover or terminal timeout Note An asynchronous operation runs in the background and the EXEC prompt is returned as soon as possible This is the default mode A synchronous operation ...

Page 356: ...uter running configuration In the following example the install attach command is used to attach the terminal to the installation operation and complete the operation in synchronous mode The CLI prompt is returned only after the installation operation is complete RP 0 RP0 CPU0 router admin install attach Install operation 14 install activate disk0 asr14k mcast 3 7 6 started by user user_b at 08 04...

Page 357: ...bort timer that was activated with the install activate or install deactivate command Alternatively you can use the install commit command to halt the timer If you do not halt the auto abort timer the software loads to the last committed loadpath when the timer expires If the software has installed successfully and you intend to continue using the new software you should disable the auto abort tim...

Page 358: ... 17231 01 Examples The following example shows how to halt the auto abort timer RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin install auto abort timer stop Related Commands Command Description install activate Adds a software package or SMU to the active software set install commit Makes the current active software set persistent across RP reloads install deactivate Removes a package from ...

Page 359: ...he card from a disk in another node You can use the hw module location reload command with the path argument to download a boot image using TFTP from a remote node When the reboot is complete the boot options are reset Task ID Examples The following example shows how to set the card located in node 0 0 CPU0 to be cleaned during the next reboot RP 0 RP0 CPU0 router admin install boot options clean ...

Page 360: ...ration 8 admin install boot options format location 0 0 CPU0 started by user via CLI at 09 15 52 GMT Mon Mar 10 2008 Info The boot option will be in effect when the node is reloaded and will Info be cleared when the node preparation is complete Install operation 8 completed successfully at 09 15 52 GMT Mon Mar 10 2008 Related Commands Command Description clear install boot options Clears boot opti...

Page 361: ...urrent running configuration To make the package activation persistent across domain router shelf controller DSDRSC reloads enter the install commit command On startup the DSDRSC of the SDR loads this committed software set If the system is restarted before the active software set is saved with the install commit command the previously committed software set is used To commit the active software s...

Page 362: ...ersistent across DSDRSC reloads for all SDRs in the system RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin install commit Install operation 16 install commit started by user user_b at 19 18 58 UTC Sat Apr 08 2006 Install operation 16 completed successfully at 19 19 01 UTC Sat Apr 08 2006 Related Commands Task ID Operations pkg mgmt read write Command Description show install committed Displa...

Page 363: ...mmited loadpath sdr OWNER Optional Administration EXEC mode only Deactivates a package for a specific secure domain router SDR The only SDR available is OWNER which refers to the entire Cisco ASR 14000 Series Router router location node id Optional Deactivates a package from the designated node The node id argument is entered in rack slot module notation Note In most cases a package cannot be deac...

Page 364: ...tware set from all nodes or from a single node When a deactivation is attempted the system runs an automatic check to ensure that the package is not required by other active packages The deactivation is permitted only after all compatibility checks have passed The following conditions apply to software deactivation A feature package cannot be deactivated if active packages need it to operate To do...

Page 365: ...s of the proposed operations use the show install log command for more details about the effects of the proposed operations Auto Abort Option Use the auto abort timer keyword to provide a safety mechanism for the instance that a package is deactivated and for some reason access to the router is lost This option automatically rolls back to the current committed loadpath thereby undoing any changes ...

Page 366: ...hat the system is consistent following the software Info change using the following commands Info show system verify Info install verify The currently active software is not committed If the system reboots then the committed software will be used Use install commit to commit the active software Install operation 11 completed successfully at 03 25 56 est Thu Mar 02 2006 You cannot deactivate a pack...

Page 367: ...nstall activate Adds a software package or SMU to the active software set install commit Makes the current active software set persistent across RP reloads install remove Removes a deactivated package from a storage device show install inactive Displays inactive packages in the active software set show install log Displays the entries stored in the logging installation buffer show install request ...

Page 368: ...o put a label and description on an installation rollback point that can be used to identify the rollback point in other commands Commands that support the rollback label include clear install rollback install rollback show install rollback Labels and descriptions defined in administrative EXEC mode are visible only in administrative EXEC mode Labels and descriptions defined in EXEC mode for an SD...

Page 369: ...llowing characters Comma Semi colon Colon Single quote Double quote Cannot contain uppercase alphabetic characters Cannot contain numeric characters only Task ID Examples The following example shows how to define a label for an installation operation RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin install label 0 label name brians smu Install operation 5 install label 0 label name brians_smu...

Page 370: ...Package Management Commands on Cisco IOS XR Software install label SMR 368 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description install activate Adds a software package or SMU to the active software set ...

Page 371: ...enated form for example disk0 asr14k mgbl 3 7 1 For the device argument the value is a specified storage device typically disk0 Note Multiple packages can be removed at the same time inactive Optional Removes all inactive non committed packages from the boot device usually disk0 sdr OWNER Optional Administration EXEC mode only Removes a package for a specific secure domain router SDR The only SDR ...

Page 372: ...e To remove packages from a specific SDR use the install remove command in EXEC mode To remove all inactive packages from the boot device in the system or SDR use the install remove inactive command Note A package can be removed from a single SDR only if the package was not added to any other SDRs Router Reloads If the operation requires a router reload a confirmation prompt appears Use the instal...

Page 373: ...ages will not be present Info 4 9 10 14 15 17 18 Proceed with removing these packages confirm y The install operation will continue asynchronously Install operation 30 completed successfully at 23 The following example shows how to remove all inactive packages from the boot device RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin install remove inactive synchronous RP 0 RP0 CPU0 Aug 15 09 25 4...

Page 374: ...tion point auto abort timer time Optional Specifies an abort timer value time in minutes which when expired loads the last committed loadpath sdr OWNER Optional Rolls back the software set for a specific secure domain router SDR The only SDR available is OWNER which refers to the entire Cisco ASR 14000 Series Router router admin profile Optional Rolls back the active software set on the admin prof...

Page 375: ...e install point to rollback to 4 Specify the id for the install point to rollback to 6 Specify the id for the install point to rollback to 7 Specify the id for the install point to rollback to 8 Specify the id for the install point to rollback to 9 Specify the id for the install point to rollback to committed Rollback to the last committed installation point If a rollback operation is beyond two s...

Page 376: ...tion will continue asynchronously RP 0 RP0 CPU0 router admin Info The changes made to software configurations will not be persistent Info across system reloads Use the command admin install commit to make Info changes persistent Info Please verify that the system is consistent following the software Info change using the following commands Info show system verify Info install verify The currently ...

Page 377: ...correct and are executing from the correct location Note The install verify healthcheck command can take up to two minutes per package to process asynchronous Optional Performs the command in asynchronous mode In asynchronous mode this command runs in the background and the EXEC prompt is returned as soon as possible This is the default mode synchronous Optional Performs the command in synchronous...

Page 378: ...cesses have right version Info 0 1 CPU0 LC SDR Owner Info pkg md5 f322c8dff20af6b765c8e8423899401a has wrong version Info 0 6 CPU0 LC SDR Owner Info pkg md5 f322c8dff20af6b765c8e8423899401a has wrong version Info Health Check Summary Info 0 RP0 CPU0 DLLs and processes have right version Info 0 RP1 CPU0 DLLs and processes have right version Info 0 1 CPU0 Process es with wrong version found Info 0 6...

Page 379: ...Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Info Restart insthelper on 0 0 CPU0 Info Repair successful Info Repair ends Related Commands Command Description show install log Displays the entries stored in the logging installation buffer show install request Displays the list of incomplete installation manager requests ...

Page 380: ...active software set for all nodes or for specific nodes Enter the command in administration EXEC mode to display information for all nodes in all SDRs summary Optional Displays a summary of the active packages in a system or secure domain router Use this command to display the default software profile for SDRs detail Optional Displays a detailed summary of the active packages for a system secure d...

Page 381: ...mation for each package Note This command displays output that is similar to the show install command Displaying the Default SDR Software Profile When an SDR is created the nodes assigned to that SDR are configured with the default software profile To view a summary of the default SDR software configuration enter the show install summary command in administration EXEC mode Any new nodes that are c...

Page 382: ...ields shown in the display Related Commands Table 44 show install Field Descriptions Field Description Boot Device Device where the node stores the active software Boot Image Location on the dSC of the active minimum boot image MBI used to boot the node Active Packages Active packages loaded on the node Command Description install activate Adds a software package or an SMU to the active software s...

Page 383: ...and Use the show install active command to display the active software set for all nodes or for specific nodes Enter the command in administration EXEC mode to display information for all nodes in all SDRs summary Optional Displays a summary of the active packages in a system or secure domain router detail Optional Displays a detailed summary of the active packages for a system secure domain route...

Page 384: ... an SDR or in all SDRs Use the verbose keyword to display additional information including component and file information for each package Task ID Examples The following is sample output from the show install active command with the location keyword and node id argument specified RP 0 RP0 CPU0 router admin show install active location 0 1 cpu0 Node 0 1 CPU0 LC SDR Owner Boot Image disk0 asr14k os ...

Page 385: ...tive Packages disk0 asr14k diags 3 7 1 11I disk0 asr14k mcast 3 7 1 11I disk0 asr14k mpls 3 7 1 11I disk0 comp asr14k mini 3 7 1 11I Node 0 6 CPU0 LC SDR Owner Boot Device bootflash Boot Image disk0 asr14k os mbi 3 7 1 11I mbiasr14k lc vm Active Packages disk0 asr14k diags 3 7 1 11I disk0 asr14k mcast 3 7 1 11I disk0 asr14k mpls 3 7 1 11I disk0 comp asr14k mini 3 7 1 11I Node 0 RP0 CPU0 RP SDR Own...

Page 386: ...tion Boot Device Device where the node stores the active software Boot Image Location on the dSC of the active minimum boot image MBI used to boot the node Active Packages Active packages loaded on the node Command Description install activate Adds a software package or an SMU to the active software set show install Displays active software packages show install package Displays information about ...

Page 387: ...group associated with a task group that includes the proper task IDs Use the show install audit command to compare the currently active packages and SMUs on the router with a list of packages and SMUs that should be active The file should be a simple text file with a flat list of packages that should be active on the router It should be placed in a location accessible from the router file file nam...

Page 388: ...e sdr keyword and sdr name argument To display information for an SDR when logged into that SDR enter the command in EXEC mode Displaying Information for a Specific Node Use the location keyword and node id argument to display information for a specific node If you do not specify a location with the location keyword and node id argument this command displays information for all nodes Verbose Infor...

Page 389: ...n happen due to a failure to parse the audit file failure to get package information from the installation directory and so on Task ID Examples The following sample output indicates that the audit is successful RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin show install audit file tftp 10 2 2 2 install_list txt Install audit operation completed Install audit result SUCCESS The following sam...

Page 390: ...Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs The show install auto abort timer displays the timer value configured with the install activate and install deactivate commands Task ID Examples The following sample output displays the current auto abort timer value RP 0 RP0 CPU0 router show install auto ...

Page 391: ...be in a user group associated with a task group that includes the proper task IDs Use the show install boot options command to display boot options that were set using the install boot options command Task ID Examples The following example shows how to display the boot options for all locations RP 0 RP0 CPU0 router admin show install boot options Node Boot Options 0 1 SP no boot options set 0 1 CP...

Page 392: ...t options SMR 390 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 0 SM0 SP no boot options set 0 SM1 SP no boot options set 0 SM2 SP no boot options set 0 SM3 SP no boot options set Related Commands Command Description clear install boot options Clears boot options install boot options Sets boot options ...

Page 393: ...s activated it remains active only until the next router reload To save the active software to be persistent across router reloads use the install commit command Use the show install committed command to display the packages included in the committed software set This is useful for verifying that the desired set of packages is committed summary Optional Displays a summary of the committed packages...

Page 394: ... and Verbose Information Use the summary keyword to display summary of packages in a system or SDR Use the detail keyword to display the packages for each node in an SDR or in all SDRs Use the verbose keyword to display additional information including component and file information for each package Task ID Examples The following is sample output from the show install committed summary command RP ...

Page 395: ...diags 3 7 1 disk0 asr14k mgbl 3 7 1 disk0 asr14k k9sec 3 7 1 disk0 comp asr14k mini 3 7 1 Node 0 RP1 CPU0 RP SDR Owner Boot Image disk0 asr14k os mbi 3 7 1 mbiasr14k rp vm Committed Packages disk0 asr14k diags 3 7 1 disk0 asr14k mgbl 3 7 1 disk0 asr14k k9sec 3 7 1 disk0 comp asr14k mini 3 7 1 Node 0 SM0 SP SP SDR Owner Boot Image disk0 asr14k os mbi 3 7 1 sp mbiasr14k sp vm Committed Packages disk...

Page 396: ...e MBI used to boot the node Commited Packages Active packages committed on the node Command Description install activate Adds a software package or SMU to the active software set install commit Makes the current active software set persistent across RP reloads show install Displays active software packages show install active Displays active software packages show install package Displays informat...

Page 397: ... a task group that includes the proper task IDs Use the show install inactive command to display the inactive packages for the DSDRSC Note Use the show version show install active or show install committed command to determine the device used as the boot device Enter the command in administration EXEC mode to display information for the DSDRSC in all SDRs summary Optional Displays a summary of ina...

Page 398: ...ackages for each node in an SDR or in all SDRs Use the verbose keyword to display additional information including component and file information for each package Task ID Examples The following is sample output from the show install inactive command RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin show install inactive Secure Domain Router Owner Node 0 0 CPU0 RP SDR Owner Inactive Packages di...

Page 399: ...ode 0 5 CPU0 LC E3 OC48 POS SDR Owner Inactive Packages disk0 asr14k rout 3 7 1 disk0 asr14k compmgmt__installmgr 0 0 5 Table 47 describes the significant fields shown in the display Related Commands Table 47 show install inactive Field Descriptions Field Description disk0 asr14k mgbl 3 7 1 Storage device and the name of the package that is inactive asr14k mgbl V3 7 1 Manageability Package Name of...

Page 400: ...is attached to messages from that operation For example the third installation operation has Install 3 attached to all of its status messages The reverse keyword displays the information from the latest install log to the oldest install log Use the from keyword to limit the output to be from the specified installation identifier and later Displaying Information One or More SDRs Enter the show inst...

Page 401: ... 3 7 1 SIT image disk1 asr14k mcast p pie 3 7 1 SIT image disk1 asr14k mgbl p pie 3 7 1 SIT image disk1 asr14k mpls p pie 3 7 1 SIT image disk1 asr14k pagent p pie 3 7 1 SIT image disk1 asr14k doc pie 3 7 1 SIT image Install operation 2 completed successfully at 20 48 31 UTC Mon Aug 28 2006 Install operation 3 started by user user_b at 20 49 34 UTC Mon Aug 28 2006 admin install activate disk0 asr1...

Page 402: ... mcast processes affected 0 updated 14 added 0 removed 0 impacted Install logs Install operation 3 admin install activate disk0 asr14k k9sec 3 7 1 disk0 asr14k mcast 3 7 1 disk0 asr14k mgbl 3 7 1 disk0 asr14k mpls 3 7 1 disk0 asr14k pagent 3 7 1 disk0 asr14k doc 3 7 1 disk0 asr14k diags 3 7 1 started by user user_b at 20 49 34 UTC Mon Aug 28 2006 Info The changes made to software configurations wi...

Page 403: ... Install logs Install operation 3 admin install activate disk0 asr14k k9sec 3 7 1 disk0 asr14k mcast 3 7 1 disk0 asr14k mgbl 3 7 1 disk0 asr14k mpls 3 7 1 disk0 asr14k pagent 3 7 1 disk0 asr14k doc 3 7 1 disk0 asr14k diags 3 7 1 started by user user_b at 20 49 34 UTC Mon Aug 28 2006 Info The changes made to software configurations will not be Info persistent across system reloads Use the command a...

Page 404: ...pv4_mfwd_netio dll More The following example displays all installation requests in reverse order such that the most recent requests are displayed first RP 0 RP0 CPU0 router admin show install log reverse Install operation 2 started by user user_a via CLI at 12 33 10 GMT Mon Oct 29 2007 admin install add tftp xx tftp user_a asr14k fpd pie Install operation 2 completed successfully at 12 35 19 GMT ...

Page 405: ...where the package was built Use the show install package with the verbose keyword to display the same information as the detail keyword plus additional information regarding dynamic link libraries DLLs Note This command returns the same data in EXEC mode and administration EXEC mode In EXEC mode only the information for the current SDR is displayed For additional information about the status of in...

Page 406: ... 0 RP0 CPU0 router admin show install package disk0 comp asr14k full 3 7 1 disk0 comp asr14k full 3 7 1 disk0 asr14k rout 3 7 1 disk0 asr14k mcast 3 7 1 disk0 asr14k mpls 3 7 1 disk0 asr14k lc 3 7 1 disk0 asr14k fwdg 3 7 1 disk0 asr14k admin 3 7 1 disk0 asr14k base 3 7 1 disk0 asr14k os mbi 3 7 1 The following sample shows output from the show install package command with the detail keyword RP 0 R...

Page 407: ...Management Information Base MI asr14k iox mgb cwi V r37x 2 Craft Web Interface related binaries and e man xml cfgmgr ops V r37x 1 Handler for XML which contains CfgMgr reqs manageability perf V r37x 1 Performance Management Component for Manay snmp assetmib enhi V r37x 2 CISCO ENHANCED IMAGE MIB snmp frucontrolmib V r37x 2 CISCO FRU CONTROL MIB Implementation in EA Table 48 describes the significa...

Page 408: ... show install pie info command to display information about a specified PIE installation file Task ID Examples The following is sample output from the show install pie info command The default display shows the package name expiration date and file size RP 0 RP0 CPU0 router admin show install pie info disk1 asr14k mgbl p pie 3 7 1 Contents of pie file disk1 asr14k mgbl p pie 3 7 1 Expiry date Jan ...

Page 409: ...ML which contains CfgMgrs man xml cli ops V r37x 1 Handler for XML which contains CLI reques man xml infra V r37x 1 Generic infrastructure for XML support man xml mda ops V r37x 1 Handler for XML which contains MDA reques man xml ttyagent V r37x 1 XML Telnet SSH agent cfg sh mgbl V r37x 1 LR shared plane manageability config orb taoorb V r37x 1 TAO ACE ORB to support various CORBA services package...

Page 410: ... win asr14k feature ipsla V r37x 1 IPSLA time stamping feature ipsla_ts_svr ipsla_ts_svr startup libplatform_ipsla_ts dll show_ipsla_ts parser show_ipsla_ts_ltrace doc asr14k mgbl V r37x 2 Contains the man page documentation for ASR 14000 Fault Manager Debug info Fault Manager info IP Service Level Agreement info Manageability Debug info Manageability info Manageabilty Debug info Manageabilty info...

Page 411: ...a ipsla_op_stats_ltst_oper schema ipsla_op_stats_oper schema ipsla_path_setup_test ipsla_react_trig_cfg schema ipsla_responder ipsla_responder startup ipsla_responder_cfg schema ipsla_responder_oper schema ipsla_sa ipsla_sa startup lib_ipsla_app_cmn_bag_descr dll lib_ipsla_responder_stats_bag_descr dll lib_mgbl_ipsla_oper_bag_descr dll libipsla_error dll libipsla_icmp_echo dll libipsla_icmp_path_e...

Page 412: ...li ops V r37x 1 Handler for XML which contains CLI reques libxmlclierror dll libxmlcliops dll xml_cli_debug parser man xml infra V r37x 1 Generic infrastructure for XML support libxmlservice dll libxmlservice_utils dll libxmlserviceerror dll xml_demo_agent xml_infra_cfg parser xml_infra_debug parser xml_infra_show parser man xml mda ops V r37x 1 Handler for XML which contains MDA reques libxmlmdad...

Page 413: ...HANCED IMAGE MIB enhimage mib enhimagemib_cmds parser libenhimagemib dll snmp disman mib V r37x 1 Event MIB Implementation Event mib eventmib_cmds parser libeventmib dll snmp disman mib V r37x 1 EXPRESSION MIB implementation expression mib expressionmib_cmds parser libexpressionmib dll snmp frucontrolmib V r37x 1 CISCO FRU CONTROL MIB Implementation A frucontrol mib frucontrolmib_cmds parser libfr...

Page 414: ...dor Name of the manufacturer Desc Name of the package Build Date and time the package was built Source Source directory where the package was built Card s Card types supported by the package Restart information Restart impact on processes or nodes Components in package Components included in the package Command Description show install Displays active software packages show install active Displays...

Page 415: ...mplete request that is currently running Use the show install request command in administration EXEC mode to display installation operations for all SDRs in the system In EXEC mode this command displays only the installation requests for that SDR Note The default of installation commands is asynchronous mode meaning that the command runs in the background and the EXEC prompt is returned as soon as...

Page 416: ...can still be aborted The following is sample output from the show install request command when no installation operations are running RP 0 RP0 CPU0 router admin show install request There are no install requests in operation Related Commands Command Description install activate Adds a software package or an SMU to the active software set install add Adds the contents of a PIE file to a storage dev...

Page 417: ... the software set associated with a saved installation point To display the available rollback points use the online help system For example show install rollback Tip This command can be used with the install rollback to command to verify the software set associated with a saved installation point before rolling back to the saved installation point point id Installation point ID number label Label...

Page 418: ...tail keyword to display additional information including the individual packages included in the composite packages Tip Use the clear install rollback oldest command to delete saved installation points from the installation buffer Task ID Examples In the following example the show install rollback command displays the available rollback points RP 0 RP0 CPU0 router admin RP 0 RP0 CPU0 router admin ...

Page 419: ...p asr14k mini 3 7 1 Node 0 SM2 SP SP SDR Owner Boot Image disk0 asr14k os mbi 3 7 1 sp mbiasr14k sp vm Rollback Packages disk0 comp asr14k mini 3 7 1 Node 0 SM3 SP SP SDR Owner Boot Image disk0 asr14k os mbi 3 7 1 sp mbiasr14k sp vm Rollback Packages disk0 comp asr14k mini 3 7 1 In the following example the show install rollback detail command displays additional information for the packages inclu...

Page 420: ... disk0 asr14k base 3 7 1 disk0 asr14k os mbi 3 7 1 Node 0 RP1 CPU0 RP SDR Owner Boot Image disk0 asr14k os mbi 3 7 1 mbiasr14k rp vm Rollback Packages disk0 comp asr14k mini 3 7 1 disk0 asr14k rout 3 7 1 disk0 asr14k lc 3 7 1 disk0 asr14k fwdg 3 7 1 disk0 asr14k admin 3 7 1 disk0 asr14k base 3 7 1 disk0 asr14k os mbi 3 7 1 Node 0 SM0 SP SP SDR Owner Boot Image disk0 asr14k os mbi 3 7 1 sp mbiasr14...

Page 421: ... 7 1 disk0 asr14k os mbi 3 7 1 Table 50 describes the significant fields shown in the display Related Commands Table 50 show install rollback Field Descriptions Field Description Boot Image Minimum boot image MBI used to boot the node Rollback Packages Packages that are rolled back Command Description clear install rollback oldest Deletes saved installation points from the installation buffer inst...

Page 422: ...is located This command returns the same data in EXEC mode and administration EXEC mode Enter the command in administration EXEC mode to display information for all nodes in all SDRs Displaying Information for a Specific SDR To display information for a specific SDR from administration EXEC mode use the sdr keyword and sdr name argument To display information for an SDR when logged into that SDR e...

Page 423: ... 3 7 1 5I lc mbihfe Package asr14k base asr14k base V3 7 1 5I SIT image Base Package Vendor Cisco Systems Desc Base Package Build Built on Mon Aug 28 07 54 07 UTC 2006 Source By edde bld1 in vws aga production 3 7 1 5I SIT image asr14k wor8 Card s RP DRP DRPSC OC3 POS 4 OC12 POS GE 3 OC12 POS 4 OC48 POC Restart information Default parallel impacted processes restart Component cdp V ci 34 6 Cisco D...

Page 424: ... 3 7 1 5I lc mbihfe Package asr14k base asr14k base V3 7 1 5I SIT image Base Package Vendor Cisco Systems Desc Base Package Build Built on Mon Aug 28 07 54 07 UTC 2006 Source By edde bld1 in vws aga production 3 7 1 5I SIT image asr14k wor8 Card s RP DRP DRPSC OC3 POS 4 OC12 POS GE 3 OC12 POS 4 OC48 POC Restart information Default parallel impacted processes restart Component cdp V ci 34 6 Cisco D...

Page 425: ...P DRP LC SC Local view pkg bin cdp Local install path disk0 asr14k base 3 7 1 5I bin cdp Central install path disk0 asr14k base 3 7 1 5I bin cdp File cdp not active on node 0 SM0 SP File cdp not active on node 0 SM1 SP File cdp not active on node 0 SM2 SP File cdp not active on node 0 SM3 SP Table 51 describes the significant fields shown in the display Table 51 show install which Field Descriptio...

Page 426: ...ll which Field Descriptions continued Field Description Command Description show install Displays active software packages show install active Displays active software packages show install inactive Displays inactive packages in the active software set show install committed Displays committed software packages show install log Displays the entries stored in the logging installation buffer show in...

Page 427: ...scribes the Cisco IOS XR Network Time Protocol NTP commands used to perform basic network time management tasks including synchronizing time settings and coordinating time distribution over the network When an NTP server or client is configured NTP features are available on all router interfaces NTP features can be disabled for any specified interface local or remote to the route processor RP ...

Page 428: ...g order from least restrictive to most restrictive 1 peer 2 serve 3 serve only 4 query only Access is granted for the first match that is found If no access groups are specified all access is granted to all sources If any access groups are specified only the specified access is granted This facility provides minimal security for the time services of the system However it can be circumvented by a d...

Page 429: ...w to configure the system to allow itself to be synchronized by a peer from an access list named access1 and to restrict access to allow only time requests from an access list named access2 RP 0 RP0 CPU0 router config ntp access group peer access1 RP 0 RP0 CPU0 router config ntp access group serve only access2 Related Commands Task ID Operations ip services read write Command Description ipv4 acce...

Page 430: ...thenticate command to enable NTP authentication When NTP authentication is enabled the system does not synchronize to a time source unless it carries one of the authentication keys specified by the trusted key command Packets failing the authentication check are dropped Task ID Examples The following example shows how to configure the system to synchronize only to a system that provides an authent...

Page 431: ... To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the authentication key command to define authentication keys for use with trusted NTP time sources Note When this command is written to NVRAM the key is encrypted so that it is not displayed when the configuration is displayed Task ID key number Authentication key A number in the ran...

Page 432: ...ion key 42 in their NTP packets RP 0 RP0 CPU0 router config ntp RP 0 RP0 CPU0 router config ntp authenticate RP 0 RP0 CPU0 router config ntp authentication key 42 md5 clear key1 RP 0 RP0 CPU0 router config ntp trusted key 42 Related Commands Command Description authenticate NTP Enables NTP authentication peer NTP Configures the system clock to synchronize a peer or to be synchronized by a peer ser...

Page 433: ...proper task IDs Use the broadcast command to create an NTP broadcast server on an NTP interface to send NTP broadcast packets Use the broadcast client command to set a specific interface to receive NTP broadcast packets Task ID Examples The following example shows how to configure Packet over SONET SDH POS interface 0 0 0 1 to send NTP packets to destination host IP address 10 0 0 0 RP 0 RP0 CPU0 ...

Page 434: ...2 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description broadcast client Allows a networking device to receive NTP broadcast packets on an interface broadcastdelay Sets the estimated round trip delay between the software and an NTP broadcast server ...

Page 435: ... that includes the proper task IDs Use the broadcast client command to configure and create an NTP broadcast client and to associate the client with an interface to receive and handle NTP broadcast packets If no NTP client has been created for an interface the received NTP broadcast packets are dropped Use this command to allow the system to listen to broadcast packets on an interface by interface...

Page 436: ...configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the broadcastdelay command to change the default round trip delay time on a networking device that is configured as a broadcast client Task ID Examples The following example shows how to set the estimated round trip delay between a networ...

Page 437: ... configured By default after the NTP process is started NTP features become available for all interfaces To exit NTP interface configuration mode use the exit command Task ID Examples The following example shows how to enter NTP configuration mode specify an NTP interface to be configured and enter NTP interface configuration mode RP 0 RP0 CPU0 router config ntp RP 0 RP0 CPU0 router config ntp int...

Page 438: ...its time through NTP from a stratum 1 time server a stratum 3 from a stratum 2 and so on Caution Use the master command with extreme caution It is easy to override other valid time sources using this command especially if a low stratum number is configured Configuring multiple machines in the same network with the master command can lead to instability in time keeping if the machines do not agree ...

Page 439: ...en manually set from some source before the master command has an effect This precaution protects against the distribution of erroneous time after the system is restarted Task ID Examples The following example shows how to configure a networking device as an NTP master clock to which peers may synchronize RP 0 RP0 CPU0 router config ntp RP 0 RP0 CPU0 router config ntp master 9 Task ID Operations i...

Page 440: ... configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the max associations command to specify the maximum number of associations for an NTP server Task ID Examples The following example shows how to set the maximum number of associations to 200 RP 0 RP0 CPU0 router config ntp RP 0 RP0 CPU0 ...

Page 441: ...ing NTP configuration commands are available RP 0 RP0 CPU0 router config ntp access group Control NTP access authenticate Authenticate time sources authentication key Authentication key for trusted time sources broadcastdelay Estimated round trip delay commit Commit the configuration changes to running default Set a command to its defaults describe Describe a command without taking real actions do...

Page 442: ...Software ntp SMR 440 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Task ID Examples The following example shows how to enter NTP configuration mode RP 0 RP0 CPU0 router config ntp RP 0 RP0 CPU0 router config ntp Task ID Operations ip services read write ...

Page 443: ...ption Defaults No defaults behavior or values Command Modes EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to clear all NTP peers RP 0 RP0 CPU0 router ntp clear peer IPv4 address or hostname of the NTP peer to be cleared Clears all NTP peers Release...

Page 444: ...ime Protocol NTP version number where the number argument is a value from 1 to 4 The default is 4 key key id Optional Defines the authentication key where the key id argument is the authentication key to use when packets are sent to this peer The authentication key is also used for packets received from the peer minpoll interval Optional Defines the shortest polling interval where the interval arg...

Page 445: ... the system issues an error message To provide peer level service as opposed to client server level service it may be necessary to explicitly specify the NTP version for the peer if it is not version 4 Task ID Examples The following example shows how to configure a networking device to allow its system clock to be synchronized with the clock of the peer or conversely at IP address 10 0 0 0 using N...

Page 446: ...TP version number where the number argument is a value from 1 to 4 The default is 4 key key id Optional Defines the authentication key where the key id argument is the authentication key to use when packets are sent to this peer minpoll interval Optional Defines the shortest polling interval where the interval argument is specified in seconds as a power of 2 The number is used in a power of 2 expr...

Page 447: ...error message Using the prefer keyword reduces switching back and forth among servers Task ID Examples The following example shows how to configure a router to allow its system clock to be synchronized with the clock of the peer at IP address 209 165 201 1 using NTP RP 0 RP0 CPU0 router config ntp RP 0 RP0 CPU0 router config ntp server 209 165 201 1 minpoll 8 maxpoll 12 Related Commands Task ID Op...

Page 448: ...odes EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the show calendar command to display the time and date in Coordinated Universal Time UTC format Task ID Examples The following is sample output from the show calendar command RP 0 RP0 CPU0 router show calendar 01 29 28 UTC Thu Apr 01 2004 Rel...

Page 449: ...iations command RP 0 RP0 CPU0 router show ntp associations address ref clock st when poll reach delay offset disp 172 19 69 1 171 68 10 150 2 4 64 3 2 0 3 79 0 0 master synced master unsynced selected candidate configured Table 52 describes the significant fields shown in the display detail Optional Displays detailed information about each NTP association location node id Optional Displays the sta...

Page 450: ...0 06 0 08 0 09 0 32 Table 53 describes the significant fields shown in the display Peer is elected for possible synchronization Peer is a candidate for selection Indicates peer is statically configured address Address of the peer ref clock Reference clock type or address for the peer st Stratum setting for the peer when Time in milliseconds since last NTP packet was received from peer poll Polling...

Page 451: ...l sync dist Peer synchronization distance delay Round trip delay to peer offset Offset of peer clock relative to this clock dispersion Dispersion of peer clock precision Precision of peer clock in Hertz Hz version NTP version number that peer is using org time Originate time stamp rcv time Receive time stamp xmt time Transmit time stamp filtdelay Round trip delay in milliseconds of each sample fil...

Page 452: ...s location 0 2 cpu0 Clock is synchronized stratum 4 reference is DLRSC node nominal freq is 1000 0000 Hz actual freq is 999 9801 Hz precision is 2 26 reference time is C4143841 3403218C 18 17 37 203 UTC Tue Mar 30 2004 clock offset is 11 9957 msec root delay is 11 41 msec root dispersion is 65 94 msec peer dispersion is 0 00 msec Table 54 describes the significant fields shown in the display locat...

Page 453: ...frequency in Hz of the system hardware clock precision Precision of the clock of this system in Hz reference time Reference time stamp clock offset Offset of clock in milliseconds to synchronized peer root delay Total delay in milliseconds along path to root clock root dispersion Dispersion of root path peer dispersion Dispersion of synchronized peer Table 54 show ntp status Field Descriptions con...

Page 454: ... Interface type For more information use the question mark online help function interface id Either a physical or virtual interface identifier as follows Physical interface identifier Naming notation is rack slot module port and a slash between values is required as part of the notation rack Chassis number of the rack slot Physical slot number of the modular services card or line card module Modul...

Page 455: ... source keyword has been configured with the server NTP or peer NTP command that value overrides the global value Task ID Examples The following example shows how to configure the router to use the IP address of Packet over SONET SDH POS interface 0 0 0 1 as the source address of all outgoing NTP packets RP 0 RP0 CPU0 router config ntp RP 0 RP0 CPU0 router config ntp source POS 0 0 0 1 Related Com...

Page 456: ...on is enabled use the trusted key command to define one or more key numbers corresponding to the keys defined with the authentication key NTP command that a NTP system must provide in its NTP packets for this system to synchronize to it Because the other system must know the correct authentication key this precaution provides protection against accidentally synchronizing the system to a system tha...

Page 457: ...s on Cisco IOS XR Software trusted key SMR 455 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description authenticate NTP Enables NTP authentication authentication key NTP Defines an authentication key for NTP ...

Page 458: ...mmand you must be in a user group associated with a task group that includes the proper task IDs Some networking devices have a calendar that is separate from the system clock This calendar runs continuously even if the device is powered off or rebooted If a networking device is synchronized to an outside time source through NTP it is a good idea to update the calendar with the time learned from N...

Page 459: ...e update calendar SMR 457 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description clock read calendar Copies the hardware calendar clock settings into the software clock clock update calendar Sets the calendar from the software clock ...

Page 460: ...C i sc o C o n f id en t ia l B et a R ev iew R 3 7 1 NTP Commands on Cisco IOS XR Software update calendar SMR 458 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 ...

Page 461: ... a R ev iew R 3 7 1 SMR 459 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Object Tracking Commands in Cisco IOS XR Software This chapter describes the Cisco IOS XR software commands used to track objects ...

Page 462: ...lay which had been set to notify the network administrator of a change in the up state of the interface every five seconds RP 0 RP0 CPU0 router configuration RP 0 RP0 CPU0 router config track atm1235 RP 0 RP0 CPU0 router config track clear delay up 5 Related Commands delay up seconds Sets delay of from 1 to 10 seconds before communication of the up status of the tracked object or list of objects d...

Page 463: ...ce command is accessed through line protocol tracking configuration submode Task ID Examples The following example shows the use of the clear interface command RP 0 RP0 CPU0 router configuration RP 0 RP0 CPU0 router config track name1 RP 0 RP0 CPU0 router config track type line protocol state RP 0 RP0 CPU0 router config track line prot clear interface atm 0 2 0 0 1 RP 0 RP0 CPU0 router config trac...

Page 464: ... Management Command Reference OL 17231 01 Related Commands Command Description interface track Indicates an interface object type for tracking purposes track Initiates or identifies a tracking process to track the status of an object also enters track configuration mode type line protocol state Configures tracking based on the line protocol state of an interface object ...

Page 465: ...list tracking configuration submode Task ID Examples The following example shows the use of the clear object command RP 0 RP0 CPU0 router configuration RP 0 RP0 CPU0 router config track name1 RP 0 RP0 CPU0 router config track type list boolean and RP 0 RP0 CPU0 router config track list clear object IPSEC3 not Related Commands object name Name of the object to be tracked not Deletes tracking config...

Page 466: ...acking configuration submode Task ID Examples The following example shows the use of the clear route ipv4 command RP 0 RP0 CPU0 router configuration RP 0 RP0 CPU0 router config track name1 RP 0 RP0 CPU0 router config track type route reachability RP 0 RP0 CPU0 router config track route clear route ipv4 10 56 8 10 16 Related Commands IP prefix and subnet mask An IP prefix consisting of the network ...

Page 467: ...and History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to use the clear type line protocol state command RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config track track12 RP 0 RP0 CPU0 router config track clear type line protocol state Related Commands Releas...

Page 468: ...with a task group that includes the proper task IDs Task ID Examples The following example shows how to use the clear type list boolean command RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config track connection100 RP 0 RP0 CPU0 router config track list clear type list boolean and and Specifies that the list is up if all objects are up or down if one or more objects are down For example wh...

Page 469: ...MR 467 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description track Initiates or identifies a tracking process to track the status of an object also enters track configuration mode type list boolean Configures tracking of a list of objects based on a Boolean calculation ...

Page 470: ... group associated with a task group that includes the proper task IDs A tracked IP route object is considered up and reachable when a routing table entry exists for the route and the route is not inaccessible Task ID Examples The following example shows how to clear tracking for route reachability RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config track track22 RP 0 RP0 CPU0 router config ...

Page 471: ...racking configuration submode Task ID Examples The following example shows the use of the clear vrf command RP 0 RP0 CPU0 router configuration RP 0 RP0 CPU0 router config track name1 RP 0 RP0 CPU0 router config track type route reachability RP 0 RP0 CPU0 router config track clear vrf vrf table name Related Commands vrf table name Name of the VRF table used for route reachability tracking Release M...

Page 472: ...The delay command can be used in conjunction with all track types type line protocol state type list boolean type route reachability When using the no form of the command the use of the seconds argument is optional Task ID Examples The following example shows that the tracking process is configured to notify the network administrator that the interface should be polled for its up state in five sec...

Page 473: ...ries Router System Management Command Reference OL 17231 01 Related Commands Command Description clear delay Clears entry of a delay in seconds before the track or interface state should be polled for a change in status track Initiates or identifies a tracking process to track the status of an object also enters track configuration mode ...

Page 474: ...ace command you must be in line protocol tracking configuration submode For information about interface keywords see Cisco IOS XR Interface and Hardware Component Command Reference Task ID Examples The following example shows the interface command in the context of object tracking RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config track track12 RP 0 RP0 CPU0 router config track type line p...

Page 475: ...rs entry of a particular interface object type track Initiates or identifies a tracking process to track the status of an object also enters track configuration mode type line protocol state Configures tracking based on the line protocol state of an interface object type list boolean Configures tracking of a list of objects based on a Boolean calculation type route reachability Configures tracking...

Page 476: ... that includes the proper task IDs Task ID Examples The following example shows how the line protocol track command is used RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config track PREFIX1 RRP 0 RP0 CPU0 router config track type route reachability RP 0 RP0 CPU0 router config track route route ipv4 7 0 0 0 24 RP 0 RP0 CPU0 router config track route interface service ipsec 1 RP 0 RP0 CPU0 ro...

Page 477: ...nfigured track based on whether an interface object is not up or down use the not keyword together with the object command in a list of tracked objects based on a Boolean expression The object command can only be used for a track based on a Boolean expression Task ID Examples The following example shows how to configure an object using the optional not keyword in a tracked list of objects based on...

Page 478: ...Management Command Reference OL 17231 01 Related Commands Command Description clear object Clears entry of a specific object to be used for tracking track Initiates or identifies a tracking process to track the status of an object also enters track configuration mode type list boolean Configures tracking of a list of objects based on a Boolean calculation ...

Page 479: ...r values Command Modes Route tracking configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs The IP prefix and subnet mask arguments are optional for the no form of this command Task ID Examples The following example displays use of the route ipv4 command RP 0 RP0 CPU0 router configure RP 0 RP0 C...

Page 480: ...mand Reference OL 17231 01 Related Commands Command Description clear route ipv4 Clears entry of an IP prefix and subnet mask as a basis for tracking route reachability type route reachability Configures tracking based on whether or not a route is part of a particular routing table vrf track Configures that a VRF table should be used as the basis to track route reachability ...

Page 481: ...and to display information about objects that are tracked by the tracking process When no arguments or keywords are specified information for all objects is displayed Task ID Examples The following sample output illustrates use of the show track command RP 0 RP0 CPU0 router show track Track_name3 Track_name3 List boolean and is DOWN 1 change last change 10 26 20 SJC Sun Aug 05 2007 object name2 no...

Page 482: ...s in Cisco IOS XR Software show track SMR 480 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description track Initiates or identifies a tracking process to track the status of an object also enters track configuration mode ...

Page 483: ... group associated with a task group that includes the proper task IDs When you use the track command you enter track configuration mode The track command is used in conjunction with all the following track commands and types delay show track type line protocol state type list boolean type route reachability Task ID Examples The following example shows that the tracking process is configured to not...

Page 484: ...econds before the track or interface state should be polled for a change in status show track Displays information about objects that were tracked type line protocol state Configures tracking based on the line protocol state of an interface object type list boolean Configures tracking based on whether or not a route is part of a particular routing table type route reachability Configures tracking ...

Page 485: ...ol state command can be used in conjunction with the delay command to configure the delay in seconds before the track or interface state should be polled for a change in its status The type line protocol state command enters line protocol tracking configuration mode Task ID Examples The following example shows how to use the type line protocol state command RP 0 RP0 CPU0 router configure RP 0 RP0 ...

Page 486: ... line protocol state SMR 484 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 show track Displays information about objects that were tracked track Initiates or identifies a tracking process to track the status of an object also enters global configuration mode Command Description ...

Page 487: ...o configure the delay in seconds before the track or interface state should be polled for a change in its status To remove a track based on whether an interface object is not up or down use the not keyword together with the object command as shown in the example that follows Task ID Examples The following example shows how to use the type list boolean command in creating a list of objects to be tr...

Page 488: ...t RP 0 RP0 CPU0 router config track interface service ipsec 1 RP 0 RP0 CPU0 router config if vrf 1 RP 0 RP0 CPU0 router config if ipv4 address 70 0 0 2 255 255 255 0 RP 0 RP0 CPU0 router config if profile vrf_1_ipsec RP 0 RP0 CPU0 router config if line protocol track LIST2 RP 0 RP0 CPU0 router config if tunnel source 80 0 0 2 RP 0 RP0 CPU0 router config if tunnel destination 80 0 0 1 RP 0 RP0 CPU0...

Page 489: ... associated with a task group that includes the proper task IDs A tracked IP route object is considered up and reachable when a routing table entry exists for the route and the route is not inaccessible The type route reachability command can be used in conjunction with the delay command to configure the delay in seconds before the track or interface state should be polled for a change in its stat...

Page 490: ...ds Command Description clear type route reachability Clears entry of type route reachability as the basis for tracking an object delay Configures the duration in seconds before the track or interface state should be polled for a change in status show track Displays information about objects that were tracked track Initiates or identifies a tracking process to track the status of an object also ent...

Page 491: ... you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example displays the use of the vrf command RP 0 RP0 CPU0 router configure RP 0 RP0 CPU0 router config track track22 RP 0 RP0 CPU0 router config track type route reachability RP 0 RP0 CPU0 router config track route vrf vrf1 Related Commands vrf name Network and subnet for exam...

Page 492: ...C i sc o C o n f id en t ia l B et a R ev iew R 3 7 1 Object Tracking Commands in Cisco IOS XR Software vrf track SMR 490 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 ...

Page 493: ... 17231 01 Process and Memory Management Commands on Cisco IOS XR Software This chapter describes the Cisco IOS XR software commands used to manage processes and memory For more information about using the process and memory management commands to perform troubleshooting tasks see Cisco ASR 14000 Series Router Getting Started Guide ...

Page 494: ... this command you must be in a user group associated with a task group that includes the proper task IDs The affinity location set command assigns an affinity for a process to run on a specific node node pair or set of up to 5 nodes A node pair is either an active and standby pair of nodes hosted on route processors RPs or a single active node on an RP that does not have a standby By containing re...

Page 495: ...s on the node pair RP 0 RP0 CPU0 router config placement program ospf RP 0 RP0 CPU0 router config place affinity location set 0 1 cpu0 0 1 cpu1 attract 200 The following example shows how to stop loading an RP with more processes RP 0 RP0 CPU0 router config placement program default RP 0 RP0 CPU0 router config place affinity location set 0 1 cpu0 repulse 90 Related Commands Task ID Operations sysm...

Page 496: ...pecifying an affinity value of default is equivalent to specifying the attract strength argument to be 200 Command Modes Placement program configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs The affinity location type command is used to place a process at a particular location The default poli...

Page 497: ...ffinity towards the nodes that are paired active and standby nodes and as mentioned earlier this is the default policy The affinity location type using the primary option configures the affinity towards the designated secure domain router system controller DSDRSC node Note Change the current affinity with assistance from Cisco support personnel Task ID Examples This example shows how to place Bord...

Page 498: ...mand you must be in a user group associated with a task group that includes the proper task IDs The affinity program command is used to collocate processes or keep them apart You would want to use this command because you have learned that certain processes perform better when they are running together on the same node attract or on different nodes apart from each other repulse Task ID Examples Th...

Page 499: ...ement Commands on Cisco IOS XR Software affinity program SMR 497 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description placement program Enters placement program configuration mode to set process affinities preferences ...

Page 500: ...e affinity self command is used to adjust placement decisions when multiple instances of a process are started An attract positive affinity indicates a preference to have all instances of a process run on the same node while a repulse negative affinity indicates a preference to have each instance of a process run on different nodes Typically you would want to monitor how a process on your system b...

Page 501: ...agement Commands on Cisco IOS XR Software affinity self SMR 499 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description placement program Enters placement program configuration mode to set process affinities preferences ...

Page 502: ...r context command to clear core dump context information If you do not specify a node with the location keyword and node id argument this command clears core dump context information for all nodes Use the show context command to display core dump context information Task ID Examples The following example shows how to clear core dump context information RP 0 RP0 CPU0 router clear context Related Co...

Page 503: ... the Cisco IOS XR software core dumps can be generated manually for a process even when a process has not crashed Two modes exist to generate a core dump manually running Generates a core dump for a running process This mode can be used to generate a core dump on a critical process a process whose suspension could have a negative impact on the performance of the router because the core dump file i...

Page 504: ...ep 22 01 40 26 998 dumper 54 DUMPER 7 DLL_INFO pkg lib libbackplane dll 0xfc1d8000 0x0000134c 0xfc0c2e4c 0x000000a8 0 RP 0 RP0 CPU0Sep 22 01 40 26 999 dumper 54 DUMPER 7 DLL_INFO pkg lib libnodeid dll 0xfc1e5000 0x00009114 0xfc1e41a8 0x00000208 0 RP 0 RP0 CPU0Sep 22 01 40 26 999 dumper 54 DUMPER 7 DLL_INFO pkg lib libttyserver dll 0xfc1f1000 0x0003dfcc 0xfc22f000 0x00002000 0 RP 0 RP0 CPU0Sep 22 0...

Page 505: ...8 0 RP 0 RP0 CPU0Sep 22 01 40 27 007 dumper 54 DUMPER 7 DLL_INFO pkg lib libbag dll 0xfc431000 0x0000ee98 0xfc40cc94 0x00000368 0 RP 0 RP0 CPU0Sep 22 01 40 27 008 dumper 54 DUMPER 7 DLL_INFO pkg lib libchkpt dll 0xfc474000 0x0002ecf8 0xfc4a3000 0x00000950 0 RP 0 RP0 CPU0Sep 22 01 40 27 008 dumper 54 DUMPER 7 DLL_INFO pkg lib libsysdbbackend dll 0xfc8ed000 0x0000997c 0xfc8d3aa8 0x0000028c 0 RP 0 RP...

Page 506: ...her or not the core dump file should be sent compressed By default core dump files are sent compressed If you specify the compress keyword you must specify one of the following required keywords on Compresses the core dump file before sending it off Does not compress the core dump file before sending it filename filename lower limit higher limit Optional Specifies the filename to be appended to co...

Page 507: ...e secondary location for core dump files Tertiary location The tertiary fallback choice as the destination for core dump files if the primary and secondary locations fail Enter the choice keyword and a value of 3 that is choice 3 for the preference argument to specify a destination as the tertiary location for core dump files When specifying a destination for a core dump file you can specify an ab...

Page 508: ...ddition to uniquely identify each core dump file a value is appended to each core dump file beginning with the lower limit value specified with the lower limit argument and continuing until the higher limit value specified with the higher limit keyword has been reached When the configured higher limit value has been reached the Cisco IOS XR software begins to recycle the values appended to core du...

Page 509: ...l core filenames will be named core the range value is set from 0 to 5 that is the values 0 to 5 are appended to the filename for the first five generated core dump files respectively before being recycled and the destination is set to a directory on the hard disk RP 0 RP0 CPU0 router config exception choice 1 compress off filename core 0 5 filepath harddisk corefile Related Commands Task ID Opera...

Page 510: ...roup associated with a task group that includes the proper task IDs Use the exception pakmem on command to configure the collection of packet memory information in core dump files Cisco Technical Support Center engineers and development engineers use packet memory information to debug packet memory issues related to a process Caution Including packet memory information in core dump files significa...

Page 511: ...R 509 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description exception filepath Modifies core dump settings exception sparse Enables or disables sparse core dumps exception sprsize Sets the maximum size of core dump files show exception Displays the configured core dump settings ...

Page 512: ...equired to generate core dump files corresponds to faster process restart times Sparse core dumps contain the following information about crashed processes Register information for all threads and any memory pages referenced in these register values Stack information for all threads and any memory pages referenced in these threads All memory pages referenced by a loaded dynamic loadable library DL...

Page 513: ... ID Examples The following example shows how to enable sparse core dumps RP 0 RP0 CPU0 router config exception sparse on Related Commands Task ID Operations diag read write Command Description exception filepath Modifies core dump settings exception pakmem Collects packet memory information in core dumps exception sprsize Sets the maximum file size of core dump files show exception Displays the co...

Page 514: ...mand to specify the maximum file size for core dumps The maximum file size configured for the megabytes argument is used with the configuration set for the exception sparse command to determine whether or not to generate a sparse core dump file If sparse core dumps are disabled and a core dump file is predicted to exceed the default value 192 MB uncompressed or the value specified for the megabyte...

Page 515: ...he target process on the designated node The node id argument is expressed in the rack slot module notation all Optional Follows all threads blocked Optional Follows the chain of thread IDs TIDs or PIDs that are blocking the target process debug level Optional Sets the debug level for the following operation Valid values for the level argument are 0 to 10 delay seconds Optional Sets the delay inte...

Page 516: ...performance related issues by specifying a high number of iterations with a zero delay Task ID Examples The following example shows how to use the follow command to debug the process associated with job ID 257 for one iteration RP 0 RP0 CPU0 router follow job 257 iteration 1 Attaching to process pid 28703 pkg bin packet No tid specified following all threads DLL Loaded by this process DLL path Tex...

Page 517: ...rrent process pkg bin packet PID 28703 TID 3 trace_back 0 0xfc17d54c SignalWaitinfo trace_back 1 0xfc161c64 sigwaitinfo trace_back 2 0xfc10302c event_signal_thread ENDOFSTACKTRACE Current process pkg bin packet PID 28703 TID 4 trace_back 0 0xfc1106c4 MsgReceivePulse trace_back 1 0xfc0fc604 msg_receive_async trace_back 2 0xfc0ffa70 event_dispatch trace_back 3 0xfc0ffc5c event_block_async trace_back...

Page 518: ...ow command to debug the chain of threads blocking thread 2 associated with the process assigned PID 139406 RP 0 RP0 CPU0 router follow process 139406 blocked iteration 1 thread 2 Attaching to process pid 139406 pkg bin lpts_fm DLL Loaded by this process DLL path Text addr Text size Data addr Data size Version pkg lib libplatform dll 0xfc0d6000 0x0000aa88 0xfc0e1000 0x00002000 0 pkg lib libsysmgr d...

Page 519: ...0 0x0000079c 0 pkg lib libsysdbutils dll 0xfc29a000 0x0000ae04 0xfc29979c 0x000003ec 0 pkg lib libwd_evm dll 0xfc2a9000 0x0000481c 0xfc299b88 0x00000188 0 pkg lib lrdlib dll 0xfc2f6000 0x0000a900 0xfc2f551c 0x00000610 0 pkg lib liblrfuncs dll 0xfc30e000 0x00001998 0xfc2ebd80 0x000001ec 0 pkg lib libdscapi dll 0xfc310000 0x0000457c 0xfc2f5b2c 0x0000035c 0 pkg lib liblrdshared dll 0xfc315000 0x00005...

Page 520: ...teration 1 stackonly thread 2 Attaching to process pid 139406 pkg bin lpts_fm Iteration 1 of 1 Current process pkg bin lpts_fm PID 139406 TID 2 trace_back 0 0xfc110744 MsgSendv trace_back 1 0xfc0fbf04 msg_sendv trace_back 2 0xfc0fbbd8 msg_send trace_back 3 0xfcec7580 pa_fm_close trace_back 4 0xfcec78b0 pa_fm_process_0 ENDOFSTACKTRACE REPLY node node0_RP1_CPU0 pid 57433 No specific TID following al...

Page 521: ...rence OL 17231 01 Current process pkg bin lpts_pa PID 57433 TID 3 trace_back 0 0xfc1106dc MsgReceivev trace_back 1 0xfc0fc840 msg_receivev trace_back 2 0xfc0fc64c msg_receive trace_back 3 0xfc0ffa70 event_dispatch trace_back 4 0xfc0ffc2c event_block trace_back 5 0x482064c4 N A ENDOFSTACKTRACE Related Commands Command Description show processes Displays information about the running processes ...

Page 522: ...r task IDs Use the monitor processes command to display the top ten processes based on CPU usage The display refreshes every 10 seconds To change the parameters displayed by the monitor processes command enter one of the interactive commands described in Table 56 To terminate the display and return to the system prompt enter the q key To list the interactive commands type during the display The av...

Page 523: ...1 packet The following is sample output from the monitor processes command using the optional location keyword and node id argument RP 0 RP0 CPU0 router monitor processes location 0 RP0 CPU0 202 processes 724 threads 3750 channels 5092 fds CPU states 48 8 idle 0 8 user 1 5 kernel Memory 2048M total 1526M avail page size 4K JID TIDS Chans FDs Tmrs MEM HH MM SS CPU NAME 1 27 205 3 1 0 10 54 12 1 52 ...

Page 524: ...03 dsc 303 3 25 34 5 292K 0 00 00 0 03 statsd_server 121 3 10 8 2 564K 0 00 06 0 03 bcm_process 195 processes 628 threads 3409 channels 4601 fds CPU states 46 5 idle 0 5 user 52 8 kernel Memory 2048M total 1576M avail page size 4K JID TIDS Chans FDs Tmrs MEM HH MM SS CPU NAME 1 27 198 6 1 0 6 33 44 52 89 kernel 52 5 215 44 5 228K 0 00 06 0 38 devc conaux 309 6 25 23 8 352K 0 00 08 0 03 sysdb_mc 31...

Page 525: ...vc conaux 293 7 31 39 11 352K 0 00 09 0 04 shelfmgr 315 3 177 14 4 1M 0 00 11 0 03 sysdb_svr_local 304 3 14 29 7 304K 0 00 01 0 02 statsd_manager 309 6 25 23 8 352K 0 00 08 0 02 sysdb_mc 342 4 195 14 6 1M 0 00 08 0 01 wdsysmon 298 9 25 111 9 2M 0 00 09 0 00 snmpd 265 5 31 19 4 204K 0 00 09 0 00 packet 153 2 35 18 4 120K 0 00 00 0 00 dsc 290 4 6 17 2 112K 0 00 00 0 00 sc_reddrv 275 7 34 36 7 588K 0...

Page 526: ... the monitor threads command to show the top ten threads based on CPU usage The display refreshes every 10 seconds To change the parameters displayed by the monitor threads command enter one of the key commands described in Table 58 To terminate the display and return to the system prompt enter the q key To list the interactive commands type during the display The available interactive display com...

Page 527: ... sysdb_svr_local 55 7 0 55 Rcv 0 00 11 0 02 eth_server The following is sample output from the monitor threads command using the optional location keyword RP 0 RP0 CPU0 router monitor threads location 0 RP0 CPU0 Computing times 195 processes 628 threads CPU states 95 1 idle 2 7 user 2 0 kernel Memory 2048M total 1576M avail page size 4K JID TID LAST_CPU PRI STATE HH MM SS CPU COMMAND 1 25 0 10 Run...

Page 528: ...3 10 Rcv 0 00 24 0 00 sysdbsvr 1 3 10 Rcv 0 00 21 0 00 kernel 69 1 10 Rcv 0 00 20 0 00 wdsysmon 1 5 10 Rcv 0 00 20 0 00 kernel 159 2 10 Rcv 0 00 05 0 00 qnet 160 1 10 Rcv 0 00 05 0 00 netio 157 1 10 NSlp 0 00 04 0 00 envmon_periodic 160 9 10 Intr 0 00 04 0 00 netio n Enter number of threads to display 3 Please enter a number between 5 and 40 Enter number of threads to display 8 87 processes 249 th...

Page 529: ...00 Series Router System Management Command Reference OL 17231 01 When a number outside the acceptable range is entered the acceptable range is displayed Please enter a number between 5 and 40 Enter number of threads to display Related Commands Command Description monitor processes Displays interactive auto updating process statistics in a full screen mode ...

Page 530: ...es to 100 percent If a node has 2 GB of available memory then only 2 GB of processes can be placed on the node estimated memory usage This means that oversubscription is not allowed The command placement memory maximum 50 sets the maximum memory usage on nodes to 50 percent so that placeable processes can use only half the memory on the node The command placement memory maximum 200 would allow the...

Page 531: ...ttings RP 0 RP0 CPU0 router show placement policy global Per location placement policy parameters Memory preferred threshold 80 Memory maximum threshold 200 Threshold satisfaction affinity points 50 Task ID Examples In the following example the maximum memory threshold is set to 80 percent RP 0 RP0 CPU0 router config placement memory maximum 80 Related Commands Task ID Operations sysmgr read write...

Page 532: ... for any placeable process such as Open Shortest Path First OSPF and Border Gateway Protocol BGP Placement policy consists of two types resource consumption and affinities Resource consumption involves CPU and memory usage and is a hard resource requirement Affinities are preferences and are considered soft requirements for a placement policy Only affinities can be configured by the operator The p...

Page 533: ...ter config place affinity location type current attract 100 Related Commands Task ID Operations sysmgr read write Command Description affinity location set Sets the affinity of a placeable program process to or from node pairs affinity location type Sets the affinity of a placeable program process to or from a location type affinity program Sets the affinity of a placeable program process to or fr...

Page 534: ...ailable nodes based on memory usage and other calculations This placement reoptimize command first displays the predicted results of the reoptimization before running the command You can accept the changes and run the command or cancel the procedure without impacting the router Task ID Examples The following example illustrates how to use the placement reoptimize command The predicted changes are ...

Page 535: ... 0 RP0 CPU0 Nov 12 1 1 1 1 placed 170 PLACED_PLACE 6 REOP_START Re optimization of the placement requested You will be notified on completion RP 0 RP0 CPU0 Nov 12 1 1 1 1 placed 254 OS PLACED_PLACE 6 REOP_COMPLETE Re optimization of the placement complete Use show placement to view the ne w placement Related Commands Command Description show placement reoptimize Displays information about process ...

Page 536: ...he operation of a router Use these commands only under the direction of a Cisco Technical Support representative blocked Collects debug information The node is restarted if the mandatory reboot flag is set crash Crashes a process restart Restarts a process shutdown Stops a process The process is not restarted even if considered mandatory start Starts a process executable name Optional Executable n...

Page 537: ...e process are started simultaneously process blocked This command is used by Cisco Technical Support engineers to collect debug information about a process If the process mandatory command is set for a process the process blocked command also causes the node to restart Task ID Examples The following example shows how to restart a process In this example the IS IS process is restarted RP 0 RP0 CPU0...

Page 538: ...ommands on Cisco IOS XR Software process SMR 536 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description process mandatory Sets the options for mandatory processes show processes Displays information about the running processes ...

Page 539: ...ces of a running process job id Job ID associated with the process instance Specifying a job id value changes the core dump option for only a single instance of a running process context Dumps only context information for a process copy Copies a core dump locally before performing the core dump fallback Sets the core dump options to use the fallback options if needed iomem Dumps the I O memory of ...

Page 540: ...t area stack data section and heap information Specifying an executable name for the executable name argument changes the core dump option for all instances of the process Specifying a job ID for the job id value changes the core dump option for a single instance of a running process Task ID Examples The following example shows how to enable the collection of shared memory of a process RP 0 RP0 CP...

Page 541: ...se this command you must be in a user group associated with a task group that includes the proper task IDs on Turns on mandatory process attribute off Turns off the mandatory process attribute The process is not considered mandatory reboot enable disable Enables or disables the reboot action when a mandatory process fails toggle Toggles a mandatory process attribute executable name Executable name...

Page 542: ...andatory on media_ether_config_di The following example shows how to turn the reboot option on In this example the router is set to reboot the node if a mandatory process goes down and cannot be restarted RP 0 RP0 CPU0 router process mandatory reboot enable RP 0 RP0 CPU0 Mar 19 19 28 10 sysmgr 71 SYSMGR 4 MANDATORY_REBOOT_ENABLE mandatory reboot option enabled by request The following example show...

Page 543: ...e last ten core dumps Cisco Technical Support Center engineers and development engineers use this command for post analysis in the debugging of processes Use the clear context command to clear core dump context information Task ID coredump occurrence Optional Core dump context information to be displayed based on the occurrence of the core dump Valid values are 1 to 10 For example entering a value...

Page 544: ...fc2c 481ffcb4 00000000 r20 r21 r22 r23 R20 00398020 00000000 481ffb6c 4820a484 r24 r25 r26 r27 R24 00000000 00000001 4820efe0 481ffb88 r28 r29 r30 r31 R28 00000001 481ffb18 4820ef08 00000001 cnt lr msr pc R32 fc168d58 fc104348 0000d932 fc117c9c cnd xer R36 24000022 00000004 DLL Info DLL path Text addr Text size Data addr Data size Version pkg lib libinfra dll 0xfc0f6000 0x00032698 0xfc0f5268 0x000...

Page 545: ... OL 17231 01 Related Commands Core for process at File path to the core dump file Stack Trace Stack trace information Registers Info Register information related to crashed threads DLL Info Dynamically loadable library DLL information used to decode the stack trace Table 60 show context Field Descriptions continued Field Description Command Description clear context Clears core dump context inform...

Page 546: ...oaded on the router RP 0 RP0 CPU0 router show dll jobid job id virtual Optional Displays DLL information for the specified job identifier virtual Optional Displays the virtual path of DLLs The virtual path is expressed in the pkg lib library name dll format where the library name is the name of the DLL followed by the dll suffix address virtual address Optional Displays the DLL that is mapped at t...

Page 547: ...x0000530c 0xfc120c70 0x00000308 129 disk0 asr14k base 0 48 0 lib liblpts_ifib_platform dll 0xfc1d730c 0x00000cc8 0xfcef4000 0x00000068 1 lib libbackplane dll 0xfc1d8000 0x0000134c 0xfc0c2e4c 0x000000a8 163 disk0 asr14k base 0 48 0 lib libipv6_platform_client dll 0xfc1d934c 0x00000c48 0xfcef4f8c 0x00000068 1 mbi lib libpkgfs_node dll 0xfc1da000 0x000092d4 0xfc1e4000 0x000001a8 3 The following is sa...

Page 548: ...ID 86111 Refcount 1 Table 62 describes the significant fields shown in the display The following is sample output from the show dll command with the optional memory keyword RP 0 RP0 CPU0 router show dll memory Total DLL Text 14778896 bytes Total DLL Data 12688500 bytes Total DLL Memory 27467396 bytes Data VA Virtual address of the data segment of the DLL Data Sz Size of the data segment of the DLL...

Page 549: ... configured core dump settings The output from this command displays the core dump settings configured with the following commands exception filepath exception pakmem exception sparse exception sprsize Task ID Examples The following is sample output from the show exception command RP 0 RP0 CPU0 router show exception Choice 1 path harddisk coredump compress on filename process_name time Choice 2 pa...

Page 550: ...or kernel core dump not configured Dumper packet memory in core dump enabled Sparse core dump enabled Dumper will switch to sparse core dump automatically at size 300MB Related Commands Command Description exception filepath Modifies core dump settings exception pakmem Collects packet memory information in core dumps exception sparse Enables or disables sparse core dumps exception sprsize Sets the...

Page 551: ... sample output from the show memory command entered without keywords or arguments This command displays details for the entire router RP 0 RP0 CPU0 router show memory Physical Memory 2048M total Application Memory 1802M 1636M available job id Optional Job ID associated with a process instance Specifying a job ID for the job id argument displays the memory available and memory usage information for...

Page 552: ...Image 2M bootram 2M Reserved 4M IOMem 0 flashfsys 0 sbin pipe jid 7 Address Bytes What 07f7c000 126976 Program Stack pages not allocated 07f9b000 4096 Program Stack 07f9d000 126976 Program Stack pages not allocated 07fbc000 4096 Program Stack 07fbe000 126976 Program Stack pages not allocated 07fdd000 4096 Program Stack 07fdf000 126976 Program Stack pages not allocated 07ffe000 4096 Program Stack 0...

Page 553: ... Reserved Total reserved memory IOMem Available I O memory flashfsys Total flash memory Shared window fibv6 Internal shared window information Shared window PFI_IFH Internal shared window information Shared window aib Internal shared window information Shared window infra_statsd Internal shared window information Shared window ipv4_fib Internal shared window information Shared window atc_cache Int...

Page 554: ... is useful for detecting patterns of memory usage during events such as restarting processes or configuring interfaces Use the following steps to create and compare memory snapshots Step 1 Enter the show memory compare start command to take the initial snapshot of heap memory usage for all processes on the router Note The snapshot is similar to that resulting from entry of the show memory heap com...

Page 555: ...partner 25676 66676 41000 5 208 aib 55320 96320 41000 5 209 ipv4_io 119724 160724 41000 5 103 loopback_caps_partne 33000 74000 41000 5 190 ipv4_arm 41432 82432 41000 5 191 ipv6_arm 33452 74452 41000 5 104 sysldr 152164 193164 41000 5 85 nd_partner 37200 78200 41000 5 221 clns 61520 102520 41000 5 196 parser_server 1295440 1336440 41000 5 75 bundlemgr_distrib 57424 98424 41000 5 200 arp 83720 12472...

Page 556: ...compare report Field Descriptions Field Description JID Process job ID name Process name mem before Heap memory usage at start in bytes mem after Heap memory usage at end in bytes difference Difference in heap memory usage in bytes mallocs Number of unfreed allocations made during the test period restarted Indicates if the process was restarted during the test period Command Description show memor...

Page 557: ...ID Examples The following is sample output from the show memory heap command specifying a job ID for the job id argument RP 0 RP0 CPU0 router show memory heap 111 Malloc summary for pid 16433 Heapsize 16384 allocd 6328 free 8820 overhead 1236 Calls mallocs 144 reallocs 73 frees 5 core allocs 1 core frees 0 Block Allocated List Total Total Block Name ID Caller Usize Size Count job id Job ID associa...

Page 558: ...psize 65536 allocd 40332 free 16568 overhead 8636 Calls mallocs 883 reallocs 3 frees 671 core allocs 4 core frees 0 Band size 16 element per block 48 nbuint 1 Completely free blocks 0 Block alloced 2 Block freed 0 allocs 85 frees 20 allocmem 1040 freemem 496 overhead 448 blocks 2 blknodes 96 Band size 24 element per block 34 nbuint 1 Completely free blocks 0 Block alloced 1 Block freed 0 allocs 24...

Page 559: ...Block alloced 1 Block freed 0 allocs 6 frees 2 allocmem 256 freemem 640 overhead 88 blocks 1 blknodes 14 Band size 72 element per block 12 nbuint 1 Completely free blocks 0 Block alloced 1 Block freed 0 allocs 1 frees 0 allocmem 72 freemem 792 overhead 80 blocks 1 blknodes 12 Table 66 describes the significant fields shown in the display Table 66 show memory heap summary Field Descriptions Field D...

Page 560: ...n the band completely free available for allocation Block alloced Number of blocks currently allocated for the band allocs Number of allocations currently performed from the band frees Number of free calls that resulted in memory being returned to the band allocmem Amount of memory currently allocated from the band overhead Amount of memory in bytes as overhead for managing the band blocks Number ...

Page 561: ...entifies the process placement locations the operational state of the nodes and the processes currently running on the nodes To display the node location and operational state for a program use the show placement program command Task ID Examples The following example shows all the nodes on the routing system and the placeable programs on those node locations RP 0 RP0 CPU0 router show placement loc...

Page 562: ...pv6_rib ipv4_rib cdp_mgr statsd_manager Table 67 describes the significant fields shown in the display Related Commands Table 67 show placement location Field Descriptions Field Description Locations Physical placement locations identified on the routing system State Operational state of the nodes Primary Whether or not the locations are primary nodes Paired Whether or not the locations are node p...

Page 563: ...the policy based on program If you configured the placement policy the scope could be the default program a given program or even a particular program instance Alternatively the policy could be specified in a placement file entered by the system with different levels of affinities To view all this information you can specify the program all option to display the source of each program and the poli...

Page 564: ...0 system default affinity location type paired attract 60 system default affinity existence attract 90 system default affinity location type current attract 100 system default Program mpls_static source Assumed mem 1 MB system default Slow migration interval 1 second system default affinity location type primary attract 40 system default affinity location type paired attract 60 system default affi...

Page 565: ...Slow migration interval 1 second system default affinity location type primary repulse 40 system ipv6_static affinity location type paired attract 60 system default affinity existence attract 90 system default affinity location type current attract 100 system default Program ipv4_static source Assumed mem 1 MB system default Slow migration interval 1 second system default affinity location type pr...

Page 566: ...stem ipv4_rib affinity existence attract 90 system default affinity location type current attract 100 system default Program bgp source Assumed mem 1 MB system default Slow migration interval 1 second system default affinity location type current attract 600 system bgp affinity location type paired attract 50 system bgp affinity location type primary repulse 50 system bgp affinity self repulse 160...

Page 567: ... process was rejected and location where the process is waiting to start Task ID Examples The following example shows that all placement programs are running on the node pair 0 RP0 CPU0 and 0 RP1 CPU0 RP 0 RP0 CPU0 router show placement program all If a program is shown as having rejected locations i e locations on which it cannot be placed the locations in question can been seen using the show pl...

Page 568: ...RP1 CPU0 tftp_fs 0 RP0 CPU0 0 RP1 CPU0 rcp_fs 0 RP0 CPU0 0 RP1 CPU0 ftp_fs 0 RP0 CPU0 0 RP1 CPU0 domain_services 0 RP0 CPU0 0 RP1 CPU0 bfd 0 RP0 CPU0 0 RP1 CPU0 ipv6_mpa 0 RP0 CPU0 0 RP1 CPU0 ipv4_mpa 0 RP0 CPU0 0 RP1 CPU0 ipv6_arm 0 RP0 CPU0 0 RP1 CPU0 ipv4_arm 0 RP0 CPU0 0 RP1 CPU0 policy_repository 0 RP0 CPU0 0 RP1 CPU0 ipv6_rib 0 RP0 CPU0 0 RP1 CPU0 ipv4_rib 0 RP0 CPU0 0 RP1 CPU0 statsd_manage...

Page 569: ...cludes the proper task IDs Use the show placement reoptimize command to display the predicted changes that will occur when the placement reoptimize command is run Task ID Examples The following example is of the show placement reoptimize command entered without keywords or arguments RP 0 RP0 CPU0 router show placement reoptimize Predicted changes to the placement Program Current location New locat...

Page 570: ... Management Commands on Cisco IOS XR Software show placement reoptimize SMR 568 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description placement reoptimize Reoptimizes the processes among the available RPs and DRPs ...

Page 571: ...send and mutex blocked processes boot Displays process boot information cpu Displays CPU usage for each process distribution Displays the distribution of processes dynamic Displays process data for dynamically created processes failover Displays process failover information family Displays the process session and family information files Displays information about open files and open communication...

Page 572: ...n CPU usage Task ID Examples The show processes process name command displays detailed information about a process RP 0 RP0 CPU0 router show processes ospf Job Id 261 PID 139453 Executable path asr14k rout 0 44 0 bin ospf Instance 1 Version ID 00 00 0000 Respawn ON Respawn count 1 Max spawns per minute 12 Last started Wed Mar 17 07 46 26 2004 Process state Run Package state Normal Started on confi...

Page 573: ...105920 110592 3866624 netio 361 2605056 122880 12288 3866624 schema_server 280 3551232 684032 53248 3563520 lpts_pa 382 4337664 258048 57344 3518464 statsd_manager 391 3399680 102400 36864 3375104 sysdb_svr_local 398 6438912 819200 561152 3178496 tcp 373 6778880 466944 49152 2850816 snmpd 296 5144576 737280 98304 2842624 mrib More Table 71 show processes Field Descriptions Field Description Job id...

Page 574: ...xt Size of text region process executable Data Size of data region initialized and uninitialized variables Stack Size of process stack Dynamic Size of dynamically allocated memory Process Process name Table 73 show processes all Field Descriptions Field Description JID Job ID Last Started Date when the process was last started State State of the process Restart Number of times the process has rest...

Page 575: ...ossible to perform diagnostics on a card when a problem is suspected However even the diagnostics require some services running Name IID Name of the process followed by the instance ID A process can have multiple instances running so the IID is the instance ID Args Command line arguments to the process Table 73 show processes all Field Descriptions continued Field Description Command Description m...

Page 576: ...ssociated with a task group that includes the proper task IDs The placement reoptimize command identifies processes that must be moved to achieve optimal placement To prevent disruption on the router you can use the slow migration interval command to specify the time to wait after moving each process to allow the router to recover before preceding to move the next process Task ID Examples The foll...

Page 577: ... Series Router System Management Command Reference OL 17231 01 SNMP Server Commands on Cisco IOS XR Software This chapter describes the Cisco IOS XR software commands used to configure and monitor the Simple Network Management Protocol SNMP for network monitoring and management ...

Page 578: ...efault behavior or values Command Modes EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs The clear snmp counters command provides the ability to clear all SNMP counters used in the show snmp command without restarting any processes Task ID Examples The following example shows how to clear the SNMP c...

Page 579: ...ncludes the proper task IDs Issue the index persistence command to enable ifIndex persistence for individual entries corresponding to individual interfaces in the ifIndex table of the IF MIB IfIndex persistence retains the mapping between the ifName object values and the ifIndex object values generated from the IF MIB across reboots allowing for consistent identification of specific interfaces usi...

Page 580: ...ce SMR 578 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 snmp server ifindex persist Enables ifIndex persistence globally for all SNMP interfaces snmp server interface Enables an interface to send SNMP trap notifications and enter SNMP interface configuration mode Command Description ...

Page 581: ... in a user group associated with a task group that includes the proper task IDs By default linkUp and linkDown notifications are enabled on physical interfaces Issue the notification linkupdown disable command to disable linkUp and linkDown notifications on an interface Use the no form of this command to enable linkUp and linkDown notifications on an interface if linkUp and linkDown notifications ...

Page 582: ...n disable SMR 580 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 snmp server ifindex persist Enables ifIndex persistence globally for all SNMP interfaces snmp server interface Enables an interface to send SNMP trap notifications and enter SNMP interface configuration mode Command Description ...

Page 583: ...Ds Use the show snmp command to show counter information for SNMP operations It also displays the chassis ID string defined with the snmp server chassis id command Task ID Examples The following is sample output from the show snmp command RP 0 RP0 CPU0 Router show snmp Chassis 01506199 37 SNMP packets input 0 Bad SNMP version errors 4 Unknown community name 0 Illegal operation for community name s...

Page 584: ...s Number of altered variables Number of variables altered by SNMP managers Get request PDUs Number of get requests received Get next PDUs Number of get next requests received Set request PDUs Number of set requests received SNMP packets output Total number of SNMP packets sent by the device Too big errors Number of SNMP packets that were larger than the maximum packet size Maximum packet size Maxi...

Page 585: ...ies Router System Management Command Reference OL 17231 01 Related Commands Command Description show snmp mib Displays a list of the MIB objects registered on the system snmp server chassis id Provides a message line identifying the SNMP server serial number snmp server queue length Establishes the message queue length for each trap host ...

Page 586: ...nd History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the show snmp engineid command to display the identification of the SNMP engine and all remote engines that have been configured on the router An SNMP engine is a copy of SNMP that can reside on a local device Task ID Examples The following is sample output...

Page 587: ...task group that includes the proper task IDs Task ID Examples The following is sample output from the show snmp group command RP 0 RP0 CPU0 Router show snmp group groupname public security model snmpv1 readview v1default writeview notifyview v1default row status nonVolatile groupname public security model snmpv2c readview v1default writeview notifyview v1default row status nonVolatile Table 75 des...

Page 588: ...roup either v1 v2c or v3 writeview String identifying the write view of the group notifyview String identifying the notify view of the group row status Settings that are set in volatile or temporary memory on the device or in nonvolatile or persistent memory where settings remain after the device is turned off and on again Table 75 show snmp group Field Descriptions continued Field Definition Comm...

Page 589: ...History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following is sample output from the show snmp host command RP 0 RP1 CPU0 Router config show snmp host Notification host 10 50 32 170 udp port 2345 type trap user userV3auth security model v3 auth Notification host 10 50 32 170 udp port 2345 ty...

Page 590: ... shown in the display Related Commands Table 76 show snmp host Field Descriptions Field Definition Notification host Name or IP address of target host udp port UDP port number to which notifications are sent type Type of notification configured user Security level of the user security model Version of SNMP used to send the trap either v1 v2c or v3 Command Description snmp server host Specifies the...

Page 591: ...r task IDs Task ID Examples The following example displays the ifIndex value for a specific interface RP 0 RP0 CPU0 Router show snmp interface pos 0 1 0 1 ifindex ifName POS0 1 0 1 ifIndex 12 The following example displays the ifIndex value for all interfaces RP 0 RP0 CPU0 Router show snmp interface ifName Loopback0 ifIndex 1 ifName POS0 1 0 1 ifIndex 12 type Optional Interface type For more infor...

Page 592: ...ex 9 ifName MgmtEth0 RP0 CPU0 0 ifIndex 6 ifName MgmtEth0 RP1 CPU0 0 ifIndex 10 ifName GigabitEthernet0 1 5 0 ifIndex 11 ifName GigabitEthernet0 1 5 1 ifIndex 13 ifName GigabitEthernet0 1 5 2 ifIndex 3 ifName GigabitEthernet0 6 5 1 ifIndex 16 ifName GigabitEthernet0 6 5 2 ifIndex 17 ifName GigabitEthernet0 6 5 7 ifIndex 21 Table 77 describes the significant fields shown in the display Related Comm...

Page 593: ...ion SMI of Open Systems Interconnection OSI Reference Model SNMP management information is viewed as a collection of managed objects residing in a virtual information store termed the MIB Collections of related objects are defined in MIB modules These modules are written using a subset of ASN 1 termed the SMI The definitions for the OIDs displayed by this command can be found in the relevant RFCs ...

Page 594: ...1 1 1 13 1 3 6 1 2 1 47 1 1 1 1 14 1 3 6 1 2 1 47 1 1 1 1 15 1 3 6 1 2 1 47 1 1 1 1 16 1 3 6 1 2 1 47 1 2 1 1 2 1 3 6 1 2 1 47 1 2 1 1 3 1 3 6 1 2 1 47 1 2 1 1 4 1 3 6 1 2 1 47 1 2 1 1 5 1 3 6 1 2 1 47 1 2 1 1 6 1 3 6 1 2 1 47 1 2 1 1 7 1 3 6 1 2 1 47 1 2 1 1 8 1 3 6 1 2 1 47 1 3 1 1 1 More The following is sample output from the show snmp mib detailed command RP 0 RP0 CPU0 Router show snmp mib de...

Page 595: ...ciscosystemmib dll config ciscosystem mib loaded confcopymib dll pkg lib mib libconfcopymib dll config confcopy mib loaded configmanmib dll pkg lib mib libconfigmanmib dll config configman mib loaded dot3admib dll pkg lib mib libdot3admib dll config dot3ad mib loaded fabhfrmib dll pkg lib mib libfabhfrmib dll config fabhfr mib loaded fabmcastapplmib dll pkg lib mib libfabmcastapplmib dll config fa...

Page 596: ...hat includes the proper task IDs An SNMP user must be part of an SNMP group as configured using the snmp server user command Use the show snmp users command to display information about all configured users When configuring SNMP you may see the logging message Configuring snmpv3 USM user USM stands for the User Based Security Model USM for SNMP Version 3 SNMPv3 For further information about USM se...

Page 597: ...8 show snmp users Field Descriptions Field Definition User name String identifying the name of the SNMP user Engine ID String identifying the name of the copy of SNMP on the device storage type Settings that are set in volatile or temporary memory on the device or in nonvolatile or persistent memory where settings remain after the device is turned off and on again Command Description snmp server g...

Page 598: ... behavior or values Command Modes EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following is sample output from the show snmp view command RP 0 RP0 CPU0 Router show snmp view view1 1 3 included nonVolatile active v1default 1 3 6 1 included nonVolatile active Related Commands ...

Page 599: ...isco devices have default chassis ID values of their serial numbers Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server chassis id command to provide a message line identifying the SNMP server serial number The chassis ID message can be displayed with t...

Page 600: ...r text and should be encrypted when displayed by the show running command encrypted Optional Specifies that the entered community string is encrypted text and should be displayed as such by the show running command string Community string that acts like a password and permits access to the SNMP protocol If the clear keyword was used string is assumed to be clear text If the encrypted keyword was u...

Page 601: ...nted to all SDRs in the system Note In a non owner SDR a community name provides access only to the object instances that belong to that SDR regardless of the access privilege assigned to the community name Access to the owner SDR and system wide access privileges are available only from the owner SDR Note Secure domain routers SDRs were previously known as logical routers LRs The name was changed...

Page 602: ... or SNMPv2c community name to one or more of the following context name Maps a community name to a specific SNMP context name This allows MIB instances in an SNMP context to be accessed through SNMPv1 or SNMPv2c using this community name security name By default the community name is used to authenticate SNMPv1 and SNMPv2c Configure a security name for a community name to override the default and ...

Page 603: ...nning command output To enter an encrypted string use the encrypted keyword To enter a clear text community string that is not encrypted by the system use neither of these keywords Task ID Examples The following example maps the community name sample 2 to the SNMP context name sample1 RP 0 RP0 CPU0 Router config snmp server community map sample2 context sample1 Related Commands Task ID Operations ...

Page 604: ...ry Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server contact command to set the system contact string Use the no form of this command to remove the system contact information Task ID Examples The following example shows how to specify a system contact string RP 0 RP0 CPU0 Router config snmp server con...

Page 605: ... be in a user group associated with a task group that includes the proper task IDs This command creates an SNMP context By default all the SNMP MIB instances are in a default context Create an SNMP context and map it to a particular feature to enable similar instances of the same object to co exist in different SNMP contexts Task ID Examples The following example creates a new SNMP context named s...

Page 606: ...ed automatically Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to configure the SNMP engine ID on the local device RP 0 RP0 CPU0 Router config snmp server engineID local 00 00 00 09 00 00 00 a1 61 6c 20 61 Related Comm...

Page 607: ...ecifies a group that uses the SNMPv2c security model The SNMPv2c security model is the second least secure of the possible security models v3 Specifies a group that uses the SNMPv3 security model The SNMP v3 security is the most secure of the possible security models auth Specifies authentication of a packet without encrypting it noauth Specifies no authentication of a packet priv Specifies authen...

Page 608: ...No default values exist for authentication or privacy algorithms when this command is configured In addition no default passwords exist The minimum length for a password is one character although we recommend using eight characters for security A plain text password or localized Message Digest 5 MD5 password can be specified Forgotten passwords cannot be recovered and the user must be reconfigured...

Page 609: ...figure an SNMP version 3 group named group1 that requires the authentication of packets with encryption RP 0 RP0 CPU0 Router config snmp server group group1 v3 priv Related Commands Command Description show snmp Displays the status of SNMP communications show snmp group Displays information about each SNMP group on the network snmp server host Specifies the recipient of an SNMP notification operat...

Page 610: ...text traps Optional Specifies that notifications should be sent as traps This is the default version 1 2c 3 auth noauth priv Optional Specifies the version of the SNMP used to send the traps The default is SNMPv1 Version 3 is the most secure model because it allows packet encryption with the priv keyword When the version keyword is used one of the following keywords must be specified 1 Specifies S...

Page 611: ...mp server host command When the command is entered without keywords all trap types are enabled for the host udp port port Optional Specifies the User Datagram Protocol UDP port of the host to use Range is from 1 to 65535 The default UDP port is 161 notification type Optional Type of notification to be sent to the host If no type is specified all available notifications are sent The notification ty...

Page 612: ... system use the question mark online help function at the end of the snmp server host command The no snmp server host command used with no keywords disables traps Use the clear keyword to specify that the clear text community string you enter is displayed encrypted in the show running command output To enter an encrypted string use the encrypted keyword To enter a clear text community string that ...

Page 613: ...elated Commands Command Description snmp server engineid Specifies the identification number of the local SNMP engine snmp server host Specifies the recipient of an SNMP notification operation snmp server traps bgp Enables BGP state change SNMP notifications snmp server traps snmp Enables RFC 1157 SNMP notifications snmp server traps syslog Enables SNMP notifications for Cisco syslog MIB error mes...

Page 614: ...task IDs Use the snmp server ifindex persist command to enable ifIndex persistence on all interfaces that have entries in the ifIndex table of the IF MIB When enabled this command retains the mapping between the ifName object values and the ifIndex object values generated from the IF MIB persistent during reloads allowing for consistent identification of specific interfaces using SNMP Applications...

Page 615: ...ed The alias name is 64 bytes in length Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server ifmib ifalias long command to enable the IF MIB object ifAlias to accept an interface alias name that is greater than 64 bytes in length The default length for t...

Page 616: ...his command you must be in a user group associated with a task group that includes the proper task IDs Cisco IOS XR statistics infrastructure maintains a cache of statistics for all interfaces This cache is updated every 30 seconds Use the snmp server ifmib stats cache command to enable the IF MIB to retrieve these cached statistics rather than real time statistics Accessing cached statistics is l...

Page 617: ...ommand you must be in a user group associated with a task group that includes the proper task IDs interface type Interface type For more information use the question mark online help function interface id Either a physical or virtual interface identifier as follows Physical interface identifier Naming notation is rack slot module port and a slash between values is required as part of the notation ...

Page 618: ...ask ID Examples The following example shows how to assign ifIndex persistence on Packet over SONET SDH POS interface 0 0 1 0 RP 0 RP0 CPU0 Router config snmp server interface pos 0 0 1 0 RP 0 RP0 CPU0 Router config snmp if Related Commands Task ID Operations snmp read write Command Description show snmp interface Displays the ifIndex value for an SNMP interface snmp server engineid Specifies the i...

Page 619: ...es Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server ipv4 dscp command to specify an IP DSCP value to give SNMP traffic higher or lower priority in your network Task ID Examples The following example shows how to configure the DSCP value to af32 RP 0 RP0 CPU0 route...

Page 620: ...command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server ipv4 precedence command to specify an IP Precedence value to give SNMP traffic higher or lower priority in your network Task ID value Value of the precedence The precedence value can be a number from 0 to 7 or it can be one of the following keywords critical Set packets with criti...

Page 621: ...mands on Cisco IOS XR Software snmp server ipv4 precedence SMR 619 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Examples The following example shows how to set the precedence to 2 RP 0 RP0 CPU0 router config snmp server ipv4 precedence 2 ...

Page 622: ...ts No system location string is set Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to specify a system location string RP 0 RP0 CPU0 Router config snmp server location Building 3 Room 214 Related Commands system locatio...

Page 623: ...must be in a user group associated with a task group that includes the proper task IDs Logging of NOTIFICATION LOG MIB notifications begins when the default log is created Named logs are not supported therefore only the default log can be created Task ID Examples The following example creates a default log for notifications RP 0 RP0 CPU0 Router config snmp server notification log mib default The f...

Page 624: ...nt Command Reference OL 17231 01 RP 0 RP0 CPU0 Router config no snmp server notification log mib default The following example configures the size of all logs to be 1500 RP 0 RP0 CPU0 Router config snmp server notification log mib globalSize 1500 Related Commands Command Description snmp server community map Associates an SNMP community with an SNMP context security name or target list ...

Page 625: ...o snmp server packetsize Syntax Description Defaults size 1500 Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server packetsize command to establish control over the largest SNMP packet size permitted when the SNMP server is receiving a request or generat...

Page 626: ...ommand History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server queue length command to define the length of the message queue for each trap host After a trap message is successfully sent the Cisco IOS XR software continues to empty the queue at a throttled rate to prevent trap flooding Task ID Examp...

Page 627: ...e proper task IDs Use this command to create an SNMP target list and assign hosts to the list When a target list is mapped to a community name using the snmp server community map command SNMP access is restricted to the hosts in the target list for that community name Task ID Examples The following example a new target list sample3 is created and assigned to the vrf server server2 RP 0 RP0 CPU0 Ro...

Page 628: ...erver throttle time Syntax Description Defaults time 0 Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples In the following example the throttle time is set to 500 msec RP 0 RP0 CPU0 Router config snmp server throttle time 500 Related Commands time Throttl...

Page 629: ...r group associated with a task group that includes the proper task IDs For more information about linkUP and linkDown notifications see RFC 2863 The Interface Group MIB and RFC 3418 Management Information Base MIB for the Simple Network Management Protocol SNMP Task ID Examples The following example shows how to enable the RFC 2863 standard varbind RP 0 RP0 CPU0 Router config snmp server trap link...

Page 630: ...e Enables CISCO CONFIG COPY MIB ccCopyCompletion traps entity Controls Entity MIB modification notifications This notification type is defined in the ENTITY MIB enterprise 1 3 6 1 2 1 47 2 as 1 entConfigChange fabric bundle Enables SNMP fabric bundle traps fabric plane Enables SNMP fabric plane state change traps flash insertion Enable ciscoFlashDeviceInsertedNotif flash removal Enable ciscoFlashD...

Page 631: ...ication type More information about individual MIBs can be found in the SNMP Object Navigator available through cisco com at http tools cisco com Support SNMP do BrowseMIB do local en step 2 The snmp server traps command is used with the snmp server host command Use the snmp server host command to specify which host or hosts receive SNMP notifications Task ID Some SNMP trap notifications require a...

Page 632: ...erations bgp bgp read write copy complete config services read write ipsec crypto read write isakmp crypto read write l2vpn l2vpn read write mpls frr mpls ldp read write mpls te read write mpls l3vpn ipv4 read write mpls ldp read write mpls te read write mpls ldp mpls ldp read write mpls te read write mpls traffic eng mpls ldp read write mpls te read write ospf ospf read write syslog sysmgr read w...

Page 633: ...user group associated with a task group that includes the proper task IDs SNMP notifications can be sent as traps Use the snmp server traps bgp command to enable or disable BGP server state change notifications as defined in the BGP4 MIB enterprise 1 3 6 1 2 1 15 7 The notifications types are bgpEstablished bgpBackwardTransition The BGP notifications are defined in the BGP 4 MIB as follows bgpTrap...

Page 634: ...hich host or hosts receive SNMP notifications Task ID Examples The following example shows how to enable the router to send BGP state change notifications to the host at the address myhost cisco com using the community string defined as public RP 0 RP0 CPU0 Router config snmp server traps bgp RP 0 RP0 CPU0 Router config snmp server host myhost cisco com version 2c public Related Commands Task ID O...

Page 635: ...tions are disabled by default Command Modes Global configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to enable the device to send MPLS Layer 3 VPN traps RP 0 RP0 CPU0 Router config snmp server traps mpls l3vpn all all Enables all MPLS Layer 3 ...

Page 636: ...7 1 SNMP Server Commands on Cisco IOS XR Software snmp server traps mpls l3vpn SMR 634 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description snmp server traps Enables SNMP trap notifications ...

Page 637: ...n a user group associated with a task group that includes the proper task IDs SNMP notifications can be sent as traps For a complete description of OSPF error notifications and additional MIB functions see the OSPF TRAP MIB in the SNMP Object Navigator available through cisco com at http tools cisco com Support SNMP do BrowseMIB do local en step 2 The snmp server traps ospf errors command is used ...

Page 638: ...om using the community string defined as public RP 0 RP0 CPU0 Router config snmp server traps ospf errors RP 0 RP0 CPU0 Router config snmp server host myhost cisco com version 2c public Related Commands Task ID Operations snmp read write Command Description snmp server engineid Specifies the identification number of the local SNMP engine snmp server host Specifies the recipient of an SNMP notifica...

Page 639: ...ons can be sent as traps For a complete description of OSPF link state advertisement notifications and additional MIB functions see the OSPF TRAP MIB in the SNMP Object Navigator available through cisco com at http tools cisco com Support SNMP do BrowseMIB do local en step 2 The snmp server traps ospf lsa command is used with the snmp server host command Use the snmp server host command to specify...

Page 640: ...gement Command Reference OL 17231 01 Related Commands Command Description snmp server engineid Specifies the identification number of the local SNMP engine snmp server host Specifies the recipient of an SNMP notification operation snmp server traps snmp Enables RFC 1157 SNMP notifications snmp server traps syslog Enables SNMP notifications for Cisco syslog MIB error messages ...

Page 641: ...tifications can be sent as traps For a complete description of OSPF retransmission notifications and additional MIB functions see the OSPF TRAP MIB in the SNMP Object Navigator available through cisco com at http tools cisco com Support SNMP do BrowseMIB do local en step 2 The snmp server traps ospf retransmit command is used with the snmp server host command Use the snmp server host command to sp...

Page 642: ...Management Command Reference OL 17231 01 Related Commands Command Description snmp server engineid Specifies the identification number of the local SNMP engine snmp server host Specifies the recipient of an SNMP notification operation snmp server traps snmp Enables RFC 1157 SNMP notifications snmp server traps syslog Enables SNMP notifications for Cisco syslog MIB error messages ...

Page 643: ...u must be in a user group associated with a task group that includes the proper task IDs SNMP notifications can be sent as traps Use the snmp server traps ospf state change neighbor state change command to enable or disable OSPF server state change notifications as defined in the MIB One notification types is ospfNbrStateChange For example the OSPF ospfNbrStateChange notification is defined in the...

Page 644: ...co com using the community string defined as public RP 0 RP0 CPU0 Router config snmp server traps ospf state change neighbor state change RP 0 RP0 CPU0 Router config snmp server host myhost cisco com version 2c public Related Commands Task ID Operations snmp read write Command Description snmp server engineid Specifies the identification number of the local SNMP engine snmp server host Specifies t...

Page 645: ...up associated with a task group that includes the proper task IDs Use the snmp server host command to specify which host or hosts receive SNMP notifications Use the snmp server traps pim interface state change command to send notifications when a PIM interface changes status from up to down When the status is up the notification signifies the restoration of a PIM interface When the status is down ...

Page 646: ...the recipient of an SNMP notification operation snmp server traps pim invalid message received Enables notifications for monitoring invalid PIM protocol operations snmp server traps pim neighbor change Enables PIM neighbor status down notifications snmp server traps pim rp mapping change Enables notifications indicating a change in the rendezvous point RP mapping information due to either Auto RP ...

Page 647: ...al configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server host command to specify which host or hosts receive SNMP notifications A router can receive a join or prune message in which the RP specified in the packet is not the RP for the multicast group Or a router can receive a...

Page 648: ... host Specifies the recipient of an SNMP notification operation snmp server traps pim interface state change Enables PIM interface status notification snmp server traps pim neighbor change Enables PIM neighbor status down notifications snmp server traps pim rp mapping change Enables notifications indicating a change in the rendezvous point RP mapping information due to either Auto RP or bootstrap ...

Page 649: ...t be in a user group associated with a task group that includes the proper task IDs Use the snmp server traps pim neighbor change command to send notifications when a PIM neighbor changes status from up to down on an interface Use the snmp server host command to specify which host or hosts receive SNMP notifications PIM notifications are defined in the CISCO PIM MIB my and PIM MIB my files that ca...

Page 650: ...ecipient of an SNMP notification operation snmp server traps pim interface state change Enables PIM interface status notification snmp server traps pim invalid message received Enables notifications for monitoring invalid PIM protocol operations snmp server traps pim rp mapping change Enables notifications indicating a change in the rendezvous point RP mapping information due to either Auto RP or ...

Page 651: ...ry Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the snmp server host command to specify which host or hosts receive SNMP notifications PIM notifications are defined in the CISCO PIM MIB my and PIM MIB my files that can be accessed from the SNMP Object Navigator available through cisco com at http tools cisco com...

Page 652: ...raps pim interface state change Enables PIM interface status notification snmp server traps pim invalid message received Enables notifications for monitoring invalid PIM protocol operations snmp server traps pim neighbor change Enables PIM neighbor status down notifications snmp server traps snmp Enables RFC 1157 SNMP notifications snmp server traps syslog Enables SNMP notification for Cisco syslo...

Page 653: ...pecify which host or hosts receive SNMP notifications An authentication Failure 4 trap signifies that the sending device is the addressee of a protocol message that is not properly authenticated The authentication method depends on the version of SNMP being used For SNMPv1 or SNMPv2c authentication failure occurs for packets with an incorrect community string For SNMPv3 authentication failure occu...

Page 654: ...mmand Reference OL 17231 01 Related Commands Command Description snmp server engineid Specifies the identification number of the local SNMP engine snmp server host Specifies the recipient of an SNMP notification operation snmp server traps bgp Enables BGP server state change SNMP notifications snmp server traps syslog Enables SNMP notifications for Cisco syslog MIB error messages ...

Page 655: ...that includes the proper task IDs The snmp server traps syslog command is used with the snmp server host command Use the snmp server host command to specify which host or hosts receive SNMP notifications Task ID Examples The following example shows how to enable Cisco syslog MIB error message notifications to the host at the address myhost cisco com using the community string defined as public RP ...

Page 656: ...per task IDs interface type Interface type For more information use the question mark online help function interface id Either a physical or virtual interface identifier as follows Physical interface identifier Naming notation is rack slot module port and a slash between values is required as part of the notation rack Chassis number of the rack slot Physical slot number of the modular services car...

Page 657: ...e following example shows how to specify that the IP address for Packet over SONET SDH POS interface 0 0 1 0 is the source for all SNMP notifications RP 0 RP0 CPU0 Router config snmp server trap source POS 0 0 1 0 Related Commands Task ID Operations snmp read write Command Description snmp server engineid Specifies the identification number of the local SNMP engine snmp server host Specifies the r...

Page 658: ...XR software tries to send a trap it looks for a route to the destination address If there is no known route the trap is saved in a retransmission queue Use the snmp server trap timeout command to determine the number of seconds between retransmission attempts Task ID Examples The following example shows how to set an interval of 20 seconds to try resending trap messages on the retransmission queue...

Page 659: ...XR Software snmp server trap timeout SMR 657 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 snmp server traps snmp Enables RFC 1157 SNMP notifications snmp server traps syslog Enables SNMP notifications for Cisco syslog MIB error messages Command Description ...

Page 660: ...vel with one of the following keywords md5 Specifies the HMAC MD5 96 authentication level sha Specifies the HMAC SHA 96 authentication level After you specify the authentication level you must specify an authorization password Before setting the authorization password you must specify one of the following required keywords clear Specifies that an unencrypted password follows encrypted Specifies th...

Page 661: ...stem Only one user can be configured with SystemOwner privileges Note In a non owner SDR user access is provided only to the object instances in that SDR regardless of the access privilege assigned Access to the owner SDR and system wide access privileges are available only from the owner SDR Task ID Examples The following example shows how to enter a plain text password for the string abcd for us...

Page 662: ...hm SHA digest is known specify that string instead of the plain text password The digest should be formatted as AA BB CC DD where AA BB CC and DD are hexadecimal values The digest should also be exactly 16 octets long The following example shows how to specify the command with a digest name of 00 11 22 33 44 55 66 77 88 99 AA BB CC DD EE FF RP 0 RP0 CPU0 Router config snmp server user user2 group2...

Page 663: ...ew Instead of defining a view explicitly you can rely on the following predefined views which are supported by the SNMP agent all Predefined view indicating that a user can see all objects CfgProt Predefined view indicating that a user can see all objects except the SNMPv3 configuration tables vacmViewTreeFamilyEntry Predefined view indicating that a user can see the default configuration of vacmV...

Page 664: ...ter config snmp server view view1 1 3 6 1 2 1 1 included RP 0 RP0 CPU0 Router config snmp server view view1 1 3 6 1 4 1 9 included The following example shows how to create a view that includes all objects in the MIB II system group except for sysServices System 7 and all objects for interface 1 in the MIB II interfaces group RP 0 RP0 CPU0 Router config snmp server view view1 1 3 6 1 2 1 1 include...

Page 665: ...ddress of the host the targeted recipient clear Optional Specifies that the community string argument is clear text encrypted Optional Specifies that the community string argument is encrypted text traps Optional Specifies that notifications should be sent as traps This is the default version 1 2c 3 Optional Specifies the version of the SNMP used to send the traps The default is SNMPv1 When the ve...

Page 666: ... Use the clear keyword to specify that the clear text community string you enter is displayed encrypted in the show running command output To enter an encrypted string use the encrypted keyword To enter a clear text community string that is not encrypted by the system use neither of these keywords An SNMP context identified by the value of the context name argument can be mapped to a VRF in this s...

Page 667: ... Router System Management Command Reference OL 17231 01 Terminal Services Commands on Cisco IOS XR Software This chapter describes the Cisco IOS XR commands used for setting up physical and virtual terminal connections managing terminals and configuring virtual terminal line vty pools ...

Page 668: ...e the absolute timeout command to terminate the connection after the specified time has elapsed regardless of whether the connection is being used at the time of termination You can specify an absolute timeout value for each port The user is notified 20 seconds before the session is terminated Task ID Examples The following example shows how to set the session timeout value to 2880 minutes 2 days ...

Page 669: ...ou must be in a user group associated with a task group that includes the proper task IDs Use the access class command to restrict incoming or outgoing connections to addresses defined in an access list Use the ipv4 access list or ipv6 access list command to define an access list by name Note To restrict access of incoming or outgoing connections over IPv4 and IPv6 the IPv4 access list and IPv6 ac...

Page 670: ...ccess lists vtyacl ipv4 access list vtyacl 10 permit ip host 10 32 162 48 any 20 permit ip host 10 20 49 170 any 30 permit ip host 10 60 3 5 any The following sample output from the show ipv6 access lists command displays the IPv6 access list name vtyacl RP 0 RP0 CPU0 router show ipv6 access lists vtyacl ipv6 access list vtyacl 10 permit ipv6 host 2001 db8 2222 any 20 permit ipv6 host 2001 db8 0 4...

Page 671: ...matically run a command or command alias when a user logs in to a vty session To run multiple commands use a command alias for the command argument When the user logs in the commands included in the alias are run sequentially Note The autocommand command is supported on vty connections only it is not supported on console or aux line connections Use this command to automatically run a command after...

Page 672: ... logs back in the autocommand does not run RP 0 RP0 CPU0 router configure terminal RP 0 RP0 CPU0 router config line default RP 0 RP0 CPU0 router config line no autocommand LINE Appropriate EXEC command RP 0 RP0 CPU0 router config line no autocommand show ip interface brief RP 0 RP0 CPU0 router config line end Uncommitted changes found commit them before exiting yes no cancel cancel yes RP 0 RP0 CP...

Page 673: ...ing Autocommand test RP 0 RP0 CPU0 router test RP 0 RP0 CPU0 router show ip interface brief Interface IP Address Status Protocol MgmtEth0 RP0 CPU0 0 172 16 0 0 Up Up POS0 0 0 0 unassigned Up Up POS0 0 0 1 unassigned Up Up POS0 0 0 2 unassigned Up Up POS0 0 0 3 unassigned Up Up POS0 3 0 0 unassigned Up Up POS0 3 0 1 unassigned Up Up POS0 3 0 2 unassigned Up Up POS0 3 0 3 unassigned Up Up RP 0 RP0 C...

Page 674: ... the delimiting character c After entering one or more lines of text terminate the message with the delimiting character c When a user connects to a router the message of the day MOTD banner appears first followed by the login banner and prompts After the user logs in to the router the EXEC banner or incoming banner is displayed depending on the type of connection For a reverse Telnet login the in...

Page 675: ... domain name for the router line Displays the vty or tty asynchronous line number Table 81 banner exec Tokens continued Token Information Displayed in the Banner Task ID Operations tty access read write Command Description banner incoming Defines and enables a customized message that is displayed when there is an incoming connection to a terminal line from a host on the network banner login Define...

Page 676: ... initiated from the network side of the router Incoming connections are also called reverse Telnet sessions These sessions can display message of the day MOTD banners and incoming banners but they do not display EXEC banners When a user connects to a router the MOTD banner if configured appears first followed by the login banner and prompts After the user logs in to the router the EXEC banner or i...

Page 677: ...ble 82 banner incoming Tokens Token Information Displayed in the Banner hostname Displays the hostname for the router domain Displays the domain name for the router line Displays the vty or tty asynchronous line number Task ID Operations tty access read write Command Description banner exec Defines a customized banner that is displayed whenever the EXEC process is initiated banner login Defines an...

Page 678: ...r c When a user connects to the router the message of the day MOTD banner if configured appears first followed by the login banner and prompts After the user successfully logs in to the router the EXEC banner or incoming banner is displayed depending on the type of connection For a reverse Telnet login the incoming banner is displayed For all other connections the router displays the EXEC banner T...

Page 679: ...essage End with the character c THIS IS A LOGIN BANNER c Related Commands Task ID Operations tty access read write Command Description banner exec Defines a customized banner that is displayed whenever the EXEC process is initiated banner incoming Defines and enables a customized message that is displayed when there is an incoming connection to a terminal line from a host on the network banner mot...

Page 680: ...s useful for sending messages that affect all users such as impending system shutdowns Use the no motd banner command to disable the MOTD banner on a line When a user connects to the router the MOTD banner if configured appears first followed by the login banner and prompts After the user successfully logs in to the router the EXEC banner or incoming banner is displayed depending on the type of co...

Page 681: ...in name for the router line Displays the vty or tty asynchronous line number Table 84 banner motd Tokens Token Information Displayed in the Banner Task ID Operations tty access read write Command Description banner exec Defines and enables a customized banner that is displayed whenever the EXEC process is initiated banner incoming Defines and enables a customized message that is displayed when the...

Page 682: ...er group associated with a task group that includes the proper task IDs Follow this command with one or more blank spaces and the delimiting character c Then enter one or more lines of text terminating the message with the second occurrence of the delimiting character c This prompt timeout banner is displayed when there is a login authentication timeout at the username and password prompt Task ID ...

Page 683: ...Description banner exec Defines and enables a customized banner that is displayed whenever the EXEC process is initiated banner incoming Defines and enables a customized message that is displayed when there is an incoming connection to a terminal line from a host on the network banner login Defines and enables a customized banner that is displayed before the username and password login prompts ban...

Page 684: ...r group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to clear the console line putting it in an idle state RP 0 RP0 CPU0 router clear line console location 0 RP1 CPU0 Related Commands node id Node ID entered in the rack slot module notation The location refers to a route processor RP where the auxiliary or console line to be cleare...

Page 685: ...ith a task group that includes the proper task IDs Use the show users command to determine the origin of the connection and which lines to clear When a line is cleared to an idle state the user on the other end of the connection receives notice that the connection was closed by a foreign host Task ID Examples The following example shows how to reset vty 3 to the idle state RP 0 RP0 CPU0 router cle...

Page 686: ...Command Modes Line console configuration Line default configuration Line template configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the cli interactive syntax check command to check command syntax as you type You are not allowed to enter incorrect syntax Task ID Examples The following ex...

Page 687: ...ation Line default configuration Line template configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the cli whitespace completion command to complete the next word of the command syntax if you type the space key before completing the word If more than one option is valid all options are dis...

Page 688: ... terminal connections Physical terminal connections use either the console or auxiliary line template The databits command masks the high bit on input from devices that generate 7 data bits with parity If parity is being generated specify 7 data bits per character If no parity generation is in effect specify 8 data bits per character The keywords 5 and 6 are supplied for compatibility with older d...

Page 689: ...nds on Cisco IOS XR Software databits SMR 687 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description show users Displays information about the active lines on the networking device stopbits Sets the number of stop bits ...

Page 690: ... that includes the proper task IDs Do not disconnect a line to end a session Instead log off the host before ending the session to clear the connection If you cannot log out of an active session disconnect the line Task ID Examples The following example shows how to disconnect from a device in this example User1 to return to the router User1 disconnect Connection closed by remote host RP 0 RP0 CPU...

Page 691: ...ines To use this command you must be in a user group associated with a task group that includes the proper task IDs The break character is represented by 0 null cannot be represented Refer to the ASCII Character Set and Hex Values appendix for a list of ASCII characters Task ID Examples The following example shows how to set the disconnect character for the default line template to the Esc charact...

Page 692: ...cape character sequence that is different from the default Use the escape character to exit from an existing connection and return to the EXEC prompt See the ASCII Character Set and Hexidecimal Values appendix for a list of ASCII characters The default escape key sequence is Ctrl Shift 6 X X The escape character default command sets the escape character to the Break key the default setting for the...

Page 693: ...3 7 1 Terminal Services Commands on Cisco IOS XR Software escape character SMR 691 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description disconnect character Defines a disconnect character ...

Page 694: ...ry Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs If no input is detected during the interval the EXEC facility resumes the current connection If no connections exist the EXEC facility returns the terminal to the idle state and disconnects the incoming session To disable the EXEC timeout function so that the EXEC sess...

Page 695: ...e exec timeout SMR 693 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description absolute timeout Sets the absolute timeout for line disconnection session timeout Sets the idle wait timeout interval for user input over a virtual terminal connection ...

Page 696: ...History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the flowcontrol hardware command to set the flow control attribute for physical line connections Physical line connections use either the console or auxiliary line template Task ID Examples The following example shows how to restrict the hardware flow control ...

Page 697: ...udes the proper task IDs Use the length command to modify the default length setting for the specified line template The length setting determines when the screen pauses during the display of multiple screen output Specifying a value of 0 for the lines argument prevents the router from pausing between screens of output Task ID Examples The following example shows how to set the length of the defau...

Page 698: ...anage physical terminal line connections the console and auxiliary ports and vty connections The following templates are available in the Cisco IOS XR software Default line template The default line template that applies to a physical and virtual terminal lines Console line template The line template that applies to the console line User defined line templates User defined line templates that can ...

Page 699: ... R ev iew R 3 7 1 Terminal Services Commands on Cisco IOS XR Software line SMR 697 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description vty pool Creates or modifies a vty pool ...

Page 700: ...task IDs Communication protocols provided by devices such as terminals and modems often require a specific parity bit setting Use the parity command for setting the parity attribute for physical terminal connections Physical terminal connections use either the console or auxiliary line template Task ID Examples The following example shows how to set the line parity configuration to even for the co...

Page 701: ...sumed by specifying the number of the connection or the name of the connection You can have several concurrent sessions open and switch back and forth between them The number of sessions that can be open is defined using the session limit command You can switch between sessions by escaping one session and resuming a previously opened session as follows Step 1 Escape from the current session by pre...

Page 702: ...ne connection and resume another You can omit the connection name and simply enter the connection number to resume that connection host1 X RP 0 RP0 CPU0 router resume 1 blg_router Related Commands Task ID Operations tty access read write Command Description session limit Sets the maximum number of outgoing terminal sessions from the current terminal show sessions Displays information about SSH and...

Page 703: ...Enter Ctrl Z to end the message Enter Ctrl C to abort this command Task ID Examples The following example shows how to send a message to all lines RP 0 RP0 CPU0 router send Enter message end with CTRL Z abort with CTRL C The system will be shut down in 10 minutes for repairs Z Send message confirm RP 0 RP0 CPU0 router Message from tty to all terminals The system will be shut down in 10 minutes for...

Page 704: ...efaults connections 6 Command Modes Line console configuration Line default configuration Line template configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples The following example shows how to limit the number of active outgoing connections for the default line template to eight...

Page 705: ...p that includes the proper task IDs Use the session timeout command to set the interval that the Cisco IOS XR software waits for traffic before closing the connection to a remote device and returning the terminal to an idle state If the output keyword is not specified the session timeout interval is based solely on detected input from the user If the output keyword is specified the interval is bas...

Page 706: ...line command The asterisk indicates the current terminal session RP 0 RP0 CPU0 router show line Tty Speed Modem Uses Noise Overruns Acc I O aux0_0_0 9600 0 0 con0_0_0 9600 0 0 vty0 0 0 0 0 vty1 0 0 0 0 vty2 0 0 0 0 vty3 0 0 0 0 vty4 0 0 0 0 vty100 0 0 0 0 vty101 0 0 0 0 vty102 0 0 0 0 vty103 0 0 0 0 location node id Optional Specifies the location for the route processor RP on which the auxiliary ...

Page 707: ...is using in bps Modem Not implemented in the Cisco IOS XR software Uses Not implemented in the Cisco IOS XR software Noise Not implemented in the Cisco IOS XR software Overruns Hardware Universal Asynchronous Receiver Transmitter UART overruns or software buffer overflows both defined as the number of overruns or overflows that have occurred on the specified line since the system was restarted Har...

Page 708: ...plays the type of TTY and the physical location of physical TTYs Location Not implemented in the Cisco IOS XR software Type Not implemented in the Cisco IOS XR software Length Length of the terminal or screen display in rows Width Width of the terminal or screen display in columns Baud rate TX RX Transmit rate receive rate of the line in bps parity Parity bits value used for physical terminal conn...

Page 709: ...and Modes EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the show sessions command to display the hostname remote connection service used by the router to access the host idle time and connection name Task ID Examples The following is sample output from the show sessions command RP 0 RP0 CPU0 ...

Page 710: ...mote host to which the router is connected This field displays either the IP address or hostname of the remote host If the IP address of the remote host is mapped to hostname that is if Domain Name System DNS services are enabled and the session is initiated with the hostname the output for this field displays the hostname of the host rather than the IP address of the host Address IP address of th...

Page 711: ...ask group that includes the proper task IDs Task ID Examples The following is sample output from the show terminal command RP 0 RP0 CPU0 router show terminal Line con0_0_0 Location Unknown Type Unknown Length 0 lines Width 0 columns Baud rate TX RX is 9600 9600 1 parity 2 stopbits 8 databits Template console Config Allowed transports are none Table 88 describes the significant fields shown in the ...

Page 712: ...used for physical terminal connections stopbits Stop bits value used for physical terminal connections databits Data bits value used for physical terminal connections Template Line template being sourced by the particular connection Config Configuration applied to the tty This field indicates the allowed incoming transports that can be used to access the router from this tty Allowed transports are...

Page 713: ...Use the show users command to display the line number connection name idle time hosts and terminal location An asterisk indicates the current terminal session Note To display all user groups and task IDs associated with the currently logged in user use the show user command in EXEC mode See Authentication Authorization and Accounting Commands on Cisco IOS XR Software Task ID Examples The following...

Page 714: ...ption Line All current connections An asterisk indicates the active connection User Username of the user logged into the line Service Physical or remote login service used Conns Number of outgoing connections Idle Interval in hours minutes seconds since last keystroke Location IP address of remote login host For local physical terminal connections this field is blank Command Description show line ...

Page 715: ...udes the proper task IDs Use the stopbits command to set the data bits attributes for physical terminal connections Physical terminal connections use either the console or auxiliary terminal templates Communication protocols provided by devices such as terminals and modems often require a specific stop bit setting Task ID Examples The following example shows how to change the default from two stop...

Page 716: ...no timestamp command to disable the timestamp display Note The terminal commands are active for the current terminal session only To apply a setting to all sessions use the line commands Task ID Examples The following example shows how to enable the timestamp prompt When enabled the date and time are displayed after each command In this example the show version command is entered and the date and ...

Page 717: ...sable the time stamp prompt RP 0 RP0 CPU0 router terminal exec prompt no timestamp Sun Aug 17 15 50 15 187 PST RP 0 RP0 CPU0 dt ortho 8 show version Cisco IOS XR Software Version 3 7 1 11I SIT_IMAGE Copyright c 2008 by Cisco Systems Inc ROM System Bootstrap Version 1 51 20080807 092259 ASR 14000 ROMMON dt ortho 8 uptime is 2 days 22 hours 1 minute System image file is disk0 asr14k os mbi 3 7 1 11I...

Page 718: ...y the current terminal session and not save it to the running configuration exiting from the terminal session returns the terminal length value to the value configured with the length command Specifying a value of 0 for the lines argument prevents the router from pausing between screens of output Note The terminal commands are active for the current terminal session only To apply a setting to all ...

Page 719: ...des EXEC Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Task ID Examples In the following example the system is configured to display debug command output and error messages during the current terminal session RP 0 RP0 CPU0 router terminal monitor Related Commands disable Optional Disables the terminal...

Page 720: ...es the proper task IDs Use the terminal width command to set the terminal width value for only the current terminal session and not save it to the running configuration exiting from the terminal session returns the terminal width value to the value configured with the width display command Task ID Examples The following example shows how to set the terminal width for the current terminal session t...

Page 721: ...at includes the proper task IDs To be accepted incoming network connections to an asynchronous port terminal line must use a transport protocol specified with the transport input command This command can be useful in limiting the acceptable transport protocols to include or exclude those used by different types of users or to restrict a line to secure connections SSH connections Task ID Examples T...

Page 722: ... Series Router System Management Command Reference OL 17231 01 Related Commands Command Description transport output Determines the protocols that can be used for outgoing connections from a line transport preferred Specifies the transport protocol that the Cisco IOS XR software uses if the user does not specify one when initiating a connection ...

Page 723: ...iguration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Any settings made with the transport output command override settings made with the transport preferred command Task ID Examples The following example shows how to set the default line template to prevent any outgoing transport protocol connectio...

Page 724: ...000 Series Router System Management Command Reference OL 17231 01 Related Commands Command Description transport input Defines which protocols to use to connect to a specific line of the router transport preferred Specifies the transport protocol that the Cisco IOS XR software uses if the user does not specify one when initiating a connection ...

Page 725: ... user group associated with a task group that includes the proper task IDs Use the transport preferred command to provide a default transport protocol to use when initiating outgoing connections The preferred outgoing transport protocol specified with the transport preferred command enables you to initiate an outgoing connection without explicitly specifying the transport protocol The Cisco IOS XR...

Page 726: ... following example shows how to set the preferred transport setting for the default line template to SSH RP 0 RP0 CPU0 router config line default RP 0 RP0 CPU0 router config line transport preferred ssh Related Commands Command Description transport input Defines which protocols to use to connect to a specific line of the router transport output Determines the protocols that can be used for outgoi...

Page 727: ...Command History default Specifies the default vty pool fm Specifies the fault manager vty pool pool name User defined vty pool first vty First vty line in the pool For the default vty pool you must specify 0 for the first vty line For a user defined vty pool the range is 5 to 99 For the fault manager vty pool you must specify 100 for the first vty line last vty Last vty line in the pool The defaul...

Page 728: ...s The vty range from 0 through 99 can reference the default vty pool The vty range from 5 through 99 can reference a user defined vty pool The vty range from 100 is reserved for the fault manager vty pool The vty range for fault manager vty pools must start at vty 100 and must contain a minimum of six vtys A vty can be a member of only one vty pool A vty pool configuration fails if the vty pool in...

Page 729: ... Line template configuration Command History Usage Guidelines To use this command you must be in a user group associated with a task group that includes the proper task IDs Use the width command to modify the default width setting for the specified line template Task ID Examples The following example shows how to set the terminal width for the default line template to 99 characters RP 0 RP0 CPU0 r...

Page 730: ...i sc o C o n f id en t ia l B et a R ev iew R 3 7 1 Terminal Services Commands on Cisco IOS XR Software width display SMR 728 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 ...

Page 731: ...ommands for the Cisco IOS XR software Utility commands provide CLI equivalents to common UNIX commands Note Keywords are entered using the displayed syntax or with UNIX equivalent syntax The UNIX equivalent syntax is displayed in parentheses in the syntax description For example the keyword universal can also be entered using the UNIX equivalent u To display the UNIX equivalent syntax online enter...

Page 732: ...y path filename Include the alias for the device argument followed by a colon and optionally the name of a directory The possible devices are disk0 Uses a file from disk0 file system disk0a Uses a file from disk0a file system partition disk1 Uses a file from disk1 file system disk1a Uses a file from disk1a file system partition ftp Uses a file from an FTP network server The syntax is ftp username ...

Page 733: ... defined functions with parameters Local variables Information About Supported Network Protocols In the syntax for the ftp rcp and tftp network protocols the location is either an IP address or a hostname The filename is specified relative to the directory used for file transfers When no device is specified the current directory is used To view the current directory enter the pwd command Table 90 ...

Page 734: ... ASR 14000 Series Router System Management Command Reference OL 17231 01 Task ID Examples In the following example the utility bc command is used to execute the be statements contained in the ASCII text file exp txt RP 0 RP0 CPU0 router utility bc file disk0 usr exp txt 50 15 25 3 17 Task ID Operations universal execute ...

Page 735: ...t The list argument specifies the field numbers or ranges For example utility field 2 9 outputs the second and ninth fields utility field 1 3 outputs the first three fields utility list 6 outputs the first six fields Note The fields indicated by the list argument are assumed to be separated in the file by a delimiter character The default delimiter is tab Use the delimiter delimiter option to spec...

Page 736: ...racted For the character list argument use a comma to indicate more than one character or use a dash to indicate a range For example utility list 1 2 5 outputs the first second and fifth characters utility list 1 64 outputs the first 64 characters of each line utility list 5 outputs the fifth character to the end of the line You can also use the cut utility as a filter If no files are specified th...

Page 737: ... usr passwd root Super User daemon bin sys adm Admin lp Line Printer Admin uucp uucp Admin nuucp uucp Admin listen Network Admin nobody Nobody In the following example the utility cut command is used with the delimiter keyword to specify an alternative field delimiter RP 0 RP0 CPU0 router utility cut fields 1 4 5 delimiter file disk0 usr passwd root 1 Super User daemon 1 bin 2 sys 3 adm 4 Admin lp...

Page 738: ...body noaccess x 60002 60002 No Acce nobody4 x 65534 65534 SunOS 4 In the following example the UNIX equivalent options are used directly First the utility cut command is entered with the usage keyword to display the possible options Next the utility cut command is entered with the options to extract the desired data RP 0 RP0 CPU0 router utility cut usage cut c list file cut f list d delim s file R...

Page 739: ...escriptors prefaced with in a manner similar to a C language printf format specifier In the output each field descriptor is replaced by its corresponding value all other characters are copied to the output without change The format is specified using the following arguments C Century in CC form For example 20 y Year in YY form For example 06 m Month in MM form For example 08 d Date in DD form For ...

Page 740: ...mples The following example shows how to display the router date and time using the utility date command RP 0 RP0 CPU0 router utility date Fri Aug 04 11 53 38 UTC 2006 The following example shows how to display the router date and time using a variety of options with the format keyword RP 0 RP0 CPU0 router utility date format y m d 060828 RP 0 RP0 CPU0 router utility date format y m d 06 08 28 RP ...

Page 741: ...ility you need not set the software clock Use the date command or clock set command if no other time sources are available Note To manually copy the hardware clock calendar settings into the software clock use the clock read calendar command in EXEC mode By default the system makes a slow adjustment if the new time is in the range of the following 2 5 minutes old time 5 minutes old time In a slow ...

Page 742: ...Management Command Reference OL 17231 01 Task ID Examples The following example shows how to set the time using the utility date set command RP 0 RP0 CPU0 router admin utility date set 13 07 00 Fri Sep 15 13 07 00 UTC 2006 Related Commands Task ID Operations universal execute Command Description utility date Displays the internal date and time of the router ...

Page 743: ...ord to invoke the statvfs function which provides additional details for all mounted file systems kbytes Optional k Displays the sizes in 1 K blocks 1024 byte units instead of the default of 512 byte blocks mountinfo Optional n Displays the file system mountpoints and types only vsfStats Optional g Displays all statvfs information file source Optional Specifies the storage device and directory pat...

Page 744: ...2 for column descriptions In the following example the kbytes keyword is used to display information in 1 K blocks 1024 byte units instead of the default of 512 byte blocks RP 0 RP0 CPU0 router admin utility df kbytes dev hd0t6 38993872 30796 38963076 1 harddisk nvram 2043 30 2013 2 dev disk1t6 1000640 191360 809280 20 disk1 dev disk0t6 1000592 266784 733808 27 disk0 dev fs0p1 60928 34 60893 1 boo...

Page 745: ...ing example the file source keyword and argument is used to specify a directory RP 0 RP0 CPU0 router admin utility df file disk0 usr dev disk0t6 2001184 533568 1467616 27 disk0 Table 92 describes the significant fields shown in the display Table 91 utility df Field Descriptions Field Description Files Number of files in the file system Blocks Amount of space available on the file system in 1 K blo...

Page 746: ... Management Command Reference OL 17231 01 Related Commands Use Percentage of space used on the file system Mounted on Storage device where the file system is mounted Table 92 utility df Column Descriptions left to right continued Field Description Command Description utility du Displays the amount of disk space used by one or more directories or files ...

Page 747: ...ries kbytes Optional k Displays the disk space used in 1 K blocks 1024 byte units instead of the default of 512 byte blocks bytes Optional p Displays the disk space used in bytes the default is 512 byte blocks Also generates error messages for exiting files that cannot be displayed local Optional x Displays information for the local device only file source Optional Displays the disk space used for...

Page 748: ...ile disk0 asr14k mpls 3 7 1 160 disk0 asr14k mpls 3 7 1 schema 104 disk0 asr14k mpls 3 7 1 lib cerrno 625 disk0 asr14k mpls 3 7 1 lib mib 2545 disk0 asr14k mpls 3 7 1 lib 9658 disk0 asr14k mpls 3 7 1 bin 39 disk0 asr14k mpls 3 7 1 startup 840 disk0 asr14k mpls 3 7 1 parser 37 disk0 asr14k mpls 3 7 1 configs 35 disk0 asr14k mpls 3 7 1 mib 35 disk0 asr14k mpls 3 7 1 rules 34 disk0 asr14k mpls 3 7 1 ...

Page 749: ...Series Router System Management Command Reference OL 17231 01 9658 bin 39 startup 840 parser 37 configs 35 mib 35 rules 34 partitions 135 etc compat 167 etc 66 instdb_v 181 lc bin 33 lc startup 246 lc 112 instdb 14006 Related Commands Command Description utility df Displays the amount of disk space available for a directory or file ...

Page 750: ...arated by a new line The type of the expressions is determined by the e and f options This form is used when more than one expression is specified You can specify more than one f option The expression file syntax is device directory path filename file search file Optional The file used for the search Replace the search file argument with the device and directory path of the file The search file sy...

Page 751: ...num keyword is also entered to display the line number before each line of output RP 0 RP0 CPU0 router show version utility egrep expr uptime linenum 7 router uptime is 5 days 19 hours 27 minutes In the following example the utility egrep command is used to locate a regular expression in a file In this example all lines with adm are displayed The character is used as a wildcard RP 0 RP0 CPU0 route...

Page 752: ...g of each output line RP 0 RP0 CPU0 router utility egrep expr Adm linenum file disk0 usr passwd 5 adm x 4 4 Admin var adm 6 lp x 71 8 Line Printer Admin usr spool lp 7 uucp x 5 5 uucp Admin usr lib uucp 8 nuucp x 9 9 uucp Admin var spool uucppublic usr lib uucp uucico 9 listen x 37 4 Network Admin usr net nls 15 ssadmin x 901218 60001 Sun StorEdge tm Configuration Service Agent Admin bin false Rel...

Page 753: ...more than one expression is specified You can specify more than one f option The expression file syntax is device directory path filename Include the alias for the device argument followed by a colon and optionally the name of a directory Use the online help system to display the available storage devices and network protocols file search file The file used for the search Replace the search file a...

Page 754: ...words are entered using the displayed syntax or with UNIX equivalent syntax The UNIX equivalent syntax is displayed in parentheses in the syntax description For example the keyword count can also be entered using the UNIX equivalent c To display the UNIX equivalent syntax online enter the keyword usage Task ID Examples The following example the utility fgrep command is used with the nocase and lin...

Page 755: ... directory is not specified then the search is performed for the current directory To search for a regular expression string use the name pattern keyword and argument Replace the pattern argument with the regular expression string If this option is not used then all files within the specified directory are displayed To search for files belonging to a specific user use the user id argument If this ...

Page 756: ... txt In the following example the UNIX equivalent option is used to locate files matching a pattern In this example all files ending in txt are displayed RP 0 RP0 CPU0 router utility find path disk0 name txt disk0 asr14k base 3 7 1 etc vim doc editing txt disk0 asr14k base 3 7 1 etc vim doc help txt disk0 asr14k base 3 7 1 etc vim doc intro txt disk0 asr14k base 3 7 1 etc vim doc uganda txt disk0 ...

Page 757: ...mber option to specify the number of bytes or lines to copy By default the utility head command copies the first 10 lines of each file If more than one file is selected an identifying header is added before the output for each file If no file is specified then the standard input keyboard is used Note Keywords are entered using the displayed syntax or with UNIX equivalent syntax The UNIX equivalent...

Page 758: ...asr14k os mbi 3 7 1 11I mbiasr14k rp vm cisco ASR14K 8 S 7457 processor with 4194304K bytes of memory 7457 processor at 1197Mhz Revision 1 2 2 Ethernet IEEE 802 3 interface s 104 GigabitEthernet IEEE 802 3 interface s 8 SONET SDH Port controller s In the following example the utility head command is entered with the bytes keyword Only the first 15 bytes of output are displayed RP 0 RP0 CPU0 router...

Page 759: ...mands are similar to the vi editor Note Keywords are entered using the displayed syntax or with UNIX equivalent syntax The UNIX equivalent syntax is displayed in parentheses in the syntax description To display the UNIX equivalent syntax online enter the keyword usage exiteof Optional E Automatically exists the utility the first time an end of file is encountered nocase Optional i Ignores uppercas...

Page 760: ...amples The following example the utility less command is used to display the file config_store Only part of the file is shown here RP 0 RP0 CPU0 router utility less file disk0 usr config_store Last configuration change at Tue Feb 20 18 34 02 2007 by xxx hostname H1 line console exec timeout 600 0 session timeout 600 line default exec timeout 600 0 session timeout 600 Task ID Operations universal e...

Page 761: ...nt syntax The UNIX equivalent syntax is displayed in parentheses in the syntax description To display the UNIX equivalent syntax online enter the keyword usage Task ID Examples In the following example the utility mv command is used to move the file aaa from disk0a to disk1a RP 0 RP0 CPU0 router utility mv source disk0a aaa target disk1a aaa force Optional f Forces an overwrite if the target file ...

Page 762: ...anagement Command Reference OL 17231 01 Related Commands Command Description utility cut Cuts characters or lines from the output displayed from standard input or a file utility sort Sorts merges or sequence checks the output displayed from standard input or a file utility tail Copies the end portion of the output displayed from standard input or a file ...

Page 763: ...ified For field_end the n refers to the nth character after the last character of the specified field and is taken as zero if not specified The type_string may be formed from the characters bdfinr which apply their defined attributes to the determination of the key Note When ordering options appear independent of key field specifications the requested field ordering rules are applied globally to a...

Page 764: ...ds are entered using the displayed syntax or with UNIX equivalent syntax The UNIX equivalent syntax is displayed in parentheses in the syntax description To display the UNIX equivalent syntax online enter the keyword usage Task ID Examples In the following example the utility sort command is used to sort the contents of the file words txt RP 0 RP0 CPU0 router utility sort disk0 usr words txt The f...

Page 765: ...layed RP 0 RP0 CPU0 router utility sort unique file disk0 usr words txt Code Date best selling book concerning have list of our way work Related Commands Command Description utility uniq Displays or removes repeated lines in a file utility cut Cuts characters or lines from the output displayed from standard input or a file utility tail Copies the end portion of the output displayed from standard i...

Page 766: ...a FIFO special file a named pipe count number Optional n Copies the number of lines default or bytes specified with the number argument The number range is 0 to 4294967295 By default the last 10 lines are copied The number argument is a decimal integer that defines the location in the file to begin copying Include the plus character to copy from the beginning of the file Include the minus characte...

Page 767: ...y tail command is used to display the last 10 lines of the output from the command show version RP 0 RP0 CPU0 router show version utility tail count 10 By iox25 cisco com in auto ioxws46 nightly ci 34_asr14k_06 09 13 for c2 95 3 8 asr14k base V 3 7 1 4n_06 09 13 Cisco Systems at disk0 asr14k base 3 7 1 Built on Wed Sep 13 22 04 26 UTC 2006 By iox25 cisco com in auto ioxws46 nightly ci 34_asr14k_06...

Page 768: ...l SMR 766 Cisco ASR 14000 Series Router System Management Command Reference OL 17231 01 utility sort Sorts merges or sequence checks the output displayed from standard input or a file utility head Copies bytes or lines at the beginning of the output displayed from standard input or a file Command Description ...

Page 769: ...ptional u Displays only the nonrepeating lines from the input file repeating lines are not displayed repeating Optional d Displays only the repeating lines from the input file nonrepeating lines are not displayed infile input file Optional Specifies an input file for processing The input file argument specifies the device directory and filename of the input file If no input file is specified then ...

Page 770: ...o display the UNIX equivalent syntax online enter the keyword usage Task ID Examples In the following example the utility unique command is used to display the repeating lines in the output of the show environment command RP 0 RP0 CPU0 router show environment utility uniq repeating host 5V 4500 5500 4250 5750 4000 6000 fabricq 1 25V 1125 1375 1063 1438 1000 1500 fabricq 1 25V 1125 1375 1063 1438 1...

Page 771: ...IX equivalent options are entered the output appears in the order specified by the options For example if the command utility wc w l c is entered the output appears in the order words lines and bytes bytes Optional c Displays the number of bytes in each input file lines Optional l el Displays the number of lines in each input file words Optional w Displays the number of words in each input file fi...

Page 772: ...valent syntax online enter the keyword usage Task ID Examples In the following example the utility wc command is issued to display the number of lines words and bytes in the output of the show version command RP 0 RP0 CPU0 router show version utility wc 221 1160 10820 The output displays the following 221 lines 1160 words 10820 bytes In the following example the utility wc command is entered with ...

Page 773: ...s in the syntax description To display the UNIX equivalent syntax online enter the keyword usage Task ID Examples In the following example the utility which command is entered without keywords or arguments to display the location of the perl program RP 0 RP0 CPU0 router utility which program perl all Optional a Displays all occurrences of the program specified by the program pathname keyword and a...

Page 774: ...the fullname keyword to display the full directory path of the perl program RP 0 RP0 CPU0 router utility which fullname program perl disk0 asr14k base 3 7 1 1I sbin perl In the following example the utility which command is entered with the long keyword to display additional details about the perl program file RP 0 RP0 CPU0 router utility which long program perl rwxrwxrwx 1 0 0 19245 Jul 28 14 31 ...

Page 775: ...ivalent syntax is displayed in parentheses in the syntax description To display the UNIX equivalent syntax online enter the keyword usage Task ID Examples In the following example the utility xargs command is used to display the egress lines RP 0 RP0 CPU0 router more disk0 usr files utility xargs program grep EGRESS trace Optional t Prints each program on standard error before executing program Op...

Page 776: ...atm cfg service policy output EGRESS GigabitEthernet0 0 0 0 104 disk0 usr atm cfg service policy output EGRESS GigabitEthernet0 0 0 0 105 disk0 usr atm cfg service policy output EGRESS GigabitEthernet0 0 0 0 106 disk0 usr atm cfg service policy output EGRESS GigabitEthernet0 0 0 0 107 disk0 usr atm cfg service policy output EGRESS GigabitEthernet0 0 0 0 108 disk0 usr atm cfg service policy output ...

Page 777: ... 672 banner incoming command SMR 674 banner login command SMR 676 banner motd command SMR 678 banner prompt timeout command SMR 680 broadcast client command SMR 433 broadcast command SMR 431 broadcastdelay command SMR 434 C cd command SMR 220 cdp advertise v1 command SMR 50 cdp command SMR 48 cdp holdtime command SMR 52 cdp log adjacency changes command SMR 54 cdp timer command SMR 56 ce tftp serv...

Page 778: ...d SMR 123 dsc serial command SMR 255 dumpcore command SMR 501 E end command SMR 124 end template command SMR 126 env disable command SMR 257 env power supply command SMR 258 erase nvram command SMR 233 erase nvram raw command SMR 234 escape character command SMR 690 exception filepath command SMR 504 exception pakmem command SMR 508 exception sparse command SMR 510 exception sprsize command SMR 51...

Page 779: ... man command SMR 136 master command SMR 436 max associations command SMR 438 mirror command SMR 14 mirror pause command SMR 16 mirror resume command SMR 17 mirror verify command SMR 18 mkdir command SMR 240 monitor processes command SMR 520 monitor threads command SMR 524 more command SMR 139 N notifications linkupdown disable command SMR 579 ntp clear command SMR 441 ntp command SMR 439 O object ...

Page 780: ...on failed remove command SMR 184 show configuration failed rollback command SMR 186 show configuration failed startup command SMR 188 show configuration history command SMR 190 show configuration inconsistency replica command SMR 194 show configuration persistent command SMR 196 show configuration removed command SMR 198 show configuration rollback changes command SMR 200 show configuration runnin...

Page 781: ...s boot command SMR 36 show variables system command SMR 38 show version command SMR 316 show xml schema command SMR 215 slow migration interval command SMR 574 snmp server chassis id command SMR 597 snmp server community command SMR 598 snmp server community map command SMR 600 snmp server contact command SMR 602 snmp server context command SMR 603 snmp server engineID command SMR 604 snmp server ...

Page 782: ... line protocol state command SMR 483 type list boolean command SMR 485 type route reachability command SMR 487 U unmount command SMR 250 update calendar command SMR 456 upgrade cpuctrlbits command SMR 318 upgrade hw module fpd command SMR 320 utilitiy bc command SMR 730 utility cut command SMR 733 utility date command SMR 737 utility date set command SMR 739 utility df command SMR 741 utility du c...

Reviews:

No comments

Brands by name

Popular brands

Load more brands