内容

概要

背景説明

サービスの状態

トラブルシュート

問題の特定

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

特定のサービスが開始しない

Cisco Sync Agent

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

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

Cisco File Transfer Manager

Cisco XCP Message Archiver

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

関連情報

概要

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

背景説明

サービスの状態

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

開始

サービスはアクティブで実行中です。

Starting

サービスは停止から開始に移行中です。

STOPPED

サービスが開始されていません。手動で停止されたか、アクティブ化されていない可能性があります。

停止中

サービスは開始から停止に移行中です。

IM&Pノードのリブート後に次の警告が生成され、[Notifications]ページに移動した場合は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状態のままであることを必ずしも意味するわけではありません。これは、IM&P Data Monitorが、リブートまたはブートからIM&Pが起動するとすぐにサービスの監視を開始するためです。モニタサービスが最初に検出するのは、すべての主要なサービスが開始の処理中であり、メッセージがトリガーされることです。

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

注：サービスがStarted状態の場合は、アラートを削除してNotification Alertsをクリーンな状態に保つことができます。

トラブルシュート

問題の特定

開始しないサービスをトラブルシューティングする最初のステップは、どのサービスが開始されていないかを理解することです。

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

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

- Commanded out of service：このメッセージは、サーバのリブート後、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 Config Manager。

- Cisco Route and Presenceデータストア。

警告: XCP、プレゼンスエンジン、およびSIPプロキシサービスはリストされているネットワークサービスに依存しているため、開始できません。これにより、Instant Message Database(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 Config Manager。

- Cisco XCP Router.

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

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

1. CLI出力

- show network cluster

- utils dbreplication runtimestate

- utils ha status

- utils core active list

- utils service list

2. ログ/トレース

- Cisco Syslog Agent.

- Event Viewer-Application Log.

- Event Viewer-System Log.

- 停止したままのサービスからのトレース。

Cisco Database(DB)

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

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

原因:

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

- シスコのガイドラインプロセスを使用せずに、ホスト名、IPアドレス、またはドメインを変更する。

- システムの不適切なシャットダウン後のファイルの破損。

ソリューション：

残念ながら、このサービスが開始されない場合は、単純なソリューションステップはありません。提案は次のとおりです。

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

ステップ 2：Cisco DBレプリケータを再起動します。

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

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

1. CLI出力：

- show tech network hosts

- show tech database dump

- show tech dbintegrity

- utils create report database

- utils network connectivity IM&P_node 1500

- Show network cluster

- utils core active list

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. ハイアベイラビリティが不良（または誤った）状態にあり、サービスが起動できません。

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

- サーバは次の2つの不具合の

- Cisco Bug ID CSCvj09515

- Cisco Bug ID CSCvq63308

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

1. CLI出力

- show network cluster

- utils dbreplication runtimestate

- utils ha status

- utils core active list

- utils service list

2. ログ/トレース

- Cisco Syslog Agent.

- Event Viewer-Application Log.

- Event Viewer-System Log.

- Cisco Service Recovery Manager。

- Cisco Intercluster Sync Agentサービス。

プレゼンスエンジン

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

1. CLIを開き、コマンド utils service list を実行して、次のサービスが実行状態にあることを確認します。実行されていない場合は、最初に開始する必要があります。

- Cisco Presenceデータストア。

- Cisco SIP Proxy.

- Cisco XCP Router.

- Cisco Sync Agent.

2. Cisco Presence Engine(PE)サービスがIM&Pサブスクライバで起動しない最も一般的な理由は、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 enterprise node コマンドを実行します。このクエリの出力には、ノードのID、ノードのsubclusterid(PRG ID)、名前、またはIPアドレス、およびその他の値が表示されます。注目したいのは、両方のIM&Pノードが同じsubclusterid値を共有していることです。

- 理由: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 enterprise 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を実行しているかどうかを確認します。バージョン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サービスがRUNNING状態であることを確認します。

- そうでない場合は、Cisco AXL Webサービスを起動します。

3. IM&PノードがCUCMのサーバリストにリストされていることを確認します。

- そうでない場合は、IM&Pサーバの再構築が必要です。サーバがサーバリストエントリに再び追加された場合は、追加された各エントリに対して特定のIDが生成されるため、何の効果もありません。そのため、IM&Pは古いIDのまま残ります。

4. IM&Pの[CUCM Publisher]ページのトラブルシュータテストが合格したことを確認します。

5. 次のUniform Resource Locator(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で次のクエリを実行します。

run 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上）

11. epassyncagentcfg内のaxluserがCUCMユーザリスト内に見つからない場合は、古いaxluserと同じアプリケーションユーザをCUCM側に作成します（既知の場合）。その前のパスワードを使用します。

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

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

- Show network cluster

- Utils dbreplication runtimestate

- Utils ha status

- Utils core active list

- Utilsサービスリスト

- epassyncagentcfgからsql select *を実行します（IM&P上のみ）

- sql select applicationuser.pkid、applicationuser.name、credential.credentials from applicationuser inner join credential on applicationuser.pkid=credential.fkapplicationuser（credential.tkcredential=3および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 Directory Service。

- Cisco XCP File Transfer Manager。

- Cisco XCP Message ArchivesおよびCisco XCP XMPP Federation。

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

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

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

このサービスを開始するには、[Cisco Unified CM IM and Presence Administration] > [Application] > [Third-Party Clients] に移動し、サードパーティXMPPクライアントの設定を行います。

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

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

Cisco File Transfer Manager

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

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

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

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

Cisco XCP Message Archiver

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

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

メッセージアーカイブの設定方法の詳細については、『IM and Presenceサービス向けインスタントメッセージングのコンプライアンス、リリース12.5(1)』を参照してください。

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

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

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

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

関連情報

- シスコテクニカルサポートおよびダウンロード