IM&で開始しないサービスのトラブルシューティング

はじめに

このドキュメントでは、Cisco Instant Message and Presence(IM&P)からのサービスが期待どおりに開始されない場合に実行する手順について説明します。

背景説明

サービスの状態

IM&Pサービスには、次の状態があります。

IM&Pノードのリブート後に次の警告が生成されます。この警告は、通知ページに移動するとGraphic User Interface（GUI；グラフィックユーザインターフェイス）に表示される場合と、Command Line Interface（CLI；コマンドラインインターフェイス）から表示される場合があります。

Cisco IM and Presence Data Monitorが、データベースレプリケーションが完了していないこと、またはCisco Unified Communications ManagerからのCisco Sync Agentの同期が完了していないことを検出しました。レプリケーションとCisco Sync Agentの同期が正常に完了するまで、一部のサービスは「Starting」状態のままになる可能性があります。

このメッセージは、必ずしもアラートが生成されてからサービスがStarting状態のままであることを意味しているわけではありません。これは、IM&P Data Monitorが、リブートまたはブートからIM&Pが起動するとすぐにサービスの監視を開始するためです。モニタサービスが最初に検出するのは、すべての主要なサービスがメッセージをトリガーする開始のプロセスであるということです。

サービスの実際の状態を確認するために、utils service listコマンドを実行します。

注：サービスがStarted状態の場合は、このアラートを自由に削除して、通知アラートをクリーンな状態に保ってください。

トラブルシュート

問題の特定

「Services not Starting」のトラブルシューティングを行う最初のステップは、開始されていないサービスを特定することです。

停止したサービスの右側に表示される凡例を検証することが重要です。一般に、次の情報を確認できます。

• Service not activated：これは、機能サービスがアクティブ化されておらず、最初に行う必要があることを意味します。

• サービス停止のコマンド：このメッセージは、サーバの再起動後、HAが無効でなかった場合、または特定のサービスが再起動した場合に表示されます。このアクションによって他のサービスが手動で停止します。その他のシナリオでは、ネットワーク管理者がサービスを手動で停止すると、このメッセージが表示されます。ここでの解決策は、GUIまたはCLIから手動でサービスを開始することです。

• NOTRUNNING：このメッセージは、サービスにエラーがあり、起動できない場合に表示されます。このメッセージは、サービスを手動で開始しようとした後に表示されることがあります。最初の試みはサービスを手動で開始することですが、このアクションが機能しない場合は、次のトラブルシューティング手順を実行する必要があります。このガイドを使用して、サービスが開始されない問題の解決に役立てます。

サービスがSTARTING状態のままになる

再起動後にIM&Pサブスクライバで確認される最も一般的な問題の1つは、IM&PパブリッシャですべてのサービスがSTARTEDと表示されているのに、ほとんどすべてのサービスがSTARTING状態になっていることです。

この動作の一般的な原因は、ハイアベイラビリティ(HA)がプレゼンス冗長グループから無効になっていない場合に、IM&Pサブスクライバを再起動することで明らかになります。

解決方法

ステップ 1：プレゼンス冗長グループからハイアベイラビリティを無効にし、CUCM Administrationページ> Systemに移動します。

ステップ 2：両方のIM&Pノードで次のコマンドを実行します：set replication-sync monitor disable。

ステップ 3：5分ほど待ってから、utils service listコマンドをもう一度実行して、サービスが開始されていることを確認します。

ステップ 4：サブスクライバですべてのサービスが開始されていることを確認してから、両方のIM&Pノードで次のコマンドを実行します：set replication-sync monitor enable。

ステップ 5：プレゼンス冗長グループからハイアベイラビリティを再度有効にします。

特定のサービスが起動しない

ネットワーク サービス

IM&Pパブリッシャで一部のネットワークサービスが開始されないケースはまれですが、次のようなケースがあります。

• Cisco Client Profile Agent
• Cisco Extensible Communications Platform(XCP)ルータ
• Cisco XCPコンフィギュレーションマネージャ
• Cisco Route and Presenceデータストア

警告: XCP、プレゼンスエンジン、およびSIPプロキシサービスは一覧にあるネットワークサービスに依存しているため開始できません。これにより、インスタントメッセージデータベース(IMDB)が複製されず、Jabberユーザはログインできなくなります。

