Cisco Finesse アドミニストレーション ガイド
定期メンテナンスの実行
定期メンテナンスの実行

定期メンテナンスの実行

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

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

Cisco Finesse サービス

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

  • Cisco Finesse Notification Service:このサービスは、メッセージングとイベントに使用されます。 このサービスが開始されていない場合、コール イベント、エージェント状態の変更、統計情報などを表示できず、Finesse Desktop がサインイン後にロードされません。

  • Cisco Tomcat:このサービスには、導入されたすべての Finesse アプリケーションが含まれます。 Cisco Tomcat サービスを再起動するには、すべてのエージェントがサイン アウトしてから再びサイン インする必要があります。

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

  • Finesse Desktop アプリケーション:このアプリケーションは、エージェントおよびスーパーバイザ用のユーザ インターフェイスを提供します。

  • Finesse REST API アプリケーション:このアプリケーションは、Finesse デスクトップおよび Finesse 管理アプリケーションのために Cisco CTI サーバとの統合を実現します。 どの API をユーザが使用できるかは、ユーザの資格情報に関連付けられたロールによって異なります。 このアプリケーションは、Finesse REST API を使用するように作成されたサードパーティ アプリケーションで使用できるプログラミング インターフェイスも提供します。

  • Finesse Administration アプリケーション:このアプリケーションは、Finesse の管理オペレーションを提供します。

  • Finesse Diagnostic Portal アプリケーション:このアプリケーションは、Finesse のパフォーマンスに関する情報を提供します。

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


(注)  


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

  1. Cisco Tomcat サービスを停止します。

  2. Cisco Finesse Notification Service を停止します。

  3. Cisco Finesse Notification Service を開始します。

  4. Cisco Tomcat サービスを開始します。


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

手順
    ステップ 1   管理者ユーザ アカウントの資格情報を使用して CLI にサインインします。
    ステップ 2   すべてのサービスとその状態の一覧を表示するには、次のコマンドを入力してください。utils service list

    サービスの状態として、「STOPPED」、「STARTING」、「STARTED」のいずれかが表示されます。

    「STOPPED」はサービスが動作していないことを意味します。 「STARTING」はサービスが動作を開始し、初期化を実行していることを意味します。 「STARTED」はサービスが正常に初期化され、動作していることを意味します。

    ステップ 3   サービスを開始するには、次のコマンドを入力してください。utils service start service name

    例:たとえば、Cisco Tomcat を開始するには、utils service start Cisco Tomcat コマンドを入力します。
    ステップ 4   サービスを開始するには、次のコマンドを入力してください。utils service start service name

    例:たとえば、Cisco Tomcat を停止するには、utils service stop Cisco 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 です。 このディレクトリには最大 300 のログ ファイルが保存されます。 ログ ファイルが 100 MB に達すると、そのファイルは圧縮され、新しいログ ファイルが生成されます。 最後に圧縮されたデスクトップ ログ ファイルへの出力は、次に作成されるログ ファイルに引き継がれます。 ログ ファイルのラップアップ期間は、システムのユーザ数に基づいて異なります。 各デスクトップ ログ ファイル名にはタイム スタンプが含まれます。

      • desktop:このディレクトリには、Finesse デスクトップ ガジェットを保持する [Finesse agent desktop] ガジェットのコンテナからのログが保存されます。 Finesse エージェント デスクトップでのあらゆるコンテナ レベルのエラーがこれらのログ ファイルに表示されます。

      • admin:このディレクトリには、管理ガジェットを保持する [Finesse administration] ガジェットのコンテナからのログが保存されます。 Finesse 管理コンソールでのあらゆるコンテナ レベルのエラーがこれらのログ ファイルに表示されます。

      • clientlogs:このディレクトリには、Finesse エージェント デスクトップから Finesse サーバに送信されたクライアント側のログが保存されます。 各ログ ファイルは 1.5 MB 未満で、ファイルを送信したエージェントのタイムスタンプとエージェント ID が含まれます。 エージェントがクライアント側のログを送信するたびに新しいログ ファイルが作成されます(既存のログ ファイルにはデータが追加されません)。 このディレクトリの最大サイズは 100 MB です。 ディレクトリが 100 MB に達すると、サイズが 100 MB を超えないように、最も古いファイルが削除されます。

      • openfireservice:このディレクトリには Cisco Finesse Notification Service の起動とシャットダウンに関連する情報のログが保存されます。

      • openfire:このディレクトリには Cisco Finesse Notification Service の限定されたエラーおよび情報のログが保存されます。

      • finesse-dp:このディレクトリには、Finesse 診断ポータル アプリケーションによって生成される、開始、エラー、情報のログが保存されます。

      これらのログは 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 は長い形式のタイムスタンプです。

    • VOS インストール ログ:file get install install.log

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


    (注)  


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


    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

    Replication Status

    複製ステータスを調べるには、プライマリ Finesse サーバで次のコマンドを実行してください。

    • utils dbreplication runtimestate

      このコマンドは、プライマリおよびセカンダリ Finesse サーバの両方で複製ステータスを返します。

    • 複製の RTMT カウンタ値を確認します。 クラスタのすべてのノードが複製ステータスとして 2 を示す場合、複製は正しく動作しています。

      図 1. Replication Status

    • クラスタ内のすべてのノードで複製ステータスの RTMT カウンタ値が 3 または 4 の場合、複製は設定されていますが、エラーが生じ、複製が正しく動作していません。

    • ノードの大半で値 0 または 1 が表示される場合は、プライマリ Finesse サーバから utils dbreplication reset all コマンドを実行します。

    • いずれかのノードに対して 1 または 2 以外の複製値が表示される場合、複製が正しく設定されていません。

    • 複製を修正するには、シスコ テクニカル サポートに問い合わせてください。