2.12 檢視 Identity Manager 程序

若要檢視 Identity Manage 處理事件，請使用 DSTRACE。 僅在測試和疑難排解 Identity Manager 時才會使用它。 在驅動程式用於生產時執行 DSTRACE，會提高 Identity Manager 伺服器的使用率，且會導致事件處理非常緩慢。

為了在 DSTRACE 中看到 Identity Manager 程序，會將值新增至「驅動程式集」和「驅動程式」物件。 您可以在 Designer 和 iManager 中這樣做。

2.12.1 在 Designer 中新增追蹤層級

您可以將追蹤層級新增至「驅動程式集」物件或每個「驅動程式」物件。

驅動程式集

  1. 在 Designer 中開啟的專案內，選取「大綱」檢視窗中的「驅動程式集」物件。

    選取驅動程式集物件

  2. 按一下滑鼠右鍵並選取「內容」，然後按一下「5. 追蹤」。

  3. 設定用於追蹤的參數，然後按一下「確定」。如需「驅動程式集」追蹤參數的相關資訊，請參閱表 2-1。

    如果在「驅動程式集」物件上設定追蹤層級，則所有驅動程式都會顯示在 DSTRACE 記錄中。

表 2-1 驅動程式集追蹤參數

參數

描述

驅動程式追蹤層級

隨著「驅動程式」物件追蹤層級的增加，DSTRACE 中顯示的資訊量也會增加。

追蹤層級一顯示錯誤，但不會顯示錯誤原因。 如果您要查看密碼同步化資訊，請將追蹤層級設為五。

XSL 追蹤層級

DSTRACE 會顯示 XSL 事件。 僅在疑難排解 XSL 樣式表時才設定此追蹤層級。 如果您不想要查看 XSL 資訊，請將層級設為零。

Java 除錯埠

允許開發人員連接 Java 除錯程式。

Java 追蹤檔案

在此欄位中設定值時，「驅動程式集」物件的所有 Java 資訊都會寫入檔案。 此欄位中的值是該檔案的修補。

只要指定該檔案，Java 資訊就會寫入此檔案。 如果您不需要除錯 Java，請將此欄位保留空白。

追蹤檔案大小限制

允許您設定 Java 追蹤檔案的限制。 如果您將檔案大小設為沒有限制，則檔案大小會一直增加，直到沒有剩餘的磁碟空間為止。

驅動程式

  1. 在 Designer 中開啟的專案內，選取「大綱」檢視窗中的「驅動程式」物件。

    選取驅動程式物件

  2. 按一下滑鼠右鍵並選取「內容」，然後按一下「8. 追蹤」。

  3. 設定用於追蹤的參數，然後按一下「確定」。如需這些參數的相關資訊，請參閱表 2-2。

    如果僅在「驅動程式」物件上設定參數，則 DSTRACE 記錄中僅會顯示該驅動程式的資訊。

表 2-2 驅動程式追蹤參數

參數

描述

追蹤層級

隨著「驅動程式」物件追蹤層級的增加，DSTRACE 中顯示的資訊量也會增加。

追蹤層級一顯示錯誤，但不會顯示錯誤原因。 如果您想要查看密碼同步化資訊，請將追蹤層級設為五。

如果選取「使用驅動程式集的設定」，則會從「驅動程式集」物件取得該值。

追蹤檔案

為選定的驅動程式指定要寫入 Identity Manager 資訊的檔名和位置。

如果選取「使用驅動程式集的設定」，則會從「驅動程式集」物件取得該值。

追蹤檔案大小限制

允許您設定 Java 追蹤檔案的限制。 如果您將檔案大小設為沒有限制，則檔案大小會一直增加，直到沒有剩餘的磁碟空間為止。

如果選取「使用驅動程式集的設定」，則會從「驅動程式集」物件取得該值。

追蹤名稱

輸入的值 (而不是驅動程式名稱) 會預加在驅動程式追蹤訊息中。請在驅動程式名稱過長時使用。

2.12.2 在 iManager 中新增追蹤層級

