啟動 Domino® 診斷探測

「Domino® 診斷探測 (DDP)」是從命令提示字元啟動，並執行為獨立式程序，而不是 Domino® 伺服器程序。

開始之前

您必須使用 Domino® 隨附的 Eclipse OpenJ9 Java™。SUN Java™ 不支援此探測。

注意： 在執行探測時，您不應該重新啟動 Domino® 伺服器。在重新啟動 Domino® 伺服器之前，必須關閉探測，否則某些 Domino® 程序在關閉期間，可能會發生停滯現象。（最後會清除這些程序，並建立 NSD）。

執行這項作業的原因和時機

此探測會使用 Domino® 伺服器的身分，並嘗試每隔 n 秒（如 -polling [-p] 參數所指定）開啟階段作業和資料庫（如 -database [-d] 參數所指定）。如果開啟資料庫所花費的時間超出 -threshold [-t] 參數所指定的時間，則會啟動 NSD 程式來收集診斷資料。NSD 日誌檔會在 domino_data_directory\IBM_TECHNICAL_SUPPORT 名錄中產生。您也可以為此探測指定下列程序中表格所列出的選用參數。

程序

  1. 對於您要使用探測監視的每一個資料庫，開啟資料庫並選取「檔案 > 應用程式 > 存取控制」。
  2. 在「存取控制清單」中，新增 Domino® 伺服器名稱並加以強調顯示，然後在「屬性」下，將「使用者類型」變更為「未指定」。儲存存取控制清單。
  3. 若要在 Windows™ 或 UNIX™ 上執行探測，請確定 Domino® 程式目錄中有 dbopen.jar，依預設，它會安裝在該目錄中。
  4. 從命令提示字元切換至伺服器的 NOTES.INI 所在的目錄（通常是 UNIX™ 上的資料目錄及 Windows™ 上的程式目錄）。使用此表格所提供的語法範例，從命令提示字元中啟動探測。
    表 1. Windows 及 UNIX™ 上用於 Domino® 診斷探測的指令
    平台 指令語法
    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 上，使用「配置 TCP/IP (CFGTCP)」指令，並選取「使用 TCP/IP 主機表項目」（選項 10）來顯示主機表。必要的話，請使用「新增 TCP/IP 主機表項目 (ADDTCPHTE)」，將伺服器名稱及 IP@ 新增至主機表。
    1. 使用下列 RUNDOMCMD 指令啟動 QShell，以 Domino® 伺服器的名稱取代 servername： 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® 診斷探測公用程式的選項
    參數 預設值 用途
    -資料庫[-d]（必要） 無 要開啟的資料庫；例如，mail/test.nsf
    -threshold [-t] 30 如果資料庫開啟所花費的時間超出臨界值，則執行 NSD。值以秒為單位。
    -polling [-p] 60 輪詢資料庫以開啟的頻率（以秒為單位）。
    -nsdoptions 全部 傳遞至 NSD 的選項。必須以引號括住；例如，"-nomecheck -stacks"。預設的 "ALL" 會執行下列所有指令：DUMP、MEMCHECK、PERF、HANDLES、WALKMEM 及 PS。

    鍵入 nsd -help 以查看所有可用的 NSD 參數。

    -out檔案 無 將輸出列印至指定的日誌檔（例如，c:\temp\DDPlog.txt）及顯示畫面上。如果檔案路徑包含「空格」字元，則必須用引號括住檔名。如果未指定路徑，檔案將建立在 Domino® 程式目錄中。如果在後續的執行中指定現有的日誌檔，則輸出將加至日誌檔的最後。
    -help - 顯示說明文字。

結果

Domino® 伺服器主控台將顯示伺服器已開啟及關閉的階段作業（伺服器為每一個輪詢週期開啟一個階段作業 - 每次開啟新的階段作業時，前一個階段作業將在 Domino® 伺服器上關閉）。探測的輸出將列印至本端指令視窗以及日誌檔（如果已指定的話）。如果資料庫開啟時間超出指定的臨界值，會建立 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
註： 此探測的任何階段作業將在探測關閉時結束。當探測發出下列訊息時，即會結束階段作業：Shut down 完成。

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 captured 狀態 of 伺服器 at time of delayed DB 開啟 (at 3.001 seconds).

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.