제니퍼 4.5 설치가이드 ( .net )docs.jennifersoft.com/dotnetinstallguide.pdf · 8.1...
TRANSCRIPT
제니퍼 45 설치가이드 ( NET )
JenniferSoft
목차
iii
목차
1 제니퍼 서버 설치
11 제니퍼 서버 사양
12 UNIX에 제니퍼 서버 설치
13 WINDOWS에 제니퍼 서버 설치
14 클라이언트 설정
141 웹 브라우져
142 자바 플러그인
1421 설치와 제거
143 메모리 설정
144 웹 브라우져 설정
1441 자바 애플릿
1442 자바스크립트
1443 플래시 플레이어
145 윈도우 서비스 등록
2 제니퍼 닷넷 설치가이드
21 제니퍼 닷넷 에이전트 설치 및 제거
211 제니퍼 닷넷 에이전트 설치 환경
212 에이전트 설치
2121 설치환경
2122 사전 설치
2123 에이전트 설치
2124 에이전트 제거
213 제니퍼 서버 구성 변경
2131 클라이언트를 위한 설정 변경
iii
1
1
1
3
4
4
5
5
5
6
6
8
10
10
11
11
11
11
11
12
12
12
13
13
iv | 목차
2132 제니퍼 에이전트를 위한 설정
2133 제니퍼 사용을 위한 방화벽 설정
214 설치 트러블 슈팅
2141 설치 오류
2142 라이선스 오류 유형
2143 대시 보드 동작 오류 유형
3 제니퍼 닷넷 구성 (IIS COM+)
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
312 구성
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
31212 설정
31213 응용 프로그램 재실행
웹 응용 프로그램 w3wpexe 재시작
COM+ dllhostexe 재시작
3122 모니터링 해제
31221 설정파일 제거
31222 IIS COM+ 재실행
4 COM+ 구성 (2013-06-04 이전)
41 에이전트 구성
411 구성 환경
412 COM+ 응용 프로그램 이름의 conf 파일 구성
4121 COM+ 응용 프로그램 이름 확인
4122 설정 파일 생성
4123 구성요소 재실행
42 에이전트 구성 제거
5 독립 실행형 응용 프로그램 및 NT 서비스
51 에이전트 구성
511 구성 환경
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
5121 conf 파일 설정
5122 환경 변수 설정
5123 txserver 옵션 설정
5124 응용 프로그램 재 시작
13
14
15
15
15
15
17
17
17
18
18
18
18
19
19
19
20
20
20
21
21
21
21
22
22
23
23
25
25
25
25
25
26
26
26
| v
52 에이전트 구성 제거
6 닷넷 배치 프로세스 모니터링
61 MasterAgent 설치 및 실행
611 conf 파일 설정
612 마스터 에이전트 실행
62 SubAgent 설치 및 실행
621 conf 파일 설정
622 배치 프로세스에 conf 파일 연결
623 사용자 정의 메서드 프로파일링 설정
63 제니퍼 에이전트 환경변수 설정
64 에이전트 모니터링 해제 제거
7 NET Data Provider 호출 모니터링 방법
71 사용중인 Data Provider 어셈블리 버전 확인
72 버전을 Profilerini 파일에 명시
8 닷넷 프레임워크
81 윈도우 환경
811 관리자 권한으로 실행
8111 Windows Server 2003
8112 Windows Server 2008 Windows Server 2008 R2
812 NT 서비스 명(Service name) 찾는 방법
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
8222 IIS 7 이상에서 확인하는 방법
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
824 IIS 7 이상에서 확인하는 방법
8241 응용 프로그램의 단위
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
27
29
29
29
29
30
30
30
31
31
32
33
33
34
35
35
35
35
35
36
36
36
37
37
38
40
40
42
44
46
46
47
47
48
49
vi | 목차
91 에이전트 구성
911 구성 환경
912 webconfig 및 conf 파일 구성
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
91212 webconfig에 conf파일을 지정
91213 w3wpexe 재실행
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
91222 conf 파일의 내용 설정
91223 webconfig에 conf 파일을 지정
91224 w3wpexe 재실행
92 에이전트 구성 제거
921 설정 제거
922 iis 재실행
10 COM+ 구성 (NET Framework 11 용)
101 에이전트 구성
1011 구성 환경
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
10121 conf 파일 설정
10122 applicationconfig applicationmanifest 생성
10123 Application Root Directory 지정
10124 구성요소 재실행
102 에이전트 구성 제거
11 w3wp 자동 시작 옵션
색인
49
49
49
49
49
50
52
52
52
52
52
53
53
53
53
55
55
55
55
55
56
56
57
58
59
61
제니퍼 서버 설치
1
1
이 장에서는 제니퍼 서버의 설치와 구성 방법에 대해 설명한다
11 제니퍼 서버 사양
모니터링 대상 시스템의 규모및 수집하는 데이터의 양에 따라 다르기는 하나 일반적으로 평균 1000TPS
이하의 트랜잭션을 서비스하는 시스템에서는 다음과 같은 사양을 필요로 한다
항목 권장사양
CPU 펜디엄4이상 (인텔기준)
Memory 2GB이상
하드디스크 10GB이상 - 시스템 규모에 따라 변동 될 수 있음
지원 OS Windows Linux AIX HP Solaris
자바 버전 15 이상
지원 Database Derby(기본) Oracle DB2 MS-SQL
제니퍼서버는 JAVA가 설치되어 있는 대부분의 시스템에서 운영가능하며 하드디스크 용량의경우 제니
퍼가 구성되어질 시스템 규모 데이터 수집 정도에 따라 사양이 변경될 수 있다
12 UNIX에 제니퍼 서버 설치
제니퍼 서버 설치에 따른 사용자의 이해를 돕기 위해 아래의 표는 제니퍼 서버 설치에 필요한 서버의 환경
정보 예제를 보여주고 있다 본 설치가이드는 아래의 환경 값을 기준으로 설명되며 실제 값은 사용자 서버
의 환경 정보에 맞추어 실제 설치 작업을 진행해야 한다
환경변수 값
제니퍼 서버 HOME 디렉토리 homejenniferserver
JAVA_HOME usrjava15
IP Address 1921680139
2 | 제니퍼 서버 설치
1 jennifer 계정을 새로 생성하면서 homejennifer 홈 디렉토리를 확인하여 생성한다
2 생성된 디렉토리에 압축파일을 해제한다
gzip -d jennifer452targz
tar -xvf jennifer452tar
3 JAVA_HOME 환경변수를 설정한다
4 homejenniferserverbin으로 이동한다
cd homejenniferserverbin
5 startupsh을 실행한 후 로그를 확인한다
제니퍼 서버 최초 기동시만 데이터베이스 테이블 생성작업이 아래와 같이 진행된다 이때문에 서버의 사
양에 따라 시간이 오래걸릴 수 있다
homejenniferserverlogs 디렉토리에서 jenniferlogyyyymmdd 파일에서 아래의 로그를 확인한다
20110530140340Checking database
20110530140342S017javasqlSQLException Schema JENNIFER does not exist
20110530140342Checking Adm database
20110530140343S020javasqlSQLException Schema JENNIFER does not exist
20110530140343INF
Creating new tables with
20110530140343INFThe database URL is jdbcderbyjennifer
20110530140343INFApache Derby Embedded JDBC Driver Version 10420 - (689064)
20110530140343INFDatabase Apache Derby 10420 - (689064)
두번째 기동시부터 아래와 같이 데이타베이스 확인 후 제니퍼를 기동하게 된다
20110530140646Checking database
20110530140648done
20110530140648Checking Adm database
20110530140648INFdone
20110530140648INFXVProfileISAMManager ISAM index generated 0
20110530140648INFUdpRuntimeListener udp listening on port 6901
20110530140649INFUdpRuntimeWorkerPool started 10
20110530140649INFUdpSummaryListener udp listening on port 6902
20110530140649INFUdpSummaryWorkerPool started 10
20110530140649INFUdpXViewProfileListener udp listening on port 6703
20110530140649INFUdpXViewProfileWorkerPool started 30
20110530140650INFTcpSocketServer listening port 6701
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
목차
iii
목차
1 제니퍼 서버 설치
11 제니퍼 서버 사양
12 UNIX에 제니퍼 서버 설치
13 WINDOWS에 제니퍼 서버 설치
14 클라이언트 설정
141 웹 브라우져
142 자바 플러그인
1421 설치와 제거
143 메모리 설정
144 웹 브라우져 설정
1441 자바 애플릿
1442 자바스크립트
1443 플래시 플레이어
145 윈도우 서비스 등록
2 제니퍼 닷넷 설치가이드
21 제니퍼 닷넷 에이전트 설치 및 제거
211 제니퍼 닷넷 에이전트 설치 환경
212 에이전트 설치
2121 설치환경
2122 사전 설치
2123 에이전트 설치
2124 에이전트 제거
213 제니퍼 서버 구성 변경
2131 클라이언트를 위한 설정 변경
iii
1
1
1
3
4
4
5
5
5
6
6
8
10
10
11
11
11
11
11
12
12
12
13
13
iv | 목차
2132 제니퍼 에이전트를 위한 설정
2133 제니퍼 사용을 위한 방화벽 설정
214 설치 트러블 슈팅
2141 설치 오류
2142 라이선스 오류 유형
2143 대시 보드 동작 오류 유형
3 제니퍼 닷넷 구성 (IIS COM+)
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
312 구성
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
31212 설정
31213 응용 프로그램 재실행
웹 응용 프로그램 w3wpexe 재시작
COM+ dllhostexe 재시작
3122 모니터링 해제
31221 설정파일 제거
31222 IIS COM+ 재실행
4 COM+ 구성 (2013-06-04 이전)
41 에이전트 구성
411 구성 환경
412 COM+ 응용 프로그램 이름의 conf 파일 구성
4121 COM+ 응용 프로그램 이름 확인
4122 설정 파일 생성
4123 구성요소 재실행
42 에이전트 구성 제거
5 독립 실행형 응용 프로그램 및 NT 서비스
51 에이전트 구성
511 구성 환경
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
5121 conf 파일 설정
5122 환경 변수 설정
5123 txserver 옵션 설정
5124 응용 프로그램 재 시작
13
14
15
15
15
15
17
17
17
18
18
18
18
19
19
19
20
20
20
21
21
21
21
22
22
23
23
25
25
25
25
25
26
26
26
| v
52 에이전트 구성 제거
6 닷넷 배치 프로세스 모니터링
61 MasterAgent 설치 및 실행
611 conf 파일 설정
612 마스터 에이전트 실행
62 SubAgent 설치 및 실행
621 conf 파일 설정
622 배치 프로세스에 conf 파일 연결
623 사용자 정의 메서드 프로파일링 설정
63 제니퍼 에이전트 환경변수 설정
64 에이전트 모니터링 해제 제거
7 NET Data Provider 호출 모니터링 방법
71 사용중인 Data Provider 어셈블리 버전 확인
72 버전을 Profilerini 파일에 명시
8 닷넷 프레임워크
81 윈도우 환경
811 관리자 권한으로 실행
8111 Windows Server 2003
8112 Windows Server 2008 Windows Server 2008 R2
812 NT 서비스 명(Service name) 찾는 방법
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
8222 IIS 7 이상에서 확인하는 방법
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
824 IIS 7 이상에서 확인하는 방법
8241 응용 프로그램의 단위
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
27
29
29
29
29
30
30
30
31
31
32
33
33
34
35
35
35
35
35
36
36
36
37
37
38
40
40
42
44
46
46
47
47
48
49
vi | 목차
91 에이전트 구성
911 구성 환경
912 webconfig 및 conf 파일 구성
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
91212 webconfig에 conf파일을 지정
91213 w3wpexe 재실행
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
91222 conf 파일의 내용 설정
91223 webconfig에 conf 파일을 지정
91224 w3wpexe 재실행
92 에이전트 구성 제거
921 설정 제거
922 iis 재실행
10 COM+ 구성 (NET Framework 11 용)
101 에이전트 구성
1011 구성 환경
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
10121 conf 파일 설정
10122 applicationconfig applicationmanifest 생성
10123 Application Root Directory 지정
10124 구성요소 재실행
102 에이전트 구성 제거
11 w3wp 자동 시작 옵션
색인
49
49
49
49
49
50
52
52
52
52
52
53
53
53
53
55
55
55
55
55
56
56
57
58
59
61
제니퍼 서버 설치
1
1
이 장에서는 제니퍼 서버의 설치와 구성 방법에 대해 설명한다
11 제니퍼 서버 사양
모니터링 대상 시스템의 규모및 수집하는 데이터의 양에 따라 다르기는 하나 일반적으로 평균 1000TPS
이하의 트랜잭션을 서비스하는 시스템에서는 다음과 같은 사양을 필요로 한다
항목 권장사양
CPU 펜디엄4이상 (인텔기준)
Memory 2GB이상
하드디스크 10GB이상 - 시스템 규모에 따라 변동 될 수 있음
지원 OS Windows Linux AIX HP Solaris
자바 버전 15 이상
지원 Database Derby(기본) Oracle DB2 MS-SQL
제니퍼서버는 JAVA가 설치되어 있는 대부분의 시스템에서 운영가능하며 하드디스크 용량의경우 제니
퍼가 구성되어질 시스템 규모 데이터 수집 정도에 따라 사양이 변경될 수 있다
12 UNIX에 제니퍼 서버 설치
제니퍼 서버 설치에 따른 사용자의 이해를 돕기 위해 아래의 표는 제니퍼 서버 설치에 필요한 서버의 환경
정보 예제를 보여주고 있다 본 설치가이드는 아래의 환경 값을 기준으로 설명되며 실제 값은 사용자 서버
의 환경 정보에 맞추어 실제 설치 작업을 진행해야 한다
환경변수 값
제니퍼 서버 HOME 디렉토리 homejenniferserver
JAVA_HOME usrjava15
IP Address 1921680139
2 | 제니퍼 서버 설치
1 jennifer 계정을 새로 생성하면서 homejennifer 홈 디렉토리를 확인하여 생성한다
2 생성된 디렉토리에 압축파일을 해제한다
gzip -d jennifer452targz
tar -xvf jennifer452tar
3 JAVA_HOME 환경변수를 설정한다
4 homejenniferserverbin으로 이동한다
cd homejenniferserverbin
5 startupsh을 실행한 후 로그를 확인한다
제니퍼 서버 최초 기동시만 데이터베이스 테이블 생성작업이 아래와 같이 진행된다 이때문에 서버의 사
양에 따라 시간이 오래걸릴 수 있다
homejenniferserverlogs 디렉토리에서 jenniferlogyyyymmdd 파일에서 아래의 로그를 확인한다
20110530140340Checking database
20110530140342S017javasqlSQLException Schema JENNIFER does not exist
20110530140342Checking Adm database
20110530140343S020javasqlSQLException Schema JENNIFER does not exist
20110530140343INF
Creating new tables with
20110530140343INFThe database URL is jdbcderbyjennifer
20110530140343INFApache Derby Embedded JDBC Driver Version 10420 - (689064)
20110530140343INFDatabase Apache Derby 10420 - (689064)
두번째 기동시부터 아래와 같이 데이타베이스 확인 후 제니퍼를 기동하게 된다
20110530140646Checking database
20110530140648done
20110530140648Checking Adm database
20110530140648INFdone
20110530140648INFXVProfileISAMManager ISAM index generated 0
20110530140648INFUdpRuntimeListener udp listening on port 6901
20110530140649INFUdpRuntimeWorkerPool started 10
20110530140649INFUdpSummaryListener udp listening on port 6902
20110530140649INFUdpSummaryWorkerPool started 10
20110530140649INFUdpXViewProfileListener udp listening on port 6703
20110530140649INFUdpXViewProfileWorkerPool started 30
20110530140650INFTcpSocketServer listening port 6701
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
iv | 목차
2132 제니퍼 에이전트를 위한 설정
2133 제니퍼 사용을 위한 방화벽 설정
214 설치 트러블 슈팅
2141 설치 오류
2142 라이선스 오류 유형
2143 대시 보드 동작 오류 유형
3 제니퍼 닷넷 구성 (IIS COM+)
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
312 구성
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
31212 설정
31213 응용 프로그램 재실행
웹 응용 프로그램 w3wpexe 재시작
COM+ dllhostexe 재시작
3122 모니터링 해제
31221 설정파일 제거
31222 IIS COM+ 재실행
4 COM+ 구성 (2013-06-04 이전)
41 에이전트 구성
411 구성 환경
412 COM+ 응용 프로그램 이름의 conf 파일 구성
4121 COM+ 응용 프로그램 이름 확인
4122 설정 파일 생성
4123 구성요소 재실행
42 에이전트 구성 제거
5 독립 실행형 응용 프로그램 및 NT 서비스
51 에이전트 구성
511 구성 환경
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
5121 conf 파일 설정
5122 환경 변수 설정
5123 txserver 옵션 설정
5124 응용 프로그램 재 시작
13
14
15
15
15
15
17
17
17
18
18
18
18
19
19
19
20
20
20
21
21
21
21
22
22
23
23
25
25
25
25
25
26
26
26
| v
52 에이전트 구성 제거
6 닷넷 배치 프로세스 모니터링
61 MasterAgent 설치 및 실행
611 conf 파일 설정
612 마스터 에이전트 실행
62 SubAgent 설치 및 실행
621 conf 파일 설정
622 배치 프로세스에 conf 파일 연결
623 사용자 정의 메서드 프로파일링 설정
63 제니퍼 에이전트 환경변수 설정
64 에이전트 모니터링 해제 제거
7 NET Data Provider 호출 모니터링 방법
71 사용중인 Data Provider 어셈블리 버전 확인
72 버전을 Profilerini 파일에 명시
8 닷넷 프레임워크
81 윈도우 환경
811 관리자 권한으로 실행
8111 Windows Server 2003
8112 Windows Server 2008 Windows Server 2008 R2
812 NT 서비스 명(Service name) 찾는 방법
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
8222 IIS 7 이상에서 확인하는 방법
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
824 IIS 7 이상에서 확인하는 방법
8241 응용 프로그램의 단위
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
27
29
29
29
29
30
30
30
31
31
32
33
33
34
35
35
35
35
35
36
36
36
37
37
38
40
40
42
44
46
46
47
47
48
49
vi | 목차
91 에이전트 구성
911 구성 환경
912 webconfig 및 conf 파일 구성
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
91212 webconfig에 conf파일을 지정
91213 w3wpexe 재실행
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
91222 conf 파일의 내용 설정
91223 webconfig에 conf 파일을 지정
91224 w3wpexe 재실행
92 에이전트 구성 제거
921 설정 제거
922 iis 재실행
10 COM+ 구성 (NET Framework 11 용)
101 에이전트 구성
1011 구성 환경
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
10121 conf 파일 설정
10122 applicationconfig applicationmanifest 생성
10123 Application Root Directory 지정
10124 구성요소 재실행
102 에이전트 구성 제거
11 w3wp 자동 시작 옵션
색인
49
49
49
49
49
50
52
52
52
52
52
53
53
53
53
55
55
55
55
55
56
56
57
58
59
61
제니퍼 서버 설치
1
1
이 장에서는 제니퍼 서버의 설치와 구성 방법에 대해 설명한다
11 제니퍼 서버 사양
모니터링 대상 시스템의 규모및 수집하는 데이터의 양에 따라 다르기는 하나 일반적으로 평균 1000TPS
이하의 트랜잭션을 서비스하는 시스템에서는 다음과 같은 사양을 필요로 한다
항목 권장사양
CPU 펜디엄4이상 (인텔기준)
Memory 2GB이상
하드디스크 10GB이상 - 시스템 규모에 따라 변동 될 수 있음
지원 OS Windows Linux AIX HP Solaris
자바 버전 15 이상
지원 Database Derby(기본) Oracle DB2 MS-SQL
제니퍼서버는 JAVA가 설치되어 있는 대부분의 시스템에서 운영가능하며 하드디스크 용량의경우 제니
퍼가 구성되어질 시스템 규모 데이터 수집 정도에 따라 사양이 변경될 수 있다
12 UNIX에 제니퍼 서버 설치
제니퍼 서버 설치에 따른 사용자의 이해를 돕기 위해 아래의 표는 제니퍼 서버 설치에 필요한 서버의 환경
정보 예제를 보여주고 있다 본 설치가이드는 아래의 환경 값을 기준으로 설명되며 실제 값은 사용자 서버
의 환경 정보에 맞추어 실제 설치 작업을 진행해야 한다
환경변수 값
제니퍼 서버 HOME 디렉토리 homejenniferserver
JAVA_HOME usrjava15
IP Address 1921680139
2 | 제니퍼 서버 설치
1 jennifer 계정을 새로 생성하면서 homejennifer 홈 디렉토리를 확인하여 생성한다
2 생성된 디렉토리에 압축파일을 해제한다
gzip -d jennifer452targz
tar -xvf jennifer452tar
3 JAVA_HOME 환경변수를 설정한다
4 homejenniferserverbin으로 이동한다
cd homejenniferserverbin
5 startupsh을 실행한 후 로그를 확인한다
제니퍼 서버 최초 기동시만 데이터베이스 테이블 생성작업이 아래와 같이 진행된다 이때문에 서버의 사
양에 따라 시간이 오래걸릴 수 있다
homejenniferserverlogs 디렉토리에서 jenniferlogyyyymmdd 파일에서 아래의 로그를 확인한다
20110530140340Checking database
20110530140342S017javasqlSQLException Schema JENNIFER does not exist
20110530140342Checking Adm database
20110530140343S020javasqlSQLException Schema JENNIFER does not exist
20110530140343INF
Creating new tables with
20110530140343INFThe database URL is jdbcderbyjennifer
20110530140343INFApache Derby Embedded JDBC Driver Version 10420 - (689064)
20110530140343INFDatabase Apache Derby 10420 - (689064)
두번째 기동시부터 아래와 같이 데이타베이스 확인 후 제니퍼를 기동하게 된다
20110530140646Checking database
20110530140648done
20110530140648Checking Adm database
20110530140648INFdone
20110530140648INFXVProfileISAMManager ISAM index generated 0
20110530140648INFUdpRuntimeListener udp listening on port 6901
20110530140649INFUdpRuntimeWorkerPool started 10
20110530140649INFUdpSummaryListener udp listening on port 6902
20110530140649INFUdpSummaryWorkerPool started 10
20110530140649INFUdpXViewProfileListener udp listening on port 6703
20110530140649INFUdpXViewProfileWorkerPool started 30
20110530140650INFTcpSocketServer listening port 6701
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
| v
52 에이전트 구성 제거
6 닷넷 배치 프로세스 모니터링
61 MasterAgent 설치 및 실행
611 conf 파일 설정
612 마스터 에이전트 실행
62 SubAgent 설치 및 실행
621 conf 파일 설정
622 배치 프로세스에 conf 파일 연결
623 사용자 정의 메서드 프로파일링 설정
63 제니퍼 에이전트 환경변수 설정
64 에이전트 모니터링 해제 제거
7 NET Data Provider 호출 모니터링 방법
71 사용중인 Data Provider 어셈블리 버전 확인
72 버전을 Profilerini 파일에 명시
8 닷넷 프레임워크
81 윈도우 환경
811 관리자 권한으로 실행
8111 Windows Server 2003
8112 Windows Server 2008 Windows Server 2008 R2
812 NT 서비스 명(Service name) 찾는 방법
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
8222 IIS 7 이상에서 확인하는 방법
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
824 IIS 7 이상에서 확인하는 방법
8241 응용 프로그램의 단위
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
27
29
29
29
29
30
30
30
31
31
32
33
33
34
35
35
35
35
35
36
36
36
37
37
38
40
40
42
44
46
46
47
47
48
49
vi | 목차
91 에이전트 구성
911 구성 환경
912 webconfig 및 conf 파일 구성
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
91212 webconfig에 conf파일을 지정
91213 w3wpexe 재실행
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
91222 conf 파일의 내용 설정
91223 webconfig에 conf 파일을 지정
91224 w3wpexe 재실행
92 에이전트 구성 제거
921 설정 제거
922 iis 재실행
10 COM+ 구성 (NET Framework 11 용)
101 에이전트 구성
1011 구성 환경
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
10121 conf 파일 설정
10122 applicationconfig applicationmanifest 생성
10123 Application Root Directory 지정
10124 구성요소 재실행
102 에이전트 구성 제거
11 w3wp 자동 시작 옵션
색인
49
49
49
49
49
50
52
52
52
52
52
53
53
53
53
55
55
55
55
55
56
56
57
58
59
61
제니퍼 서버 설치
1
1
이 장에서는 제니퍼 서버의 설치와 구성 방법에 대해 설명한다
11 제니퍼 서버 사양
모니터링 대상 시스템의 규모및 수집하는 데이터의 양에 따라 다르기는 하나 일반적으로 평균 1000TPS
이하의 트랜잭션을 서비스하는 시스템에서는 다음과 같은 사양을 필요로 한다
항목 권장사양
CPU 펜디엄4이상 (인텔기준)
Memory 2GB이상
하드디스크 10GB이상 - 시스템 규모에 따라 변동 될 수 있음
지원 OS Windows Linux AIX HP Solaris
자바 버전 15 이상
지원 Database Derby(기본) Oracle DB2 MS-SQL
제니퍼서버는 JAVA가 설치되어 있는 대부분의 시스템에서 운영가능하며 하드디스크 용량의경우 제니
퍼가 구성되어질 시스템 규모 데이터 수집 정도에 따라 사양이 변경될 수 있다
12 UNIX에 제니퍼 서버 설치
제니퍼 서버 설치에 따른 사용자의 이해를 돕기 위해 아래의 표는 제니퍼 서버 설치에 필요한 서버의 환경
정보 예제를 보여주고 있다 본 설치가이드는 아래의 환경 값을 기준으로 설명되며 실제 값은 사용자 서버
의 환경 정보에 맞추어 실제 설치 작업을 진행해야 한다
환경변수 값
제니퍼 서버 HOME 디렉토리 homejenniferserver
JAVA_HOME usrjava15
IP Address 1921680139
2 | 제니퍼 서버 설치
1 jennifer 계정을 새로 생성하면서 homejennifer 홈 디렉토리를 확인하여 생성한다
2 생성된 디렉토리에 압축파일을 해제한다
gzip -d jennifer452targz
tar -xvf jennifer452tar
3 JAVA_HOME 환경변수를 설정한다
4 homejenniferserverbin으로 이동한다
cd homejenniferserverbin
5 startupsh을 실행한 후 로그를 확인한다
제니퍼 서버 최초 기동시만 데이터베이스 테이블 생성작업이 아래와 같이 진행된다 이때문에 서버의 사
양에 따라 시간이 오래걸릴 수 있다
homejenniferserverlogs 디렉토리에서 jenniferlogyyyymmdd 파일에서 아래의 로그를 확인한다
20110530140340Checking database
20110530140342S017javasqlSQLException Schema JENNIFER does not exist
20110530140342Checking Adm database
20110530140343S020javasqlSQLException Schema JENNIFER does not exist
20110530140343INF
Creating new tables with
20110530140343INFThe database URL is jdbcderbyjennifer
20110530140343INFApache Derby Embedded JDBC Driver Version 10420 - (689064)
20110530140343INFDatabase Apache Derby 10420 - (689064)
두번째 기동시부터 아래와 같이 데이타베이스 확인 후 제니퍼를 기동하게 된다
20110530140646Checking database
20110530140648done
20110530140648Checking Adm database
20110530140648INFdone
20110530140648INFXVProfileISAMManager ISAM index generated 0
20110530140648INFUdpRuntimeListener udp listening on port 6901
20110530140649INFUdpRuntimeWorkerPool started 10
20110530140649INFUdpSummaryListener udp listening on port 6902
20110530140649INFUdpSummaryWorkerPool started 10
20110530140649INFUdpXViewProfileListener udp listening on port 6703
20110530140649INFUdpXViewProfileWorkerPool started 30
20110530140650INFTcpSocketServer listening port 6701
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
vi | 목차
91 에이전트 구성
911 구성 환경
912 webconfig 및 conf 파일 구성
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
91212 webconfig에 conf파일을 지정
91213 w3wpexe 재실행
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
91222 conf 파일의 내용 설정
91223 webconfig에 conf 파일을 지정
91224 w3wpexe 재실행
92 에이전트 구성 제거
921 설정 제거
922 iis 재실행
10 COM+ 구성 (NET Framework 11 용)
101 에이전트 구성
1011 구성 환경
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
10121 conf 파일 설정
10122 applicationconfig applicationmanifest 생성
10123 Application Root Directory 지정
10124 구성요소 재실행
102 에이전트 구성 제거
11 w3wp 자동 시작 옵션
색인
49
49
49
49
49
50
52
52
52
52
52
53
53
53
53
55
55
55
55
55
56
56
57
58
59
61
제니퍼 서버 설치
1
1
이 장에서는 제니퍼 서버의 설치와 구성 방법에 대해 설명한다
11 제니퍼 서버 사양
모니터링 대상 시스템의 규모및 수집하는 데이터의 양에 따라 다르기는 하나 일반적으로 평균 1000TPS
이하의 트랜잭션을 서비스하는 시스템에서는 다음과 같은 사양을 필요로 한다
항목 권장사양
CPU 펜디엄4이상 (인텔기준)
Memory 2GB이상
하드디스크 10GB이상 - 시스템 규모에 따라 변동 될 수 있음
지원 OS Windows Linux AIX HP Solaris
자바 버전 15 이상
지원 Database Derby(기본) Oracle DB2 MS-SQL
제니퍼서버는 JAVA가 설치되어 있는 대부분의 시스템에서 운영가능하며 하드디스크 용량의경우 제니
퍼가 구성되어질 시스템 규모 데이터 수집 정도에 따라 사양이 변경될 수 있다
12 UNIX에 제니퍼 서버 설치
제니퍼 서버 설치에 따른 사용자의 이해를 돕기 위해 아래의 표는 제니퍼 서버 설치에 필요한 서버의 환경
정보 예제를 보여주고 있다 본 설치가이드는 아래의 환경 값을 기준으로 설명되며 실제 값은 사용자 서버
의 환경 정보에 맞추어 실제 설치 작업을 진행해야 한다
환경변수 값
제니퍼 서버 HOME 디렉토리 homejenniferserver
JAVA_HOME usrjava15
IP Address 1921680139
2 | 제니퍼 서버 설치
1 jennifer 계정을 새로 생성하면서 homejennifer 홈 디렉토리를 확인하여 생성한다
2 생성된 디렉토리에 압축파일을 해제한다
gzip -d jennifer452targz
tar -xvf jennifer452tar
3 JAVA_HOME 환경변수를 설정한다
4 homejenniferserverbin으로 이동한다
cd homejenniferserverbin
5 startupsh을 실행한 후 로그를 확인한다
제니퍼 서버 최초 기동시만 데이터베이스 테이블 생성작업이 아래와 같이 진행된다 이때문에 서버의 사
양에 따라 시간이 오래걸릴 수 있다
homejenniferserverlogs 디렉토리에서 jenniferlogyyyymmdd 파일에서 아래의 로그를 확인한다
20110530140340Checking database
20110530140342S017javasqlSQLException Schema JENNIFER does not exist
20110530140342Checking Adm database
20110530140343S020javasqlSQLException Schema JENNIFER does not exist
20110530140343INF
Creating new tables with
20110530140343INFThe database URL is jdbcderbyjennifer
20110530140343INFApache Derby Embedded JDBC Driver Version 10420 - (689064)
20110530140343INFDatabase Apache Derby 10420 - (689064)
두번째 기동시부터 아래와 같이 데이타베이스 확인 후 제니퍼를 기동하게 된다
20110530140646Checking database
20110530140648done
20110530140648Checking Adm database
20110530140648INFdone
20110530140648INFXVProfileISAMManager ISAM index generated 0
20110530140648INFUdpRuntimeListener udp listening on port 6901
20110530140649INFUdpRuntimeWorkerPool started 10
20110530140649INFUdpSummaryListener udp listening on port 6902
20110530140649INFUdpSummaryWorkerPool started 10
20110530140649INFUdpXViewProfileListener udp listening on port 6703
20110530140649INFUdpXViewProfileWorkerPool started 30
20110530140650INFTcpSocketServer listening port 6701
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
제니퍼 서버 설치
1
1
이 장에서는 제니퍼 서버의 설치와 구성 방법에 대해 설명한다
11 제니퍼 서버 사양
모니터링 대상 시스템의 규모및 수집하는 데이터의 양에 따라 다르기는 하나 일반적으로 평균 1000TPS
이하의 트랜잭션을 서비스하는 시스템에서는 다음과 같은 사양을 필요로 한다
항목 권장사양
CPU 펜디엄4이상 (인텔기준)
Memory 2GB이상
하드디스크 10GB이상 - 시스템 규모에 따라 변동 될 수 있음
지원 OS Windows Linux AIX HP Solaris
자바 버전 15 이상
지원 Database Derby(기본) Oracle DB2 MS-SQL
제니퍼서버는 JAVA가 설치되어 있는 대부분의 시스템에서 운영가능하며 하드디스크 용량의경우 제니
퍼가 구성되어질 시스템 규모 데이터 수집 정도에 따라 사양이 변경될 수 있다
12 UNIX에 제니퍼 서버 설치
제니퍼 서버 설치에 따른 사용자의 이해를 돕기 위해 아래의 표는 제니퍼 서버 설치에 필요한 서버의 환경
정보 예제를 보여주고 있다 본 설치가이드는 아래의 환경 값을 기준으로 설명되며 실제 값은 사용자 서버
의 환경 정보에 맞추어 실제 설치 작업을 진행해야 한다
환경변수 값
제니퍼 서버 HOME 디렉토리 homejenniferserver
JAVA_HOME usrjava15
IP Address 1921680139
2 | 제니퍼 서버 설치
1 jennifer 계정을 새로 생성하면서 homejennifer 홈 디렉토리를 확인하여 생성한다
2 생성된 디렉토리에 압축파일을 해제한다
gzip -d jennifer452targz
tar -xvf jennifer452tar
3 JAVA_HOME 환경변수를 설정한다
4 homejenniferserverbin으로 이동한다
cd homejenniferserverbin
5 startupsh을 실행한 후 로그를 확인한다
제니퍼 서버 최초 기동시만 데이터베이스 테이블 생성작업이 아래와 같이 진행된다 이때문에 서버의 사
양에 따라 시간이 오래걸릴 수 있다
homejenniferserverlogs 디렉토리에서 jenniferlogyyyymmdd 파일에서 아래의 로그를 확인한다
20110530140340Checking database
20110530140342S017javasqlSQLException Schema JENNIFER does not exist
20110530140342Checking Adm database
20110530140343S020javasqlSQLException Schema JENNIFER does not exist
20110530140343INF
Creating new tables with
20110530140343INFThe database URL is jdbcderbyjennifer
20110530140343INFApache Derby Embedded JDBC Driver Version 10420 - (689064)
20110530140343INFDatabase Apache Derby 10420 - (689064)
두번째 기동시부터 아래와 같이 데이타베이스 확인 후 제니퍼를 기동하게 된다
20110530140646Checking database
20110530140648done
20110530140648Checking Adm database
20110530140648INFdone
20110530140648INFXVProfileISAMManager ISAM index generated 0
20110530140648INFUdpRuntimeListener udp listening on port 6901
20110530140649INFUdpRuntimeWorkerPool started 10
20110530140649INFUdpSummaryListener udp listening on port 6902
20110530140649INFUdpSummaryWorkerPool started 10
20110530140649INFUdpXViewProfileListener udp listening on port 6703
20110530140649INFUdpXViewProfileWorkerPool started 30
20110530140650INFTcpSocketServer listening port 6701
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
2 | 제니퍼 서버 설치
1 jennifer 계정을 새로 생성하면서 homejennifer 홈 디렉토리를 확인하여 생성한다
2 생성된 디렉토리에 압축파일을 해제한다
gzip -d jennifer452targz
tar -xvf jennifer452tar
3 JAVA_HOME 환경변수를 설정한다
4 homejenniferserverbin으로 이동한다
cd homejenniferserverbin
5 startupsh을 실행한 후 로그를 확인한다
제니퍼 서버 최초 기동시만 데이터베이스 테이블 생성작업이 아래와 같이 진행된다 이때문에 서버의 사
양에 따라 시간이 오래걸릴 수 있다
homejenniferserverlogs 디렉토리에서 jenniferlogyyyymmdd 파일에서 아래의 로그를 확인한다
20110530140340Checking database
20110530140342S017javasqlSQLException Schema JENNIFER does not exist
20110530140342Checking Adm database
20110530140343S020javasqlSQLException Schema JENNIFER does not exist
20110530140343INF
Creating new tables with
20110530140343INFThe database URL is jdbcderbyjennifer
20110530140343INFApache Derby Embedded JDBC Driver Version 10420 - (689064)
20110530140343INFDatabase Apache Derby 10420 - (689064)
두번째 기동시부터 아래와 같이 데이타베이스 확인 후 제니퍼를 기동하게 된다
20110530140646Checking database
20110530140648done
20110530140648Checking Adm database
20110530140648INFdone
20110530140648INFXVProfileISAMManager ISAM index generated 0
20110530140648INFUdpRuntimeListener udp listening on port 6901
20110530140649INFUdpRuntimeWorkerPool started 10
20110530140649INFUdpSummaryListener udp listening on port 6902
20110530140649INFUdpSummaryWorkerPool started 10
20110530140649INFUdpXViewProfileListener udp listening on port 6703
20110530140649INFUdpXViewProfileWorkerPool started 30
20110530140650INFTcpSocketServer listening port 6701
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
WINDOWS에 제니퍼 서버 설치 | 3
20110530140650INFJennifer452(2011-03-03) started
20110530140650INFhttpstartupport=7900
20110530140650INFTcpServerWorkerPool started 80
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900이다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
13 WINDOWS에 제니퍼 서버 설치
제니퍼서버는 Tomcat55를 기반으로 운영되고 있다 일반적인 Tomcat과 같이JAVA_HOME환경변수
지정 후 제니퍼 서버를 기동시킬 수 있다
환경변수 값
제니퍼 서버 HOME 디렉토리 cjenniferserver
JAVA_HOME CJavajdk16u13
IP Address 1921680139
1 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예cjennifer
) 해제한다
2 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]
3 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다
CJavagtecho JAVA_HOME
CJavajdk16u13
4 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 | 환경변수]
에 JAVA_HOME환경변수 값을 설정한다
5 명령프롬프트상에서 제니퍼서버 디렉토리(예cjenniferserverbin)이동 후 startupbat을 실
행한다 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행한다 탐색기상에서 직접
startupbat파일을 더블 클릭해 실행 할 수도 있다 제니퍼 서버의 최초 기동시만 데이터베이스 테이
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
4 | 제니퍼 서버 설치
블 생성작업이 진행된다 서버 머신의 사양에 따라서 제니퍼 서버의 기동 시간이 차이가 있을 수 있다
6 로그인 한다
웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로 구성된 URL
을 입력하면 로그인 화면이 나타난다 제니퍼의 모든 기능은 로그인 후에 사용할 수 있다 제니퍼 서버의 기
본 포트 번호는 7900인다
http19216801397900
로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다 초기 관리자 계정의 아이디는
admin이며 패스워드도 admin이다 처음 로그인을 한 후에 패스워드를 수정하는 것을 권장한다 제니퍼
클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시 플레이어 90 이상을 설치해야 한다
14 클라이언트 설정
제니퍼 클라이언트는 웹에 기반한다 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인터페이스에
접근한다 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고 그리드 표시를위한 플래시
플레이어가 필요하다 운영 체계 제니퍼 클라이언트는 마이크로소프트 윈도우즈 XP와 비스타를 지원한다
단 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상적으로 나타나지 않을 수 있다 현재 윈도우즈 XP
를 사용하는 경우에 테마로 Windows 고전을 사용하면 BLACK 스타일이 정상적으로 나타나지 않는다 현
재 사용하고 있는 테마는 바탕화면에서 오른쪽 마우스를 클릭하면 나타나는 컨텍스트 메뉴에서 [속성] 메
뉴를 선택하면 확인할 수 있다 공식적으로 제니퍼 클라이언트는 리눅스와 맥 OS등을 지원하지 않는다 그
러나 파이어 폭스 30 이상과 자바 플러그인 160_10 이상을 설치할 수 있는 OS라면 제니퍼를 사용할 수
있을 것이다
141 웹 브라우져
마이크로소프트 IE 70 IE 80 IE 90 그리고 모질라 파이어 폭스 35 등의 웹 브라우저를 지원한다 IE 6
0은 CSS를 포함한 웹 표준 지원이 미흡하고 투명한 PNG 이미지 파일을 처리하지 못하는 단점을 가지고
있다 따라서 IE 60은 지원하지 않는다 IE 70이상으로 업그레이드할 수 없는 환경에서는 파이어폭스 35
을 사용하는 것을 권장한다
제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한다 대부분의
웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
클라이언트 설정 | 5
142 자바 플러그인
제니퍼 클라이언트의 일부는 자바 애플릿으로 구현되어 있기 때문에 선 자바 플러그인 160_10 이상을
설치해야 한다 제니퍼 40부터는 마이크로소프트 자바 VM을 지원하지 않는다
1421 설치와 제거
자바 플러그인을 설치와 제거에 대한 내용은 선의 자바 사이트(httpjavasuncomjavasedownloads
indexjsp)를 참고한다
143 메모리 설정
별도의 설정의 없다면 자바 애플릿이 사용할 수 있는 최대 자바 힙 메모리는 96 MB이다 제니퍼 클라이언
트를 안정적으로 사용하기 위해서는 자바 힙 메모리 최대 값과 최소 값을 지정하는 것을 권장한다 특히 에
이전트의 숫자가 많거나 업무 처리량이 많은 경우에는 자바 힙 메모리 최대 값을 높게 설정할 필요가 있다
윈도우즈 운영 체계에서 자바 플러그인의 자바 힙 메모리 크기는 다음과 같이 설정한다
1 제어판으로 이동한다
2 제어판에서 자바를 클릭하면 Java 제어판을 연다 여기에서 Java 탭을 선택한다
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
6 | 제니퍼 서버 설치
3 Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난다 여러 개의
자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한다
예를 들어 자바 힙 메모리 최소 값을 100 MB 최대 값을 150 MB로 설정하려면 JRE의 Java 런
타임 매개 변수 칼럼에 다음과 같이 입력한다
-Xms100m -Xmx150m
설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다 설정 가능한 값보다 큰 값을
지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다 설정 가능한 자바 힙 메모리 최
대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙 메모리 최대 값을 설정해야 한다
144 웹 브라우져 설정
1441 자바 애플릿
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자바 플러그인
사용 여부를 설정한다 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러그인 정보가 나타난다 여
기서 선 자바 플러그인을 사용하도록 설정한다
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
클라이언트 설정 | 7
모질라 파이어 폭스 3X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정] 메뉴에서 액
티브스크립팅 사용 여부를 확인한다 기본적으로 허용으로 선택되어 있다
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
8 | 제니퍼 서버 설치
1442 자바스크립트
마이크로소프트 IE 70 IE 80 IE 90 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용자레벨 지정]
메뉴에서 스크립팅 사용 여부를 설정한다 기본적을 사용되도록 설정되어 있다
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
클라이언트 설정 | 9
모질라 파이어 폭스 35를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여부를 설정한
다 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다 기본으로 선택되어 있다
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
10 | 제니퍼 서버 설치
1443 플래시 플레이어
제니퍼 클라이언트의 일부는 플래시로 구현되어 있다 정상적인 화면 표시를 위해서는 어도비 플래시 플레
이어 90 이상을 설치해야 한다
145 윈도우 서비스 등록
제니퍼서버를 윈도우 서비스에 등록해서 관리할 경우 servicebat를 사용한다
명령프롬프트를 실행 후 제니퍼서버 디렉토리로 이동한다
Cjenniferserverbingtservicebat install JenniferServer
Installing the service JenniferServer
Using CATALINA_HOME Cjenniferserver
Using CATALINA_BASE Cjenniferserver
Using JAVA_HOME CJavajdk16u13
Using JVM CJavajdk16u13jrebinserverjvmdll
The service JenniferServer has been installed
Cjenniferserverbingt
세번째 파라미터는 서비스명이다
윈도우서비스에 등록했으면 [ 제어판| 관리도구 | 서비스 ] 메뉴에서 JennfierServer를 기동한다
윈도우서비스로 등록하기 위해서는 환경변수에 JAVA_HOME이 반드시 설정되어 있어야 한다
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
제니퍼 닷넷 설치가이드
2
11
21 제니퍼 닷넷 에이전트 설치 및 제거
이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다
211 제니퍼 닷넷 에이전트 설치 환경
닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다
표 2-1 제니퍼 에이전트 지원환경
구분 대상
운영체제 Microsoft Windows Server 2003 2008R2 2012R2
닷넷 프레임워크 프레임워크 20 30 35 40 45
시스템에 설치된 닷넷 프레임워크 확인 방법은 rdquo설치된 닷넷 프레임워크 버전 확인ldquo을 참고한다
212 에이전트 설치
2121 설치환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 2-2 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
12 | 제니퍼 닷넷 설치가이드
제니퍼 서버 IP Address 1921680139
구분 대상
2122 사전 설치
닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워
크가 설치되었음을 가정할 수 있지만 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다
면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다
2123 에이전트 설치
닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다
1 제니퍼소프트로부터 제공받은 라이선스 키를 ldquoCJenniferagentnetlicensetxtrdquo 파일에 입력
하고 저장한다
2 CJenniferagentnetinstall_Jenniferbat 을 관리자 권한으로 실행한다 실행 후 반드시 출력
되는 메시지에서 Installation completed 를 확인한다 만약 이 메시지가 없으면 설치에 실패한 것
이다
3 제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업
이 달라진다
4 구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 CJenniferagentnetlog 폴더
에 다음과 같은 형식의 로그 파일이 생성된다
Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜]log
예를 들어 2010년 3월 8일 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 ldquoDefaultAppPoolrdquo
이고 그와 연결된 conf 파일에 agent_pool 값을 N109000과 같이 주었다면 ldquojennifer_DefaultAppPo
ol_N10_20100308logrdquo 파일이 생성된다
2124 에이전트 제거
닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다
1 ldquoCJenniferagentnetuninstall_Jenniferbatrdquo을 관리자 권한으로 실행한다
운영체제별 관리자 권한 실행 방법은 rdquo관리자 권한으로
실행rdquo 내용을 참조한다
2 만약 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고 폴더를 삭제한다
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
제니퍼 닷넷 에이전트 설치 및 제거 | 13
213 제니퍼 서버 구성 변경
이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해
설명한다
2131 클라이언트를 위한 설정 변경
제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토콜을 사용한다 이 때 사용하는 기본
HTTP 포트 번호는 7900이다 그리고 제니퍼 서버 정지를 위한 기본 포트 번호는 7999이다 이 포트 번호
를 변경하려면 제니퍼 서버가 설치된 컴퓨터에서 $JENNIFER_HOMEserverbincatalinash(bat) 파일
을 수정한다
유닉스 혹은 리눅스의 경우에는 catalinash 파일의 다음 부분에서 포트 번호를 설정한다
JAVA_HOME=$JAVA_HOME
if [ -z $STARTUP_PORT ]
then
export STARTUP_PORT=7900
fi
if [ -z $SHUTDOWN_PORT ]
then
export SHUTDOWN_PORT=7999
fi
윈도우의 경우에는 catalinabat 파일의 다음 부분에서 포트 번호를 설정한다
set JAVA_HOME=JAVA_HOME
if STARTUP_PORT == SET STARTUP_PORT=7900
if SHUTDOWN_PORT == SET SHUTDOWN_PORT=7999
자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한다 이 때 사
용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 server_tcp_port 옵션으로 설정하고 기본 포
트 번호는 6701이다
2132 제니퍼 에이전트를 위한 설정
제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다 제니퍼 서버는 제니퍼 에이전트
가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다 제니퍼 에이전트는 제니퍼 서버의 serv
er_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이
터를 전송한다 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다 기본 포트 번
호는 6901이다
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
14 | 제니퍼 닷넷 설치가이드
server_udp_runtime_port = 6901
제니퍼 에이전트는 제니퍼 서버의 server_udp_listen_port 옵션으로 설정한 UDP 포트를 통해서 1초마
다 반복적으로 서비스 요청 률 평균 응답 시간 등의 일반 성능 데이터를 전송한다 기본 포트 번호는 6902
이다
server_udp_listen_port = 6902
제니퍼 에이전트는 제니퍼 서버의 server_udp_lwst_call_stack_port 옵션으로 설정한 UDP 포트를 통
해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다 기본 포트 번호는 6703이다
server_udp_lwst_call_stack_port = 6703
앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버뿐만 아니라 제니퍼 에이전트의 동일
한 옵션도 함께 수정해야 한다
그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사용할 IP 바인
딩 주소를 지정할 필요가 있다 이는 닷넷 TCP 소켓 프로그래밍에서 [Socket 인스턴스]Bind(new IPEnd
Point(address port)) 생성자의 IPEndPoint 첫 번째 파라미터 address에 해당하는 값이다 하드웨어에
둘 이상의 네트워크 카드가 있다면 특정 네트워크 카드로 들어오는 요청만 바인딩 하고자 할 때 설정한다
udp_server_host 속성을 ldquo0000rdquo으로 지정하면 모든 네트워크카드에서 들어오는 패킷을 받을 수 있다
제니퍼 서버에서 제니퍼 에이전트로의 TCP연결을 위한 TIME OUT옵션이 존재한다 아래의 설정 값이
기본값(ms)이다
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
만약 네트워크 연결이 지연되는 현상이 발생하면 제니퍼 서버에 에러가 로그 파일에 출력된다
이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것
을 권고한다
2133 제니퍼 사용을 위한 방화벽 설정
제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면 앞에서 설정한 포트
번호가 방화벽을 정상적으로 통과하도록 설정해야 한다
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
제니퍼 닷넷 에이전트 설치 및 제거 | 15
사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한
다
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901 6902 6703 포트를 통해서 접근할 수 있어야 한다
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다
214 설치 트러블 슈팅
이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다
2141 설치 오류
Q 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가
A install_jenniferbat 와 uninstall_jenniferbat 파일은 각각 로그를 남길 수 있는 버전인 install_wit
h_logbat uinstall_with_logbat 배치 파일이 동일 폴더에 제공됩니다 설치제거 과정에서 문제가 발생
하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오
2142 라이선스 오류 유형
Q 전달받은 라이선스 키를 입력했는데 ldquoTrial license key is not availablerdquo 오류가 발생합니다
A 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다 라이선스
를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할
수 있습니다
2143 대시 보드 동작 오류 유형
Q NET 40 웹 사이트에서 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵니다
A NET 40 의 경우 webconfig 에 다음과 같은 설정이 포함되어 있어야만 정상적인 성능 카운터가 제
공됩니다
ltsystemdiagnosticsgt
ltswitchesgt
ltadd name=ConnectionPoolPerformanceCounterDetail value=4gt
ltswitchesgt
ltsystemdiagnosticsgt
Q Windows 2008 R2 환경에서 오라클 DB를 사용하고 있는데 ldquo최근 DB 커넥션 개수rdquo가 0으로 나옵
니다
A 오라클 ODAC(Oracle Data Acess Component)측에서 DB 연결 수에 대한 성능 카운터를 제공하지
않는 문제일 수 있습니다 윈도우의 ldquo관리 도구rdquo에서 ldquo성능 카운터rdquo를 실행하여 오라클의 연결 개수 정보를
확인하십시오
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
16 | 제니퍼 닷넷 설치가이드
Q 여전히 ldquo최근 DB 커넥션 개수rdquo가 0으로 나온다면
A 연결 문자열에서 ldquoPooling=falserdquo로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다
또한 NET 11 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
제니퍼 닷넷 구성 (IIS COM+)
3
17
ldquojenniferversionrdquo 이 ldquo450(2010-10-291)rdquo 버전 이후부터 지원되는 새로운 구성 방식으로 기존 설치
방식이 webconfig 의 변경을 필요로 했던 단점 및 그로 인한 부작용이 제거되었다 기존 설치 방식도 여
전히 지원되지만 권장되지 않는다
31 IIS 웹 응용 프록램 COM+ 구성
311 실행
[제니퍼 에이전트 설치폴더]utilityIISConfigHelperexe 파일을 실행한다
아래 화면은 1개의 Web Site 3개의 COM+ 서버 응용 프로그램이 컴퓨터에 구성된 예를 보여주고 있
다
그림 3-1 IIS와 COM+의 모니터링 가능한 응용 프로그램
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
18 | 제니퍼 닷넷 구성 (IIS COM+)
Web Garden 우측의 Enable AutoStart 옵션은 2012년 11월 8일 이후 릴리즈 된 버전부터 적
용된다 자세한 사항은 11 w3wp 자동 시작 옵션 절을 참고한다
312 구성
ACT 도구를 이용하면 모니터링 해야 할 웹 응용 프로그램 및 COM+ 서버 응용 프로그램을 지정해제 할
수 있다
3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
31211 설정 파일 생성
모니터링 하기를 원하는 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메
뉴의 ldquoInstallrdquo을 실행한다
그림 3-2 에이전트 적용을 위한 conf 파일 생성
실행하고 나면 rdquo[제니퍼 에이전트 설치 폴더]confrdquo 폴더에 대상 응용 프로그램에 대한 제니퍼 모니터
링을 할 수 있는 conf 파일이 생성된다
새롭게 생성된 conf 파일은 제니퍼 설치 시 기본 제공되는 app_poolconf 파일의 복사본이므
로 반드시 app_poolconf 파일이 있어야 한다
31212 설정
생성된 conf 파일에는 필수적으로 ldquoJennifer Serverrdquo ldquoUDP Portrdquo ldquoListen Portrdquo ldquoLWST Portrdquo 및 해당 응
용 프로그램을 대표하는 ldquoAgent IDrdquo를 지정해 주어야 한다 아래의 그림에서와 같이 오른쪽 패널에서 이러
한 값들을 지정할 수 있으며 변경 후 ldquoSaverdquo 버튼을 눌러서 저장해 준다
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
IIS 웹 응용 프록램 COM+ 구성 | 19
그림 3-3 응용 프로그램과 연결된 제니퍼 닷넷의 에이전트 설정
31213 응용 프로그램 재실행
에이전트 설정 파일이 생성되었으면 이제 응용 프로그램이 모니터링 되도록 새롭게 재시작을 해야한다
웹 응용 프로그램 w3wpexe 재시작
설정을 새롭게 반영하기 위해 좌측 트리에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴의 ldquoIIS Resetrdquo을 실행
한다
그림 3-4 IIS Reset
COM+ dllhostexe 재시작
COM+ 의 경우 모든 응용 프로그램을 재시작하는 방법은 없고 필요한 응용 프로그램마다 마우스 오른쪽
버튼을 눌러 나오는 메뉴의 Recycle 명령을 실행한다
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
20 | 제니퍼 닷넷 구성 (IIS COM+)
그림 3-5 COM+ 응용 프로그램 재시작
3122 모니터링 해제
31221 설정파일 제거
모니터링에서 제외될 응용 프로그램 항목을 트리에서 선택하고 마우스 오른쪽 버튼을 눌러 나오는 메뉴의
ldquoUninstallrdquo을 실행한다
그림 3-6 모니터링 해제
31222 IIS COM+ 재실행
설정을 새롭게 반영하기 위해 응용 프로그램을 재시작한다 (웹 응용 프로그램의 경우 IIS Reset COM+
의 경우 Recycle)
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
COM+ 구성 (2013-06-04 이전)
4
21
제니퍼 ldquo450(2010-10-292)rdquo 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이
기존과 비교해서 대폭 간소화되었다 이전 버전에서는 rdquoconfigrdquo rdquomanifestrdquo 및 그에 대한 폴더를 만
들어서 ldquoApplication Root Directoryrdquo에 설정하는 복잡함뿐만 아니라 COM+ 개체가 새로 등록되는
과정에서 ldquoApplication Root Directoryrdquo 설정이 초기화되는 문제로 인해 그 때 마다 재설정해야 하는
어려움이 있었는데 새로운 환경 설정 구성방법은 이러한 문제를 모두 해결하였다
제니퍼 450(2013-06-05) 버전 부터 COM+ 응용 프로그램을 모니터링하기 위한 설정 방법이 IIS
ConfigHelperexe에 통합되었다
41 에이전트 구성
411 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 4-1 기본구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
모니터링 대상 COM+ 응용프로그램 이름 A MyComponentServer
412 COM+ 응용 프로그램 이름의 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소의 이름에 해당하는 conf 파일
을 생성한다
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
22 | COM+ 구성 (2013-06-04 이전)
4121 COM+ 응용 프로그램 이름 확인
ldquo구성 요소 관리자(Component Services)rdquo 에서 모니터링을 원하는 COM+ 응용 프로그램의 ldquo이름rdquo을 확
인한다 아래의 화면에서는 ldquoMyComponentServerrdquo 임을 알 수 있다
그림 4-1 COM+ 응용 프로그램의 이름을 구하는 방법
4122 설정 파일 생성
COM+ 와 연결될 모니터링 구성을 담는 conf 파일 생성 규칙은 다음과 같다
[제니퍼 에이전트 설치 폴더]confcomplus[COM+ 응용 프로그램 이름]conf
따라서 이번 예제에서는 다음과 같다
CJenniferconfcomplusMyComponentServerconf
나머지 내부 conf 파일 구성 규칙(udp_server_hosthellip)은 동일하지만 agent_pool 의 수는 COM+ 서
버 응용 프로그램의 ldquoApplication Poolingrdquo 에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+
Application Pool 확인ldquo을 참고한다
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
에이전트 구성 제거 | 23
4123 구성요소 재실행
COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼 닷넷이 반영
되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
42 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 그 응용 프로그램과 연결된 rdquo[제니퍼 서버
설치 폴더]confcomplus[COM+ 응용 프로그램 이름]confrdquo 파일을 삭제한다 (예 ldquoCJennifer
confcomplusMyComponentServerconfrdquo)
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
독립 실행형 응용 프로그램 및 NT 서비스
5
25
이 장에서는 IISCOM+ 이외의 응용 프로그램인 일반적인 독립실행형 응용 프로그램(Console WinForm
WPFhellip) 또는 NT 서비스 형식의 응용 프로그램을 모니터링 하기 위한 방법을 설명한다
51 에이전트 구성
511 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 5-1 예제 환경 설정
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 대상 응용 프로그램과 11 관계로 rdquoconfrdquo파일을
하나씩 지정한다
5121 conf 파일 설정
만약 테스트 exe 프로그램의 이름이 testexe 라고 가정해 보자
ldquoCJenniferagentnetconfrdquo 폴더에 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사해서 testexe
conf 라는 파일명으로 저장한다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
26 | 독립 실행형 응용 프로그램 및 NT 서비스
포트 값을 적절하게 설정한다
5122 환경 변수 설정
환경변수 설정 방법은 일반적인 독립실행형 응용 프로그램과 NT 서비스 응용 프로그램에 대해서 달라진다
독립실행형 응용 프로그램의 경우 다음과 같은 배치 파일을 이용해서 exe 실행 이전에 환경 변수를 설정
하도록 바꾼다
REM ===== startappbat =====
REM ===== 반드시 exe 파일명을 소문자로 지정한다
SET JENNIFER_PROFILE=testexe
testexe
반면 ldquoNT 서비스 응용 프로그램rdquo을 모니터링하려면 위와 같이 환경 변수를 설정하는 배치 파일을 만들
어 줄 수 없으므로 컴퓨터의 시스템 환경 변수 설정 창에서 시스템 환경 변수 영역에 JENNIFER_PROFI
LE 과 NT 서비스의 exe 파일 이름을 소문자로 등록해 준다 (물론 독립 실행형 응용 프로그램도 배치 파일
이 아닌 시스템 환경 변수에 등록해 줘도 무방하다)
5123 txserver 옵션 설정
독립 실행형 EXE나 NT 서비스는 RequestResponse에 대한 처리를 일반 소켓으로 입출력할 가능성이 크
기 때문에 그런 트랜잭션 단위가 되는 메소드를 알아내서 [설치 폴더]profilerini 의 [txserver] 섹션에
등록해 주어야 한다
txserver 지정 단위는 메소드와 클래스가 허용된다 다음은 각각의 예를 보여준다
[txserver]
BizServerBizClassSelectProduct=1 메소드 단위 지정
1은 enable을 의미
BizServerDacClass=c 1 대신 c 값을 지정해서 클래스 단위 지정이 가능
따라서 BizServerDacClass 안의 모든 메서드를
txserver로 동작하게 됨
참고로 일부 EXE 프로그램에서는 소켓이 아닌 닷넷의 원격 호출 규약으로 서비스를 제공하는 경우도 있
다 예를 들어 NT 서비스 프로그램 내에서 WCF NET Remoting 등의 방법을 사용해서 원격 호출을 제
공하는데 그런 경우에는 굳이 txserver를 지정하지 않아도 모니터링이 가능하다
5124 응용 프로그램 재 시작
모니터링 대상이 되는 응용 프로그램을 새롭게 설정한 환경 변수들이 적용되기 위해 재 시작을 한다
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
에이전트 구성 제거 | 27
52 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 JENNIFER_PROFILE 환경 변수에서 해당 e
xe 이름을 제거하면 모니터링이 중지된다 만약 프로세스가 실행 중이라면 재시작한다
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
닷넷 배치 프로세스 모니터링
6
29
이 장에서는 닷넷 버전의 제니퍼 에이전트를 이용하여 배치(Batch) 작업을 모니터링하는 방법을 설명한다
제니퍼에서 구현되는 배치 모니터링의 개념 및 자바에서의 설치방법은 rdquoBatch JOB Monitorin
grdquo 문서를 참고한다
61 MasterAgent 설치 및 실행
611 conf 파일 설정
rdquo[에이전트 설치 폴더]confapp_poolconfrdquo 파일을 복사해서 ldquobatchjob_masterconfrdquo 파일을 생성
한다 batchjob_masterconf 파일을 메모장에서 열고 제니퍼 서버 주소와 마스터 에이전트임을 알리는
설정을 추가한다
udp_server_host = [제니퍼 서버 주소]
MASTER_AGENT = true
612 마스터 에이전트 실행
마스터 에이전트 실행파일은 JENNIFER와 함께 설치되므로 별도의 설치작업은 필요없고 단순히 아래의 경
로에 제공되는 모듈을 실행하면 된다
NET 11 [에이전트 설치 폴더]binMasterAgentClr10exe
NET 20 ~ 35 [에이전트 설치 폴더]binMasterAgentClr20exe
NET 40 이상 [에이전트 설치 폴더]binMasterAgentClr40exe
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
30 | 닷넷 배치 프로세스 모니터링
62 SubAgent 설치 및 실행
서브 에이전트는 모니터링 해야 할 대상을 의미하는데 제니퍼 에이전트가 활성화 되는 배치 프로세스(exe)
가 이에 해당한다
621 conf 파일 설정
서브 에이전트가 종속될 마스터 에이전트의 conf 파일을 복사해서 새롭게 conf 파일을 생성하고 서브 에
이전트 임을 명시하기 위해 다음의 설정을 추가한다
[예 youragentconf]
SUB_AGENT = true
622 배치 프로세스에 conf 파일 연결
모니터링하려는 배치 프로세스의 실행 파일 경로가 다음과 같다고 가정할 때
CBatchJobsDailyWorkerexe
해당 프로세스 명에 rdquoconfigrdquo 파일을 연결하여 conf 폴더에 새롭게 파일을 생성한다
[에이전트 설치 폴더]confDailyWorkerexeconfig
파일의 내용은 아래와 같이 이전에 서브 에이전트 용으로 만들어 둔 conf (예 youragentconf) 를 지정
한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=youragentconf gt
ltappSettingsgt
ltconfigurationgt
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
제니퍼 에이전트 환경변수 설정 | 31
623 사용자 정의 메서드 프로파일링 설정
일반적으로 배치 프로세스에서는 사용자가 정의한 메서드를 트랜잭션 단위로 여기게 된다 따라서 rdquo닷넷
메서드 프로파일링ldquo에서 설명한 방법에 따라 rdquo[txserver]rdquo 절을 별도로 구성해야 한다
또한 배치 프로세스의 경우 반드시 rdquo[batchjob]rdquo 절을 정의하고 해당 응용 프로그램의 Main 함수를 정
의해 줘야 한다
예를 들어 사용자 코드가 다음과 같이 정의된 경우
namespace BatchJob1
class Program
static void Main(string[] args)
DoBatchJob()
void DoBatchJob()
만약 DoBatchJob 이 실제 배치 작업을 처리하는 메서드이고 txserver 로 모니터링해야 할 대상이라면
profilerini 파일에는 다음과 같이 설정해 주어야 한다
[batchjob프로세스명]
BatchJob1ProgramMain=1
[txserver프로세스명]
BatchJob1ProgramDoBatchJob=1
63 제니퍼 에이전트 환경변수 설정
배치 프로세스가 프로파일링되기 위해서는 ldquoJENNIFER_PROFILErdquo 이라는 별도의 환경 변수를 지정해야 한
다 만약 사용자의 배치 프로세스 명이 ldquoDailyWorkerexerdquo이고 마스터 에이전트의 프로세스 명이 Mast
erAgentClr40exe인 경우 다음과 같이 환경 변수를 등록한다
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
32 | 닷넷 배치 프로세스 모니터링
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexemasteragentclr40exe
프로세스 명은 반드시 소문자로 지정해야 한다
배치 프로세스가 여러 개인 경우 세미콜론()을 구분자로 해서 다음과 같이 지정하는 것이 가능하다
환경 변수 이름 JENNIFER_PROFILE
값 dailyworkerexeweeklyworkerexemonthlyworkerexemasteragentclr40exe
설정을 마치고 해당 배치 프로세스를 실행하면 정상적으로 모니터링이 이뤄진다
64 에이전트 모니터링 해제 제거
제니퍼 에이전트가 설치된 상태에서 배치 프로세스에 대한 모니터링만을 해제하고 싶다면 환경 변수에서
ldquoCOR_ENABLE_PROFILINGrdquo 값을 ldquo0rdquo으로 변경하면 된다 (또는 ldquoJENNIFER_PROFILErdquo 로 설정된 경우라
면 프로세스 명을 빼거나 JENNIFER_PROFILE 환경 변수 자체를 지우면 된다)
만약 제니퍼 에이전트까지 모두 제거하고 싶다면 현재 모니터링 중인 배치 프로세스를 모두 종료하고 ldquo
[에이전트 설치 폴더]uninstall_Jenniferbatrdquo을 관리자 권한으로 실행한 후 설치 폴더를 수동으로 삭제
해 준다
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
NET Data Provider 호출 모니터링 방법
7
33
71 사용중인 Data Provider 어셈블리 버전 확인
NET Framework 에서 제공되는 기본 NET Data Provider 이외에 제니퍼 닷넷에서 모니터링이 가능한 3
rd-party Data Provider 는 다음과 같다
OracleDataAccessClient (Oracle ODPNET)
MySqlData
Npgsql (PostgreSQL)
CoreLabOracle
그 외 Data Provider는 별도 문의
하지만 이와 같은 Data Provider를 모니터링하기 위해서는 대상 어셈블리의 정확한 버전을 알아야 한
다 이를 위해서 제니퍼 닷넷 설치 후 해당 Data Provider를 사용하는 웹 페이지를 한번이라도 방문한 후
에 [장애진단 | 유틸리티 | 시스템 환경 변수]를 통해서 현재 사용중인 Data Provider의 버전을 알아낼 수
있다
아래의 화면에서는 ldquoK11rdquo 에이전트가 설치된 응용 프로그램이 PostgreSQL 에 대한 접속을 위해 Npgsq
l NET Data Provider를 20110 버전으로 사용하고 있으며 ODPNET 은 211160 버전을 사용하고
있다는 것을 보여준다
그림 7-1 시스템 환경 변수
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
34 | NET Data Provider 호출 모니터링 방법
참고로 CoreLabOracle의 경우 예외적으로 1과 2 항목으로 나뉘어져 버전 표시가 된다
72 버전을 Profilerini 파일에 명시
모니터링 하려는 대상 어셈블리의 버전을 제니퍼에 알리기 위해서 [제니퍼 닷넷 설치 폴더]agentnet
폴더에 ldquoProfilerinirdquo 파일이 제공된다 이 파일을 메모장으로 열면 다음과 같이 ldquoPostgreSQLrdquo ldquoODPNET
rdquo 섹션을 확인할 수 있다
[생략]
[PostgreSQL]
20100
[ODPNET]
2111720
211160
210232
2102220
1020100
[MySqlData]
6640
[CoreLabOracle]
475430
470240
이 곳에 예제에서 확인했던 Npgsql 20110 ODPNET 211160 을 다음과 같이 반영해 줄 수 있다
[PostgreSQL]
20110
[ODPNET]
211160
변경 사항을 저장하고 다시 모니터링 대상 응용 프로그램을 재시작하면 정상적으로 모니터링 된다
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
닷넷 프레임워크
8
35
제니퍼의 닷넷 버전 지원에 따른 추가 설명이 필요한 환경 설정을 기술한다
81 윈도우 환경
811 관리자 권한으로 실행
프로그램을 실행시킬 때 ldquo관리자 권한rdquo을 획득하여 실행하는 방법이 Windows Server 2003과 Windows
Server 2008에서 다르기 때문에 각각 그 방법을 나눠서 설명한다
8111 Windows Server 2003
2가지 방법으로 관리자 권한을 획득할 수 있다
1 관리자 권한으로 시스템에 로그인 한 경우 모든 실행 프로그램들에 관리자 권한이 부여된다
2 비-관리자 권한으로 시스템에 로그인 한 경우 탐색기에서 해당 프로그램을 마우스 오른쪽 버튼 클릭
메뉴에서 ldquoRun ashellipldquo를 선택하고 관리자 계정을 입력하여 실행한다 참고로 배치 파일(bat)인 경우
ldquoRun ashelliprdquo 메뉴가 제공되지 않기 때문에 ldquo시작rdquo ldquo모든 프로그램rdquo ldquo보조 프로그램rdquo ldquo명령 프롬프
트rdquo를 ldquoRun ashellipldquo메뉴를 이용하여 관리자 계정으로 실행한 다음 명령행에서 배치 파일을 실행한다
8112 Windows Server 2008 Windows Server 2008 R2
Windows Server 2008 이후부터는 ldquo사용자 계정 컨트롤(UAC User Access Control)rdquo 기능이 ldquoAdmini
stratorrdquo 계정 이외의 관리자 계정에 적용되기 때문에 다음과 같이 3가지 상황에 따라 그에 알맞는 방법을
선택해야 한다
Administrator계정으로 로그인 한 경우 실행되는 모든 응용 프로그램은 기본적으로 ldquo관리자 권한rdquo으
로 실행된다
ldquo관리자 그룹rdquo에 속한 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그램을 마우스
오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택한다 ldquo사용자 계정 컨트롤rdquo 창이 뜨고 ldquo확인rdquo
버튼을 선택하면 ldquo관리자 권한rdquo으로 실행된다
ldquo관리자 그룹rdquo 이외의 일반 사용자 계정으로 로그인 한 경우 탐색기에서 실행하고자 하는 응용 프로그
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
36 | 닷넷 프레임워크
램을 마우스 오른쪽 버튼 클릭 후 ldquo관리자 권한으로 실행rdquo 메뉴를 선택하고 관리자 그룹에 속한 사용
자 계정 정보를 입력한다
812 NT 서비스 명(Service name) 찾는 방법
ldquo시작rdquo ldquo관리도구rdquo ldquo서비스rdquo 관리자를 실행하고 대상 NT 서비스의 ldquo속성창rdquo을 연다 예를 들어 다음은
예제 NT 서비스인 ldquoRemoteTestServicerdquo의 속성창에서 ldquoService namerdquo을 확인하는 방법을 보여준다
그림 8-1 Services
이 예제에서는 NT 서비스명이 ldquoRemoteTestServicerdquo임을 알 수 있다
82 IIS 환경
821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
IIS 7(R2 의 경우 IIS 75) 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선
택한 후 ldquoFeatures Viewrdquo 기능 중에서 ldquoApplication Settingsrdquo 아이콘을 더블 클릭한다
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
IIS 환경 | 37
그림 8-2 Application Settings
우측 ldquoActionsrdquo 메뉴에서 ldquoAddhelliprdquo 버튼을 누르고 아래와 같이 값을 입력한다
Name JenniferFileName
Value [conf 파일명]
만약 설정된 conf 파일명이 app_poolconf 라면 다음과 같이 입력될 수 있다
Name JenniferFileName
Value app_poolconf
822 응용 프로그램의 webconfig 위치 확인 방법
8221 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
38 | 닷넷 프레임워크
e Directoryrdquo 탭을 선택한다
그림 8-3 Local Path
위의 예제에서는 해당 응용 프로그램의 설치 폴더가 ldquoDJennifer40WebSiteTestrdquo로 지정된 것을 확
인할 수 있는데 이 폴더에 webconfig 파일이 있다
8222 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
IIS 환경 | 39
그림 8-4 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 설치된 폴더를 확인할 수 있는데 이 예제에서는 webco
nfig 파일이 ldquoCinetpubwwwrootrdquo에 있음을 알 수 있다
그림 8-5 Physical Path
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
40 | 닷넷 프레임워크
823 Web Garden 수 확인하는 방법
8231 IIS 6 에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo의 속성 창을 띄우고 ldquoHom
e Directoryrdquo 탭을 선택한다
그림 8-6 Application pool
위의 예제에서는 해당 응용 프로그램의 ldquoApplication Poolrdquo이 ldquoDefaultAppPoolrdquo로 지정된 것을 확인할
수 있다 이제 IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 ldquoDefaultAppPoolrdquo 이름에 해당하는 노드를 선
택하고 속성창을 띄운다
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
IIS 환경 | 41
그림 8-7 Properties
마지막으로 ldquoPerformancerdquo 탭을 선택하면 아래와 같이 ldquoWeb Gardenrdquo의 수를 확인할 수 있다 (기본값
1)
그림 8-8 Web garden
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
42 | 닷넷 프레임워크
824 IIS 7 이상에서 확인하는 방법
IIS 관리자를 실행하고 모니터링 하려는 ldquo웹 사이트rdquo 또는 ldquo가상 응용 프로그램rdquo을 선택한 후 ldquoAdvanced S
ettingshelliprdquo 링크를 누른다
그림 8-9 Advanced Settings
대화창에서 다음과 같이 해당 응용 프로그램이 활성화되는 ldquoApplication Poolrdquo을 확인할 수 있다
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
IIS 환경 | 43
그림 8-10 Application Pool
IIS 관리자의 ldquoApplication Poolsrdquo 노드에서 위의 예제에서 확인한 ldquoDefaultAppPoolrdquo 이름을 선택하고
ldquoAdvanced Settingshelliprdquo 링크를 누른다
그림 8-11 Application Pools
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
44 | 닷넷 프레임워크
그럼 다음 화면과 같이 ldquoMaximum Worker Processesrdquo 의 수를 확인할 수 있는데 이 값이 바로 IIS 6
버전에서 지정되던 ldquoWeb Gardenrdquo 값이다
그림 8-12 Maximum Worker Processes
8241 응용 프로그램의 단위
IIS 에서 ldquo응용 프로그램rdquo이란 ldquo웹 사이트rdquo 와 그 하위의 ldquo가상 응용 프로그램rdquo을 의미한다 다음과 같은 IIS
환경을 예를 들어 설명하면
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
IIS 환경 | 45
그림 8-13 Web Sites
총 11개의 ldquo응용 프로그램rdquo 이 있는데 각각 다음과 같이 나뉜다
웹 사이트
Default Web Site
ScrumEvent
Team Foundation Server
WCFTest
TFSWSS
SharePoint Central Administration
가상 응용 프로그램
ScrumforTeamSystem
Build
Services
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
46 | 닷넷 프레임워크
VersionControl
Warehouse
WorkItemTracking
83 COM+ 구성요소 서비스
831 COM+ Application Pool 확인
서버 활성화 유형의 COM+ 서비스는 IIS의 Web Garden과 유사하게 Application Pool 설정을 통해서 같
은 COM+ 구성요소를 호스팅하는 프로세스를 다중으로 실행해준다 설정된 Pool 의 수를 확인하기 위해
서 다음과 같은 순서를 따른다
3 ldquo시작rdquo ldquo관리 도구(Administrative Tools)rdquo ldquo구성요소 서비스(Component Services)rdquo 를 실행한다
4 아래와 같이 원하는 구성요소를 선택하고 마우스 오른쪽 버튼을 눌러 ldquo속성(Properties)rdquo 메뉴를 선택
한다
그림 8-14 COM+ Applications
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
닷넷 프레임워크 환경 | 47
5 속성 창에서 ldquoPooling amp Recyclingrdquo 탭을 선택하면 아래와 같이 ldquoPool Sizerdquo를 확인할 수 있다
그림 8-15 Application Pooling
84 닷넷 프레임워크 환경
841 설치된 닷넷 프레임워크 버전 확인
닷넷 프레임워크는 버전 20 을 기반으로 WCF WF WPF 기능에 해당하는 DLL 들이 추가되어 30 이 되
고 LINQ 등이 추가되면서 35 가 된다 따라서 해당 시스템에 35가 설치되어 있다는 것은 곧 30과 20
이 함께 추가되어 있다는 것을 의미하며 마찬가지로 30이 설치되어 있다는 것은 20이 기본적으로 설치
되어 있다는 것을 의미한다
설치된 닷넷 프레임워크 버전은 다음의 레지스트리 키를 통해서 가능하다
HKEY_LOCAL_MACHINESOFTWAREMicrosoftNET Framework SetupNDP
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
48 | 닷넷 프레임워크
아래의 그림은 Windows 2003 운영체제에서 버전 11 20 30 35 가 설치되어 있는 것을 보여준다
그림 8-16 NET Framework Setup
이때 주의할 것은 해당 레지스트리 키에 속한 ldquoInstallrdquo (REG_DWROD) 값이 반드시 1임을 확인한다
842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
기본적으로 설치된 닷넷 프레임워크 버전 확인 에서 설명한 레지스트리 경로 ldquoHKEY_LOCAL_MACHINE
SOFTWAREMicrosoftNET Framework SetupNDPrdquo는 32비트 운영체제에서는 32비트 닷넷 프
레임워크 설치 여부를 알려주고 64비트 운영체제에서는 64비트 닷넷 프레임워크 설치 여부를 알려준다
추가적으로 64비트의 경우 32비트 닷넷 프레임워크가 별도로 설치되는 것이 가능한데 이를 확인하기
위해서는 아래와 같이 ldquoWow6432Noderdquo를 포함한 레지스트리 경로값을 확인해야 한다
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftNET Framework SetupNDP
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
제니퍼 닷넷 구성 IIS (NET Framework 11
용)
9
49
이 장에서는 IIS 웹 응용 프로그램을 모니터링하는 방법을 설명한다
91 에이전트 구성
911 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 9-1 기본 구성 환경
구분 대상
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
912 webconfig 및 conf 파일 구성
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 응용 프로그램을 대상으로 webconfig을 변경
하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
모니터링 대상이 되는 응용 프로그램에 대해서는 응용 프로그램의 단위 를 참조한다
9121 하나의 응용 프로그램만 모니터링 할 경우
91211 conf 파일 설정
ldquoCJenniferagentnetconfapp_poolconfrdquo 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준
다
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
50 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
udp_server_host = 1921680139
모니터링 대상이 되는 응용 프로그램을 위해 제니퍼 서버에서 식별할 고유 이름을 제공한다
agent_pool=N109000
agent_pool 값은 rdquo[식별자][포트번호]rdquo 형식으로 2개 이상을 지정하는 경우 컴마()를 구분자
로 연결할 수 있다
이 때 만약 해당 응용 프로그램을 호스팅 하는 ldquoAppPoolrdquo 의 Web Garden 수가 2개라면 그 수에 해당
하는 agent_pool값을 설정해야 한다 (Web Garden에 대해서는 Web Garden 수 확인하는 방법을 참조
한다)
agent_pool=N109000N119001
마찬가지로 ldquoWeb Gardenrdquo의 수가 3이라면 다음과 같이 설정한다
agent_pool=N109000N119001N129002
91212 webconfig에 conf파일을 지정
ldquo시작rdquo ldquo관리도구rdquo ldquoIIS(인터넷 정보 서비스) 관리자rdquo 를 실행하고 모니터링 하기를 원하는 대상 응용 프
로그램을 선택하고 ldquo속성rdquo 메뉴를 선택한다 예를 들어 아래의 화면에서처럼 ldquo웹 사이트rdquo 또는 ldquo웹 가상 응
용 프로그램rdquo을 선택해야 한다
그림 9-1 Properties
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
에이전트 구성 | 51
속성창에서 ldquoASPNETrdquo 탭을 선택하고 ldquoEdit Configurationhelliprdquo 버튼을 눌러서 ldquoASPNET Configuratio
n Settingsrdquo 창을 띄워서 ldquoAddhelliprdquo 버튼을 누른다
그림 9-2 Configuration Settings
새로운 값을 입력받는 창에서 다음과 같은 값을 넣는다
Key JenniferFileName
Value [Step 1]단계에서 구성한 conf 파일명
만약 app_poolconf 파일을 사용한다면
Key JenniferFileName
Value app_poolconf
와 같이 입력하고 ldquo확인rdquo 버튼을 누른다 이렇게 입력되고 나면 webconfig 파일의 내용에 다음과 같은
설정이 추가된다
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
52 | 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
ltappSettingsgt lt-- webconfig에 이미 appSettings 노드가 있다면
내부에 아래의 내용만 추가해 준다 --gt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
따라서 IIS 관리자에서 제공되는 UI를 통해서 입력될 뿐만 아니라 메모장 등의 편집기를 통해서 직접 내
용을 추가하는 것이 가능하다
Windows Server 2008의 경우 Windws Server 2008에서 webconfig에 conf파일을 지정
하는 방법 을 참고한다
91213 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
91221 응용 프로그램 수에 따라 conf 파일 생성
모니터링 대상이 2개 이상이라면 그 수에 맞게 conf 파일을 생성해 준다 예를 들어 응용 프로그램이 3개
라면 다음과 같이 3개의 conf 파일을 생성해 두어야 한다
CJenniferagentnetconfapp_poolconf
CJenniferagentnetconfapp_pool_2conf
CJenniferagentnetconfapp_pool_3conf
이름 규칙은 없으며 간단히 기존의 app_poolconf 파일을 복사해서 다른 이름으로 설정하면 된다
91222 conf 파일의 내용 설정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 1]ldquo에서 설명한 데로 udp_server_host 값과 agent_p
ool 값을 모니터링 대상이 되는 응용 프로그램의 상황에 맞게 설정한다
91223 webconfig에 conf 파일을 지정
하나의 응용 프로그램만 모니터링 할 경우의 rdquo[Step 2]ldquo에서 설명한 데로 개별 응용 프로그램에 속한 web
config 마다 다음과 같이 ltadd gt로 연결해 준다
ltappSettingsgt
ltadd key=JenniferFileName value=app_poolconf gt
ltappSettingsgt
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
에이전트 구성 제거 | 53
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_2conf gt
ltappSettingsgt
ltappSettingsgt
ltadd key=JenniferFileName value=app_pool_3conf gt
ltappSettingsgt
91224 w3wpexe 재실행
ldquoiisresetrdquo 을 실행하여 변경 사항을 응용 프로그램에 반영한다
92 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 webconfig 에 구성한 JenniferFileName
값을 삭제해서 conf 파일과의 관계를 끊어주면 모니터링이 중지된다
921 설정 제거
웹 응용 프로그램의 webconfig 에서 제니퍼 에이전트 설정을 지운다
ltxmlversion10gt
ltconfigurationxmlnshttpschemasmicrosoftcomNetConfigurationv20gt
hellip [생략] hellip
ltappSettingsgt
lt--add key=JenniferFileName value=app_poolconf --gt
ltappSettingsgt
hellip [생략] hellip
ltconfigurationgt
922 iis 재실행
만약 서비스 중인 웹 응용 프로그램이 있다면 ldquoiisresetrdquo 명령어를 실행해서 모니터링이 중지된 서비스가
실행되도록 한다
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
COM+ 구성 (NET Framework 11 용)
10
55
이 장에서는 ldquo서버 활성화rdquo 유형의 COM+(NET Framework 11용) 패키지를 모니터링하는 방법을 설명
한다
101 에이전트 구성
1011 구성 환경
아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환
경 정보를 보여주고 있다 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며 실제 작업 시는 사용자
서버의 환경 정보에 맞추어 설치작업을 진행해야 한다
표 10-1 기본 구성환경
구분 설명
제니퍼 에이전트 홈 디렉토리 CJennifer
제니퍼 서버 IP Address 1921680139
모니터링 대상 COM+ 응용프로그램 A MyComponentServer
모니터링 대상 COM+ 응용프로그램 B SecondEntLibServerApp
1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
제니퍼 에이전트가 시스템에 설치된 후 모니터링 하려는 COM+ 구성요소를 대상으로 applicationconfi
g을 설정하고 11 관계로 rdquoconfrdquo파일을 하나씩 지정한다
10121 conf 파일 설정
ldquoCJenniferagentnetconfrdquo 폴더의 기본 설정값을 담은 ldquoapp_poolconfrdquo를 복사한다 (예 defaul
t_poolconf) 복사된 conf 파일에서 제니퍼 서버 주소를 명시적으로 지정해 준다
udp_server_host 에는 제니퍼 서버가 설치된 컴퓨터의 주소를 입력하고 agent_pool 에는 고유 ID 와
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
56 | COM+ 구성 (NET Framework 11 용)
포트 값을 적절하게 설정한다 에이전트의 고유 ID 수는 모니터링 대상이 되는 COM+ 서버 응용 프로그램
의 ldquoApplication Poolingrdquo에 설정된 ldquoPool Sizerdquo에 따르도록 한다
COM+ 구성요소의 Application Pool 수를 알아내는 방법은 rdquoCOM+ Application Pool 확인
ldquo을 참고한다
10122 applicationconfig applicationmanifest 생성
COM+ 구성요소 하나에 대해서 임의의 폴더를 하나 생성한다 예를 들어 ldquoMyComponentServerrdquo ldquoSec
ondEntLibServerApprdquo 라는 이름의 COM+ 구성요소 2개를 모니터링하려면 다음의 예에서 보는 것처럼
2개의 폴더를 생성해 둔다
dmanifestmycomapp
dmanifestsecondapp
생성된 2개의 폴더 모두에 rdquo[제니퍼 홈 폴더]agentnetsamplecomplusrdquo 폴더에 있는 ldquoapplicati
onconfigrdquo ldquoapplicationmanifestrdquo 파일을 복사한다 복사된 2개의 파일 중에서 ldquoapplicationmanifest
rdquo 파일은 변경없이 사용하지만 ldquoapplicationconfigrdquo 파일은 webconfig 파일을 편집했던 것처럼 ldquoJennif
erFileNamerdquo 값을 [Step 1] 에서 생성해 두었던 conf 파일명으로 지정해 주어야 한다
ltxml version=10 encoding=UTF-8gt
ltconfigurationgt
ltappSettingsgt
ltadd key=JenniferFileName value=default_poolconf gt
ltappSettingsgt
ltconfigurationgt
10123 Application Root Directory 지정
생성해 두었던 폴더를 가리키도록 해당 COM+ 응용 프로그램 설정에서 ldquoApplication Root Directoryrdquo 값
을 지정해 준다
COM+ 응용 프로그램 Application Root Directory
MyComponentServer dmanifestmycomapp
SecondEntLibServerApp dmanifestsecondapp
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
에이전트 구성 | 57
그림 10-1 Application Root Directory
10124 구성요소 재실행
아래와 같이 COM+ 구성요소 서비스 관리자에서 현재 실행되어 있는 dllhostexe 실행 파일들에 제니퍼
닷넷이 반영되도록 개별 프로세스마다 ldquoRecyclerdquo메뉴를 실행한다
그림 10-2 Recycle
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
58 | COM+ 구성 (NET Framework 11 용)
ldquoSystem Applicatoinrdquo 구성요소는 시스템에 의해서 등록된 구성요소 서비스이므로 ldquoRecyclerdquo
명령을 실행하지 않는다
102 에이전트 구성 제거
제품 설치는 그대로 유지하고 모니터링만을 그만 두려는 경우 COM+ 응용 프로그램 설정에 적용된 Appli
cationRootDirectory 설정을 해제한다 만약 제니퍼 적용 이전에 이미 ApplicationRootDirectory 설정
을 가진 응용 프로그램이었다면 applicationconfig 파일 안의 JenniferFileName 속성만을 삭제해 준다
이후 만약 서비스 중인 COM+ 구성요소가 있다면 ldquoCOM+ 구성요소 관리자rdquo에서 실행중인 인스턴스에
대해 각각 ldquoRecyclerdquo 명령을 실행해서 모니터링 상태를 해제한다
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
w3wp 자동 시작 옵션
11
59
IIS 에서 호스팅되는 w3wpexe는 클라이언트로부터의 요청이 20분(기본값)동안 없는 경우 스스로 종료
하게 되어 있다 이와 함께 제니퍼 닷넷 에이전트도 내려가기 때문에 제니퍼 콘솔에서는 해당 에이전트가 S
topped로 표시된다
문제는 Stopped가 실제 응용 프로그램의 오류로 인해 IIS가 강제로 실행되지 못하도록 한 것인지 20분
동안 요청이 없어서 내려간 것인지에 대한 구분이 없으므로 장애 모니터링을 하는 데 불편하므로 이를 해
결하기 위해 IIS 75부터 제공되는 Start Mode AlwaysRunning 기능을 이용한 JenniferPreloaddll을
활용할 수 있다
2012년 11월 8일 이후 릴리즈 된 제니퍼 닷넷의 IISConfigHelper는 이를 위해 Web Garden 우측에
Enable AutoStart라는 옵션을 제공한다 이 옵션은 오직 다음의 조건을 만족하는 경우에만 활성화 된다
IIS 75
Web Application 이 NET 40 이상의 응용 프로그램
Enable AutoStart 옵션을 켜고 Save 버튼을 누르면 2가지 변경 사항이 시스템에 적용된다
1 WINDIRsystem32inetsrvconfigapplicationHostconfig 파일에 AutoStart 관련
옵션 변경
JenniferPreloaddll 이 실행되도록 설정
2 제니퍼의 에이전트 conf 파일에 startup_url 옵션 변경
startup_url 키에 w3wpexe 프로세스가 시작되면서 방문하게 될 페이지에 대한 URL 경로 설정
startup_url 옵션은 기본적으로 httplocalhost[포트번호]로 간단하게 구성되는데 고객사마다 도메
인 명을 특별하게 구성하는 변경이 있다면 그런 경우에만 제니퍼 콘솔의 구성 관리 구성 설정 에서
변경해 준다
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-
색인
61
- 제니퍼 45 설치가이드 ( NET )
- 목차
- 1 제니퍼 서버 설치
-
- 11 제니퍼 서버 사양
- 12 UNIX에 제니퍼 서버 설치
- 13 WINDOWS에 제니퍼 서버 설치
- 14 클라이언트 설정
-
- 141 웹 브라우져
- 142 자바 플러그인
-
- 1421 설치와 제거
-
- 143 메모리 설정
- 144 웹 브라우져 설정
-
- 1441 자바 애플릿
- 1442 자바스크립트
- 1443 플래시 플레이어
-
- 145 윈도우 서비스 등록
-
- 2 제니퍼 닷넷 설치가이드
-
- 21 제니퍼 닷넷 에이전트 설치 및 제거
-
- 211 제니퍼 닷넷 에이전트 설치 환경
- 212 에이전트 설치
-
- 2121 설치환경
- 2122 사전 설치
- 2123 에이전트 설치
- 2124 에이전트 제거
-
- 213 제니퍼 서버 구성 변경
-
- 2131 클라이언트를 위한 설정 변경
- 2132 제니퍼 에이전트를 위한 설정
- 2133 제니퍼 사용을 위한 방화벽 설정
-
- 214 설치 트러블 슈팅
-
- 2141 설치 오류
- 2142 라이선스 오류 유형
- 2143 대시 보드 동작 오류 유형
-
- 3 제니퍼 닷넷 구성 (IIS COM+)
-
- 31 IIS 웹 응용 프록램 COM+ 구성
-
- 311 실행
- 312 구성
-
- 3121 모니터링을 원하는 IISCOM+ 응용 프로그램 설정
-
- 31211 설정 파일 생성
- 31212 설정
- 31213 응용 프로그램 재실행
-
- 웹 응용 프로그램 w3wpexe 재시작
- COM+ dllhostexe 재시작
-
- 3122 모니터링 해제
-
- 31221 설정파일 제거
- 31222 IIS COM+ 재실행
-
- 4 COM+ 구성 (2013-06-04 이전)
-
- 41 에이전트 구성
-
- 411 구성 환경
- 412 COM+ 응용 프로그램 이름의 conf 파일 구성
-
- 4121 COM+ 응용 프로그램 이름 확인
- 4122 설정 파일 생성
- 4123 구성요소 재실행
-
- 42 에이전트 구성 제거
-
- 5 독립 실행형 응용 프로그램 및 NT 서비스
-
- 51 에이전트 구성
-
- 511 구성 환경
- 512 [응용 프로그램 이름]execonfig 변경 및 환경 변수 설정
-
- 5121 conf 파일 설정
- 5122 환경 변수 설정
- 5123 txserver 옵션 설정
- 5124 응용 프로그램 재 시작
-
- 52 에이전트 구성 제거
-
- 6 닷넷 배치 프로세스 모니터링
-
- 61 MasterAgent 설치 및 실행
-
- 611 conf 파일 설정
- 612 마스터 에이전트 실행
-
- 62 SubAgent 설치 및 실행
-
- 621 conf 파일 설정
- 622 배치 프로세스에 conf 파일 연결
- 623 사용자 정의 메서드 프로파일링 설정
-
- 63 제니퍼 에이전트 환경변수 설정
- 64 에이전트 모니터링 해제 제거
-
- 7 NET Data Provider 호출 모니터링 방법
-
- 71 사용중인 Data Provider 어셈블리 버전 확인
- 72 버전을 Profilerini 파일에 명시
-
- 8 닷넷 프레임워크
-
- 81 윈도우 환경
-
- 811 관리자 권한으로 실행
-
- 8111 Windows Server 2003
- 8112 Windows Server 2008 Windows Server 2008 R2
-
- 812 NT 서비스 명(Service name) 찾는 방법
-
- 82 IIS 환경
-
- 821 Windws Server 2008에서 webconfig에 conf파일을 지정하는 방법
- 822 응용 프로그램의 webconfig 위치 확인 방법
-
- 8221 IIS 6 에서 확인하는 방법
- 8222 IIS 7 이상에서 확인하는 방법
-
- 823 Web Garden 수 확인하는 방법
-
- 8231 IIS 6 에서 확인하는 방법
-
- 824 IIS 7 이상에서 확인하는 방법
-
- 8241 응용 프로그램의 단위
-
- 83 COM+ 구성요소 서비스
-
- 831 COM+ Application Pool 확인
-
- 84 닷넷 프레임워크 환경
-
- 841 설치된 닷넷 프레임워크 버전 확인
- 842 64비트 운영체제에 설치된 32비트 닷넷 프레임워크 버전 확인
-
- 9 제니퍼 닷넷 구성 IIS (NET Framework 11 용)
-
- 91 에이전트 구성
-
- 911 구성 환경
- 912 webconfig 및 conf 파일 구성
-
- 9121 하나의 응용 프로그램만 모니터링 할 경우
-
- 91211 conf 파일 설정
- 91212 webconfig에 conf파일을 지정
- 91213 w3wpexe 재실행
-
- 9122 두 개 이상의 응용 프로그램을 모니터링 할 경우
-
- 91221 응용 프로그램 수에 따라 conf 파일 생성
- 91222 conf 파일의 내용 설정
- 91223 webconfig에 conf 파일을 지정
- 91224 w3wpexe 재실행
-
- 92 에이전트 구성 제거
-
- 921 설정 제거
- 922 iis 재실행
-
- 10 COM+ 구성 (NET Framework 11 용)
-
- 101 에이전트 구성
-
- 1011 구성 환경
- 1012 conf 파일 구성 및 COM+ 응용 프로그램 설정
-
- 10121 conf 파일 설정
- 10122 applicationconfig applicationmanifest 생성
- 10123 Application Root Directory 지정
- 10124 구성요소 재실행
-
- 102 에이전트 구성 제거
-
- 11 w3wp 자동 시작 옵션
- 색인
-