排除与JTAPI错误相关的CAD和Finesse桌面登录问题
目录
简介
本文档介绍桌面登录因JAVA电话API(JTAPI)问题而失败时的可能原因及其解决方法。
背景信息
登录Cisco Agent Desktop(CAD)和Finesse时看到的错误消息如下图所示。
- CAD上的错误消息
- Finesse上的错误消息
这些是在CAD/Finesse上桌面登录时遇到的最常见错误，原因有多种。
原因和解决方法
1.电话的MAC与CUCM上的RMCM应用用户不关联
必须在资源管理器联系管理器(RMCM)应用用户上的受控设备下选择IP联系中心(IPCC)扩展所在电话的MAC地址。
解决方案：将MAC地址与RMCM应用用户关联。在Cisco Unified Communications Manager(CUCM)上，导航至User Management > Application User。
如果电话的MAC已关联，则
- 取消MAC关联。
- Click Save.
- 重新关联MAC。
- Click Save.
您还可以尝试在所有JTAPI提供商上停止然后启动思科计算机电话集成(CTI)管理器服务。
2.分机移动(EM)配置文件未与RMCM用户关联
如果将EM与CUCM 8.0或更高版本一起使用，请将设备配置文件（而不是设备的MAC）与RMCM应用用户关联。
无论设备配置文件如何，您都可以将应用用户与关联，在CUCM中将Intra-Cluster multiple Login Behavior Extension Mobility Service参数设置为Auto Logout。
此操作有助于克服场景中注意到的CTI/JTAPI中的设计限制，当“集群内多登录行为分机移动服务”参数设置为“允许多次登录”时，就会出现这种情况。
- 座席在电话上登录EM，也登录CAD。
- 如果电话从CUCM注销，而座席仍登录EM，则电话不会重新注册。当座席关闭电话而不注销EM或网络断开时，可能会发生注册失败。
- 代理从其他设备登录EM。
- 当座席尝试登录CAD时，系统显示错误消息“Login failed due to a configuration error with your phone and JTAPI or Unified CM（由于电话和JTAPI或Unified CM的配置错误，登录失败）”。请与您的管理员联系”。
Bug CSCtx48427记录了此限制。
3.使用EM记录简档
如果CAD代理使用“分机移动”(Extension Mobility)，其中“设备配置文件”的目录号码已启用“自动呼叫记录”选项，则可能导致登录问题，如下图所示。
发生这种情况是因为当EM注销时，Cisco Unified Contact Center Express(UCCX)未发送deviceUnregisteredEvent消息。此问题在9.X之前的CUCM版本中发生。
Bugs CSCty63105和CSCty63127记录了这些限制。
此问题没有正确的解决方法，但已知在登录EM后重置电话设备在某些情况下可以正常工作。但是，这是间歇性的。
您还可以尝试：
- 禁用“录制”选项
- 从目录号码(DN)中删除录音配置文件
- 重置电话
永久修复是将CUCM升级到已解决错误的版本。
4.共享线路
IPCC分机不得是共享线路。
您可以通过导航Call Routing > Route Plan Report来检查CUCM。确保IPCC分机是唯一的。此映像中不应显示DN的其他实例。
此外，IPCC分机不得属于寻线组。
5. IPCC分机号必须位于前4行
IPCC分机必须位于代理设备的前4行。UCCX允许在代理设备上配置4条以上的线路，但只监控前4条线路（如果这些线路不共享）。
6.允许从CTI控制设备
确保在IPCC分机、电话和最终用户上选中Allow Control of Device from CTI复选框，如此图所示。如果它已关联，请尝试取消检查并重新检查。
7. RMCM角色
RMCM应用用户必须启用组Standard CTI Enabled，如果使用SIP电话，则Standard CTI Allow Control of Phones supporting Connected Xfer and Conf，如下图所示。
8.通用设备配置配置文件已启用IPV6
如果座席电话已分配公用设备配置文件，请确保IP编址模式字段已分配IPV4 Only 。要检查CUCM，请导航至Device > Device Settings > Common Device Configuration，如图所示。
9. RMCM子系统停滞在初始化状态
当RMCM子系统停滞在“初始化”(Initializing)中时，打开CAD应用程序时，您会遇到“初始化失败，重新启动应用程序”(Initialization failed， restart the application)错误。
如果CAD已打开，并且您输入要登录的凭证，则您会收到“Login failed due to a configuration error with your phone and JTAPI or Unified CM（由于电话和JTAPI或Unified CM的配置错误，登录失败）”。与管理员联系。
要进行检查，请导航至Cisco Unified CCX Serviceability > Tools > Network Services > Cisco Unified CCX Engine > Subsystem Manager。
RMCM是UCCX中的一个子系统，负责监控座席的状态并根据座席的技能和所需的队列技能选择座席。
要使RMCM恢复服务，必须采取以下必要措施：
- 如果RMCM子系统在任何一个节点上停滞在INITIALIZING状态，则
1.禁用CDS/HDS
2.重置复制
3.启用CDS/HDS。
- 重置UCCX上的RMCM用户密码，保存并重新启动UCCX引擎。如果是HA，请在两个节点上重新启动引擎。
- 创建新的RMCM提供程序用户。在UCCX上创建用户会将其传播到CUCM。
- 在UCCX 9.0.1、9.0.2.10000-71（9.0.2基础版）和9.0.2.11001-24(9.0.2 SU1)版中，如果JMX日志已满，RMC将停滞在初始化状态。
通过在受影响服务器的CLI上运行show status命令，检查磁盘登录是否已满。
admin:show status
Host Name : pub9
Date : Wed May 13, 2015 07:14:53
Time Zone : India Standard Time (Asia/Kolkata)
Locale : en_US.UTF-8
Product Ver : 9.0.2.11001-24
OS Ver : 5.0.0.0-2
License MAC : 0183a27e0bc7
Uptime:
07:14:54 up 3 days, 21:35, 1 user, load average: 0.74, 0.81, 0.67
CPU Idle: 88.12% System: 00.00% User: 09.90%
IOWAIT: 01.98% IRQ: 00.00% Soft: 00.00% Intr/sec: 263.37
Memory Total: 6097316K
Free: 2412372K
Used: 3684944K
Cached: 1990132K
Shared: 0K
Buffers: 297104K
Total Free Used
Disk/active 26657340K 15888436K 10493712K (40%)
Disk/inactive 27087452K 18957564K 7854696K (30%)
Disk/logging 92738892K 40350056K 47601872K (100%)
Bug CSCul18667和CSCun54915记录此行为。
根据缺陷CSCul18667删除JMX日志后，您需要联系技术支持中心(TAC)，以强制执行缺陷CSCun54915的解决方法。如果CSCun54915的解决方法未执行，则在服务器重新启动后，UCCX引擎不会启动。
- 如果您在CCX 8.5 SU1或更低版本上，当未按Bug CSCtq84602所述创建代理时，RMCM可能停滞在初始化状态。
您始终可以在所有CUCM节点上重新启动CTI-Manager。删除电话的身份信任列表(ITL)/证书信任列表(CTL)文件有帮助。
如果上述解决方法无用，请提交TAC案例。
反馈