解決方法

サービスはWebインターフェイス(IM and Presence Serviceability > Tools > Control Center - Network Services > Look for the IM and Presence Servicesの順に選択)またはコマンドラインインターフェイス(CLI)で開始するには、utils service start <name_of_the_service>コマンドを使用します。

ステップ 1：プレゼンス冗長グループからハイアベイラビリティを無効にします。

ステップ 2：各サービスを次の順序で手動で開始します。

• Cisco Client Profile Agent
• Ciscoルートデータストア
• Cisco Presenceデータストア
• Cisco XCPコンフィギュレーションマネージャ
• Cisco XCP Router

注:Cisco Client Profile Agentを起動するには、Cisco Tomcat Serviceを起動する必要があります。

上記の手順で解決できない場合は、さらにトラブルシューティングを進めるために、Cisco Technical Assistant Center(TAC)のケースをオープンする必要があります。次の出力とログが必要であることに注意してください。

1. CLI出力：
• ネットワーククラスタの表示
• utils dbreplication runtimestate
• utils haステータス
• utils core activeリスト
• utils serviceリスト
2. ログ/トレース：
• Cisco Syslog Agent
• Event Viewer-Application Log
• Event Viewer-System Log
• 停止したままになっているサービスからのトレース

シスコデータベース(DB)

これは、システム内の主要なサービスの1つです。

警告：このサービスが開始されないと、サーバがサーバWebページの特定の機能にアクセスできず、Jabberユーザとその機能が侵害され、DBレプリケーションが破損します。

原因:

この問題の最も一般的な原因は次のとおりです。

• シスコのガイドラインに従わずに、ホスト名、IPアドレス、またはドメインを変更する。
• システムの通常ではないシャットダウン後のファイルの破損。

ソリューション：

残念ながら、このサービスが開始されない場合、直接的な解決策はありません。次の推奨事項があります。

ステップ 1：プレゼンス冗長グループからハイアベイラビリティを無効にします。

ステップ 2：Cisco DB Replicatorを再起動します。

ステップ 3：Cisco DBを再起動します。STARTING状態が続く場合は、停止してから開始してください。

この場合の最善のアプローチは、Cisco TACに調査を依頼することです。次の情報が必要です。

1. CLI出力：
• show tech network hosts（登録ユーザ専用）
• show techデータベースダンプ
• show tech dbintegrity（読み取り専用）
• utils create reportデータベース
• utils network connectivity IM&P_node 1500
• ネットワーククラスタの表示
• utils core activeリスト
2. ログまたはトレース
• Cisco Database Layer Monitor
• Cisco Database Library Trace
• Cisco Database Notification Service
• Cisco Database Replicator Trace
• Cisco Informix Database Service
• Cisco Syslog Agent
• Event Viewer-Application Log
• Event Viewer-System Log

Cisco Intercluster Sync Agent(ICSA)

警告：このサービスが開始されないと、IM&PデータベースをIM&PノードとIM&Pクラスタ間で同期できません（クラスタ間ピアリング）。

ソリューション：

1. ハイアベイラビリティ(HA)の状態が悪い（または正しくない）ため、サービスを起動できません。

ステップ 1：HAを無効にし、サービスを開始してから、HAを再度有効にする必要があります。

• サーバは、次の2つの不具合のいずれかによって影響を受けます。
  • Cisco Bug ID CSCvj09515
  • Cisco Bug ID CSCvq63308  

サービスが起動しない場合は、さらにトラブルシューティングを行うためにTACケースをオープンする必要があります。次の出力とログが必要であることに注意してください。

1. CLI出力
• ネットワーククラスタの表示
• utils dbreplication runtimestate
• utils haステータス
• utils core activeリスト
• utils serviceリスト
2. ログ/トレース
• Cisco Syslog Agent
• Event Viewer-Application Log
• Event Viewer-System Log
• Cisco Service Recovery Manager(SRM)
• Cisco Intercluster Sync Agentサービス

プレゼンスエンジン

Cisco Presence Engineサービスには、サービスが開始されない理由とその開始方法を理解するために考慮する必要がある複数のバリアントがあります。

