开启跟踪

Introduction

Cisco智能联络管理(ICM)事件管理系统(EMS)为ICM进程提供一Application Program Interface (API)使用为了报告事件。本文讨论如何出现追踪为了帮助排除在Cisco ICM的问题故障。

Prerequisites

Requirements

Cisco 建议您了解以下主题：

• Cisco ICM

• 微软Windows NT版本4和Windows 2000

Components Used

本文档中的信息基于以下软件和硬件版本：

• Cisco ICM版本4.6.2及以上版本

• 微软视窗版本4和Windows 2000

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, make sure that you understand the potential impact of any command.

Conventions

Refer to Cisco Technical Tips Conventions for more information on document conventions.

出现追踪

有两种方式为了描述问题在Cisco ICM的API或通过出现追踪。

API

请使用API为了：

• 记录事件对本地EMS日志文件。

• 记录事件对Microsoft Windows NT/2000应用事件日志。

• 发送一个事件到存贮的数据库服务器在Cisco ICM数据库。

• 发送一个事件到发运的中央用户服务推进服务到Cisco技术支持中心(TAC)。

出现追踪

为了排除ICM问题故障，您能出现追踪与这些程序之一：

• 微软Windows NT或Windows 2000登记编辑

• Regacc实用程序

• OPCTest

• rttest

• Procmon

Note: 请务必关闭所有追踪，当完成时。并且，当您完成测试时，更加重要地，请勿打开进程命令窗口。这严重影响系统资源、特别是CPU利用率和内存。

Windows NT或Windows 2000登记编辑

完成这些步骤为了运行regedit32 ：

1. 选择Start > Run。

2. 键入regedt32为了打开Windows NT或Windows 2000登记编辑。

   这是登记编辑和EMS外围设备接口管理器(PIM)设置的示例。为了查看这些设置，连接到此路径：

   • Cisco ICM版本4.6和以下：

     Software\geotel\icr\cust_inst\ICRcomponenttype\EMS\CurrentVersion\
       Library\Processes

   • Cisco ICM版本5.0及以上版本：

     Software\Cisco Systems,Inc.\icm\cust_inst\ICMcomponenttype\EMS\
       CurrentVersion\Library\Processes

   理论上来讲，您在Registry Editor窗口的左边看到在右边的键和值。

3. 双击您要更改的值和DWORD Editor对话框显示。

4. 在Radix面板，请点击十六进制。

5. 更改值。

6. 单击 Ok。

此表显示您在登记编辑能更改的值。更改的多数共用值是AllLogFileMax、LogFileMax和TraceMask。不必须更改日志文件计数。

值	路径
EMSAllLogFileMax	所有EMS日志文件的总最大大小进程的。默认值是6000000/6 MB或2000000/2 MB。
EMSAllLogFileCount	EMS进程的日志文件的编号。默认值是20和通常不需要更改。
EmsLogFileMax	每EMS日志文件的最大大小。默认值是100000或100K。
EMSTraceMask	跟踪进程的位能有更多数据被记录对EMS日志文件。默认值是0。
EMSUserData	留下此空白。设置在procmon自动填充的跟踪位此字段。
EMSDisplaytoScreen	默认值是1.集到0为了不显示在处理窗口的数据。这较不强化中央处理，并且允许更加容易的pcAnywhere访问。

如果需要增加追踪为了排除故障，首先请确定相当数量在机器的空闲磁盘空间。如果有可用足够的磁盘空间，请做这些变动：

• 设置EMSAllLogFileMax为100 MB。

  Note: 首先请保证您有在安装Cisco ICM的驱动的足够的磁盘空间。

• 设置EmsLogFileMax为10 MB。

• 设置EMSDisplaytoScreen到0。

• 必须为您计划采集日志的每个进程做注册表更改。

  Note: 切记EMSAllLogfilesMTax是渐增的。如果设置EMSAllLogfilesMax为OPC、PIM1、PIM2和CTISVR的100 MB，您使用可用的推进空间的400 MB。

• 被建议的文件大小仅仅是参考点。大和繁忙的联系中心能潜在需要增加EMSAllLogfilesMax为了保证日志没有重写。

显示消息跟踪

一旦消息是获取的，请用Dumplog EMS工具显示他们。Dumplog读EMS日志文件，格式化事件数据，并且写格式化数据到输出文件。如果日志文件包括消息跟踪事件，每个被跟踪的消息在Dumplog输出中出现以解码的格式。

当数据是获取的时，请重置您更改的值。

Regacc实用程序

Regacc实用程序命令驱动，并且可以用于远程登录会话。键入regacc在prompt命令。此表列出最普通的regacc命令：

命令	什么它
regcd	更改当前注册表目录。
regdir	列出当前注册表目录。
regpwd	打印当前工作目录。
regset	设置在当前工作的注册表目录的一个新的注册值。
q	退出Regacc实用程序。
??	显示regacc的帮助。
命令/？	显示一个单个命令语法。

此示例显示如何访问包含进程出现追踪的目录。发出regcd命令为了更改目录，然后regdir命令为了显示工作目录的内容。

