エラーメッセージで失敗する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ヘルスチェック
• utils uccx healthcheck all（すべてチェック）

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

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

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

DBReplicationステータスの定義

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

注：上記のリンク先の記事では、UCCXに固有のコマンドの一部は記載されていません。この記事はCUCMに固有であるため。ただし、全体のプロセスはUCCXにも適用されます。たとえば、utils uccx dbreplication repair allのようになります。

このシナリオでは、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 ：情報：これはUCCXハイアベイラビリティ設定です
2021-10-01 12:03:15 ：情報：Unified CCXクラスタに2つのノードがある

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

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

2021-10-01 12:03:15 ：情報：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 データベース レプリケーションのトラブルシューティング
• シスコのテクニカルサポートとダウンロード