The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document describes the process in order to see the trace between Voice Operarting System (VOS) node and Phone/Gateway/3rd Party Server.
When you troubleshoot in Cisco Unified Communications Manager (CUCM), Cisco Unified Contact Center Express (UCCX), Cisco Unity Connection (CUC) or Instant Message and Presence (IM&P), it is sometimes necessary to collect packets for intermittent issues which are being sent to and from the network interface on a VOS server. The commands and screenshots are shown for CUCM version 11.X, the same can be applied for CUC, UCCX and IM&P (from 11.X and above).
Cisco recommends that you have knowledge of these topics:
IM&P Version 11.X and above
The information in this document is based on Call Manager 11.X.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.
Normal Interface Packet Captures
Step 1. Connect to the CUCM Host.
With the use of an Secure Shell (SSH) client like Putty/SecureCRT connect to the CUCM node as shown in the image.
Step 2. Prepare a Capture Trace File.
Now, after admin prompt, you can start to prepare a capture network utility in order to capture packets as shown in the image.
utils network capture [Currently available option]
utils network capture-rotate [New feature available from CUCM, UCCX, CUC, IMP version 11.X]
Step 3. For a usual capture, one might want to collect ALL packets of ALL sizes from and to ALL address into a capture file called PC.cap. In order to do this, simply run utils network capture eth0 file packets count 100000 size all on the admin CLI and as shown in the image.
Step 4. Press Ctrl + C in order to stop captures.
Limited number of packets (100000) when you capture to file (Limitation with above option)
Difficult to capture intermittent issues
Now, what if you want to capture packets more than 100000 or for intermittent issues, so this Enhancement method is used to collect captures on CUCM interface.
Enhanced Packet Capture
Capture more than 100000 packets
Capture continuously based on set parameters
Capture intermittent issues
Leverage larger common partitions
Restriction/Limitation: Do not consume entire common partition or trigger LowWaterMark condition
You can use this method in order to add the rotating file parameters:
admin:utils network capture-rotate file PC maxfiles 40 sizeperfile 20
utils network capture-rotate [options]
file fname - output the information to a file //Note: The file will be saved in platform/cli/fname. fname should not contain the "." character
size bytes - the number of bytes of the packet to capture. //Note: Valid values include any number up to 65535 or ALL. The default will be ALL.
sizePerFile megabytes - the sizePerFile sets the value for the size of the log files. //Note: The default value of sizePerFile is 25 MB.
maxFiles num - the maxFiles indicates the maximum number of log files to be created. // Note: The default value of maxFiles is 10.
src addr - the source address of the packet as a host name or IPV4 address
dest addr - the destination address of the packet as a host name or IPV4 address
port num - the port number of the packet (either src or dest)
host protocol addr - the protocol should be one of the following: ip/arp/rarp/all. The host address of the packet as a host name or IPV4 address. This option will display all packets to and fro that address.
Note: If host is provided, do not provide src or dest.
The image shows a successful Packet Capture rotate command:
There is currently no verification procedure available for this configuration.
This section provides information you can use in order to troubleshoot your configuration.
Low Watermark (LWM) indicates that the available disk space is low on the log (Common) partition. If Common Partition exceeds (LWM - 5), capture is prevented.
When LWM is hit, capture fails as shown in the image.
If Database is down and query fails for LWM, the error published is as shown in the image.
If query for LWM fails, enhanced capture commands fails with Database error. These command queries LWM configuration from the database and subtracts 5, so if database is down, it assumes LWM is 90% and print warning.