启动 Domino® Diagnostic Probe

Domino® Diagnostic Probe (DDP) 从命令提示符处启动，并以独立进程的形式运行，而不是以 Domino® 服务器进程的形式运行。

开始之前

必须使用随 Domino® 一起提供的 Eclipse OpenJ9 Java™。SUN Java™ 不支持探测。

警告： 探测正在运行时不应重新启动 Domino® 服务器。重新启动 Domino® 服务器之前，必须关闭探测，否则关闭期间某些 Domino® 进程可能会挂起。（最终将清理这些进程，并创建 NSD。）

关于此任务

探测使用 Domino® 服务器的身份，并尝试按照 -database [-d] 参数的指定每隔 -polling [-p] 参数指定的 n 秒打开一个会话和一个数据库。如果用于打开数据库的时间超过了 -threshold [-t] 参数指定的时间，将启动 NSD 程序来收集诊断数据。domino_data_directory\IBM_TECHNICAL_SUPPORT 目录中会生成一个 NSD 日志文件。也可为探测指定以下过程中的表内列出的可选参数。

过程

  1. 对于要使用探测监控的每个数据库，请打开数据库并选择文件 > 应用程序 > 访问控制。
  2. 在“访问控制表”中，添加 Domino® 服务器名称并突出显示，然后将属性下的用户类型更改为未指定。保存访问控制表。
  3. 要在 Windows™ 或 UNIX™ 上运行探测，请确保 Domino® 程序的缺省安装目录中包含 dbopen.jar。
  4. 从命令提示符处切换到服务器的 NOTES.INI 所在目录（UNIX™ 上通常为数据目录，而在 Windows™ 上通常为程序目录）。使用表中提供的语法示例从命令提示符启动探测。
    表 1. Windows 和 UNIX™ 上 Domino® Diagnostic Probe 的命令
    平台 命令语法
    Windows™ jvm\bin\java -jar dbopen.jar -d mail\domprobe.nsf -t 3 -p 30 -nsdoptions "-nomemcheck" -outfile C:\Domino\data\IBM_TECHNICAL_SUPPORT\DomPerfMon.txt
    注： 如果使用的是 Windows™ 2008，请在 jvm/bin/java.exe 的文件属性中的“兼容性”选项卡上设置以管理员身份运行此程序。
    UNIX™ （在数据目录中） /opt/ibm/lotus/bin/java -jar /opt/ibm/lotus/bin/dbopen.jar -d mail/domprobe.nsf -t 3 -polling 45 -nsdoptions "-stacks" -outfile domperfmon.log
    注： UNIX™ 和 IBM® i 平台命令示例区分大小写。探测将按名称连接到服务器。
  5. 要在 IBM i 上运行探测，请执行以下步骤以使用 QShell (STRQSH)。
    注： UNIX™ 和 IBM® i 平台命令示例区分大小写。探测将按名称连接到服务器。在 IBM® i 上，使用命令 Configure TCP/IP (CFGTCP) 并选择 Work with TCP/IP host table entries（选项 10）以显示主机表。使用 Add TCP/IP Host Table Entry (ADDTCPHTE) 向主机表添加服务器名称和 IP@（如果需要）。
    1. 使用以下 RUNDOMCMD 命令启动 QShell，并将 servername 替换为 Domino® 服务器的名称： RUNDOMCMD SERVER(servername) CMD(STRQSH) BATCH(*NO)
    2. 切换到服务器的数据目录（如 cd /domino/data）
    3. 使用以下命令（输入为一行）启动探测，并将 filename.nsf 替换为要进行求值的数据库的文件名： /QOpenSys/usr/bin/java -Djava.library.path=/QIBM/ProdData/LOTUS/domino100001 -jar /QIBM/ProdData/LOTUS/domino100001/dbopen.jar -database mail/filename.nsf
  6. 可选： 包含探测的任何所需可选参数。下表中列出的所有参数均为可选参数，但 -database [-d] 参数除外。
    表 2. Domino® Diagnostic Probe 实用程序的选项
    参数 缺省值 用途
    -database [-d]（必需） 无 待打开数据库，例如， mail/test.nsf
    -threshold [-t] 30 如果用于打开数据库的时间比阈值长，则运行 NSD。值以秒计。
    -polling [-p] 60 轮询数据库以打开的频率（秒）。
    -nsdoptions ALL 传递到 NSD 的选项。必须用引号引起来，如 "-nomecheck -stacks"。缺省的“ALL” 将运行以下所有命令：DUMP、MEMCHECK、PERF、HANDLES、WALKMEM 和 PS。

    键入 nsd -help 可查看所有可用 NSD 参数。

    -outfile 无 将输出打印到指定日志文件（如 c:\temp\DDPlog.txt）和显示屏。如果文件路径中包含“空格”字符，则必须使用引号将文件名引起来。如果未指定路径，将在 Domino® 程序目录中创建文件。如果在后续运行时指定了现有日志文件，将把输出附加到该日志文件。
    -help - 显示帮助文本。

