Table Of Contents
Troubleshooting Commands on Cisco ASR 9000 Series Router
show sysdb trace verification location
show sysdb trace verification shared-plane
Troubleshooting Commands on Cisco ASR 9000 Series Router
This module describes commands used for troubleshooting routers running Cisco IOS XR software.
The commands in this chapter with the cisco-support task ID are used in the Cisco IOS XR Troubleshooting Guide as part of the troubleshooting process. For information about commands with the cisco-support task ID that are not documented in this chapter, please contact Cisco Technical Support. See "Obtaining Documentation and Submitting a Service Request" section on page iii in the Preface.
![]()
CautionThese Cisco support commands are normally reserved for use by Cisco Technical Support personnel only. There is some risk that they may cause performance or other issues that impact products without proper usage, and we highly recommend that you contact Cisco Technical Support prior to using any of these commands.
show sysdb connections
To display the client connection information for the system database (SYSDB), use the show sysdb connections command in EXEC mode.
show sysdb connections [detail | job | path | location | shared-plane]
Syntax Description
detail
Displays the detailed client connection information.
job
Specify a Job ID.
path
Specify a path filter.
location
Specify a location.
shared-plane
Displays the shared-plane data
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release ModificationRelease 3.7.2
This command was introduced on the Cisco ASR 9000 Series Router.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows the output of the show sysdb connections command.
RP/0/RSP0/CPU0:router# show sysdb connections detail location 0/1/CPU0SysDB Connections:"/debug/node/11/LR/sysdb/client/"From: shmwin_svr (jid 76, nid 0/1/CPU0, tid 1)Connid: 00000001 Refcount: 0002 Options: 00000032Connected: Y In trans: N Verf susp: NClient connid: 00000000Connected at: Jul 14 19:31:47.304"/debug/node/11/LR/packet/"From: packet (jid 218, nid 0/1/CPU0, tid 1)Connid: 00000002 Refcount: 0002 Options: 00000032Connected: Y In trans: N Verf susp: NClient connid: 00000000Connected at: Jul 14 19:31:47.305"/debug/node/11/LR/cdm/qsm/"From: qsm (jid 246, nid 0/1/CPU0, tid 4)Connid: 00000003 Refcount: 0002 Options: 00000032Connected: Y In trans: N Verf susp: NClient connid: 00000000Connected at: Jul 14 19:31:47.305"/debug/node/11/LR/eem/"From: wdsysmon (jid 361, nid 0/1/CPU0, tid 5)Connid: 00000005 Refcount: 0002 Options: 00000032Connected: Y In trans: N Verf susp: NClient connid: 00000000Connected at: Jul 14 19:31:47.316"/debug/node/11/LR/sysmgr/"From: sysmgr (jid 79, nid 0/1/CPU0, tid 7)Connid: 00000013 Refcount: 0002 Options: 00000032...show sysdb trace verification location
To display trace verification information for the system database (SYSDB), use the show sysdb trace verification location command in EXEC mode.
show sysdb trace verification location node-id
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release ModificationRelease 3.7.2
This command was introduced on the Cisco ASR 9000 Series Router.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the show sysdb trace verification shared-plane location command to display details of recent verification sysDB transactions and changes on local plane configurations. The command output allows you to confirm that configuration were verified and accepted.
Task ID
Examples
The following example shows the output of the show sysdb trace verification shared-plane location command. The output shows that changes to the SysDB local plane were verified and accepted.
RP/0/RSP0/CPU0:router# show sysdb trace verification location 0/3/CPU0Timestamp jid tid reg handle connid actionpath323 wrapping entries (4096 possible, 299 filtered, 622 total)Jul 7 20:10:36.212 260 1 90 8782 apply reply'--'Jul 7 20:10:35.476 260 1 90 4912 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_0.1/a/sub_vlan/0x2/________/GigabitEthernet0_3_4_0/________'Jul 7 20:10:35.475 260 1 90 4912 verify reply: accept '--'Jul 7 20:10:35.471 260 1 90 4912 Verify called'cfg/if/act/GigabitEthernet0_3_4_0.1/a/sub_vlan/0x2/________/GigabitEthernet0_3_4_0/________'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.471 144 1 4 8782 apply reply'--'Jul 7 20:10:35.470 144 1 4 474 Apply/abort batch ended ''Jul 7 20:10:35.470 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_0/ord_x/im/shutdown'Jul 7 20:10:35.470 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_1/ord_x/im/shutdown'Jul 7 20:10:35.470 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_2/ord_x/im/shutdown'Jul 7 20:10:35.470 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_3/ord_x/im/shutdown'Jul 7 20:10:35.470 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_4/ord_x/im/shutdown'Jul 7 20:10:35.469 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_5/ord_x/im/shutdown'Jul 7 20:10:35.469 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_6/ord_x/im/shutdown'Jul 7 20:10:35.469 144 1 4 474 Apply/abort called'cfg/if/act/GigabitEthernet0_3_4_7/ord_x/im/shutdown'Jul 7 20:10:35.469 144 1 4 474 Apply/abort batch started ''Jul 7 20:10:35.469 144 1 4 474 verify reply: accept '--'Jul 7 20:10:35.469 144 1 4 474 verify reply: accept '--'Jul 7 20:10:35.469 144 1 4 474 verify reply: accept '--'!!!Table 2 describes the significant fields shown in the display.
Related Commands
Command Descriptionshow sysdb connection path shared-plane
Displays sysDB client connection shared plane data for a specific path.
show sysdb trace verification shared-plane
To display trace verification information for the system database (SYSDB), use the show sysdb trace verification shared-plane command in EXEC mode.
show sysdb trace verification shared-plane [file | hexdump | last | location | reverse | stats | tailf | unique | verbose | wrapping]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release ModificationRelease 3.7.2
This command was introduced on the Cisco ASR 9000 Series Router.s.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the show sysdb trace verification shared-plane command to display details of recent verification sysDB transactions and changes on the shared plane. The command output allows you to confirm whether the configuration was verified correctly.
Specifying a path using the | include keyword and path argument filters the data to display only the sysDB path for the router. Use the describe command to determine the path.
Task ID
Examples
The following example shows the output of the show sysdb trace verification shared-plane command. The output shows that changes to the SysDB shared plane were verified and accepted.
RP/0/RSP0/CPU0:router# show sysdb trace verification shared-plane | include gl/a/hostnameMay 18 19:16:17.143 340 3 210 962 Apply/abort called'cfg/gl/a/hostname'May 18 19:16:17.132 340 3 210 962 Verify called'cfg/gl/a/hostname'May 18 19:16:17.126 340 3 210 962 Apply/abort called'cfg/gl/a/hostname'May 18 19:16:17.109 340 3 210 962 Verify called'cfg/gl/a/hostname'May 18 18:43:16.065 340 3 210 962 register'cfg/gl/a/hostname'May 18 18:41:41.048 340 3 16 362 register'cfg/gl/a/hostname'
Related Commands
Command Descriptionshow sysdb connection path shared-plane
Displays sysDB client connection shared plane data for a specific path.
show tbm hardware
To displays tree bitmap hardware-related information, use the show tbm hardware command in EXEC mode.
show tbm hardware {ipv4 | ipv6 | mpls | vpnv4 | table-id | afi-all | sw-only | dual | egress | ingress} {unicast | multicast | safi-all} {dual | egress | ingress | sw-only} {brief | detail | lookup | prefix {prefix-hex-string}} location node-id
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release ModificationRelease 3.7.2
This command was introduced on the Cisco ASR 9000 Series Router.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the show tbm hardware command to display hardware-related ingress and egress information for the tree bitmap.
Task ID
Examples
The following example shows the output of the show tbm hardware command:
RP/0/RSP0/CPU0:router# show tbm hardware ipv4 unicast dual detail location 0/6/cpu0TBM Table Type: IPv4 Unicast------------------------------TBM: number of pulses: 71TBM: number of Err fix attempts: 0No current failuresPast failures: leaf(0), mem(0), mipc(0), flush_mipc(0)post_compact(0), pre_compact(0)PLU Bucket Statistics:-----------------------------Bucket 0: 44Bucket 1: 44Bucket 2: 327Bucket 3: 44Bucket 4: 44Bucket 5: 43Bucket 6: 43Bucket 7: 45Ingress PLU Info----------------PLU: Num Writes : 3064PLU: Num Copies : 2197PLU Memory Channel Statistics:-----------------------------Number of compactions: 0FCRAM0 Chan: 110 (Pages: 5, 1% used)FCRAM1 Chan: 125 (Pages: 8, 0% used)FCRAM2 Chan: 127 (Pages: 8, 0% used)FCRAM3 Chan: 148 (Pages: 8, 0% used)FCRAM4 Chan: 124 (Pages: 8, 0% used)Egress PLU Info----------------PLU: Num Writes : 3064PLU: Num Copies : 2197PLU Memory Channel Statistics:-----------------------------Number of compactions: 0FCRAM0 Chan: 110 (Pages: 5, 1% used)FCRAM1 Chan: 125 (Pages: 8, 0% used)FCRAM2 Chan: 127 (Pages: 8, 0% used)FCRAM3 Chan: 148 (Pages: 8, 0% used)FCRAM4 Chan: 124 (Pages: 8, 0% used)Table 3 describes the significant fields shown in the display.
show uidb data
To display index data information for the micro-interface descriptor block (uIDB), use the show uidb data command in EXEC mode.
show uidb data [shadow] [ingress | egress] [interface-type interface-instance] location node-id
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release ModificationRelease 3.7.2
This command was introduced on the Cisco ASR 9000 Series Router
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the show uidb index command to display micro-IDB index data information including, from a software perspective, features that are enabled on a selected interface.
Task ID
Examples
The following example shows the output of the show uidb data command:
RP/0/RSP0/CPU0:router# sh uidb data shadow ingress gigabitEthernet 0/2/4/4 loc 0/2/CPU0--------------------------------------------------------------------------Location = 0/2/CPU0Ifname/Ifhandle = GigabitEthernet0_2_4_4 / 0x12800a0Index = 5Pse direction = INGRESS============================================* (Not programmed in hardware) *--------------------------------------------RSM STATUS: 0x7c000000-> used: 0x1f->dirty: 0x00->badck: 0x00-> prog: DONE->count: 0--------------------------------------------BUNDLE IFHANDLE: 0TUNNEL IFHANDLE: 0L2 ENCAP: 3============================================General 16 bytes:------------------------IFHANDLE: 0x12800aSTATUS: 1ISSU State: 0IPV4 ENABLE: 1IPV6 ENABLE: 1MPLS ENABLE: 0STATS POINTER: 0x7ffd8SPRAYER QUEUE: 36IPV4 MULTICAST: 0IPV6 MULTICAST: 0USE TABLE ID IPV4: 0USE TABLE ID IPV6: 0USE TABLE ID MPLS: 0TABLE ID: 0QOS ENABLE: 0QOS ID: 0NETFLOW SAMPLING PERIOD: 0L2 PKT DROP: 0L2 QOS ENABLE: 0SRC FWDING: 0*[CHECKSUM]*: 0xff70f28cTable 4 describes the significant fields shown in the display.
Related Commands
Command DescriptionDisplays UIDB trace data debugging information that helps in troubleshooting the problem.
show uidb data-dump
Displays UIDB data information in hexadecimal format.
show uidb trace
To display trace data information for the micro-interface descriptor block (IDB), use the show uidb trace command in EXEC mode.
show uidb trace {all | errors | events | init | rsm }
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release ModificationRelease 3.7.2
This command was introduced on Cisco ASR 9000 Series Router.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows the sample output from the show uidb trace command:
RP/0/RSP0/CPU0:router# sh uidb trace init loc 0/6/CPU0--------------------------------------------------------------------------28 wrapping entries (512 possible, 0 filtered, 28 total)Mar 31 02:27:35.368 uidb_svr/initlog 0/6/CPU0 t1 Entering : Event manager initMar 31 02:27:36.641 uidb_svr/initlog 0/6/CPU0 t1 Successful : Event manager intMar 31 02:27:36.641 uidb_svr/initlog 0/6/CPU0 t1 Entering : Debug initMar 31 02:27:36.816 uidb_svr/initlog 0/6/CPU0 t1 Successful : Debug initMar 31 02:27:36.816 uidb_svr/initlog 0/6/CPU0 t1 Entering : MIPC bundMar 31 02:27:51.695 uidb_svr/initlog 0/6/CPU0 t1 Successful : MIPC bindMar 31 02:27:51.695 uidb_svr/initlog 0/6/CPU0 t1 PSE RSM : Init - main() : (50sMar 31 02:27:51.803 uidb_svr/initlog 0/6/CPU0 t1 Successful : PSE RSM Init sucdMar 31 02:27:51.803 uidb_svr/initlog 0/6/CPU0 t1 Entering : Metro bindMar 31 02:27:51.828 uidb_svr/initlog 0/6/CPU0 t1 Successful : Metro bindMar 31 02:27:51.828 uidb_svr/initlog 0/6/CPU0 t1 Entering : PLIM ASIC registerMar 31 02:27:51.922 uidb_svr/initlog 0/6/CPU0 t1 Successful : PLIM ASIC registrMar 31 02:27:51.922 uidb_svr/initlog 0/6/CPU0 t1 Entering : UIDB checkpoint intMar 31 02:27:51.944 uidb_svr/initlog 0/6/CPU0 t1 Successful : UIDB checkpoint tMar 31 02:27:51.944 uidb_svr/initlog 0/6/CPU0 t1 Entering : UIDB shadow memorytMar 31 02:27:51.944 uidb_svr/initlog 0/6/CPU0 t1 Successful : UIDB shadow memotMar 31 02:27:51.944 uidb_svr/initlog 0/6/CPU0 t1 Entering : UIDB EDM initMar 31 02:27:51.951 uidb_svr/initlog 0/6/CPU0 t1 Successful : UIDB EDM initMar 31 02:27:51.951 uidb_svr/initlog 0/6/CPU0 t1 Entering : Checkpoint ingresseMar 31 02:27:51.951 uidb_svr/initlog 0/6/CPU0 t1 Successful : Checkpoint ingreeMar 31 02:27:51.951 uidb_svr/initlog 0/6/CPU0 t1 Entering : Checkpoint egress eMar 31 02:27:51.951 uidb_svr/initlog 0/6/CPU0 t1 Successful : Checkpoint egrese
Related Commands
Command DescriptionDisplays UIDB index data information.
show uidb data-dump
Displays UIDB data information in hexadecimal format.
show uidb index
To display micro-interface descriptor block (IDB) index information, use the show uidb index command in EXEC mode.
show uidb index
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release ModificationRelease 3.7.2
This command was introduced on the Cisco ASR 9000 Series Router.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the show uidb index command to display the micro-IDB index assigned by the software.
Task ID
Examples
The following example shows the output of the show uidb index command:
RP/0/RP0/CPU0:router# show uidb index------------------------------------------------------------------------------Location Interface-name Interface-Type Ingress-index Egress-index---------------------------------------------------------------------------0/1/CPU0 0 0 00/1/CPU0 GigabitEthernet0_1_5_0 Main interface 110/1/CPU0 GigabitEthernet0_1_5_1 Main interface 220/1/CPU0 GigabitEthernet0_1_5_2 Main interface 330/1/CPU0 GigabitEthernet0_1_5_3 Main interface 440/1/CPU0 GigabitEthernet0_1_5_4 Main interface 550/1/CPU0 GigabitEthernet0_1_5_5 Main interface 660/1/CPU0 GigabitEthernet0_1_5_6 Main interface 770/1/CPU0 GigabitEthernet0_1_5_7 Main interface 880/1/CPU0 POS0_1_0_0 Main interface 9 90/1/CPU0 POS0_1_4_0 Main interface 10 100/1/CPU0 POS0_1_0_1 Main interface 11 110/1/CPU0 POS0_1_4_1 Main interface 12 120/1/CPU0 POS0_1_0_2 Main interface 13 130/1/CPU0 POS0_1_4_2 Main interface 14 140/1/CPU0 POS0_1_0_3 Main interface 15 150/1/CPU0 POS0_1_4_3 Main interface 16 160/1/CPU0 Bundle-POS24 Bundle Interface 17 170/1/CPU0 Bundle-Ether28 Bundle Interface 18 180/1/CPU0 Bundle-Ether28.1 Sub-interface 19 190/1/CPU0 Bundle-Ether28.2 Sub-interface 20 200/1/CPU0 Bundle-Ether28.3 Sub-interface 21 210/6/CPU0 0 0 00/6/CPU0 GigabitEthernet0_6_5_0 Main interface 110/6/CPU0 GigabitEthernet0_6_5_1 Main interface 220/6/CPU0 GigabitEthernet0_6_5_2 Main interface 330/6/CPU0 GigabitEthernet0_6_5_3 Main interface 440/6/CPU0 GigabitEthernet0_6_5_4 Main interface 550/6/CPU0 GigabitEthernet0_6_5_5 Main interface 660/6/CPU0 GigabitEthernet0_6_5_6 Main interface 770/6/CPU0 GigabitEthernet0_6_5_7 Main interface 880/6/CPU0 POS0_6_0_0 Main interface 9 90/6/CPU0 POS0_6_4_0 Main interface 10 100/6/CPU0 POS0_6_0_1 Main interface 11 110/6/CPU0 POS0_6_4_1 Main interface 12 120/6/CPU0 POS0_6_0_2 Main interface 13 130/6/CPU0 POS0_6_4_2 Main interface 14 140/6/CPU0 POS0_6_0_3 Main interface 15 150/6/CPU0 POS0_6_4_3 Main interface 16 160/6/CPU0 POS0_6_4_4 Main interface 17 170/6/CPU0 POS0_6_4_5 Main interface 18 180/6/CPU0 POS0_6_4_6 Main interface 19 190/6/CPU0 POS0_6_4_7 Main interface 20 20Table 5 describes the significant fields shown in the display.
Related Commands
Command DescriptionDisplays IDB index data information.
show uidb data-dump
Displays UIDB data information in hexadecimal format.
watchdog threshold memory
To configure the value of memory available for each alarm threshold, use the watchdog threshold memory command in global configuration or interface configuration mode. To revert to the default threshold memory, use the no form of this command.
watchdog memory threshold [location node-id] minor percentage-memory-available severe percentage-memory-available critical percentage-memory-available
no watchdog memory threshold [location node-id] minor percentage-memory-available severe percentage-memory-available critical percentage-memory-available
Syntax Description
Defaults
Use the show watchdog threshold memory defaults location all command to display the default memory thresholds.
Command Modes
Global configuration
Interface configurationCommand History
Release ModificationRelease 3.7.2
This command was introduced on the Cisco ASR 9000 Series Router.
Release 3.9.0
No modification.
Usage Guidelines
To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.
Use the watchdog threshold memory command to configure the memory thresholds. Threshold values can be applied to all nodes or a specific node using the location node-id keyword and argument. If the local threshold settings are removed, the local settings return to those set globally. In addition, you can view default and configured thresholds.
Table 6 lists the recommended memory threshold value calculations if the minor threshold is set to 20 percent, the severe threshold is set to 10 percent, and the critical threshold is set to 5 percent.
Task ID
Examples
The following example shows how to configure the memory available for each alarm threshold:
RP/0/RSP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# watchdog threshold memory location 0/RP0/CPU0 minor 30 severe 20 critical 10