您可以新增追蹤層級至「驅動程式集」物件或每個「驅動程式」物件。

驅動程式集

  1. 在 iManager 中，選取「Identity Manager > Identity Manager 概觀」。

  2. 瀏覽至「驅動程式集」物件，然後按一下「搜尋」。

  3. 按一下「驅動程式集」名稱。

    選取驅動程式集物件

  4. 選取「驅動程式集」物件的「其他」索引標籤。

  5. 設定用於追蹤的參數，然後按一下「確定」。如需這些參數的相關資訊，請參閱表 2-1。

驅動程式

  1. 在 iManager 中，選取「Identity Manager > Identity Manager 概觀」。

  2. 瀏覽至「驅動程式」物件所在的「驅動程式集」物件，然後按一下「搜尋」。

  3. 按一下「驅動程式」物件的右上角，然後按一下「編輯內容」。

  4. 選取「驅動程式」物件的「其他」索引標籤。

  5. 設定用於追蹤的參數，然後按一下「確定」。如需相關資訊，請參閱表 2-2。

    附註：選項「使用驅動程式集的設定」不存在於 iManager 中。

2.12.3 擷取 Identity Manager 程序至檔案

為了將 Identity Manager 程序儲存至檔案中，會透過「驅動程式」物件上的參數或透過 DSTRACE 來進行儲存。 「驅動程式」物件上的參數是「追蹤檔案」參數。

下列方法可協助您透過不同 OS 平台上的 DSTRACE 擷取並儲存 Identity Manager 程序。

NetWare

使用 DSTRACE.NLM，將追蹤訊息顯示在系統主控台上，或將追蹤訊息擷取到檔案 (SYS:\SYSTEM\DSTRACE.LOG)。 DSTRACE.NLM 將追蹤訊息顯示到標示為「DSTRACE 主控台」的螢幕中。

  1. 在伺服器主控台中輸入 DSTRACE.NLM。

    即會將 DSTRACE.NLM 載入至記憶體中。

  2. 在伺服器主控台上輸入 DSTRACE SCREEN ON。

    允許追蹤訊息出現在「DSTRACE 主控台」螢幕上。

  3. 在伺服器主控台中輸入 DSTRACE FILE ON。

    將傳送至「DSTRACE 主控台」的追蹤訊息擷取至 DSTRACE.LOG 中。

  4. 在伺服器主控台中輸入 DSTRACE -ALL。

    關閉所有追蹤旗標。

  5. 在伺服器主控台中輸入 DSTRACE +DXML DSTRACE +DVRS。

    顯示 Identity Manager 事件。

  6. 在伺服器主控台中輸入 DSTRACE +TAGS DSTRACE +TIME。

    顯示訊息標籤和時戳。

  7. 切換至「DSTRACE 主控台」螢幕，並監視要傳遞的事件。

  8. 切換回伺服器主控台。

  9. 在伺服器主控台中輸入 DSTRACE FILE OFF。

    停止將追蹤訊息擷取到記錄檔案。 同時會停止將資訊記錄到檔案中。

  10. 在文字編輯器中開啟 DSTRACE.LOG，並搜尋已修改的物件或事件。

Windows

  1. 開啟「控制台」>「NDS 服務」>「dstrace.dlm」，然後按一下「啟動」。

    即會開啟名為「NDS 伺服器追蹤公用程式」的視窗。

  2. 選取「編輯」>「選項」，然後按一下「全部清除」。

    即會清除所有預設旗標。

  3. 選取「DirXML」和「DirXML 驅動程式」。

  4. 按一下「確定」。

  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 可讓您從網頁瀏覽器取得 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. 按一下具有「目前修改時間」的文件，以查看即時追蹤。

  9. 如果要更常查看資訊，請變更「重新整理間隔」。

  10. 選取左邊的「追蹤組態」，然後按一下「關閉追蹤」，以關閉追蹤。

  11. 您可以選取「追蹤歷程」來檢視追蹤的歷程。 您可以依時戳來區分這些檔案。

如果需要 HTML 檔案的副本，則預設位置為：

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