2.12 Identity Managerのプロセスの表示

Identity Manageのプロセスイベントを表示するには、DSTRACEを使用します。これは、Identity Managerをテストおよびトラブルシューティングする場合にのみ使用してください。ドライバの運用中にDSTRACEを実行すると、Identity Managerサーバ上の使用率が増加して、イベントの処理速度が非常に遅くなる場合があります。

DSTRACEでIdentity Managerのプロセスを調べるには、ドライバセットおよびドライブのオブジェクトに値を追加します。これは、DesignerおよびiManagerで実行できます。

2.12.1 Designerでのトレースレベルの追加

ドライバセットオブジェクトまたは各ドライバオブジェクトにトレースレベルを追加できます。

ドライバセット

  1. Designer内で開いているプロジェクトの［Outline (アウトライン)］ビューで、ドライバセットオブジェクトを選択します。

    ドライバセットオブジェクトの選択

  2. 右クリックして［プロパティ］を選択し、［5. Trace (5. トレース)］をクリックします。

  3. トレースパラメータを設定し、［OK］をクリックします。ドライバセットのトレースパラメータの詳細については、表 2-1を参照してください。

    ドライバセットオブジェクトのトレースレベルを設定すると、すべてのドライバがDSTRACEログに記述されます。

表 2-1 ドライバセットのトレースパラメータ

パラメータ

説明

ドライバトレースレベル

ドライバオブジェクトのトレースレベルを上げると、DSTRACEに表示される情報量が増えます。

トレースレベル1はエラーを示しますが、エラーの原因は示しません。パスワード同期の情報を表示するには、トレースレベルを5に設定します。

XSLトレースレベル

DSTRACEでは、XSLイベントが表示されます。このトレースレベルは、XSLスタイルシートのトラブルシューティング時にのみ設定します。XSL情報を表示しない場合は、レベルをゼロに設定します。

Javaデバッグポート

開発者はJavaデバッガをアタッチできます。

Javaトレースファイル

このフィールドの値が設定されている場合、ドライバセットオブジェクトのすべてのJava情報がファイルに書き込まれます。このフィールドの値は、そのファイルのパッチです。

ファイルを指定すると、Java情報がこのファイルに書き込まれます。Javaをデバッグする必要がない場合、このフィールドを空白のままにします。

トレースファイルのサイズ制限

Javaトレースファイルの制限を設定できます。ファイルサイズを無制限に設定した場合、ディスクスペースがなくなるまでファイルサイズが増加します。

ドライバ

  1. Designer内で開いているプロジェクトの［Outline (アウトライン)］ビューで、ドライバオブジェクトを選択します。

    ドライバオブジェクトの選択

  2. 右クリックして［プロパティ］を選択し、［8. Trace (8. トレース)］をクリックします。

  3. トレースパラメータを設定し、［OK］をクリックします。これらのパラメータの詳細については、表 2-2を参照してください。

    ドライバオブジェクトのパラメータのみを設定した場合、そのドライバの情報のみがDSTRACEログに記述されます。

表 2-2 ドライバのトレースパラメータ

パラメータ

説明

トレースレベル

ドライバオブジェクトのトレースレベルを上げると、DSTRACEに表示される情報量が増えます。

トレースレベル1はエラーを示しますが、エラーの原因は示しません。パスワード同期の情報を表示するには、トレースレベルを5に設定します。

［Use setting from Driver Set (ドライバセットの設定を使用する)］を選択した場合、値はドライバセットオブジェクトから取得されます。

トレースファイル

選択したドライバに対して、ファイル名およびIdentity Manager情報を書き込む場所を指定します。

［Use setting from Driver Set (ドライバセットの設定を使用する)］を選択した場合、値はドライバセットオブジェクトから取得されます。

トレースファイルのサイズ制限

Javaトレースファイルの制限を設定できます。ファイルサイズを無制限に設定した場合、ディスクスペースがなくなるまでファイルサイズは増加します。

［Use setting from Driver Set (ドライバセットの設定を使用する)］を選択した場合、値はドライバセットオブジェクトから取得されます。

トレース名

ドライバトレースメッセージの前に、ドライバ名の代わりに入力した値が付きます。ドライバ名が長い場合に使用します。

2.12.2 iManagerでのトレースレベルの追加

ドライバセットオブジェクトまたは各ドライバオブジェクトにトレースレベルを追加できます。

ドライバセット

  1. iManagerで、［Identity Manager］>［Identity Managerの概要］の順に選択します。

  2. ドライバセットオブジェクトを参照し、［検索］をクリックします。

  3. ドライバセット名をクリックします。

    ドライバセットオブジェクトの選択

  4. ドライバセットオブジェクトの［その他］タブを選択します。

  5. トレースパラメータを設定し、［OK］をクリックします。これらのパラメータの詳細については、表 2-1を参照してください。

ドライバ

  1. iManagerで、［Identity Manager］>［Identity Managerの概要］の順に選択します。

  2. ドライバオブジェクトがあるドライバセットオブジェクトを参照し、［検索］をクリックします。

  3. ドライバオブジェクトの右上隅をクリックし、［プロパティの編集］をクリックします。

  4. ドライバオブジェクトの［その他］タブを選択します。

  5. トレースパラメータを設定し、［OK］をクリックします。詳細については、表 2-2を参照してください。

    メモ:［Use setting from Driver Set (ドライバセットの設定を使用する)］のオプションは、iManagerには存在しません。

2.12.3 ファイルへのIdentity Managerのプロセスのキャプチャ

Identity Managerのプロセスをファイルに保存する場合、ドライバオブジェクトのパラメータ、またはDSTRACEを使用して保存します。ドライバオブジェクトのパラメータは、［トレースファイル］パラメータです。

