定期メンテナンスの実行

CLI にアクセスして、サービスの表示、停止、または開始、ロギング、管理のリモートアカウントのロギングや管理、サードパーティガジェットのアカウントの管理、レプリケーションのチェックなどの定期メンテナンスタスクを実行します。

管理者ユーザアカウントの資格情報を使用して CLI にアクセスします。

Cisco Finesse サービス

CLI から次の Finesse サービスにアクセスできます。

Cisco Finesse Notification Service：このサービスは、メッセージングとイベントに使用されます。このサービスが開始されていない場合、コールイベント、エージェント状態の変更、統計情報などを表示できず、Finesse Desktop がサインイン後にロードされません。
Cisco Finesse Tomcat：このサービスには、導入されたすべての Finesse アプリケーションが含まれます。Cisco Finesse Tomcat サービスを再起動するには、すべてのエージェントがサインアウトしてから再びサインインする必要があります。

Cisco Finesse Tomcat サービスの導入済みアプリケーションは次のとおりです。

Finesse Desktop アプリケーション：このアプリケーションは、エージェントおよびスーパーバイザ用のユーザインターフェイスを提供します。
Finesse REST API アプリケーション：このアプリケーションは、Finesse Desktop および Finesse 管理アプリケーションのために Cisco CTI サーバとの統合を実現します。どの API をユーザが使用できるかは、ユーザの資格情報に関連付けられたロールによって異なります。このアプリケーションは、Finesse REST API を使用するように作成されたサードパーティアプリケーションで使用できるプログラミングインターフェイスも提供します。
Finesse Administration アプリケーション：このアプリケーションは、Finesse の管理オペレーションを提供します。
Finesse 診断ポータルアプリケーション：このアプリケーションは、Finesse のパフォーマンス関連情報を提供します。
Finesse IP Phone エージェント（IPPA）アプリケーション：このアプリケーションにより、エージェントとスーパーバイザは各自の Cisco IP フォンで Finesse 操作を実行することができます。

Cisco Finesse サービス関連の問題がある場合は、最後の手段として Finesse サービスを再起動します。ほとんどのサービス関連の問題は、サービスを再起動しても修正できません。サービスがダウンしている場合にだけ Cisco DB を再起動します。

（注）

Cisco Finesse Notification Service を再起動するには、次の順序でサービスを停止して再起動する必要があります。

Cisco Finesse Tomcat サービスを停止します。
Cisco Finesse Notification Service を停止します。
Cisco Finesse Notification Service を開始します。
Cisco Finesse Tomcat サービスを開始します。

サービスの表示、開始、または停止

手順

ステップ 1	管理者ユーザアカウントの資格情報を使用して CLI にサインインします。
ステップ 2	すべてのサービスとその状態の一覧を表示するには、次のコマンドを入力してください。utils service list。サービスの状態として、「STOPPED」、「STARTING」、「STARTED」のいずれかが表示されます。「STOPPED」はサービスが動作していないことを意味します。「STARTING」はサービスが動作を開始し、初期化を実行していることを意味します。「STARTED」はサービスが正常に初期化され、動作していることを意味します。
ステップ 3	サービスを開始するには、次のコマンドを入力してください。utils service startservice name。例: たとえば、Cisco Tomcat を開始するには、utils service start Cisco Finesse Tomcat コマンドを入力します。
ステップ 4	サービスを停止するには、次のコマンドを入力してください。utils service stopservice name。例: たとえば、Cisco Tomcat を停止するには、utils service stop Cisco Finesse Tomcat コマンドを入力します。

ログの収集

これらのコマンドでは、ファイルのアップロード先としてセキュア FTP（SFTP）サーバの場所を指定するように求められます。

ログを取得するには、次のコマンドを実行します。

インストールログ：file get install desktop-install.log

システムのインストール後にこのコマンドを使用すると、インストールログが表示されます。

このログは SFTP サーバに書き込まれ、テキストファイルとして次のパスに保存されます。<IP アドレス>\<日付とタイムスタンプ>\install\desktop-install.log
デスクトップログ：file get activelog desktop recurs compress

