この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
目次
CLI にアクセスして、サービスの表示、停止、または開始、ロギング、管理のリモート アカウントのロギングや管理、サードパーティ ガジェットのアカウントの管理、レプリケーションのチェックなどの定期メンテナンス タスクを実行します。
管理者ユーザ アカウントの資格情報を使用して CLI にアクセスします。
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 を再起動します。
これらのコマンドでは、ファイルのアップロード先としてセキュア 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 のロギングのステータスを取得するには: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
リモート アカウントは、パスフレーズを生成します。シスコのサポート担当者はこれを使用することにより、アカウントの指定有効期間の間、システムにアクセスできます。
複製ステータスを調べるには、プライマリ Finesse サーバで次のコマンドを実行してください。
utils dbreplication runtimestate
このコマンドは、プライマリおよびセカンダリ Finesse サーバの両方で複製ステータスを返します。
複製の RTMT カウンタ値を確認します。 クラスタのすべてのノードが複製ステータスとして 2 を示す場合、複製は正しく動作しています。
クラスタ内のすべてのノードで複製ステータスの RTMT カウンタ値が 3 または 4 の場合、複製は設定されていますが、エラーが生じ、複製が正しく動作していません。
ノードの大半で値 0 または 1 が表示される場合は、プライマリ Finesse サーバから utils dbreplication reset all コマンドを実行します。
いずれかのノードに対して 1 または 2 以外の複製値が表示される場合、複製が正しく設定されていません。
複製を修正するには、シスコ テクニカル サポートに問い合わせてください。
目次
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 を再起動します。
サービスの表示、開始、または停止
手順
ログの収集
これらのコマンドでは、ファイルのアップロード先としてセキュア 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 のロギングがすでに無効の場合にも失敗します。
関連資料
リモート アカウント管理
Replication Status
複製ステータスを調べるには、プライマリ Finesse サーバで次のコマンドを実行してください。
utils dbreplication runtimestate
このコマンドは、プライマリおよびセカンダリ Finesse サーバの両方で複製ステータスを返します。
複製の RTMT カウンタ値を確認します。 クラスタのすべてのノードが複製ステータスとして 2 を示す場合、複製は正しく動作しています。
クラスタ内のすべてのノードで複製ステータスの RTMT カウンタ値が 3 または 4 の場合、複製は設定されていますが、エラーが生じ、複製が正しく動作していません。
ノードの大半で値 0 または 1 が表示される場合は、プライマリ Finesse サーバから utils dbreplication reset all コマンドを実行します。
いずれかのノードに対して 1 または 2 以外の複製値が表示される場合、複製が正しく設定されていません。
複製を修正するには、シスコ テクニカル サポートに問い合わせてください。