診断フレームワーク Portico の手動インストールとログ ファイル

はじめに

このドキュメントでは、Cisco Unified Contact Center Enterprise(UCCE)Diagnostic Framework Porticoの障害が発生したインストールを回復するための手順について説明します。

前提条件

要件

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

• Cisco UCCE
• 診断フレームワークPortico
• Microsoft Windowsのサービス、レジストリ、およびCLI

使用するコンポーネント

このドキュメントの情報は、Cisco UCCEバージョン8.5および9.0に基づくものです。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。

問題

新規インストールまたは更新アップグレードの後、診断フレームワークのPorticoページが読み込まれない場合があります。また、Cisco Intelligent Contact Management(ICM)Diagnostic Frameworkサービスがservices.mscに表示されない場合もあります。

トラブルシューティング

Porticoの診断ページにアクセスするには、Porticoが実行されているローカルサーバからこれらのURLにアクセスします。環境に応じて<UCCE-server-IP>プレースホルダと<Instance-Name>プレースホルダを必ず更新してください。 

• https://localhost:7890/icm-dp/rest/DiagnosticPortal/GetMenu
• https://<UCCE-server-IP>:7890/icm-dp/rest/DiagnosticPortal/GetMenu
• https://<UCCE-server-IP>:7890/icm-dp/rest/AnalysisManager/GetMenu?InstanceName=<インスタンス名>

上記のURLが機能しない場合は、次のログファイルで詳細を参照してください。

• C:\ icm\serviceability\diagnostics\logs
• C:\Temp\icminstall.log

これらのログのいずれかでインストーラエラーが参照されている場合は、InstallUtilログを確認できます。これを行うには、C: > Windows > Microsoft.NET > Framework > v2.0.50727 > InstallUtilに移動し、InstallUtil.INSTALLLOGFILEを開きます。

解決方法

診断フレームワークを手動でインストールするには、次の手順を実行します。

1. コマンド プロンプトを開きます。
2. 次のコマンドを入力します。

   C:\Windows\Microsoft.NET\Framework\v2.0.50727\InstallUtil.exe
   C:\icm\serviceability\diagnostics\bin\DiagFwSvc.exe

   これで、次の図に示すように、診断フレームワークがインストールされました。

サービスがマシンにすでに存在する場合は、次のメッセージが表示されます。

An exception occurred during the Install phase.
System.ComponentModel.Win32Exception: The specified service already exists

インストールはトランザクション方式で実行されます。アセンブリの1つがインストールに失敗した場合、他のすべてのアセンブリのインストールは延期されます。アンインストールは処理されません。

注：診断フレームワークPorticoの手動インストール後、プロセス（次のスクリーンショットの右下）にステータスが表示されないことがあります。正しくインストールされている場合は、スクリーンショットの左下に情報が表示されます。

手動インストールの完了後、ICM Diagnostic Portico ListProcessesおよびUnified CLI show processesコマンドでICMプロセスのステータスが表示されない場合は、HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > services > DiagFwSvcの順に移動し、Typeが0x0000110 (272)に設定されていることを確認します。 

レジストリの変更が必要な場合は、変更を確定するためにサーバをリブートします。リブート後、UCCEプロセスのステータスが正しく表示されます。