Domino® 진단 프로브 시작

Domino® 진단 프로브(DDP)는 명령 프롬프트에서 시작되고 Domino® 서버 프로세스가 아닌 독립형 프로세스로 실행됩니다.

시작하기 전에

Domino®와 함께 제공되는 Eclipse OpenJ9 Java™를 사용해야 합니다. SUN Java™에서는 프로브가 지원되지 않습니다.

경고: 프로브가 실행되는 동안 Domino® 서버를 다시 시작하지 말아야 합니다. Domino® 서버를 다시 시작하기 전에 프로브를 종료해야 합니다. 그렇지 않으면 종료 중에 특정 Domino® 프로세스가 정지될 수 있습니다. 이 프로세스는 결국 정리되고 NSD가 작성됩니다.

이 태스크 정보

프로브에서 Domino® 서버의 ID를 사용하여 -database [-d] 매개변수에서 지정한 세션과 데이터베이스를 -polling [-p] 매개변수에서 지정한 n초마다 열려고 합니다. 데이터베이스를 여는 데 걸리는 시간이 -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 명령(servername은 Domino® 서버 이름으로 바꿈)을 사용하여 QShell을 시작합니다. 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® 진단 프로브 유틸리티의 옵션
    매개변수 기본값 용도
    -database [-d](필수) 없음 열려는 데이터베이스(예: mail/test.nsf
    -threshold [-t] 30 데이터베이스를 여는 데 임계값보다 오래 걸릴 경우 NSD를 실행합니다. 값은 초 단위입니다.
    -polling [-p] 60 열기 위해 데이터베이스를 폴링하는 빈도(초)입니다.
    -nsdoptions 모두 NSD에 전달할 옵션입니다. 따옴표로 묶어야 합니다(예: "-nomecheck -stacks"). 기본값 "ALL"은 DUMP, MEMCHECK, PERF, HANDLES, WALKMEM 및 PS 명령을 모두 실행합니다.

    사용 가능한 모든 NSD 매개변수를 표시하려면 nsd -help를 입력합니다.

    -outfile 없음 출력을 지정된 로그 파일(예: 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
주: 프로브가 종료되면 모든 프로브 세션은 닫힙니다. 프로브가 다음 메시지를 발행하면 세션 종료가 발생합니다. 시스템 종료 완료.

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.

DB 열기가 임계값 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초)을 기록합니다. The NSD captured the state of the server at the time of the delayed DB open (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

이 DB 열기는 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.