UCCX备份失败故障排除，并显示错误消息

简介

本文档介绍如何对Unified Contact Center Express(UCCX)无法备份并显示错误消息进行故障排除。

先决条件

要求

Cisco 建议您了解以下主题：

• Unified Contact Center Express
• 通过SSH客户端的CLI访问
• 了解NTP

使用的组件

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

• UCCX 12.5.1

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

背景信息

UCCX已停止通过计划任务进行备份。当您尝试执行手动备份作业时，备份失败，并显示错误消息“ERROR: UCCX DBReplication is not set properly， Backup completed unsuccessfully.”（错误：未正确设置UCCX DBReplication，备份未成功完成。）

UCCX备份失败

故障排除

首先，您需要通过从所有节点Pub和Sub请求CLI命令的输出来确认服务器的运行状况：

• show status
• utils诊断测试
• show network cluster
• utils ntp status
• 实用程序复制状态
• utils dbreplication runtimestate
• utils uccx复制状态
• utils uccx数据库运行状况检查
• utils uccx healthcheck all

在这些CLI命令的输出中，大多数问题与NTP或DBReplication相关。

为获得最佳性能，PUB必须与NTP服务器同步的推荐层级为4且更低。层数大于5可能导致同步问题，进而影响DBReplication。有关NTP故障排除的详细信息，请参阅文章Troubleshoot NTP on Unified Communications Manager。链接文章适用于Unified Communications Manager，但适用于所有VOS产品。

下面是DBReplication定义，用于了解您要查看的DBReplication状态值。

DBR复制状态定义

有关DBReplication故障排除的详细信息，请参阅文章排除CUCM数据库复制问题。链接文章适用于Unified Communications Manager，但同样适用于UCCX。

在此场景中，UCCX服务器的运行状况良好。

NTP同步状态

DBR复制状态

日志收集

在清除可能导致问题的运行状况和其他组件后，您可以继续收集日志中的某些其他数据，这些数据是在尝试备份失败时生成的。从显示错误消息的同一屏幕上，您可以下载生成的CCX组件日志文件，该文件与失败的备份一致。

CCX组件日志

日志分析

从日志中。

日志文件:
=====================================================
服务器：
功能：UCCX
组件：CCXCOMPONENT
完成时间：2021-10-01-12-03-21
结果代码：24-Ontape无法备份UCCX数据库
结果字符串：ERROR
=====================================================

它可以备份组件，开始备份。

2021-10-01 12:03:15 ：信息：-------------开始Unified CCX DB DoBackup(db_do_backup.py)-------------

然后，检查可用的内存。

2021-10-01 12:03:15 ：信息：可用于Unified CCX数据库备份的空间= 85622509568字节
2021-10-01 12:03:15 ：信息：为Unified CCX数据库备份找到足够的磁盘空间

之后，它会检测到它是高可用性(HA)设置。

2021-10-01 12:03:15 ：信息：这是UCCX高可用性设置
2021-10-01 12:03:15 ：信息：Unified CCX集群中有两个节点

启动备份。

2021-10-01 12:03:15 ：信息：高可用性 — 发布服务器节点。备份已启动

2021-10-01 12:03:15 ：信息：正在创建Unified CCX数据库的磁带备份……
2021-10-01 12:03:15 ：信息：正在执行[源/opt/cisco/uccx/bin/uccx_ids.env; ontape -v -s -L 0 -t STDIO > /common/drf/ccx_comps/uccx_db/ontape_uccx_backup.gz] ...

但是，它在此阶段失败。

2021-10-01 12:03:19 ：信息：执行的结果[源/opt/cisco/uccx/bin/uccx_ids.env ;ontape -v -s -L 0 -t STDIO > /common/drf/ccx_comps/uccx_db/ontape_uccx_backup.gz],returnCode :[256]，输出：[使用备份和还原过滤器/bin/gzip -c。
存档失败 — ISAM错误：备份存档时出错。

计划结束。]
2021-10-01 12:03:19 ：信息：磁带备份失败。
2021-10-01 12:03:19 ：信息： -----退出Unified CCX DB DoBackup(db_do_backup.py)，并返回Code = 24 ：未成功-----
2021/10/01 12:03:19: DO_Backup数据库脚本无法工作

纠正措施

在CLI中重新启动这些服务：

• DRF主和DRF本地服务
  • utils service restart Cisco DRF Master（在PUB上）
  • utils service restart Cisco DRF Local（在两个节点上）
• 数据库服务
  • utils service restart Cisco Unified CCX Database（在两个节点上）

之后，运行手动备份并验证是否成功。系统将显示一条成功的消息。

备份已完成

手动成功备份后，计划任务也开始工作。

相关信息

• 排除Unified Communications Manager上的NTP故障
• 排除CUCM数据库复制问题
• 思科技术支持和下载