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 驱动程序集跟踪参数

参数

说明

Driver trace level（驱动程序跟踪级别）

随着驱动程序对象跟踪级别的提高，DSTRACE 中显示的信息量也会增加。

跟踪级别 1 只显示错误，但不显示导致错误的原因。 如果希望查看口令同步信息，请将跟踪级别设置为 5。

XSL trace level（XSL 跟踪级别）

DSTRACE 会显示 XSL 事件。 仅在对 XSL 样式表进行查错时设置此跟踪级别。 如果不希望看到 XSL 信息，请将级别设置为 0。

Java debug port（Java 调试端口）

允许开发者挂接 Java 调试程序。

Java trace file（Java 跟踪文件）

在此字段中设置值后，驱动程序集对象的所有 Java 信息都会写入一个文件中。 此字段的值是该文件的增补程序。

只要指定了文件，Java 信息就将写入此文件中。 如果不需要调试 Java，请将此字段留为空。

Trace file size limit（跟踪文件大小限制）

允许设置 Java 跟踪文件大小限制。 如果将文件大小设置为无限制，则此文件可以大到占据所有磁盘剩余空间。

驱动程序

  1. 在 Designer 打开的项目中，在“大纲”视图下选择驱动程序对象。

    选择驱动程序对象

  2. 右键单击并选择“属性”，然后单击“8. 跟踪”。

  3. 设置跟踪参数，然后单击“确定”。有关这些参数的更多信息，请参见表 2-2。

    如果仅对驱动程序对象设置参数，DSTRACE 日志中将仅出现该驱动程序的信息。

表 2-2 驱动程序跟踪参数

参数

说明

Trace level（跟踪级别）

随着驱动程序对象跟踪级别的提高，DSTRACE 中显示的信息量也会增加。

跟踪级别 1 只显示错误，但不显示导致错误的原因。 如果希望查看口令同步信息，请将跟踪级别设置为 5。

如果选择 Use setting from Driver Set（使用驱动程序集的设置），将采用驱动程序集对象的值。

Trace file（跟踪文件）

指定文件名和所选驱动程序的 Identity Manager 信息的写入位置。

如果选择“使用驱动程序集的设置”，将采用驱动程序集对象的值。

Trace file size limit（跟踪文件大小限制）

允许设置 Java 跟踪文件大小限制。 如果将文件大小设置为无限制，则此文件可以大到占据所有磁盘剩余空间。

如果选择“使用驱动程序集的设置”，将采用驱动程序集对象的值。

Trace name（跟踪名称）

追加在驱动程序跟踪讯息前的为所输入的值，而不是驱动程序名称。 用于驱动程序名称过长的情况。

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 保存。 驱动程序对象的参数是跟踪文件参数。

下列方式有助于在不同的操作系统平台上通过 DSTRACE 截获并保存 Identity Manager 进程。

NetWare

使用 DSTRACE.NLM 在系统控制台上显示跟踪讯息或将跟踪讯息保存到文件中 (SYS:\SYSTEM\DSTRACE.LOG)。 DSTRACE.NLM 会将跟踪讯息显示在标为“DSTRACE Console”（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

    将跟踪讯息截获至文件 ndstrace.log，该文件位于 eDirectory 的安装目录中。 默认目录为 /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://服务器 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： 驱动器_字母:\Novell\NDS\ndsimon\dstrace\*.htm
  • UNIX： /var/nds/dstrace/*.htm