Finesse Web アプリケーションのログを取得するには、このコマンドを使用します。このコマンドを実行すると、次のディレクトリが含まれる zip ファイルがアップロードされます。
- webservices：このディレクトリには、Finesse REST API を提供する Finesse バックエンドのログが含まれます。圧縮されていないデスクトップログファイルの最大サイズは 100 MB です。このディレクトリの最大サイズは約 4.5 GB です。ログファイルが 100 MB に達すると、そのファイルは圧縮され、新しいログファイルが生成されます。最後に圧縮されたデスクトップログファイルへの出力は、次に作成されるログファイルに引き継がれます。ログファイルのラップアップ期間は、システムのユーザ数に基づいて異なります。各デスクトップログファイル名にはタイムスタンプが含まれます。
- desktop：このディレクトリには、[Finesse デスクトップ（Finesse desktop）] ガジェットを保持する [Finesse エージェントデスクトップ（Finesse agent desktop）] ガジェットのコンテナからのログが保存されます。Finesse エージェントデスクトップでのあらゆるコンテナレベルのエラーがこれらのログファイルに表示されます。
- admin：このディレクトリには、管理ガジェットを保持する [Finesse 管理（Finesse Administration）] ガジェットのコンテナからのログが保存されます。Finesse 管理コンソールでのあらゆるコンテナレベルのエラーがこれらのログファイルに表示されます。
  - audit-log：監査ログには、すべての管理操作（Finesse 管理 UI と REST クライアントの操作を含む）が記録されます。圧縮されていない監査ログファイルの最大サイズは 100 MB です。すべての監査ログの合計最大サイズ（圧縮済みログファイルを含む）は約 1 GB です。ログファイルが 100 MB に達すると、そのファイルは圧縮され、新しいログファイルが生成されます。ログファイルのラップアップ期間は、システムのユーザ数に基づいて異なります。このログには、次のパラメータが含まれています。
    - タイムスタンプ
    - 管理者のユーザ ID
    - 操作メソッド（PUT、POST、DELETE）。GET 操作はログに記録されません。
    - URL
    - ペイロード
- clientlogs：このディレクトリには、Finesse エージェントデスクトップから Finesse サーバに送信されたクライアント側のログが保存されます。各ログファイルは 1.5 MB 未満で、ファイルを送信したエージェントのタイムスタンプとエージェント ID が含まれます。エージェントがクライアント側のログを送信するたびに新しいログファイルが作成されます（既存のログファイルにはデータが追加されません）。このディレクトリの最大サイズは 100 MB です。ディレクトリには最大 25,000 の clientlog ファイルを格納できます。ディレクトリがサイズ制限またはファイル数で超過すると、最も古いファイルが削除されます。
- openfireservice：このディレクトリには Cisco Finesse Notification Service の起動とシャットダウンに関連する情報のログが保存されます。
- openfire：このディレクトリには Cisco Finesse Notification Service の限定されたエラーおよび情報のログが保存されます。
- finesse-dp:このディレクトリには、開始、エラー、そして Finesse 診断ポータルアプリケーションによって作成される情報のログが含まれます。
- realm：このディレクトリには、Finesse バックエンドで処理される、クライアントからの認証要求のログが格納されます。
- db：このディレクトリには、Finesse データベースに関するログが格納されます。
- /finesse/logs：このディレクトリには、Cisco Finesse Tomcat サービスのログが格納されます。
- fippa：このディレクトリには、Finesse IP Phone エージェント（IPPA）アプリケーションのログが格納されます。
- finesse-auth：このディレクトリには、シスココンテキストサービスでの Finesse 認証のログが格納されます。
- jmx：このディレクトリには、JMX ロガープロセスによって生成された JMX カウンタのデータが含まれています。Finesse および openfire により公開される重要な jmx カウンタが含まれています。
これらのログは SFTP サーバの次のパスに保存されます：<IP アドレス>\<日付とタイムスタンプ>\active_nnn.tgz。ここで、nnn は長い形式のタイムスタンプです。
コンテキストサービス登録のログ：file get activelog ccbu/logs/fusion-mgmt-connector

シスココンテキストサービスへの登録および登録解除の際に Finesse が生成する fusion-mgmt-connector ログは、このコマンドを使用して取得します。

これらのログは SFTP サーバの次のパスに保存されます：<IP アドレス>\<日付とタイムスタンプ>\active_nnn.tgz。ここで、nnn は長い形式のタイムスタンプです。
Servm ログ：file get activelog platform/log/servm*.* compress

Finesse サービスの開始と停止を管理するプラットフォームサービスマネージャによって生成されたログを取得するには、このコマンドを使用します。

デスクトップログと servm ログは 1 組のファイルに圧縮されます。

