Downloads |
Table Of Contents
Information About Clear IPC Statistics
Displaying Cumulative IPC Statistics
Clear IPC Statistics
First Published: 12.2(15)TLast Updated: February 28, 2006The show ipc command displays various interprocess communication (IPC) counters and is used for troubleshooting issues with IPC services. Without the ability to clear the IPC counters, it is difficult to determine whether an individual IPC message indicates a new or existing issue. This feature introduces a new command—clear ipc statistics—to clear and reset statistics that were previously reset only when the router image was reloaded. A new keyword—cumulative—has been added to the show ipc command. These two IPC updates provide improved IPC troubleshooting services.
History for the Clear IPC Statistics Feature
12.2(15)T
This feature was introduced.
12.2(28)SB
This feature was integrated into Cisco IOS Release 12.2(28)SB.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.
Contents
•
Information About Clear IPC Statistics
Information About Clear IPC Statistics
To use the Clear IPC Statistics feature, you should understand the following concept:
Cisco IOS IPC Services
The Cisco IOS version of IPC provides a reliable ordered delivery of messages using an underlying platform driver transport or User Datagram Protocol (UDP) transport protocol. Cisco IOS software IPC services allow line cards (LCs) and the central route processor (RP) in a distributed system, such as a Cisco 7500 series router, to communicate with each other by exchanging messages from the RP to the LCs. Communication messages are also exchanged between active and standby RPs. The IPC messages include configuration commands, responses to the configuration commands, and other events that are reported by an LC to the RP.
How to Clear IPC Statistics
This section contains the following tasks:
•
•
Clearing IPC Statistics
Perform this task to clear the IPC statistics to establish a baseline for troubleshooting issues with IPC services.
SUMMARY STEPS
1.
2.
3.
4.
DETAILED STEPS
Step 1
Enters privileged EXEC mode. Enter your password if prompted.
Router> enableStep 2
Use this privileged EXEC command with the status keyword to display the status of the local IPC server.
Router# show ipc statusIPC System StatusTime last IPC stat cleared : neverThis processor is the IPC master server.Do not drop output of IPC frames for test purposes.1000 IPC Message Headers Cached.Rx Side Tx SideTotal Frames 189 140Total from Local Ports 189 70Total Protocol Control Frames 70 44Total Frames Dropped 0 0Service UsageTotal via Unreliable Connection-Less Service 145 0Total via Unreliable Sequenced Connection-Less Svc 0 0Total via Reliable Connection-Oriented Service 44 70IPC Protocol Version 0Total Acknowledgements 70 44Total Negative Acknowledgements 0 0Device DriversTotal via Local Driver 0 0Total via Platform Driver 0 70Total Frames Dropped by Platform Drivers 0 0Reliable Tx StatisticsRe-Transmission 0Re-Tx Timeout 0Rx Errors Tx ErrorsUnsupp IPC Proto Version 0 Tx Session Error 0Corrupt Frame 0 Tx Seat Error 0Duplicate Frame 0 Destination Unreachable 0Out-of-Sequence Frame 0 Tx Test Drop 0Dest Port does Not Exist 0 Tx Driver Failed 0Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0Unable to Deliver Msg 0Buffer Errors Misc ErrorsIPC Msg Alloc 0 IPC Open Port 0Emer IPC Msg Alloc 0 No HWQ 0IPC Frame PakType Alloc 0 Hardware Error 0IPC Frame MemD Alloc 0Tx Driver ErrorsNo Transport 0MTU Failure 0Dest does not Exist 0Step 3
Use this privileged EXEC command to clear and reset all the IPC counters.
Router# clear ipc statisticsStep 4
Use this privileged EXEC command with the status keyword again to display the status of the local IPC server. Note the time since the statistics were cleared and that all the counters, except those counters that show the packets sent since the clearing, are now reset to zero.
Router# show ipc statusIPC System StatusTime last IPC stat cleared : 00:00:03This processor is the IPC master server.Do not drop output of IPC frames for test purposes.1000 IPC Message Headers Cached.Rx Side Tx SideTotal Frames 26 0Total from Local Ports 26 0Total Protocol Control Frames 0 0Total Frames Dropped 0 0Service UsageTotal via Unreliable Connection-Less Service 26 0Total via Unreliable Sequenced Connection-Less Svc 0 0Total via Reliable Connection-Oriented Service 0 0IPC Protocol Version 0Total Acknowledgements 0 0Total Negative Acknowledgements 0 0Device DriversTotal via Local Driver 0 0Total via Platform Driver 0 0Total Frames Dropped by Platform Drivers 0 0Reliable Tx StatisticsRe-Transmission 0Re-Tx Timeout 0Rx Errors Tx ErrorsUnsupp IPC Proto Version 0 Tx Session Error 0Corrupt Frame 0 Tx Seat Error 0Duplicate Frame 0 Destination Unreachable 0Out-of-Sequence Frame 0 Tx Test Drop 0Dest Port does Not Exist 0 Tx Driver Failed 0Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0Unable to Deliver Msg 0Buffer Errors Misc ErrorsIPC Msg Alloc 0 IPC Open Port 0Emer IPC Msg Alloc 0 No HWQ 0IPC Frame PakType Alloc 0 Hardware Error 0IPC Frame MemD Alloc 0Tx Driver ErrorsNo Transport 0MTU Failure 0Dest does not Exist 0
Displaying Cumulative IPC Statistics
Perform this task to display the IPC statistics with cumulative totals. The show ipc status command displays the IPC statistics generated after a clear ipc statistics command has been entered. The show ipc status command with the cumulative keyword displays the IPC statistics gathered since the router was rebooted, regardless of how many times the statistics have been cleared. If the IPC statistics have not been cleared, the output displayed by the cumulative keyword is the same as that displayed by the generic form of the show ipc status command.
SUMMARY STEPS
1.
2.
DETAILED STEPS
Step 1
Use this command to enter privileged EXEC mode. Enter your password if prompted.
Router> enableStep 2
Use this privileged EXEC command with the cumulative keyword to display the IPC statistics gathered since the router was rebooted, regardless of how many times the IPC statistics have been cleared.
Router# show ipc status cumulativeIPC System StatusTime last IPC stat cleared : 00:00:03This processor is the IPC master server.Do not drop output of IPC frames for test purposes.1000 IPC Message Headers Cached.Rx Side Tx SideTotal Frames 3473 184Total from Local Ports 3473 92Total Protocol Control Frames 92 54Total Frames Dropped 0 0Service UsageTotal via Unreliable Connection-Less Service 2449 0Total via Unreliable Sequenced Connection-Less Svc 970 0Total via Reliable Connection-Oriented Service 54 92IPC Protocol Version 0Total Acknowledgements 0 0Total Negative Acknowledgements 0 0Device DriversTotal via Local Driver 0 0Total via Platform Driver 0 92Total Frames Dropped by Platform Drivers 0 0Reliable Tx StatisticsRe-Transmission 0Re-Tx Timeout 0Rx Errors Tx ErrorsUnsupp IPC Proto Version 0 Tx Session Error 0Corrupt Frame 0 Tx Seat Error 0Duplicate Frame 0 Destination Unreachable 0Out-of-Sequence Frame 0 Tx Test Drop 0Dest Port does Not Exist 0 Tx Driver Failed 0Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0Unable to Deliver Msg 0Buffer Errors Misc ErrorsIPC Msg Alloc 0 IPC Open Port 0Emer IPC Msg Alloc 0 No HWQ 0IPC Frame PakType Alloc 0 Hardware Error 0IPC Frame MemD Alloc 0Tx Driver ErrorsNo Transport 0MTU Failure 0Dest does not Exist 0
Additional References
The following sections provide references related to IPC statistics.
Related Documents
IPC commands: complete command syntax, command mode, defaults, usage guidelines, and examples.
Cisco IOS Interface Command Reference, Release 12.2T
Standards
MIBs
None
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
RFCs
Technical Assistance
Command Reference
This section documents new and modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2T command reference publications.
clear ipc statistics
To clear all interprocess communication (IPC) statistics, use the clear ipc statistics command in privileged EXEC mode.
clear ipc statistics
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
12.2(15)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
The clear ipc statistics command clears all the IPC statistics and is useful for troubleshooting issues with IPC services.
Examples
The following example shows how to clear all of the statistics used by IPC services. A show ipc status command is issued first to display the current IPC counters for a local IPC server. The clear ipc statistics command is then entered to clear and reset the counters. A final show ipc status command is issued to show that all the counters, except those counters that show the packets sent since the clearing, are reset to zero.
Router# show ipc statusIPC System StatusTime last IPC stat cleared : neverThis processor is the IPC master server.Do not drop output of IPC frames for test purposes.1000 IPC Message Headers Cached.Rx Side Tx SideTotal Frames 189 140Total from Local Ports 189 70Total Protocol Control Frames 70 44Total Frames Dropped 0 0Service UsageTotal via Unreliable Connection-Less Service 145 0Total via Unreliable Sequenced Connection-Less Svc 0 0Total via Reliable Connection-Oriented Service 44 70IPC Protocol Version 0Total Acknowledgements 70 44Total Negative Acknowledgements 0 0Device DriversTotal via Local Driver 0 0Total via Platform Driver 0 70Total Frames Dropped by Platform Drivers 0 0Reliable Tx StatisticsRe-Transmission 0Re-Tx Timeout 0Rx Errors Tx ErrorsUnsupp IPC Proto Version 0 Tx Session Error 0Corrupt Frame 0 Tx Seat Error 0Duplicate Frame 0 Destination Unreachable 0Out-of-Sequence Frame 0 Tx Test Drop 0Dest Port does Not Exist 0 Tx Driver Failed 0Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0Unable to Deliver Msg 0Buffer Errors Misc ErrorsIPC Msg Alloc 0 IPC Open Port 0Emer IPC Msg Alloc 0 No HWQ 0IPC Frame PakType Alloc 0 Hardware Error 0IPC Frame MemD Alloc 0Tx Driver ErrorsNo Transport 0MTU Failure 0Dest does not Exist 0Router# clear ipc statisticsRouter# show ipc statusIPC System StatusTime last IPC stat cleared : 00:00:03This processor is the IPC master server.Do not drop output of IPC frames for test purposes.1000 IPC Message Headers Cached.Rx Side Tx SideTotal Frames 26 0Total from Local Ports 26 0Total Protocol Control Frames 0 0Total Frames Dropped 0 0Service UsageTotal via Unreliable Connection-Less Service 26 0Total via Unreliable Sequenced Connection-Less Svc 0 0Total via Reliable Connection-Oriented Service 0 0IPC Protocol Version 0Total Acknowledgements 0 0Total Negative Acknowledgements 0 0Device DriversTotal via Local Driver 0 0Total via Platform Driver 0 0Total Frames Dropped by Platform Drivers 0 0Reliable Tx StatisticsRe-Transmission 0Re-Tx Timeout 0Rx Errors Tx ErrorsUnsupp IPC Proto Version 0 Tx Session Error 0Corrupt Frame 0 Tx Seat Error 0Duplicate Frame 0 Destination Unreachable 0Out-of-Sequence Frame 0 Tx Test Drop 0Dest Port does Not Exist 0 Tx Driver Failed 0Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0Unable to Deliver Msg 0Buffer Errors Misc ErrorsIPC Msg Alloc 0 IPC Open Port 0Emer IPC Msg Alloc 0 No HWQ 0IPC Frame PakType Alloc 0 Hardware Error 0IPC Frame MemD Alloc 0Tx Driver ErrorsNo Transport 0MTU Failure 0Dest does not Exist 0Related Commands
show ipc
To display interprocess communication (IPC) statistics, use the show ipc command in privileged EXEC mode.
show ipc {nodes | ports [open] | queue | status [cumulative] | zones}
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
The Cisco IOS version of IPC provides a reliable ordered delivery of messages using an underlying platform driver transport or User Datagram Protocol (UDP) transport protocol.
Nodes
A node (referred to as a seat) is an intelligent element like a processor that can communicate using IPC services. A seat is where entities and ports reside. A seat manager performs all the interprocessor communications by receiving messages from the network and forwarding the messages to the appropriate port.
Ports
IPC communication endpoints (ports) receive and queue received IPC messages.
Queue
Use the queue keyword to display information about the IPC retransmission queue and the IPC message queue.
Status
Use the status keyword to display the IPC statistics that have been generated since a clear ipc statistics command was entered. The show ipc status command with the cumulative keyword displays the IPC statistics that have been gathered since the router was rebooted, regardless of how many times the statistics have been cleared.
Zones
The IPC zone manager allows more than one group of IPC seats to exist to enable direct communication between line cards and the route processor. Use the zones keyword to display the IPC zone and seat information.
Examples
The following is sample output from the show ipc command with the nodes keyword displaying the participating seats (nodes):
Router# show ipc nodesThere are 6 nodes in this IPC realm.ID Type Name Last LastSent Heard0.10000 Local IPC Master 0 00.1060000 RSP-CY RSP IPC card slot 6 9 790.1050000 RSP-CY RSP IPC card slot 5 21 220.1080000 RSP-CY RSP IPC card slot 8 21 221.10000 Local IPC Master: -Zone#1 0 02.10000 Local IPC Master: -Zone#2Table 1 describes the significant fields shown in the display.
The following is sample output from the show ipc command with the ports keyword displaying the local and registered IPC ports:
Router# show ipc portsThere are 11 ports defined.Port ID Type Name (current/peak/total)1.10000.1 unicast IPC Master:Zone1.10000.2 unicast IPC Master:Echo1.10000.3 unicast IPC Master:Control1.10000.4 unicast Remote TTY Server Port1.10000.5 unicast GALIOS RF :Activeindex = 0 seat_id = 0x2020000 last sent = 0 heard = 1635 0/1/16351.10000.6 unicast GALIOS RED:Activeindex = 0 seat_id = 0x2020000 last sent = 0 heard = 2 0/1/22.2020000.3 unicast GALIOS IPC:Card 2:Control2.2020000.4 unicast GALIOS RFS :Standby2.2020000.5 unicast Slave: Remote TTY Client Port2.2020000.6 unicast GALIOS RF :Standby2.2020000.7 unicast GALIOS RED:StandbyRPC packets: current/peak/total 0/1/17Table 2 describes the significant fields shown in the display.
The following is sample output from the show ipc command with the queue keyword displaying information about the IPC retransmission queue and the IPC message queue:
Router# show ipc queueThere are 0 IPC messages waiting for acknowledgement in the transmit queue.There are 0 IPC messages waiting for a response.There are 0 IPC messages waiting for additional fragments.There are 0 IPC messages currently on the IPC inboundQ.There are 0 messages currently in use by the system.The following is sample output from the show ipc command with the status keyword displaying information about the local IPC server:
Router# show ipc statusIPC System StatusTime last IPC stat cleared : neverThis processor is the IPC master server.Do not drop output of IPC frames for test purposes.1000 IPC Message Headers Cached.Rx Side Tx SideTotal Frames 189 140Total from Local Ports 189 70Total Protocol Control Frames 70 44Total Frames Dropped 0 0Service UsageTotal via Unreliable Connection-Less Service 145 0Total via Unreliable Sequenced Connection-Less Svc 0 0Total via Reliable Connection-Oriented Service 44 70IPC Protocol Version 0Total Acknowledgements 70 44Total Negative Acknowledgements 0 0Device DriversTotal via Local Driver 0 0Total via Platform Driver 0 70Total Frames Dropped by Platform Drivers 0 0Reliable Tx StatisticsRe-Transmission 0Re-Tx Timeout 0Rx Errors Tx ErrorsUnsupp IPC Proto Version 0 Tx Session Error 0Corrupt Frame 0 Tx Seat Error 0Duplicate Frame 0 Destination Unreachable 0Out-of-Sequence Frame 0 Tx Test Drop 0Dest Port does Not Exist 0 Tx Driver Failed 0Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0Unable to Deliver Msg 0Buffer Errors Misc ErrorsIPC Msg Alloc 0 IPC Open Port 0Emer IPC Msg Alloc 0 No HWQ 0IPC Frame PakType Alloc 0 Hardware Error 0IPC Frame MemD Alloc 0Tx Driver ErrorsNo Transport 0MTU Failure 0Dest does not Exist 0Table 3 describes the significant fields shown in the display.
The following example shows how to display cumulative IPC counters for the local IPC server. Note that the recent IPC clearing has not cleared the IPC counters because the cumulative keyword displays the IPC statistics that have been generated since the router was rebooted.
Router# show ipc status cumulativeIPC System StatusTime last IPC stat cleared : 00:00:05This processor is the IPC master server.Do not drop output of IPC frames for test purposes.1000 IPC Message Headers Cached.Rx Side Tx SideTotal Frames 3473 184Total from Local Ports 3473 92Total Protocol Control Frames 92 54Total Frames Dropped 0 0Service UsageTotal via Unreliable Connection-Less Service 2449 0Total via Unreliable Sequenced Connection-Less Svc 970 0Total via Reliable Connection-Oriented Service 54 92IPC Protocol Version 0Total Acknowledgements 0 0Total Negative Acknowledgements 0 0Device DriversTotal via Local Driver 0 0Total via Platform Driver 0 92Total Frames Dropped by Platform Drivers 0 0Reliable Tx StatisticsRe-Transmission 0Re-Tx Timeout 0Rx Errors Tx ErrorsUnsupp IPC Proto Version 0 Tx Session Error 0Corrupt Frame 0 Tx Seat Error 0Duplicate Frame 0 Destination Unreachable 0Out-of-Sequence Frame 0 Tx Test Drop 0Dest Port does Not Exist 0 Tx Driver Failed 0Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0Unable to Deliver Msg 0Buffer Errors Misc ErrorsIPC Msg Alloc 0 IPC Open Port 0Emer IPC Msg Alloc 0 No HWQ 0IPC Frame PakType Alloc 0 Hardware Error 0IPC Frame MemD Alloc 0Tx Driver ErrorsNo Transport 0MTU Failure 0Dest does not Exist 0The following is sample output from the show ipc command with the zones keyword displaying information about the IPC zones and seats:
Router# show ipc zonesThere are 3 Zones in this IPC realm.Zone ID Seat ID Name0 10000 IPC Default Zone1 10000 IPC TEST ZONE#12 10000 IPC TEST ZONE#2Table 4 describes the significant fields shown in the display.
Table 4 show ipc zones Field Descriptions
Zone ID
Zone number.
Seat ID
Seat number.
Name
Zone name.
Related Commands
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2003, 2006 Cisco Systems, Inc. All rights reserved.
