排除CM电话子系统和应用管理器服务部分服务问题

简介

本文档介绍如何对CM电话子系统和应用服务部分服务问题进行故障排除。

先决条件

要求

Cisco 建议您了解以下主题：

• 思科统一联系中心快捷版(UCCX)
• 思科统一通信管理器 (CUCM)
• 实时监控工具
• 实时报告工具

使用的组件

本文档不限于特定的软件和硬件版本。

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

UCCX引擎是两种管理器服务的一部分：

1.子系统管理器

2.经理经理

Unified CM电话子系统是子系统管理器下的子组件。

应用程序管理器服务是管理器下的子组件。

CM电话子系统 

CM电话子系统是一个JTAPI客户端，您可以在其中提供Unified CM电话提供商信息、计算机电话接口(CTI)端口组信息、Unified CM电话触发信息以及重新同步Unified CM电话信息。

UCCX和CUCM之间的任何通信都驻留在JTAPI上。CUCM上的CTI管理器响应来自UCCX的JTAPI请求。

JTAPI提供程序在UCCX上创建，并在CUCM上复制。

快速检查：

登录到CCX Administration页面。导航到System > CM Configuration。它列出有关axl、jtapi和rmcm提供程序的信息。在此页面上创建的JTAPI用户名和密码在CUCM上的应用用户下复制，如图所示。

注意：始终建议将本地CUCM节点指向列表顶部，然后指向远程CUCM节点。每当代理创建CTI端口或路由点时，都会在CUCM上的相应JTAPI用户下分配该端口。

快速检查：

登录到CUCM Admin Page > User Management > Application User，以验证在UCCX中创建的JTAPI和rmcm提供程序是否反映在CUCM上。

最常见原因

• 某些CTI端口或触发器似乎未注册
• 如果CCX上的触发器配置错误
• 应用程序上的触发器没有呼叫控制组
• 与触发器存在相同的转换模式
• CTI路由点，根据网络配置包含/不包含分区和设备池
• 触发器已从CUCM中删除

提示：当您倾向于删除某些触发器或cti端口时，请完全遵循这些建议。 

从UCCX删除触发器 — 此过程会自动删除CUCM上相应的CTI路由点
从UCCX删除控制组（CTI端口） — 这会自动从CUCM删除相应的电话设备（CTI端口）

故障排除

方法 1：

借助RTMT工具，您可以轻松验证触发器/CTI端口注册状态和摘要。使用管理员凭据登录到RTMT。选择RTMT页面左下方的Cisco Unified CCX。

选择CUCM Telephony Data。列出了几个选项，例如触发器、呼叫控制组、CTI端口和摘要。

选择其中一个选项以验证其状态。例如，触发器。将会弹出一个对话框，可以选择服务器（对于HA，同时列出pub和sub）。 选择服务器名称，然后单击完成，如图所示。

在本例中，已选择triggers选项，因此显示了触发器及其各自的状态以及建议。

选择摘要选项时的摘要状态。

呼叫控制组状态。

CTI端口状态。

如图所示，可以从CCX管理页面>子系统>触发器验证触发器状态。

方法 2：

在CCX Admin页面，您可以执行数据检查和数据重新同步。登录到CCX管理页面> Cisco Unified CM电话>数据同步，如图所示。

选择Triggers、Call Control Groups、CM Telephony Users，然后选择Data Check，这将花费相当多的时间，具体取决于触发器、CCG和服务器上配置的用户的数量。

“数据”检查选项显示选定组件的状态。一旦对错误执行了正确的操作，您可以执行数据重新同步，建议在呼叫量较少的期间运行数据重新同步。

方法 3：

以防任何组件发生错误。检查UCCX的CM配置页面以获取提供程序列表，并在所有这些CUCM提供程序上重新启动CTI服务，然后在UCCX节点上重新启动CCX引擎。

方法 4：

登录到RTMT > Trace and Configuration > Collect Logs。

UCCX ：

• Cisco Unified CCX引擎(MIVR)
• JTAPI日志

CUCM:

• CallManager
• CTI Manager

RTMT常见错误：

问题 1：

触发器7777在触发器状态上有配置错误，呼叫控制组未知。

在CCX Admin页面上验证触发器状态。导航至子系统> Cisco Unified CM电话>触发器。

选择触发器后，屏幕上会弹出一个对话框。