次の方法は、異なるOSプラットフォーム上でDSTRACEを使用して、Identity Managerのプロセスをキャプチャおよび保存する場合に役立ちます。

NetWare

システムコンソールにトレースメッセージを表示したり、ファイル(SYS:\SYSTEM\DSTRACE.LOG)にトレースメッセージを出力したりするには、DSTRACE.NLMを使用します。DSTRACE.NLMにより、［DSTRACE Console (DSTRACEコンソール)］画面にトレースメッセージが表示されます。

  1. サーバコンソールで「DSTRACE.NLM」と入力します。

    これにより、メモリにDSTRACE.NLMがロードされます。

  2. サーバコンソールで「DSTRACE SCREEN ON」と入力します。

    ［DSTRACE Console (DSTRACEコンソール)］画面にトレースメッセージが表示されます。

  3. サーバコンソールで「DSTRACE FILE ON」と入力します。

    これにより、［DSTRACE Console (DSTRACEコンソール)］に送信されたトレースメッセージがDSTRACE.LOGにキャプチャされます。

  4. サーバコンソールで「DSTRACE -ALL」と入力します。

    すべてのトレースのフラグがオフになります。

  5. サーバコンソールで「DSTRACE +DXML DSTRACE +DVRS」と入力します。

    Identity Managerイベントが表示されます。

  6. サーバコンソールで「DSTRACE +TAGS DSTRACE +TIME」と入力します。

    メッセージタグおよびタイムスタンプが表示されます。

  7. ［DSTRACE Console (DSTRACEコンソール)］画面に切り替え、渡されるイベントを確認します。

  8. サーバコンソールに再度切り替えます。

  9. サーバコンソールで「DSTRACE FILE OFF」と入力します。

    ログファイルへのトレースメッセージのキャプチャが停止されます。ファイルへの情報のログも停止されます。

  10. テキストエディタでDSTRACE.LOGを開き、変更したイベントまたはオブジェクトを検索します。

Windows

  1. ［コントロールパネル］>［NDS Services (NDSサービス)］>［dstrace.dlm］の順に開き、［開始］をクリックします。

    ［NDS Server Trace Utility (NDSサーバトレースユーティリティ)］という名前のウィンドウが開きます。

  2. ［編集］>［オプション］の順に選択し、［すべてクリア］をクリックします。

    これにより、すべてのデフォルトのフラグがクリアされます。

  3. ［DirXML］>［DirXMLドライバ］の順に選択します。

  4. ［OK］をクリックします。

  5. ［ファイル］>［新規］の順に選択します。

  6. ファイル名およびDSTRACE情報を保存する場所を指定し、［開く］をクリックします。

  7. イベントが発生するのを待機します。

  8. ［ファイル］>［閉じる］の順に選択します。

    これにより、ログファイルへの情報の書き込みが停止されます。

  9. テキストエディタでファイルを開き、変更したイベントまたはオブジェクトを検索します。

UNIX

  1. 「ndstrace」と入力し、ndstraceユーティリティを起動します。

  2. 「set ndstrace=nodebug」と入力します。

    現在設定されているすべてのトレースのフラグがオフになります。

  3. 「set ndstrace on」と入力します。

    トレースメッセージがコンソールに表示されます。

  4. 「set ndstrace file on」と入力します。

    eDirectoryがインストールされたディレクトリにあるndstrace.logファイルに、トレースメッセージがキャプチャされます。デフォルトでは、/var/ndsです。

  5. 「set ndstrace=+dxml」と入力します。

    Identity Managerイベントが表示されます。

  6. 「set ndstrace=+dvrs」と入力します。

    Identity Managerドライバイベントが表示されます。

  7. イベントが発生するのを待機します。

  8. 「set ndstrace file off」と入力します。

    これにより、ファイルへの情報のログが停止されます。

  9. 「exit」と入力し、ndstraceユーティリティを終了します。

  10. ファイルをテキストエディタで開きます。変更されたイベントまたはオブジェクトを検索します。

iMonitor

iMonitorを使用すると、WebブラウザからDSTRACE情報を参照できます。Identity Managerが実行されている場所は関係ありません。iMonitorを実行するファイルは、次のとおりです。

  • NDSIMON.NLM - NetWareで動作します。
  • NDSIMON.DLM - Windowsで動作します。
  • ndsimonitor - UNIXで動作します。

  1. http://server_ip:8008/ndsからiMonitorにアクセスします。

    ポート8008はデフォルトのポートです。

  2. 管理者権限を使用してユーザ名およびパスワードを入力し、［ログイン］をクリックします。

  3. 左側の［トレースの環境設定］を選択します。

  4. ［すべてクリア］をクリックします。

  5. ［DirXML］>［DirXMLドライバ］の順に選択します。

  6. ［オン］をクリックします。

  7. 左側の［トレース履歴］を選択します。

  8. ドキュメントの［Modification Time of Current (現在の変更時刻)］をクリックし、ライブトレースを表示します。

  9. より頻繁に情報を表示するには、［リフレッシュ間隔］を変更します。

  10. 左側の［トレースの環境設定］を選択し、［オフ］をクリックしてトレースをオフにします。

  11. ［トレース履歴］を選択すると、トレースの履歴を表示できます。ファイルはタイムスタンプで区別されます。

HTMLファイルのコピーが必要な場合、デフォルトの場所は次のとおりです。

  • NetWare: SYS:\SYSTEM\ndsimon\DSTRACE*.htm
  • Windows: Drive_letter:\Novell\NDS\ndsimon\dstrace\*.htm
  • UNIX: /var/nds/dstrace/*.htm