1. CLIを開き、コマンド utils service listを実行して、次のサービスが実行状態にあることを検証します。実行中でない場合は、最初に開始する必要があります。
• Cisco Presenceデータストア
• Cisco SIP Proxy
• Cisco XCP Router
• Cisco Sync Agent

2. IM&PサブスクライバでCisco Presence Engine(PE)サービスが起動しない最も一般的な理由は、IM&Pサブスクライバがプレゼンス冗長グループ(PRG)に追加されていないためです。

• 理由： PEサービスはPRGに関連付けられており、開始するには追加する必要があります。
• 解決方法： PRGにサーバーを追加し、5分ほど待って、サーバーが起動するかどうかを確認します。
• バリアント型：前の解決策が適用された後、PEが両方のIM&Pノードで停止し、解決策は次の手順を実行することです。

ステップ 1：IM&PサブスクライバをPRGに保持します。

ステップ 2：PRGからハイアベイラビリティをディセーブルにします。

ステップ3：次のステップは、最初にパブリッシャで、次にサブスクライバで実行する必要があります

ステップ 4：最初にCisco SIP Proxy Serviceを再起動し、開始されるまで待ちます。

ステップ 5：Cisco PEサービスを再起動し、開始されるまで待ちます。

3. IM&PサブスクライバがすでにPRGに追加されていてPEがSTOPPEDまたはSTARTING状態のままである場合、それは2つのIM&Pノード間のデータベースレプリケーションの不一致に関連している可能性があり、次にrun sql select * from enterprisde nodeコマンドを実行します。このクエリの出力は、ノードのID、ノードのsubclusterid(PRG ID)、名前またはIPアドレス、およびその他の値を表示します。ここで注目したいのは、両方のIM&Pノードが同じsubclusterid(SUBCD)値を共有していることです。

• 理由： DBレプリケーションが正しく実行されなかった場合、IM&PサブスクライバはsubclusteridをNULLと表示します。
• ソリューション： 

ステップ 1：次のコマンドを実行します。run sql update enterprisenode set subclesterid=subclesterid_value_as_for_the_IM&P_Pub where id=IM&P_Sub_id

ステップ 2：次のコマンドrun sql select * from enterprisde node を再実行し、両方のIM&Pノードについてsubclusterid に正しい値（同じ）が設定されていることを確認します。サービスは次の5分以内に自動的に開始する必要があります。または、手動で開始することもできます。

• 推奨事項：この変更を行うには、Cisco TACサービスリクエストをオープンしてください。

4. 前のトラブルシューティングの実行後に、PEを除くすべてのサービスが開始された場合：

• ソリューション：

ステップ 1：両方のIM&Pノードでコマンドset replication-sync monitor disableを実行します。

ステップ 2：5分ほど待機し、開始しない場合は、サービスを手動で開始して、utils service start Cisco Presence Engineコマンドを実行します。

ステップ 3：set replication-sync monitor enableコマンドを実行します。

5. PEサービスがまだ開始されていない場合は、サーバがバージョン12.5を実行しているかどうかを検証します。実行している場合は、Cisco Bug ID CSCvg94247の影響を受ける可能性が非常に高い状態です。

Cisco Sync Agent

警告：このサービスが開始されない場合、CUCMからIM&PへのDBテーブルの同期が完了しません。この影響は主に、クラスタ間のエンドユーザの同期に及びます。

解決策：次のチェックリストを確認します。

1. CUCMノードとIM & Presenceノードの両方が同じバージョンであることを確認します。サーバがバージョン11.X以降の場合、サーバは同じSUバージョンで実行する必要があります。
• そうでない場合は、両方で同じバージョンが稼働していることを確認します。
2. CUCM上のCisco AXL Web Service(CWS)が実行中の状態であることを確認します。
• 実行中でない場合は、Cisco AXL Webサービスを起動します。
3. IM&PノードがCUCMのサーバリストにリストされていることを確認します。
• そうでない場合は、IM&Pサーバの再構築が必要です。サーバがサーバリストエントリに再び追加されても効果はありません。これは、追加されたすべてのエントリに対して特定のIDが生成されるためです。そのため、IM&Pは古いIDのまま残ります。
4. IM&PのCUCMパブリッシャページで、トラブルシュータテストに合格していることを確認します。
5. 次のUniform Resource Locator(URL)がURL https://CUCM_OR_IM&P_FQDN_OR_IPで到達可能であることを確認します。
6. CUCMパブリッシャをリブートしてから、IM&Pパブリッシャをリブートします。
• リブートする前にHAをディセーブルにする必要があることに注意してください。
7. IM&Pパブリッシャで次のCLIクエリ「run sql select * from epassyncagentcfg 」を実行します。
8. 表示されるccmpublisheripアドレスがCUCMパブリッシャからのものであることを確認します。
9. CUCMで次のクエリを実行します。

