简介
本文档介绍查看语音操作系统(VOS)节点和电话/网关/第三方服务器之间的跟踪的流程。
当您在Cisco Unified Communications Manager(CUCM)、Cisco Unified Contact Center Express(UCCX)、Cisco Unity Connection(CUC)或即时消息和在线状态(IM&P)中排除故障时,有时需要收集数据包来解决VOS服务器上的网络接口上发送和发送的间歇性问题。此处显示了CUCM 11.X版的命令和屏幕截图,同样适用于CUC、UCCX和IM&P(11.X及更高版本)。
先决条件
要求
Cisco 建议您了解以下主题:
- CUCM
- UCCX
- CUC
- IM&P版本11.X及以上版本
使用的组件
本文档中的信息基于Call Manager 11.X。
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您的网络处于活动状态,请确保您了解所有命令的潜在影响。
配置
正常接口数据包捕获
步骤1.连接到CUCM主机。
使用安全外壳(SSH)客户端(如Putty/SecureCRT)连接到CUCM节点,如图所示。
步骤2.准备捕获跟踪文件。
现在,在管理提示符后,您可以开始准备捕获网络实用程序以捕获数据包,如图所示。
utils network capture [Currently available option]
utils network capture-rotate [New feature available from CUCM, UCCX, CUC, IMP version 11.X]
步骤3.对于通常的捕获,可能希望将所有大小从ALL地址到ALL地址的所有数据包收集到一个名为PC.cap的捕获文件中。为此,只需在管理CLI上运行utils network capture eth0 file packets count 100000 size all,如图所示。
步骤4.按Ctrl + C以停止捕获。
- 捕获到文件时数据包数量有限(100000)(使用上述选项进行限制)
- 难以捕捉间歇性问题
现在,如果您要捕获超过100000个数据包或出现间歇性问题,那么此增强方法用于收集CUCM接口上的捕获,该怎么办?
增强型数据包捕获
功能
- 捕获超过100000个数据包
- 根据设置的参数持续捕获
- 捕获间歇性问题
- 利用更大的通用分区
- 限制:不占用整个公共分区或触发LowWaterMark条件
配置
可以使用此方法来添加旋转文件参数:
admin:utils network capture-rotate file PC maxfiles 40 sizeperfile 20
Syntax:
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.
注意:如果提供了主机,则不提供src或dest。
该图显示了一个成功的数据包捕获旋转命令:
验证
当前没有可用于此配置的验证过程。
故障排除
本部分提供了可用于对配置进行故障排除的信息。
低水印(LWM)表示日志(通用)分区上的可用磁盘空间不足。如果公共分区超过(LWM - 5),则阻止捕获。
点击LWM时,捕获失败,如图所示。
如果数据库关闭,且对LWM的查询失败,则发布的错误如图所示。
如果查询LWM失败,则增强型捕获命令会由于数据库错误而失败。这些命令从数据库中查询LWM配置并减去5,因此,如果数据库关闭,则假设LWM为90%并打印警告。
用于增强捕获的文件格式:
<filename>.cap0, <filename>.cap1
<filename>.cap00, <filename>.cap01
用于收集数据包捕获的CLI命令:
file get activelog platform/cli/*.cap*
从实时监控工具(RTMT)收集数据包捕获。 导航到System > Trace & Log central > Collect files > Packet Capture Logs,如图所示。
注意:为了恢复公用分区空间,可能需要删除捕获文件。
注意:如果CLI会话已关闭,而rotate命令处于活动状态,则数据包捕获将在窗口关闭时停止(并保存)。
数据包捕获在删除之前仍保留在磁盘上。建议定期删除这些捕获。
- 要列出所有捕获,请运行file list activelog platform/cli/*.cap*
- 要下载捕获,请运行file get activelog platform/cli/*.cap*
- 要删除捕获,请运行file delete activelog platform/cli/*.cap*
如何通过SSH FTP(SFTP)服务器下载捕获,如图所示。