これらのログは SFTP サーバの次のパスに保存されます：<IP アドレス>\<日付とタイムスタンプ>\active_nnn.tgz。ここで、nnn は長い形式のタイムスタンプです。
プラットフォーム Tomcat ログ：file get activelog tomcat/logs recurs compress

これらのログは SFTP サーバの次のパスに保存されます：<IP アドレス>\<日付とタイムスタンプ>\active_nnn.tgz。ここで、nnn は長い形式のタイムスタンプです。
インストールログ：file get install install.log

これらのログは SFTP サーバの次のパスに保存されます：<IP アドレス>\<日付とタイムスタンプ>\active_nnn.tgz。ここで、nnn は長い形式のタイムスタンプです。

（注）

ログ収集は、多数のログファイルがある場合に圧縮フラグを使用すると、失敗することがあります。収集が失敗した場合、圧縮フラグなしでコマンドを再実行してください。

Cisco Unified Real-Time Monitoring Tool を使用したログの収集

Cisco Finesse は、ログ収集の目的で Cisco Unified Real-Time Monitoring Tool（RTMT）をサポートしています。Unified RTMT を使用してログを収集するには、以下の手順に従います。

（注）

Finesse は、ログ収集のみを目的に RTMT をサポートしています。その他の RTMT 機能はサポートされていません。

始める前に

次の URL から RTMT をクライアントコンピュータにダウンロードし、インストールします。

https://FQDN:8443/plugins/CcmServRtmtPlugin.exe

ここで、FQDN は Finesse　サーバの完全修飾ドメイン名です。

手順

ステップ 1	Finesse 管理者クレデンシャルを使用して Unified RTMT にログインします。
ステップ 2	ツリー階層で、[Trace and Log Central] を選択します。
ステップ 3	次に、[ファイルの収集（Collect Files）] をダブルクリックします。 [トレース収集（Trace Collection）] ウィザードが表示されます。
ステップ 4	ログを収集する対象のサービスと Finesse ノードを選択し、ウィザードを完了します。

次のタスク

詳細については、『Cisco Unified Real-Time Monitoring Tool Administration Guide』を参照してください（このガイドには以下のサイトからアクセスできます）。

https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-maintenance-guides-list.html

Cisco Finesse Notification Service のロギング

Cisco Finesse Notification Service のロギングのステータスが有効か無効かを表示するには、以下のコマンドを実行します。

Cisco Finesse Notification Service のロギングのステータスを取得するには：utils finesse notification logging status

このコマンドは、Cisco Finesse Notification Service のロギングが現在、システム上で有効か無効かを表示します。

（注）

Cisco Finesse Notification Service ロギングのステータスを取得するコマンドを実行する前に Cisco Finesse Notification Service を実行していることを確認します。このサービスが実行されていない場合、このコマンドは失敗します。

Cisco Finesse Notification Service のロギングを有効にするには、次のコマンドを実行します。utils finesse notification logging enable

（注）

Cisco Finesse Notification Service ロギングを有効にするコマンドを実行する前に Cisco Finesse Notification Service を実行していることを確認してください。このサービスが実行されていない場合、このコマンドは失敗します。また、このコマンドは、Cisco Finesse Notification Service のロギングがすでに有効の場合にも失敗します。

ロギングを有効にし、Cisco Finesse Notification Service を再起動すると、ロギングは自動的に無効になります。

Cisco Finesse Notification Service のロギングを無効にするには、次のコマンドを実行します。utils finesse notification logging disable

（注）

Cisco Finesse Notification Service ロギングを無効にするコマンドを実行する前に Cisco Finesse Notification Service を実行していることを確認してください。このサービスが実行されていない場合、このコマンドは失敗します。また、このコマンドは、Cisco Finesse Notification Service のロギングがすでに無効の場合にも失敗します。

リモートアカウント管理

リモートアクセスアカウントの有効化、無効化、作成、および状態の確認を行うには、次のコマンドを実行します。utils remote_account

リモートアカウントは、パスフレーズを生成します。シスコのサポート担当者はこのパスフレーズを使用することにより、アカウントの指定有効期間の間、システムにアクセスできます。

utils remote_account create account life

account はアカウント名です。life は、アカウントの有効期限を日単位で示します。
utils remote_account disable
utils remote_account enable
utils remote_account status

Cisco Finesse 管理ガイド Release 11.6(1)

偏向のない言語

翻訳について

Book Title

Cisco Finesse 管理ガイド Release 11.6(1)

Chapter Title