エラーメッセージで失敗するUCCXバックアップのトラブルシューティング

はじめに

このドキュメントでは、Unified Contact Center Express(UCCX)がバックアップに失敗し、エラーメッセージが表示される問題をトラブルシューティングする方法について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

• Unified Contact Center Express
• SSHクライアント経由のCLIアクセス
• NTPの理解

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアのバージョンに基づくものです。

• UCCX 12.5.1

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

UCCXはスケジュールされたタスクを介したバックアップを停止しました。手動バックアップジョブを実行しようとすると、バックアップが失敗し、「ERROR: UCCX DBReplication is not set properly, Backup completed unsuccessfully」というエラーメッセージが表示されます。

UCCXのバックアップに失敗しました

トラブルシューティング

まず、すべてのノードPubおよびSubからのCLIコマンドの出力を要求して、サーバの状態を確認する必要があります。

• show status
• utils diagnose test
• ネットワーククラスタの表示
• utils ntp status
• utils dbreplicationステータス
• utils dbreplication runtimestate
• utils uccx dbreplicationステータス
• utils uccx database healthcheck
• utils uccx healthcheck all（uccx healthcheckすべて）

これらのCLIコマンドの出力のうち、問題の大部分はNTPまたはDBReplicationに関連しています。

最適なパフォーマンスを得るために、PUBがNTPサーバと同期する必要がある推奨ストラタムレベルは4以下です。ストラタムが5を超えると、同期の問題が発生し、DBReplicationに影響を与える可能性があります。NTPのトラブルシューティングの詳細については、『Unified Communications ManagerでのNTPのトラブルシューティング』を参照してください。リンク先の記事はUnified Communications Manager向けですが、すべてのVOS製品に適用されます。

DBReplicationステータスに対して表示する値を理解するためのDBReplication定義を次に示します。

DBReplicationステータスの定義

DBReplication Troubleshootingの詳細については、『CUCMデータベースレプリケーションの問題のトラブルシューティング』を参照してください。リンクされている記事はUnified Communications Manager用ですが、UCCXにも適用されます。

このシナリオでは、UCCXサーバの状態は良好でした。

NTP同期ステータス

DBReplicationステータス

ログ収集

問題を引き起こす可能性があるヘルスおよびその他のコンポーネントをクリアした後で、失敗したバックアップの試行中に生成されたログに追加データを収集できます。エラーメッセージが表示された同じ画面から、生成されたCCXコンポーネントログファイルをダウンロードします。このファイルは、失敗したバックアップと同期しています。

CCXComponentログ

ログ分析

ログから。

ログ ファイル：
0.=====================================================
サーバ:
機能：UCCX
コンポーネント：CCXCOMPONENT
完了時刻：2021-10-01-12-03-21
結果コード：24-Ontape failed to backup UCCX DB
結果ストリング：エラー
0.=====================================================

コンポーネントをバックアップでき、バックアップを開始します。

2021-10-01 12:03:15 :INFO: ------------- Begin Unified CCX DB DoBackup(db_do_backup.py) -------------

次に、使用可能なメモリを確認します。

2021-10-01 12:03:15 ：情報：Unified CCX DBバックアップに使用できる空き領域= 85622509568バイト
2021-10-01 12:03:15 :INFO: Enough disk space found for Unified CCX DB backup

その後、それがハイアベイラビリティ(HA)セットアップであることを検出します。

2021-10-01 12:03:15 :INFO：これはUCCXハイアベイラビリティ設定です
2021-10-01 12:03:15 ：情報：Unified CCXクラスタに2つのノードがある

バックアップが開始されます。

2021-10-01 12:03:15 :INFO: HA – パブリッシャノード。バックアップ開始

2021-10-01 12:03:15 :INFO: Creating Ontape Backup of Unified CCX DB...
2021-10-01 12:03:15 :INFO: Executing [source /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 :INFO：実行結果[source /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], Output :[Using the backup and restore filter /bin/gzip -c.
アーカイブに失敗しました – ISAMエラー：アーカイブバックアップ中にエラーが発生しました。

プログラム終了。]
2021-10-01 12:03:19 :INFO: Ontape Backup failed.
2021-10-01 12:03:19 :INFO: ----- Exit Unified CCX DB DoBackup(db_do_backup.py) with returnCode = 24 ：成功しない-----
2021/10/01 12:03:19: DO_Backup DBスクリプトが動作しませんでした

是正アクション

CLIで次のサービスを再起動します。

• DRF MasterおよびDRF Localサービス
  • 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 データベース レプリケーションのトラブルシューティング
• シスコのテクニカルサポートとダウンロード