sql select applicationuser.pkid, applicationuser.name , credential.credentials from applicationuser inner join credential on applicationuser.pkid=credential.fkapplicationuser where credential.tkcredential=3 and applicationuser.name='axluser_displayed_from_epassyncagentcfg'を実行します

10. 次の情報を検証します。
• ユーザ名（CUCM上） = axluser（IM&P上）
• pkid（CUCM上） = cucm_axluser_pkid （IM&P上）
• クレデンシャル（CUCM上） = axlpassword（IM&P上）

10. epassyncagentcfg内のaxluserがCUCMユーザリストに見つからない場合は、旧パスワード（分かっている場合）を使用して、新しいアプリケーションユーザをCUCM側に作成します。新しいアプリケーションユーザは、旧パスワード(axluser)と同じです。

上記の手順で問題が解決しない場合は、Cisco TACにトラブルシューティングを依頼する必要があります。次の出力とログが必要であることに注意してください。

CLI出力（CUCMパブリッシャおよびIM&Pから）:

• ネットワーククラスタの表示
• utils dbreplication runtimestate
• Utils haステータス
• Utils coreアクティブリスト
• Utilsサービスリスト
• epassyncagentcfgからsql select *を実行します（IM&P上のみ）。
• sql select applicationuser.pkid、applicationuser.name、credential.credentials from applicationuser inner join credential on applicationuser.pkid=credential.fkapplicationuser where credential.tkcredential=3 and applicationuser.name='axluser_displayed_from_epassyncagentcfg'（CUCM上のみ）を実行します

ログ/トレース：

• Cisco Syslog Agent.
• Event Viewer-Application Log.
• Event Viewer-System Log.
• Cisco Sync Agent.
• Cisco AXL Web Service.

Cisco XCPコンフィギュレーションマネージャ

Cisco XCP Config Managerは、IM&Pサーバ内のすべてのXCPコンポーネントを処理するメインサービスです。XCP Routerを含むほとんどのXCPサービスがRUNNING状態であっても、このサービスはSTOPPED状態になる可能性があります。これにより、XCP Connection Manager、XCP Web Service Managerが停止したままになったり、Expressway（MRA用）などの他のサーバとの同期が失敗したりする場合があります。

まず、Informixデータベースレプリケーションが正しい状態であることを確認します。

utils dbreplicationステータス

utils dbreplication runtimestate

問題がなければ、ハイアベイラビリティを無効にし、サービスの再起動を試みます。失敗した場合は、同期モニタリング機能を無効にします。

replication-syncモニターを無効にする

次に、サービスの開始を再試行します。Real-Time Monitor Tool(RTMT)またはCLIを使用して、Cisco XCP Config Managerのログを取得します。

ファイルビューactivelog /epas/trace/xcpconfigmgr/log4j/xcpconfigmgr.log

And this is the most common scenario:

