Sametime コミュニティー・サーバーログの有効化と収集

Sametime® コミュニティー・サーバーには、問題判別のために構成ファイルとログ・ファイルを自動的に収集するユーティリティがあります。この情報を、Sametime コミュニティー・サーバーの問題の調査のために、HCL サポートに提供できます。

このタスクについて

一般的な診断情報の収集に推奨されるトレース・レベルは、VP_TRACE_ALL=1 です。ただし、このトレースレベルは非常に詳細であり、空きディスク容量と CPU 使用率に余裕のあるサーバーのみで使用する必要があります。ほぼ満杯の容量で稼働する実動サーバーでトレースを有効にする必要がある場合は、IBM サポートに連絡して、システム・リソースへの影響が高くない具体的な診断設定を確認してください。

トレースが VP_TRACE_ALL に含まれていません

VP_TRACE_ALL は、Sametime コミュニティー・サーバー上の一般的な診断情報のほとんどを有効にします。このトレース設定には、個別に設定できるサービスが含まれていません。

Sametime チャットの履歴トレースの場合は、 sametime.ini の [st chathistory] セクションに次の情報を追加します。
STCHAT_DEBUG_LEVEL=FINEST
Sametime ビジネス・カードのトレースの場合は、 sametime.ini の [Debug] セクションに追加します。
USERINFO_DEBUG_LEVEL=5
Sametime ポリシーのトレースの場合は、 sametime.ini の [Debug] セクションに追加します。
POLICY_DEBUG_LEVEL=5
STPOLICY or CONVOMPA or USERINFO

コンポーネント・レベルのトレースの詳細については、「 Sametime コミュニティー・サーバーの共通デバッグ・パラメーター」を参照してください。

以下の手順に従って、コミュニティー・サーバーでトレース・レベルを設定します。これらのステップが完了したら、問題を再現して情報がログに収集されるようにします。変更を行う前に、必ず構成ファイルのバックアップ・コピーを保持してください。

<Program directory> example: Programs/hcl/domino

<Data directory> example: Programs/hcl/domino/data

手順

  1. 両方の Domino® サーバーを停止します。これにより、Sametime コミュニティー・サーバーが停止されます。
  2. 古いログファイルを Sametime trace ディレクトリから削除します。これは通常、<Program Directory>/trace フォルダー内にあります。トレース・フォルダーは削除できません。
  3. (管理者として) <Program directory> にある sametime.ini ファイルを編集します。このファイルの [Debug] セクションを見つけます。
  4. 以下の行を [Debug] セクションに追加または修正します。

    VP_TRACE_ALL=1

  5. オプション: トレース・レベルの設定に加えて、各トレース・ファイルの最大ファイルサイズと、ファイルがリサイクルされるまでに使用されるトレース・ファイルの最大数を設定できます。
    表 1. トレース設定
    トレース設定 説明
    ST_TRACEFILE_SIZE 各トレース・ファイルの最大ファイル・サイズを設定します。デフォルト値は 20 です。
    ST_TRACEFILE_CNT Sametime サービス・アプリケーションごとに生成されるトレース・ファイルの数を設定します。デフォルト値は、25 です。
    ST_TRACEFILE_SIZE ST_TRACEFILE_SIZE に ST_TRACEFILE_CNT を掛けた値が、Sametime サービス・アプリケーションごとの、オペレーティング・システムのハードディスク上でのトレース・ファイルの最大サイズになります。

    例えば、sametime.ini ファイルに以下の設定が含まれるときは、このようになります。

    ST_TRACEFILE_SIZE=20ST_TRACEFILE_CNT=25 つまり 10 X 25 は 250 であるため、250 MB が、各 Sametime サービス・アプリケーションがトレース・ファイルに費やす最大ディスク・スペースとなります。

  6. sametime.ini ファイルを保存して閉じます。
  7. Domino サーバーを停止し、起動します。Sametime は Domino で自動的に停止/開始されます。
  8. 診断情報を収集できるよう、トラブルシューティングする問題を再現します。
  9. 以下のパス例に示すように、stdiagzip コレクタユーティリティを実行します。

    Windows™

    C:\Program Files\hcl\domino\stdiagzip.bat

    AIX®/Linux™

    /local/notesdata> sh stdiagzip.sh

  10. 出力ファイルは、<Program directory>/Trace ディレクトリー内の以下の形式の圧縮ファイルです。 stdiags_hostname_MM_DD@hh_mm.zip

    Windows Explorer の unzip ツールではなく、WinZip や 7Zip などのツールを使用して、ファイル内容を解凍します。

  11. 次のデータを収集します。
    • 問題の再現に使用されたユーザー ID の詳細
    • 再現した障害の正確な日時
    • 問題の再現に使用されたクライアントアプリケーションのタイプおよびバージョン
    • サーバーの異常終了をトラブルシューティングしている場合は、異常終了の発生時に作成されたすべてのコアダンプ (NSD ログ) ファイルを送信してください。
    • HCL サポート・チームによる問題の調査に役立つと思われる、デプロイメント、設定、異常な動作に関する追加の詳細、その他の一般的な詳細。
    • 新しくインストールしたサーバーの場合は、<Data directory>_HCL_Sametime_Server_version ディレクトリーを含めます。

次のタスク

診断情報を収集した後は、コミュニティー・サーバーで有効になっていたトレースを無効にするか、デフォルトのレベルに戻します。sametime.ini を更新してトレースの詳細を削除したら、Domino サーバーをいったん停止して起動します。

Sametime コミュニティー・サーバーのトラブルシューティングを支援する必要がある場合は、製品ケースを HCL サポートで開き、収集したデータをケースにアップロードします。