单击OK，注意此处未添加呼叫控制组。

解决方案：

从下拉列表中选择更新呼叫控制组。验证触发器状态。如果问题仍然存在，请重新启动CUCM上的CTI管理器服务和UCCX上的CCX引擎

问题 2：

Trigger as out of service出现在2个方案中。在CUCM上删除的CTI路由点或CTI路由点上的目录号码不存在。

情形 1：

原因：在CUCM上，CTI路由点被删除。

登录到CM Admin page > Device > CTI Route Point，然后检查路由点是否存在。在这种情况下，rtmt上列出的路由点不存在，如图所示。

但是，触发器存在于CCX上。

在Cisco Unified CM Telephony Data synchronization页面上执行数据检查，并观察错误为“无法在Cisco Unified CM上创建”。

可能的原因是路由点已删除，但CUCM上仍存在目录编号。

登录到CM Admin页面，选择Call Routing > Route Plan Report，然后使用目录编号进行搜索 — >单击delete

返回到CCX管理页面Subsystems > Cisco Unified CM Telephony > Data Synchronization > Data Resync，或者，如果需要特定路由点/触发器，请使用相同的设备名称在CUCM上重新创建CTI路由点。

如果问题仍然存在，请重新启动CUCM上的CTI管理器服务和UCCX上的CCX引擎。

方案 2：

原因：在CUCM上删除目录编号20211，或者设备从目录编号解离。

在这种情况下，CTI路由点显示在device > CTI route point下。但是，您可以注意到扩展名不存在。在UCCX上执行数据检查显示与上一个场景“Does not exist on Cisco Unified CM”相同的错误，但显示的是控制器号。

解决方案：

导航到相应的CTI路由点，并在CUCM上添加目录编号或在UCCX上执行数据重新同步。 

如果问题仍然存在，请重新启动CUCM上的CTI管理器服务和UCCX上的CCX引擎。

问题 3：

CTI端口状态显示为停止服务：

与各CTI端口关联的呼叫控制组显示部分服务。

同样，摘要页面包含CTI端口77661呼叫控制组id=5的错误。

原因：CTI端口已从设备取消关联或在CUCM上删除。

解决方案：

如果CCX引擎未解决问题，请重新启动。重新创建受影响的呼叫控制组，然后重新启动CUCM上的CTI管理器服务和UCCX上的CCX引擎。

应用管理器服务

在Application Management下，尤其可以添加、配置、复制、删除或刷新特定应用程序，关联触发器、脚本和其他参数。

该映像将应用管理器状态表示为部分服务。

Application Manager服务部分服务的最常见原因是：

• 之前分配给应用程序的脚本管理中不存在该脚本
• 脚本无效
• 应用程序无法加载特定脚本

故障排除

方法 1：

使用Real Time Reporting Tool，可以轻松识别受影响的应用程序。

实时报告工具(RTR)是一个Java应用程序，因此需要在客户端计算机上安装Java运行时环境(JRE)。登录到CCX管理页面，然后导航到工具> Real Time Reporting，然后选择下载。

注意：要运行Real Time Reporting客户端，请在Java控制面板的“安全”选项卡中，将Unified CCX服务器的完全限定域名(FQDN)添加到例外站点列表。对于高可用性部署，请将两个Unified CCX服务器的FQDN添加到例外站点列表。

1.在系统上启动RTR应用，并使用Unified CCX管理员或主管凭证登录。

2.定位至“报表”>“应用程序”，然后选定最后一列有效。

对于有问题的应用程序，“有效”标志显示为false

方法 2：

借助日志。跟踪级别设置

导航到Cisco Unified CCX可维护性>跟踪>配置。选择Cisco Unified CCX Engine并设置跟踪：

APP_MGR - Debug, Xdebug1

ENG - Debug, Xdebug1

ICD_CTI - Debug, Xdebug1

SS_TEL - Debug, Xdebug1

重新启动CCX引擎并从RTMT收集Cisco Unified CCX引擎日志。对日志文件应用“%MIVR-APP_MGR”筛选器以查找根本原因。

从CLI。

file search activelog /uccx/log/MIVR/* "%MIVR-APP_MGR" recurs ignorecase

使用这两种方法之一，您可以获得有问题的应用程序。

导航到UCCX管理页面上的应用管理，验证有问题的应用并进行必要的更改。重新启动CCX引擎并验证状态。