2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - java.io.FileNotFoundException: /usr/local/platform/.security/CCMEncryption/keys/oldkeys.txt (No such file or directory)
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : decryptPassword - recovery mechanism failed
2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - javax.crypto.BadPaddingException: Error finalising cipher data: pad block corrupted
2024-12-11 14:20:52,195 INFO  [XCPConfigMgr] security.Log4jEncLogger - Entering decryptPassword
2024-12-11 14:20:52,196 INFO  [XCPConfigMgr] security.Log4jEncLogger - Use Dkey to decrypt data
2024-12-11 14:20:52,213 INFO  [Thread-12] dbl.Log4j - Name of appId:dbcli
2024-12-11 14:20:52,216 INFO  [Thread-12] dbl.Log4j - Name of appId:dbxcpconfig
2024-12-11 14:20:52,219 INFO  [Thread-12] dbl.Log4j - Name of appId:dbcli
2024-12-11 14:20:52,221 INFO  [Thread-12] dbl.Log4j - Name of appId:dbxcpconfig
2024-12-11 14:20:52,649 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : Dkey decryption failed. Use recovery mechanism to decrypt data.
2024-12-11 14:20:52,649 INFO  [XCPConfigMgr] security.Log4jEncLogger - Using static key to decrypt data
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - Exiting decryptPassword.fail
2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - Decryption with static key failed as well. Fatal error javax.crypto.BadPaddingException: Error finalising cipher data: pad block corrupted
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : static key decryption failed. Use old keys to decrypt data
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - Exiting DecryptPassword.fail. failed to read oldkey file

 その場合は、不具合「Cisco Bug ID CSCur25679 XCP Config ManagerとXCP Services not Starting on IM&Pをトラブルシューティングするには、Cisco TACに連絡して回避策を適用する必要があります。

機能サービスが開始しない

各サービスの機能を使用しない限り、次のサービスはデフォルトで無効になっています。

• Cisco XCPディレクトリサービス
• Cisco XCPファイル転送マネージャ
• Cisco XCPメッセージアーカイブおよびCisco XCP XMPPフェデレーション

IM&Pでこれらのサービスがアクティブ化されていても、各サービスの各機能を設定しない限り、サービスは開始されません。

Cisco XCPディレクトリサービス

Cisco XCP Directory Serviceは、Extensible Messaging and Presence Protocol(XMPP)クライアントとLightweight Directory Access Protocol(LDAP)ディレクトリの統合をサポートし、ユーザはLDAPディレクトリから連絡先を検索および追加できます。

このサービスを開始するには、次の手順を実行します。

1. Cisco Unified CM IM and Presence Administration > Application > Third-Party Clientsの順に移動します。

2. サードパーティXMPPクライアントの設定を構成します。

Cisco XCP Directory Serviceを使用して、サードパーティのXMPPクライアントのユーザがLDAPディレクトリから連絡先を検索および追加できるようにします。

サードパーティのXMPPディレクトリの設定の詳細については、『Cisco XCPディレクトリサービスをオンにする』を参照してください。

Ciscoファイル転送マネージャ

このサービスでは、マネージドファイル転送と呼ばれるサーバ側のファイル転送ソリューションを使用できます。

マネージドファイル転送(MFT)を使用すると、Cisco JabberなどのIM and Presenceサービスクライアントで、他のユーザ、アドホックグループ、チャット、および常設チャットにファイルを転送できます。

MFTの設定が行われていない場合、サービスは開始されません。

サードパーティのXMPPディレクトリの設定の詳細については、『CUCM CM IM/Presence 10.5でマネージドファイル転送を設定する方法』を参照してください。

Cisco XCPメッセージアーカイバ

Cisco XCP Message Archiverサービスは、IMコンプライアンス機能をサポートします。IMコンプライアンス機能は、IM and Presenceサーバとの間で送受信されるすべてのメッセージをログに記録します。これには、ポイントツーポイントメッセージや、チャット機能用のアドホックチャットルーム（一時的なチャットルーム）と常設チャットルームからのメッセージが含まれます。メッセージは、シスコがサポートする外部データベースに記録されます。

コンプライアンスの設定が設定されていない場合、サービスは開始されません。

メッセージアーカイブの設定方法の詳細については、『Instant Messaging Compliance for the IM and Presence Service, Release 12.5(1)』を参照してください。

Cisco XCP XMPPフェデレーション接続マネージャ

Cisco XCP XMPP Federation Connection Managerは、XMPPプロトコルを介して、International Business Machines(IBM)Lotus Sametime、Cisco Webex Meeting Center、GoogleTalk、およびその他のIM and Presenceエンタープライズなどのサードパーティ企業とのドメイン間のフェデレーションをサポートします。

このサービスは、XMPPフェデレーションが設定されるまで開始されません。

メッセージアーカイブの設定方法の詳細については、『ドメイン間フェデレーションガイド(IM and Presenceサービス、リリース12.5(1))』を参照してください。

関連情報

• シスコのテクニカルサポートとダウンロード