-
Cisco IOS XR IP Addresses and Services Command Reference, Release 3.6
-
Preface
-
Access List Commands on Cisco IOS XR Software
-
ARP Commands on Cisco IOS XR Software
-
Cisco Express Forwarding Commands on Cisco IOS XR Software
-
DHCP Commands on Cisco IOS XR Software
-
Host Services and Applications Commands on Cisco IOS XR Software
-
HSRP Commands on Cisco IOS XR Software
-
LPTS Commands on Cisco IOS XR Software
-
Network Stack IPv4 and IPv6 Commands on Cisco IOS XR Software
-
Prefix List Commands on Cisco IOS XR Software
-
Transport Stack Commands on Cisco IOS XR Software
-
VRRP Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
Transport Stack Commands on Cisco IOS XR Software
clear tcp nsr statistics client
clear tcp nsr statistics session-set
clear tcp nsr statistics summary
nsr process-failures switchover
show tcp nsr detail session-set
show tcp nsr session-set brief
show tcp nsr statistics client
show tcp nsr statistics session-set
show tcp nsr statistics summary
Transport Stack Commands on Cisco IOS XR Software
This chapter describes the Cisco IOS XR software commands used to configure and monitor features related to the transport stack (Stream Control Transmission Protocol [SCTP], TCP, User Datagram Protocol [UDP], and RAW). Any IP protocol other than TCP or UDP is known as a RAW protocol.
For detailed information about transport stack concepts, configuration tasks, and examples, refer to the Configuring SCTP, TCP, UDP, and RAW Transports on Cisco IOS XR Software configuration module.
clear nsr ncd client
To clear the counters of a specified client or all the clients of nonstop routing (NR) Consumer Demuxer (NCD), use the clear nsr ncd client command in EXEC mode.
clear nsr ncd client {PID value | all} [location node-id]
Syntax Description
Defaults
The default value for the node-id argument is the current node in which the command is being executed. The PID value argument does not have a default value.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
The active and standby instances of some NSR-capable applications communicate through two queues, and these applications are multiplexed onto these queues. NSR consumer demuxer (NCD) is a process that provides the demuxing services on the receiver side.
You can use the clear nsr ncd client command to troubleshoot traffic issues. If you clear the existing counters, it can help you to monitor the delta changes.
Task ID
Examples
The following example shows how to clear all the counters for all NCD clients:
RP/0/RP0/CPU0:router# clear nsr ncd client allRP/0/RP0/CPU0:router# show nsr ncd client allClient PID : 3874979Client Protocol : TCPClient Instance : 1Total packets received : 0Total acks received : 0Total packets/acks accepted : 0Errors in changing packet ownership : 0Errors in setting application offset : 0Errors in enqueuing to client : 0Time of last clear : Sun Jun 10 14:43:44 20RP/0/RP0/CPU0:router# show nsr ncd client briefTotal Total AcceptedPid Protocol Instance Packets Acks Packets/Acks3874979 TCP 1 0 0 0Related Commands
clear nsr ncd queue
To clear the counters for the nonstop routing (NSR) Consumer Demuxer (NCD) queue, use the clear nsr ncd queue command in EXEC mode.
clear nsr ncd queue {all | high | low} [location node-id]
Syntax Description
Defaults
If a value is not specified, the current RP in which the command is being executed is taken as the location.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
Task ID
Examples
The following example shows how to clear the counters for all the NCD queues:
RP/0/RP0/CPU0:router# clear nsr ncd queue allRP/0/RP0/CPU0:router# show nsr ncd queue allQueue Name : NSR_LOWTotal packets received : 0Total packets accepted : 0Errors in getting datagram offset : 0Errors in getting packet length : 0Errors in calculating checksum : 0Errors due to bad checksum : 0Errors in reading packet data : 0Errors due to bad NCD header : 0Drops due to a non-existent client : 0Errors in changing packet ownership : 0Errors in setting application offset : 0Errors in enqueuing to client : 0Time of last clear : Sun Jun 10 14:44:38 2007Queue Name : NSR_HIGHTotal packets received : 0Total packets accepted : 0Errors in getting datagram offset : 0Errors in getting packet length : 0Errors in calculating checksum : 0Errors due to bad checksum : 0Errors in reading packet data : 0Errors due to bad NCD header : 0Drops due to a non-existent client : 0Errors in changing packet ownership : 0Errors in setting application offset : 0Errors in enqueuing to client : 0Time of last clear : Sun Jun 10 14:44:38 2007RP/0/RP0/CPU0:router# show nsr ncd queue briefTotal AcceptedQueue Packets PacketsNSR_LOW 0 0NSR_HIGH 0 0Related Commands
clear raw statistics pcb
To clear statistics for a single RAW connection or for all RAW connections, use the clear raw statistics pcb command in EXEC mode.
clear raw statistics pcb {all | pcb-address} location node-id
Syntax Description
Defaults
No default 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. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the all keyword to clear all RAW connections. To clear a specific RAW connection, enter the protocol control block (PCB) address of the RAW connection. Use the show raw brief command to obtain the PCB address.
Use the location keyword and node-id argument to clear RAW statistics for a designated node.
Task ID
Examples
The following example shows how to clear statistics for a RAW connection with PCB address 0x80553b0:
RP/0/RP0/CPU0:router# clear raw statistics pcb 0x80553b0RP/0/RP0/CPU0:router# show raw statistics pcb 0x80553b0Statistics for PCB 0x80553b0Send: 0 packets received from application0 xipc pulse received from application0 packets sent to network0 packets failed getting queued to networkRcvd: 0 packets received from network0 packets queued to application0 packets failed queued to applicationThe following example shows how to clear statistics for all RAW connections:
RP/0/RP0/CPU0:router# clear raw statistics pcb allRP/0/RP0/CPU0:router# show raw statistics pcb allStatistics for PCB 0x805484cSend: 0 packets received from application0 xipc pulse received from application0 packets sent to network0 packets failed getting queued to networkRcvd: 0 packets received from network0 packets queued to application0 packets failed queued to applicationStatistics for PCB 0x8054f80Send: 0 packets received from application0 xipc pulse received from application0 packets sent to network0 packets failed getting queued to networkRcvd: 0 packets received from network0 packets queued to application0 packets failed queued to applicationStatistics for PCB 0x80553b0Send: 0 packets received from application0 xipc pulse received from application0 packets sent to network0 packets failed getting queued to networkRcvd: 0 packets received from network0 packets queued to application0 packets failed queued to applicationRelated Commands
Displays information about active RAW IP sockets.
Displays statistics for either a single RAW connection or all RAW connections.
clear tcp nsr client
To bring the nonstop routing (NSR) down on all the sessions that are owned by the specified client, use the clear tcp nsr client command in EXEC mode.
clear tcp nsr client {ccb-address | all} [location node-id]
Syntax Description
Defaults
The location defaults to the current node in which the command is executing.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
The output of the show tcp nsr client command is used to locate the CCB of the desired client.
Use the clear tcp nsr client command to gracefully bring down NSR session that are owned by one client or all clients. In addition, the clear tcp nsr client command is used as a work around if the activity on the sessions freezes.
Task ID
Examples
The following example shows that the nonstop routing (NSR) client is cleared for 0x482afacc: The two sessions had NSR already up before executing the clear tcp nsr client command. NSR is no longer up after executing the clear tcp nsr client command.
RP/0/RP0/CPU0:router# show tcp nsr client briefCCB Proc Name Instance Sets Sessions/NSR Up Sessions0x482c10e0 mpls_ldp 1 2 3/10x482afacc mpls_ldp 2 1 2/2RP/0/RP0/CPU0:router# clear tcp nsr client 0x482afaccRP/0/RP0/CPU0:router# show tcp nsr client briefCCB Proc Name Instance Sets Sessions/NSR Up Sessions0x482c10e0 mpls_ldp 1 2 3/10x482afacc mpls_ldp 2 1 2/0Related Commands
clear tcp nsr pcb
To bring the nonstop routing (NSR) down on a specified connection or all connections, use the clear tcp nsr pcb command in EXEC mode.
clear tcp nsr pcb {pcb-address | all} [location node-id]
Syntax Description
Defaults
If a value is not specified, the current RP in which the command is being executed is taken as the location.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
The output of the show tcp nsr brief command is used to locate the Protocol Control Block (PCB) of a desired connection.
Task ID
Examples
The following example shows that the information for TCP connections is cleared:
RP/0/RP0/CPU0:router# show tcp nsr briefPCB Local Address Foreign Address NSR RcvOnly0x482d7470 5.1.1.1:646 5.1.1.2:14142 Up No0x482d2844 5.1.1.1:646 5.1.1.2:15539 Up No0x482d3bc0 5.1.1.1:646 5.1.1.2:25671 Up No0x482d4f3c 5.1.1.1:646 5.1.1.2:32319 Up No0x482d87ec 5.1.1.1:646 5.1.1.2:39592 Up No0x482cd670 5.1.1.1:646 5.1.1.2:43447 Up No0x482d14c8 5.1.1.1:646 5.1.1.2:45803 Up No0x482bdee4 5.1.1.1:646 5.1.1.2:55844 Up No0x482d62b8 5.1.1.1:646 5.1.1.2:60695 Up No0x482d0310 5.1.1.1:646 5.1.1.2:63007 Up NoRP/0/RP0/CPU0:router# clear tcp nsr pcb 0x482d7470RP/0/RP0/CPU0:router# clear tcp nsr pcb 0x482d2844RP/0/RP0/CPU0:router# show tcp nsr briefPCB Local Address Foreign Address NSR RcvOnly0x482d7470 5.1.1.1:646 5.1.1.2:14142 Down No0x482d2844 5.1.1.1:646 5.1.1.2:15539 Down No0x482d3bc0 5.1.1.1:646 5.1.1.2:25671 Up No0x482d4f3c 5.1.1.1:646 5.1.1.2:32319 Up No0x482d87ec 5.1.1.1:646 5.1.1.2:39592 Up No0x482cd670 5.1.1.1:646 5.1.1.2:43447 Up No0x482d14c8 5.1.1.1:646 5.1.1.2:45803 Up No0x482bdee4 5.1.1.1:646 5.1.1.2:55844 Up No0x482d62b8 5.1.1.1:646 5.1.1.2:60695 Up No0x482d0310 5.1.1.1:646 5.1.1.2:63007 Up NoRelated Commands
Displays the key nonstop routing (NSR) state of TCP connections on different nodes.
Displays detailed information about the state of nonstop routing (NSR) for TCP connections.
clear tcp nsr session-set
To clear the nonstop routing (NSR) on all the sessions in the specified session-set or all session sets, use the clear tcp nsr session-set command in EXEC mode.
clear tcp nsr session-set {sscb-address | all} [location node-id]
Syntax Description
Defaults
If a value is not specified, the current RP in which the command is being executed is taken as the location.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
The output of the show tcp nsr session-set brief command is used to locate the SSCB of the desired session-set.
Task ID
Examples
The following example shows that the information for the session sets is cleared:
RP/0/RP0/CPU0:router# show tcp nsr client briefCCB Proc Name Instance Sets Sessions/NSR Up Sessions0x482b5ee0 mpls_ldp 1 1 10/10RP/0/RP0/CPU0:router# clear tcp nsr client 0x482b5ee0RP/0/RP0/CPU0:router# show tcp nsr client briefCCB Proc Name Instance Sets Sessions/NSR Up Sessions0x482b5ee0 mpls_ldp 1 1 10/0Related Commands
clear tcp nsr statistics client
To clear the nonstop routing (NSR) statistics of the client, use the clear tcp nsr statistics client command in EXEC mode.
clear tcp nsr statistics client {ccb-address | all} [location node-id]
Syntax Description
Defaults
If a value is not specified, the current RP in which the command is being executed is taken as the location.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
Task ID
Examples
The following example shows that the statistics for the NSR clients is cleared:
RP/0/RP0/CPU0:router# show tcp nsr statistics client all==============================================================CCB: 0x482b5ee0Name: mpls_ldp, Job ID: 365Connected at: Thu Aug 16 18:20:32 2007Notification Statistics : Queued Failed Delivered DroppedInit-Sync Done : 2 0 2 0Replicated Session Ready: 0 0 0 0Operational Down : 12 0 12 0Last clear at: Never ClearedRP/0/RP0/CPU0:router# clear tcp nsr statistics client allRP/0/RP0/CPU0:router# show tcp nsr statistics client all==============================================================CCB: 0x482b5ee0Name: mpls_ldp, Job ID: 365Connected at: Thu Aug 16 18:20:32 2007Notification Statistics : Queued Failed Delivered DroppedInit-Sync Done : 0 0 0 0Replicated Session Ready: 0 0 0 0Operational Down : 0 0 0 0Last clear at: Thu Aug 16 18:28:38 2007Related Commands
clear tcp nsr statistics pcb
To clear the nonstop routing (NSR) statistics for TCP connections, use the clear tcp nsr statistics pcb command in EXEC mode.
clear tcp nsr statistics pcb {pcb-address | all} [location node-id]
Syntax Description
Defaults
If a value is not specified, the current RP in which the command is being executed is taken as the location.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
Task ID
Examples
The following example shows that the NSR statistics for TCP connections is cleared:
RP/0/RP0/CPU0:router# show tcp nsr statistics pcb 0x482d14c8==============================================================PCB 0x482d14c8Number of times NSR went up: 1Number of times NSR went down: 0Number of times NSR was disabled: 0Number of times switch-over occured : 0IACK RX Message Statistics:Number of iACKs dropped because SSO is not up : 0Number of stale iACKs dropped : 1070Number of iACKs not held because of an immediate match : 98TX Messsage Statistics:Data transfer messages:Sent 317, Dropped 0, Data (Total/Avg.) 2282700/7200Rcvd 0Success : 0Dropped (Trim) : 0Segmentation instructions:Sent 1163, Dropped 0, Units (Total/Avg.) 4978/4Rcvd 0Success : 0Dropped (Trim) : 0Dropped (TCP) : 0NACK messages:Sent 0, Dropped 0Rcvd 0Success : 0Dropped (Data snd): 0Cleanup instructions :Sent 8, Dropped 0Rcvd 0Success : 0Dropped (Trim) : 0Last clear at: Never clearedRP/0/RP0/CPU0:router# clear tcp nsr statistics pcb 0x482d14c8RP/0/RP0/CPU0:router# show tcp nsr statistics pcb 0x482d14c8==============================================================PCB 0x482d14c8Number of times NSR went up: 0Number of times NSR went down: 0Number of times NSR was disabled: 0Number of times switch-over occured : 0IACK RX Message Statistics:Number of iACKs dropped because SSO is not up : 0Number of stale iACKs dropped : 0Number of iACKs not held because of an immediate match : 0TX Messsage Statistics:Data transfer messages:Sent 0, Dropped 0, Data (Total/Avg.) 0/0Rcvd 0Success : 0Dropped (Trim) : 0Segmentation instructions:Sent 0, Dropped 0, Units (Total/Avg.) 0/0Rcvd 0Success : 0Dropped (Trim) : 0Dropped (TCP) : 0NACK messages:Sent 0, Dropped 0Rcvd 0Success : 0Dropped (Data snd): 0Cleanup instructions :Sent 0, Dropped 0Rcvd 0Success : 0Dropped (Trim) : 0Last clear at: Thu Aug 16 18:32:12 2007Related Commands
Displays the nonstop routing (NSR) statistics for a given Protocol Control Block (PCB).
clear tcp nsr statistics session-set
To clear the nonstop routing (NSR) statistics for session sets, use the clear tcp nsr statistics session-set command in EXEC mode.
clear tcp nsr statistics session-set {sscb-address | all} [location node-id]
Syntax Description
Defaults
If a value is not specified, the current RP in which the command is being executed is taken as the location.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
Task ID
Examples
The following example shows that the NSR statistics for session sets is cleared:
RP/0/RP0/CPU0:router# show tcp nsr statistics session-set all===================Session Set Stats ===========================SSCB 0x482b6684, Set ID: 1Number of times init-sync was attempted :3Number of times init-sync was successful :3Number of times init-sync failed :0Number of times switch-over occured :0Last clear at: Never ClearedRP/0/RP0/CPU0:router# clear tcp nsr statistics session-set allRP/0/RP0/CPU0:router# show tcp nsr statistics session-set all===================Session Set Stats ===========================SSCB 0x482b6684, Set ID: 1Number of times init-sync was attempted :0Number of times init-sync was successful :0Number of times init-sync failed :0Number of times switch-over occured :0Last clear at: Thu Aug 16 18:37:00 2007Related Commands
clear tcp nsr statistics summary
To clear the nonstop routing (NSR) statistics summary, use the clear tcp nsr statistics summary command in EXEC mode.
clear tcp nsr statistics summary [location node-id]
Syntax Description
location node-id
(Optional) Displays statistics summary information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
If a value is not specified, the current RP in which the command is being executed is taken as the location.
Command Modes
EXEC
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The location keyword is used so that active and standby TCP instances are independently queried.
Task ID
Examples
The following example shows how to clear the summary statistics:
RP/0/RP0/CPU0:router# clear tcp nsr statistics summaryRelated Commands
clear tcp pcb
To clear TCP protocol control block (PCB) connections, use the clear tcp pcb command in EXEC mode.
clear tcp pcb {pcb-address | all} location node-id
Syntax Description
Defaults
No default 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. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The clear tcp pcb command is useful for clearing hung TCP connections. Use the show tcp brief command to find the PCB address of the connection you want to clear.
If the clear tcp pcb all command is used, the software does not clear a TCP connection that is in the listen state. If a specific PCB address is specified, then a connection in listen state is cleared.
Task ID
Examples
The following example shows that the TCP connection at PCB address 60B75E48 is cleared:
RP/0/RP0/CPU0:router# clear tcp pcb 60B75E48Related Commands
clear tcp statistics
To clear TCP statistics, use the clear tcp statistics command in EXEC mode.
clear tcp statistics {pcb {all | pcb-address} | summary} [location node-id]
Syntax Description
Defaults
No default 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. For detailed information about