通过UCCE上的SPOG排除配置更改故障

简介

本文档介绍如何通过Unified Contact Center Enterprise(UCCE)上的单一窗格(SPOG)对配置更改进行故障排除。

先决条件

要求

Cisco 建议您了解以下主题：

• 统一联系中心企业版(UCCE)
• 套装联络中心企业版(PCCE)

使用的组件

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

• 统一联络中心企业版(UCCE)版本12.6(1)
• 套装联络中心企业版(PCCE)版本12.6(1)

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

背景信息

在Package Contact Center Enterprise(PCCE)解决方案版本12.x中，该解决方案的所有组件均由单一平台(SPOG)控制，该平台托管在主要管理工作站(AW)服务器中。

问题

代理通过B端SPOG重新启动失败，并抛出错误消息：发生错误。.意外的数据库错误。请稍后重试或与系统管理员联系。

AW Tomcat log print错误消息：errorMsg: Cannot find Peripheral for this Agent:

CCBU log exception:[exception=com.cisco.ccbu.api.jaxb.error.ApiException: Error adding agent primary record info to transaction.: RestCdbError[ count: 0 dataVal:  
errorCaption:  errorCode: 42115 errorMsg: Cannot find Peripheral for this Agent errorMsgDetail:  errorPrefix:  errorSuffix:  fieldName:  
fieldNum: 0 fieldType: 0 loggerErrorCode: 0 tableName: Agent ]]: 
There was an uncaught and unrecognized exception thrown by the REST API

解决方案

在具有单个管理站点的UCCE/PCCE部署中通常会出现此问题，并且通过广域网(WAN)将管理和数据服务器配对。在此设置中，存在指定的主管理和数据服务器以及一个或多个辅助管理和数据服务器。如果管理和数据服务器之间存在WAN连接问题，我们可以看到实时延迟更新或辅助端的配置数据。这会导致辅助管理和数据服务器上的数据损坏，如果从辅助管理和数据服务器尝试进行任何配置更改，都会引发错误。

注：根据UCCE或PCCE解决方案设计，每个站点至少有一台（通常为两台）管理和数据服务器，作为站点的实时数据管理和数据服务器。主管理和数据服务器维护与实时服务器的活动连接，通过该连接接收实时数据。如果站点有两个管理和数据服务器，则当主管理和数据服务器因任何原因无法运行时，管理客户端会配置为自动切换到辅助管理和数据服务器。辅助管理和数据服务器还维护与实时服务器的连接；但是，这些连接会一直保持空闲状态，直到需要为止。

步骤

在出现问题的管理和数据服务器的维护窗口中执行此过程。

第1步登录到Administration & Data Server。
第2步通过双击桌面快捷图标Unified CCE Web Setup打开Web Setup（Web设置）工具。
第3步从Administration & Data Server List页面中，选择要编辑的服务器的超链接名称（或选择服务器名称前面的复选框），然后点击Edit。
第4步点击Deployment页面上的Next。
第5步点击Role页面上的Next。
第6步在Administration & Data Server Connectivity页中，记录Primary Administration & Data Server和Common Site Name for Primary / Secondary Administration & Data Server保存的值，因为稍后在过程中需要此信息。
第7步将Primary Administration & Data Server值更改为Secondary Administration & Data Server值。
第8步将Primary / Secondary Administration & Data Server的Common Site Name值更改为临时值，然后点击Next。
第9步点击Database and Options页上的Next。
第10步点击中央控制器连接页面上的下一步。
第11步在Summary页面上，单击Finish以保存任何编辑。
第12步通过双击桌面快捷方式图标Unified CCE Service Control打开Service Control。
第13步点击Cycle以重新启动Distributor服务。
第14步通过双击桌面快捷图标Unified CCE Administration Tools打开Administration Tools文件夹。
第15步在Administration Tools文件夹中运行Initialize Local Database实用程序。出现Initialize Local Database主窗口。
第16步选择Start传输数据。复制数据时，屏幕将显示为每个表处理的行数。
第17步传输完成后，选择Close退出。
第18步在SPOG页面上重新启动代理并检验更改成功。
第19步重新登录Web Setup工具并导航到Administration & Data Server Connectivity页面。
第20步将Primary Administration & Data Server值恢复为第6步中记录的值。
第21步对Primary/Secondary Administration & Data Server值的Common Site Name重复第20步，然后点击Next。
步骤22重复步骤9到13。

相关信息

• 思科统一联系中心企业版解决方案设计指南，版本12.6(1)
• Cisco Unified Contact Center Enterprise安装和升级指南，版本12.6(1)
• 思科技术支持和下载