结果

Domino® 服务器控制台将显示服务器打开和关闭的会话（服务器为每个轮询周期打开一个会话 - 每次在 Domino® 服务器上打开新会话时，将关闭上一个会话。）探测的输出将打印到本地命令窗口以及日志文件（如果指定了）。如果数据库打开时间超过了指定阈值，将创建一个 NSD。NSD 完成之后，您将看到一条消息，说明 NSD 已完成，将恢复记录。

示例

诊断探测会话的 Domino 服务器控制台输出示例：

07/12/2010 04:45:48 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])
07/12/2010 04:45:48 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:     0 
07/12/2010 04:45:49 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])
07/12/2010 04:45:49 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:     0
07/12/2010 04:45:54 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])    
07/12/2010 04:45:54 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:    0
07/12/2010 04:45:59 PM  Opened session for vlap2/vTest (Release 8.5.2 [Build 379])
07/12/2010 04:45:59 PM  Closed session for vlap2/vTest Databases accessed:     1   Documents read:     0   Documents written:     0
注： 探测关闭时，将关闭此探测的任何会话。当探测发出以下消息时，表示会话结束：关闭完成。

DDP 会话的命令提示符活动示例：

[C:\Domino] jvm\bin\java -jar dbopen.jar -d mail\domprobe.nsf -threshold 3 -polling 45 -nsdoptions "-nomemcheck" -outfile C:\Domino\data\IBM_TECHNICAL_SUPPORT\perfmon.txt
11/09/2009 5:46:10 AM Opening database mail\domprobe.nsf has taken 3.001 seconds. This exceeds the set threshold of 3.0 seconds.

数据库打开时间超出阈值 3 秒，因此 NSD 立即开始。

11/09/2009 5:46:10 AM Running NSD...

正在创建 NSD。

11/09/2009 5:47:44 AM NSD completed with exit status 0

NSD 完成。

11/09/2009 5:47:45 AM Opening database mail\domprobe.nsf took a total of 4.001 seconds

NSD 完成后，DDP 会记录数据库打开总时间，在本例中为 4.001 秒。NSD 在延迟的数据库打开时（3.0001秒）捕获了服务器的状态。

11/09/2009 5:48:33 AM Opening database mail\domprobe.nsf has taken 3.001 seconds. This exceeds the set threshold of 3.0 seconds.
11/09/2009 5:48:33 AM Running NSD...
11/09/2009 5:48:59 AM NSD completed with exit status 0
11/09/2009 5:49:00 AM Opening database mail\domprobe.nsf took a total of 5.354 seconds

此数据库打开用时 5.354 秒。

...
Quit

管理员已发出 quit 命令来停止探测。必须使用 quit 来停止探测。

11/09/2009 5:51:42 AM Shut down in progress...

开始关闭探测。

11/09/2009 05:52:18 AM Shut down complete.
 Shut down of probe is complete. It can take several minutes to complete shut down if an NSD is in progress.