regcd
Cisco ICM version 4.6 and earlier:
regacc:regcd software\geotel\icr\cal\pg1a\ems\currentversion\library\processes

Cisco ICM version 5.0 and later:
regacc:regcd software\Cisco Systems, Inc.\icm\cal\pg1a\ems\currentversion\library\processes
regacc:regdir
		<KEY>       : DCServer
               <KEY>       : et
               <KEY>       : hsl
               <KEY>       : mds
               <KEY>       : mis
               <KEY>       : nm
               <KEY>       : nmm
               <KEY>       : opc
               <KEY>       : pgag
               <KEY>       : pim1
               <KEY>       : tsyp

Note: 此值在多条线路显示由于空间限制。

在这种情况下， PIM进程需要跟踪。regcd命令用于为了搬入pim1目录和regdir命令为了查看该目录内容。

regacc:  regcd pim1 
regacc:regdir

EMSAllLogFilesMax             : REG_DWORD: 1e8480
EMSBreakOnExit                : REG_DWORD: 0x0
EMSBreakOnInit                : REG_DWORD: 0x0
EMSDebugBreak                 : REG_DWORD: 0x1
EMSDisplayToScreen            : REG_DWORD: 0x1
EMSForwardLevel               : REG_DWORD: 0x1
EMSLogFileCountMax            : REG_DWORD: 0x3e8
EMSLogFileLocation            : REG_SZ: logfiles
EMSLogFileMax                 : REG_DWORD: 0x186a0 
EMSNTEventLogLevel            : REG_DWORD: 0x2
EMSTraceMask                  : REG_DWORD: 0x0
EMSUserData                   : REG_BINARY: FFFF

regset命令用于为了更改值。在本例中， EmsLogFileMax大小从5 MB更改到1 MB。

Note: 当您更改值时，您必须使用十六进制格式。

regacc:regset emsalllogfilesmax 1e8480 
emsalllogfilesmax 1e8480                    :REG_DWORD:  1e8480

OPCTest、Rttest和Procmon

这是用于追踪的进程的解释。

OPCTest

您能使用OPCTest为了出现仅OPC进程的追踪。出现各自的跟踪仪表用debug命令。在OPCTest，请键入debug/?关于命令的更多信息。

如果进程断言或，如果服务被终止，您指定的选项关闭。使用regacc或regedt32命令为了增加EMSAllLogfilesMax和EMSLogFilesMax是仍然必要的，以便数据在输出中不包裹。

为了启用跟踪从OPCTest，请发出调试/noall命令。当您完成测试时，请勿忘记使所有处理窗口减到最小。

请参见使用OPC测试Line命令工具关于OPCTest的更多信息。

Rttest

您能发出rttest命令为了出现仅跟踪RTR进程的。请使用debug命令为了出现各自的跟踪仪表。在rttest，请键入debug/?关于命令的更多信息。

如果进程断言或，如果服务被终止，您指定的选项关闭。使用regacc或regedt32命令为了增加EMSAllLogfilesMax和EMSLogFilesMax是仍然必要的，以便数据在输出中不包裹。

请参见Cisco ICM rttest实用程序关于rttest的更多信息。

Procmon

您能使用procmon出现在pims、mis和ctiserver进程的追踪。不幸地，没有出现的标准的选项这些进程的追踪。例如， Definity交换机的选项是调试，而开始VRU PIM跟踪，您必须设置跟踪仪表和使用ltrace命令为了查看跟踪仪表。为了查看关于使用的更多信息procmon，键入此在DOS提示符：

procmon custname device process

发出mhelp命令为了列出单个进程的选项。

这是选项的示例Definity交换机的：

C:\>procmon cust pg2a pim1
>>>>debug /?
Usage: acd_debug [/noagent] [/agent] [/agent+] [/agent++] [/nobri] [/bri]
                 [/bri+] [/nocall] [/call] [/call+] [/nocms] [/cms] [/cms+]
                 [/noconfig] [/config] [/nocv] [/cv] [/noerror] [/error]
                 [/nohb] [/hb] [/ken] [/ken+] [/noken] [/noopc] [/opc]
                 [/nopost] [/post] [/nosim] [/sim] [/notg] [/tg] [/notimer]
                 [/timer] [/notp] [/tp] [/tp+] [/trace] [/novq] [/vq] [/vq+]
                 [/warning] [/nowarning] [/all] [/noall] [/set UserSetBit]
                 [/help] [/?]

Regacc实用程序被建立到procmon。在procmon内，您能发出mhelp命令为了查看regacc命令。

如果进程断言或，如果服务被终止，您指定的选项关闭。使用regacc或regedt32命令增加EMSAllLogfilesMax和EMSLogFilesMax是仍然必要的，以便数据在输出中不包裹。

要启用跟踪从procmon，请输入调试/noall。当您完成测试时，请勿忘记使所有处理窗口减到最小。

请参见使用远程进程监控台(Procmon)关于procmon的更多信息。

Related Information

• 使用OPC测试Line命令工具
• Cisco ICM rttest实用程序
• 使用远程进程监控台(Procmon)
• 如何使用Dumplog程序
• Technical Support - Cisco Systems