제니퍼 4.5 설치가이드 (.NET ) JenniferSoft

목차 목차.................................................................... iii 1. 제니퍼서버설치........................................................ 1 1.1 제니퍼서버사양........................................................... 1 1.2 UNIX 에제니퍼서버설치..................................................... 1 1.3 WINDOWS 에제니퍼서버설치................................................ 3 1.4 클라이언트설정 1.4.1 웹브라우져 1.4.2 자바플러그인............................................................ 4............................................................ 4.......................................................... 5 1.4.2.1 설치와제거........................................................ 5 1.4.3 메모리설정............................................................ 5 1.4.4 웹브라우져설정 1.4.4.1 자바애플릿 1.4.4.2 자바스크립트........................................................ 6........................................................ 6....................................................... 8 1.4.4.3 플래시플레이어 1.4.5 윈도우서비스등록..................................................... 10...................................................... 10 2. 제니퍼닷넷설치가이드................................................... 11 2.1 제니퍼닷넷에이전트설치및제거 2.1.1 제니퍼닷넷에이전트설치환경............................................... 11............................................. 11 2.1.2 에이전트설치 2.1.2.1 설치환경 2.1.2.2 사전설치.......................................................... 11........................................................... 11.......................................................... 12 2.1.2.3 에이전트설치 2.1.2.4 에이전트제거....................................................... 12....................................................... 12 2.1.3 제니퍼서버구성변경.................................................... 13 2.1.3.1 클라이언트를위한설정변경............................................ 13 iii

iv 목차 2.1.3.2 제니퍼에이전트를위한설정 2.1.3.3 제니퍼사용을위한방화벽설정............................................ 13.......................................... 14 2.1.4 설치트러블슈팅 2.1.4.1 설치오류........................................................ 15.......................................................... 15 2.1.4.2 라이선스오류유형................................................... 15 2.1.4.3 대시보드동작오류유형............................................... 15 3. 제니퍼닷넷구성 (IIS, COM+).............................................. 17 3.1 IIS 웹응용프록램 / COM+ 구성................................................ 17 3.1.1 실행 3.1.2 구성................................................................. 17................................................................. 18 3.1.2.1 모니터링을원하는 IIS/COM+ 응용프로그램설정............................. 18 3.1.2.1.1 설정파일생성................................................... 18 3.1.2.1.2 설정.......................................................... 18 3.1.2.1.3 응용프로그램재실행.............................................. 19 웹응용프로그램 w3wp.exe 재시작........................................... 19 COM+ dllhost.exe 재시작................................................. 19 3.1.2.2 모니터링해제....................................................... 20 3.1.2.2.1 설정파일제거.................................................... 20 3.1.2.2.2 IIS / COM+ 재실행 4. COM+ 구성 (2013-06-04 이전 )................................................ 20........................................... 21 4.1 에이전트구성 4.1.1 구성환경............................................................. 21............................................................. 21 4.1.2 COM+ 응용프로그램이름의 conf 파일구성.................................... 21 4.1.2.1 COM+ 응용프로그램이름확인.......................................... 22 4.1.2.2 설정파일생성 4.1.2.3 구성요소재실행...................................................... 22..................................................... 23 4.2 에이전트구성제거.......................................................... 23 5. 독립실행형응용프로그램및 NT 서비스....................................... 25 5.1 에이전트구성 5.1.1 구성환경............................................................. 25............................................................. 25 5.1.2 [ 응용프로그램이름 ].exe.config 변경및환경변수설정........................... 25 5.1.2.1 conf 파일설정 5.1.2.2 환경변수설정...................................................... 25...................................................... 26 5.1.2.3 txserver 옵션설정 5.1.2.4 응용프로그램재시작................................................... 26................................................. 26

v 5.2 에이전트구성제거.......................................................... 27 6. 닷넷배치프로세스모니터링 6.1 MasterAgent 설치및실행............................................... 29.................................................... 29 6.1.1 conf 파일설정......................................................... 29 6.1.2 마스터에이전트실행 6.2 SubAgent 설치및실행..................................................... 29...................................................... 30 6.2.1 conf 파일설정......................................................... 30 6.2.2 배치프로세스에 conf 파일연결............................................. 30 6.2.3 사용자정의메서드프로파일링설정.......................................... 31 6.3 제니퍼에이전트환경변수설정 6.4 에이전트모니터링해제 / 제거................................................. 31.................................................. 32 7..NET Data Provider 호출모니터링방법....................................... 33 7.1 사용중인 Data Provider 어셈블리버전확인........................................ 33 7.2 버전을 Profiler.ini 파일에명시................................................. 34 8. 닷넷프레임워크 8.1 윈도우환경........................................................ 35............................................................... 35 8.1.1 관리자권한으로실행..................................................... 35 8.1.1.1 Windows Server 2003............................................... 35 8.1.1.2 Windows Server 2008, Windows Server 2008 R2.......................... 35 8.1.2 NT 서비스명 (Service name) 찾는방법........................................ 36 8.2 IIS 환경.................................................................. 36 8.2.1 Windws Server 2008 에서 web.config 에 conf 파일을지정하는방법.................. 36 8.2.2 응용프로그램의 web.config 위치확인방법.................................... 37 8.2.2.1 IIS 6 에서확인하는방법............................................... 37 8.2.2.2 IIS 7 이상에서확인하는방법 8.2.3 Web Garden 수확인하는방법............................................ 38............................................. 40 8.2.3.1 IIS 6 에서확인하는방법 8.2.4 IIS 7 이상에서확인하는방법 8.2.4.1 응용프로그램의단위............................................... 40............................................... 42................................................. 44 8.3 COM+ 구성요소서비스...................................................... 46 8.3.1 COM+ Application Pool 확인.............................................. 46 8.4 닷넷프레임워크환경........................................................ 47 8.4.1 설치된닷넷프레임워크버전확인............................................ 47 8.4.2 64 비트운영체제에설치된 32 비트닷넷프레임워크버전확인........................ 48 9. 제니퍼닷넷구성 IIS (.NET Framework 1.1 용 )................................. 49

vi 목차 9.1 에이전트구성 9.1.1 구성환경............................................................. 49............................................................. 49 9.1.2 web.config 및 conf 파일구성.............................................. 49 9.1.2.1 하나의응용프로그램만모니터링할경우................................... 49 9.1.2.1.1 conf 파일설정................................................... 49 9.1.2.1.2 web.config 에 conf 파일을지정....................................... 50 9.1.2.1.3 w3wp.exe 재실행................................................ 52 9.1.2.2 두개이상의응용프로그램을모니터링할경우 9.1.2.2.1 응용프로그램수에따라 conf 파일생성............................... 52................................. 52 9.1.2.2.2 conf 파일의내용설정............................................. 52 9.1.2.2.3 web.config 에 conf 파일을지정...................................... 52 9.1.2.2.4 w3wp.exe 재실행................................................ 53 9.2 에이전트구성제거.......................................................... 53 9.2.1 설정제거 9.2.2 iis 재실행............................................................. 53............................................................. 53 10. COM+ 구성 (.NET Framework 1.1 용 )...................................... 55 10.1 에이전트구성 10.1.1 구성환경............................................................ 55............................................................ 55 10.1.2 conf 파일구성및 COM+ 응용프로그램설정.................................. 55 10.1.2.1 conf 파일설정..................................................... 55 10.1.2.2 application.config, application.manifest 생성............................. 56 10.1.2.3 Application Root Directory 지정....................................... 56 10.1.2.4 구성요소재실행.................................................... 57 10.2 에이전트구성제거 11. w3wp 자동시작옵션......................................................... 58................................................... 59 색인.................................................................... 61

1. 제니퍼서버설치 이장에서는제니퍼서버의설치와구성방법에대해설명한다. 1.1 제니퍼서버사양 모니터링대상시스템의규모및수집하는데이터의양에따라다르기는하나, 일반적으로평균 1000TPS 이하의트랜잭션을서비스하는시스템에서는다음과같은사양을필요로한다. 항목 권장사양 CPU 펜디엄4이상 ( 인텔기준 ) Memory 2GB이상 하드디스크 10GB이상 - 시스템규모에따라변동될수있음. 지원 OS Windows, Linux, AIX, HP, Solaris 자바버전 1.5 이상 지원 Database Derby( 기본 ), Oracle, DB2, MS-SQL 제니퍼서버는 JAVA 가설치되어있는대부분의시스템에서운영가능하며하드디스크용량의경우제니 퍼가구성되어질시스템규모, 데이터수집정도에따라사양이변경될수있다. 1.2 UNIX 에제니퍼서버설치 제니퍼서버설치에따른사용자의이해를돕기위해, 아래의표는제니퍼서버설치에필요한서버의환경 정보예제를보여주고있다. 본설치가이드는아래의환경값을기준으로설명되며, 실제값은사용자서버 의환경정보에맞추어실제설치작업을진행해야한다. 환경변수 값 제니퍼서버 HOME 디렉토리 /home/jennifer/server JAVA_HOME /usr/java15 IP Address 192.168.0.139 1

2 제니퍼서버설치 1. jennifer 계정을새로생성하면서 /home/jennifer 홈디렉토리를확인하여생성한다. 2. 생성된디렉토리에압축파일을해제한다. # gzip -d jennifer4.5.2.tar.gz # tar -xvf jennifer4.5.2.tar 3. JAVA_HOME 환경변수를설정한다. 4. /home/jennifer/server/bin 으로이동한다. cd /home/jennifer/server/bin 5. startup.sh을실행한후로그를확인한다. 제니퍼서버최초기동시만데이터베이스테이블생성작업이아래와같이진행된다. 이때문에서버의사양에따라시간이오래걸릴수있다. /home/jennifer/server/logs 디렉토리에서 jennifer.log.yyyymmdd 파일에서아래의로그를확인한다 20110530/140340:Checking database... 20110530/140342:S017:java.sql.SQLException: Schema 'JENNIFER' does not exist 20110530/140342:Checking Adm database... 20110530/140343:S020:java.sql.SQLException: Schema 'JENNIFER' does not exist 20110530/140343:INF: Creating new tables with: 20110530/140343:INF:The database URL is jdbc:derby:jennifer 20110530/140343:INF:Apache Derby Embedded JDBC Driver Version 10.4.2.0 - (689064) 20110530/140343:INF:Database: Apache Derby 10.4.2.0 - (689064)... 두번째기동시부터아래와같이데이타베이스확인후제니퍼를기동하게된다. 20110530/140646:Checking database... 20110530/140648:done 20110530/140648:Checking Adm database... 20110530/140648:INF:done 20110530/140648:INF:XVProfileISAMManager ISAM index generated : 0 20110530/140648:INF:UdpRuntimeListener: udp listening on port 6901 20110530/140649:INF:UdpRuntimeWorkerPool started 10 20110530/140649:INF:UdpSummaryListener: udp listening on port 6902 20110530/140649:INF:UdpSummaryWorkerPool started : 10 20110530/140649:INF:UdpXViewProfileListener: udp listening on port 6703 20110530/140649:INF:UdpXViewProfileWorkerPool started 30 20110530/140650:INF:TcpSocketServer: listening port: 6701

WINDOWS 에제니퍼서버설치 3 20110530/140650:INF:Jennifer4.5.2(2011-03-03) started. 20110530/140650:INF:http.startup.port=7900 20110530/140650:INF:TcpServerWorkerPool started 80 6. 로그인한다. 웹브라우저의주소창에제니퍼서버를설치한서버의 IP 혹은도메인주소와포트번호로구성된 URL 을입력하면로그인화면이나타난다. 제니퍼의모든기능은로그인후에사용할수있다. 제니퍼서버의기본포트번호는 7900이다. http://192.168.0.139:7900 로그인을하려면아이디와패스워드를입력하고 [Login] 버튼을클릭한다. 초기관리자계정의아이디는 admin 이며패스워드도 admin 이다. 처음로그인을한후에패스워드를수정하는것을권장한다. 제니퍼 클라이언트의일부는플래시로구현되어있기때문에어도비플래시플레이어 9.0 이상을설치해야한다. 1.3 WINDOWS 에제니퍼서버설치 제니퍼서버는 Tomcat5.5 를기반으로운영되고있다. 일반적인 Tomcat 과같이 JAVA_HOME 환경변수 지정후제니퍼서버를기동시킬수있다. 환경변수 값 제니퍼서버 HOME 디렉토리 c:\jennifer\server JAVA_HOME C:\Java\jdk16u13 IP Address 192.168.0.139 1. 다운로드받은제니퍼패키징파일을압축유틸리티를사용하여제니퍼설치디렉토리 ( 예 :c:\jennifer ) 해제한다. 2. 명령프롬프트로이동 [ 시작선택 실행선택 cmd 입력후실행 ] 3. 윈도우시스템환경변수에 JAVA_HOME이설정되었는지확인한다. C:\Java>echo %JAVA_HOME% C:\Java\jdk16u13 4. 환경변수가설정되어있지않았을경우 [ 내컴퓨터아이콘우클릭 속성선택 고급탭선택 환경변수 ] 에 JAVA_HOME환경변수값을설정한다. 5. 명령프롬프트상에서제니퍼서버디렉토리 ( 예 :c:\jennifer\server\bin) 이동후 startup.bat을실행한다. 환경변수를새로입력했을경우새로명령프롬프트를생성한후진행한다. 탐색기상에서직접 startup.bat파일을더블클릭해실행할수도있다. 제니퍼서버의최초기동시만데이터베이스테이

4 제니퍼서버설치 블생성작업이진행된다. 서버머신의사양에따라서제니퍼서버의기동시간이차이가있을수있다. 6. 로그인한다. 웹브라우저의주소창에제니퍼서버를설치한서버의 IP 혹은도메인주소와포트번호로구성된 URL 을입력하면로그인화면이나타난다. 제니퍼의모든기능은로그인후에사용할수있다. 제니퍼서버의기본포트번호는 7900인다. http://192.168.0.139:7900 로그인을하려면아이디와패스워드를입력하고 [Login] 버튼을클릭한다. 초기관리자계정의아이디는 admin 이며패스워드도 admin 이다. 처음로그인을한후에패스워드를수정하는것을권장한다. 제니퍼 클라이언트의일부는플래시로구현되어있기때문에어도비플래시플레이어 9.0 이상을설치해야한다. 1.4 클라이언트설정 제니퍼클라이언트는웹에기반한다. 따라서사용자는웹브라우저를통해서제니퍼사용자인터페이스에접근한다. 클라이언트에표시되는차트표시를위한자바플러그인이필요하고, 그리드표시를위한플래시플레이어가필요하다. 운영체계제니퍼클라이언트는마이크로소프트윈도우즈 XP와비스타를지원한다. 단, 현재사용중인윈도우즈테마에따라스타일이정상적으로나타나지않을수있다. 현재, 윈도우즈 XP 를사용하는경우에테마로 Windows 고전을사용하면 BLACK 스타일이정상적으로나타나지않는다. 현재사용하고있는테마는바탕화면에서오른쪽마우스를클릭하면나타나는컨텍스트메뉴에서 [ 속성 ] 메뉴를선택하면확인할수있다. 공식적으로제니퍼클라이언트는리눅스와맥 OS등을지원하지않는다. 그러나파이어폭스 3.0 이상과자바플러그인 1.6.0_10 이상을설치할수있는 OS라면제니퍼를사용할수있을것이다. 1.4.1 웹브라우져 마이크로소프트 IE 7.0, IE 8.0, IE 9.0 그리고모질라파이어폭스 3.5 등의웹브라우저를지원한다. IE 6. 0은 CSS를포함한웹표준지원이미흡하고투명한 PNG 이미지파일을처리하지못하는단점을가지고있다. 따라서 IE 6.0은지원하지않는다. IE 7.0이상으로업그레이드할수없는환경에서는파이어폭스 3.5 을사용하는것을권장한다. 제니퍼를사용하려면쿠키와자바스크립트를사용할수있도록웹브라우저를설정해야한다. 대부분의웹브라우저는기본적으로이기능들을사용하도록설정되어있다.

클라이언트설정 5 1.4.2 자바플러그인 제니퍼클라이언트의일부는자바애플릿으로구현되어있기때문에선자바플러그인 1.6.0_10 이상을설치해야한다. 제니퍼 4.0부터는마이크로소프트자바 VM을지원하지않는다. 1.4.2.1 설치와제거 자바플러그인을설치와제거에대한내용은선의자바사이트 (http://java.sun.com/javase/downloads/ index.jsp) 를참고한다. 1.4.3 메모리설정 별도의설정의없다면자바애플릿이사용할수있는최대자바힙메모리는 96 MB이다. 제니퍼클라이언트를안정적으로사용하기위해서는자바힙메모리최대값과최소값을지정하는것을권장한다. 특히에이전트의숫자가많거나업무처리량이많은경우에는자바힙메모리최대값을높게설정할필요가있다. 윈도우즈운영체계에서자바플러그인의자바힙메모리크기는다음과같이설정한다. 1. 제어판으로이동한다. 2. 제어판에서자바를클릭하면 Java 제어판을연다. 여기에서 Java 탭을선택한다.

6 제니퍼서버설치 3. Java 애플릿런타임설정영역의보기버튼을클릭하면 Java 런타임설정화면이나타난다. 여러개의 자바를설치한경우에는 [ 사용가능 ] 칼럼을통해서사용할자바를선택한다. 예를들어, 자바힙메모리최소값을 100 MB, 최대값을 150 MB 로설정하려면 JRE 의 Java 런 타임매개변수칼럼에다음과같이입력한다. -Xms100m -Xmx150m 설정가능한자바힙메모리최대값은머신의사양과환경에영향을받는다. 설정가능한값보다큰값을 지정하면오류가발생하거나웹브라우저가비정상적으로종료될수있다. 설정가능한자바힙메모리최 대값에대한명확한규정이없기때문에시행착오를통해서자바힙메모리최대값을설정해야한다. 1.4.4 웹브라우져설정 1.4.4.1 자바애플릿 마이크로소프트 IE 7.0, IE 8.0, IE 9.0 을사용하는경우에는 [ 도구 인터넷옵션 ] 메뉴에서자바플러그인사용여부를설정한다. 인터넷옵션창에서고급탭을선택하면설치된자바플러그인정보가나타난다. 여기서선자바플러그인을사용하도록설정한다.

클라이언트설정 7 모질라파이어폭스 3.X 을사용하는경우에는 [ 도구 인터넷옵션 보안 사용자정의지정 ] 메뉴에서액 티브스크립팅사용여부를확인한다. 기본적으로허용으로선택되어있다.

8 제니퍼서버설치 1.4.4.2 자바스크립트 마이크로소프트 IE 7.0, IE 8.0, IE 9.0 을사용하는경우에는 [ 도구 인터넷옵션 보안 사용자레벨지정 ] 메뉴에서스크립팅사용여부를설정한다. 기본적을사용되도록설정되어있다.

클라이언트설정 9 모질라파이어폭스 3.5 를사용하는경우에는 [ 도구 설정 ] 메뉴에서자바플러그인사용여부를설정한 다. 설정화면에서내용탭을선택한후에자바스트립트사용을선택한다. 기본으로선택되어있다.

10 제니퍼서버설치 1.4.4.3 플래시플레이어 제니퍼클라이언트의일부는플래시로구현되어있다. 정상적인화면표시를위해서는어도비플래시플레 이어 9.0 이상을설치해야한다. 1.4.5 윈도우서비스등록 제니퍼서버를윈도우서비스에등록해서관리할경우 service.bat 를사용한다. 명령프롬프트를실행후제니퍼서버디렉토리로이동한다. C:\jennifer\server\bin>service.bat install JenniferServer Installing the service 'JenniferServer'... Using CATALINA_HOME: C:\jennifer\server Using CATALINA_BASE: C:\jennifer\server Using JAVA_HOME: C:\Java\jdk16u13 Using JVM: C:\Java\jdk16u13\jre\bin\server\jvm.dll The service 'JenniferServer' has been installed. C:\jennifer\server\bin> 세번째파라미터는서비스명이다. 윈도우서비스에등록했으면 [ 제어판 관리도구 서비스 ] 메뉴에서 JennfierServer 를기동한다. 윈도우서비스로등록하기위해서는환경변수에 JAVA_HOME 이반드시설정되어있어야한다.

2. 제니퍼닷넷설치가이드 2.1 제니퍼닷넷에이전트설치및제거 이장에서는닷넷버전의제니퍼에이전트를설치및제거하는방법을설명한다. 2.1.1 제니퍼닷넷에이전트설치환경 닷넷버전의제니퍼에이전트를설치하기위한운영환경은아래와같다. 표 2-1 제니퍼에이전트지원환경 구분 대상 운영체제 Microsoft Windows Server 2003, 2008/R2, 2012/R2 닷넷프레임워크프레임워크 2.0, 3.0, 3.5, 4.0, 4.5 시스템에설치된닷넷프레임워크확인방법은 설치된닷넷프레임워크버전확인 을참고한다. 2.1.2 에이전트설치 2.1.2.1 설치환경 아래의표는제니퍼에이전트설치에따른설치자이해를돕기위해제니퍼에이전트가설치될서버의환경정보를보여주고있다. 본설치가이드는 [ 표 1] 의환경값을기준으로설명되며, 실제작업시는사용자서버의환경정보에맞추어설치작업을진행해야한다. 표 2-2 기본구성환경 구분 제니퍼에이전트홈디렉토리 대상 C:\Jennifer 11

12 제니퍼닷넷설치가이드 구분 대상 제니퍼서버 IP Address 192.168.0.139 2.1.2.2 사전설치 닷넷프레임워크기반의응용프로그램을모니터링하는제품이기때문에해당서버에이미닷넷프레임워크가설치되었음을가정할수있지만, 만약새로구성되는서버에미리제니퍼에이전트를설치해야한다면제품설치에앞서닷넷프레임워크를미리설치해야한다. 2.1.2.3 에이전트설치 닷넷버전의제니퍼에이전트를모니터링해야할응용프로그램이설치된서버에설치한다. 1. 제니퍼소프트로부터제공받은라이선스키를 C:\Jennifer\agent.net\license.txt 파일에입력하고저장한다. 2. C:\Jennifer\agent.net\install_Jennifer.bat 을관리자권한으로실행한다. 실행후, 반드시출력되는메시지에서 "Installation completed." 를확인한다. 만약이메시지가없으면설치에실패한것이다. 3. 제니퍼에이전트가시스템에설치된후, 모니터링하려는대상응용프로그램에따라서해야할작업이달라진다. 4. 구성을완료한이후해당응용프로그램을구동하여동작시키면 C:\Jennifer\agent.net\log 폴더에다음과같은형식의로그파일이생성된다. Jennifer_[AppPool 이름 ]_[ 에이전트식별 ID]_[ 날짜 ].log 예를들어, 2010년 3월 8일, 웹응용프로그램이활성화되는 AppPool 의이름이 DefaultAppPool 이고, 그와연결된 conf 파일에 agent_pool 값을 N10:9000과같이주었다면 jennifer_defaultapppo ol_n10_20100308.log 파일이생성된다. 2.1.2.4 에이전트제거 닷넷버전의제니퍼에이전트를서버로부터제거하고파일을삭제한다. 1. C:/Jennifer/agent.net/uninstall_Jennifer.bat 을관리자권한으로실행한다. 운영체제별관리자권한실행방법은 관리자권한으로 실행 내용을참조한다. 2. 만약, 모니터링하고있는응용프로그램이서비스중이라면종료하고, 폴더를삭제한다.

제니퍼닷넷에이전트설치및제거 13 2.1.3 제니퍼서버구성변경 이절에서는제니퍼서버및에이전트가사용하고있는네트워크통신포트구성을변경하는방법에대해설명한다. 2.1.3.1 클라이언트를위한설정변경 제니퍼서버는웹기반사용자인터페이스제공을위해서 HTTP 프로토콜을사용한다. 이때사용하는기본 HTTP 포트번호는 7900이다. 그리고제니퍼서버정지를위한기본포트번호는 7999이다. 이포트번호를변경하려면, 제니퍼서버가설치된컴퓨터에서 $JENNIFER_HOME/server/bin/catalina.sh(bat) 파일을수정한다. 유닉스혹은리눅스의경우에는 catalina.sh 파일의다음부분에서포트번호를설정한다. JAVA_HOME="$JAVA_HOME" if [ -z "${STARTUP_PORT}" ] then export STARTUP_PORT="7900" fi if [ -z "${SHUTDOWN_PORT}" ] then export SHUTDOWN_PORT="7999" fi 윈도우의경우에는 catalina.bat 파일의다음부분에서포트번호를설정한다. 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이다. 2.1.3.2 제니퍼에이전트를위한설정 제니퍼에이전트는성능데이터를 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 속성을 0.0.0.0 으로지정하면모든네트워크카드에서들어오는패킷을받을수있다. 제니퍼서버에서제니퍼에이전트로의 TCP연결을위한 TIME OUT옵션이존재한다. 아래의설정값이기본값 (ms) 이다. agent_tcp_io_timeout=5000 agent_tcp_connect_timeout=3000 만약네트워크연결이지연되는현상이발생하면, 제니퍼서버에에러가로그파일에출력된다. 이때는옵션값을바꾸기전에먼저제니퍼에이전트와서버사이의네트워크환경을튜닝할것 을권고한다. 2.1.3.3 제니퍼사용을위한방화벽설정 제니퍼서버와제니퍼에이전트혹은제니퍼클라이언트사이에방화벽이존재하면, 앞에서설정한포트 번호가방화벽을정상적으로통과하도록설정해야한다.

제니퍼닷넷에이전트설치및제거 15 사용자컴퓨터에서제니퍼서버로 HTTP 7900 포트와 TCP 6701 포트를통해서접근할수있어야한다. 제니퍼에이전트에서제니퍼서버로 UDP 6901, 6902, 6703 포트를통해서접근할수있어야한다. 제니퍼서버에서제니퍼에이전트로 TCP 7750 포트를통해서접근할수있어야한다. 2.1.4 설치트러블슈팅 2.1.4.1 설치오류 이절에서는제니퍼에이전트설치및확인작업중발생할수있는문제와그에대한대응책을기술한다. Q: 설치및제거과정에대한로그파일을남기는것이가능한가? A: install_jennifer.bat 와 uninstall_jennifer.bat 파일은각각로그를남길수있는버전인 install_wit h_log.bat, uinstall_with_log.bat 배치파일이동일폴더에제공됩니다. 설치 / 제거과정에서문제가발생하면로그버전의배치파일을실행해서출력되는파일을기술지원팀에보내주십시오. 2.1.4.2 라이선스오류유형 Q: 전달받은라이선스키를입력했는데, Trial license key is not available 오류가발생합니다. A: 이오류가발생할수있는유형은라이선스발행날짜가현재날짜보다이후의경우입니다. 라이선스를발급한컴퓨터의시간대와에이전트가설치된컴퓨터의시간대가틀린경우에도동일한오류가발생할수있습니다. 2.1.4.3 대시보드동작오류유형 Q:.NET 4.0 웹사이트에서 최근 DB 커넥션개수 가 0으로나옵니다. A:.NET 4.0 의경우 web.config 에다음과같은설정이포함되어있어야만정상적인성능카운터가제공됩니다. <system.diagnostics> <switches> <add name="connectionpoolperformancecounterdetail" value="4"/> </switches> </system.diagnostics> Q: Windows 2008 R2 환경에서오라클 DB를사용하고있는데, 최근 DB 커넥션개수 가 0으로나옵니다. A: 오라클 ODAC(Oracle Data Acess Component) 측에서 DB 연결수에대한성능카운터를제공하지않는문제일수있습니다. 윈도우의 관리도구 에서 성능카운터 를실행하여오라클의연결개수정보를확인하십시오.

16 제니퍼닷넷설치가이드 Q: 여전히 최근 DB 커넥션개수 가 0 으로나온다면? A: 연결문자열에서 Pooling=false 로설정된경우 DB 연결관련한성능카운터가제공되지않습니다. 또한,.NET 1.1 웹사이트역시 DB 연결정보가제공되지않습니다.

3. 제니퍼닷넷구성 (IIS, COM+) jennifer.version 이 4.5.0(2010-10-29.1) 버전이후부터지원되는새로운구성방식으로기존설치 방식이 web.config 의변경을필요로했던단점및그로인한부작용이제거되었다. 기존설치방식도여 전히지원되지만권장되지않는다. 3.1 IIS 웹응용프록램 / COM+ 구성 3.1.1 실행 [ 제니퍼에이전트설치폴더 ]\utility\iisconfighelper.exe 파일을실행한다. 다. 아래화면은, 1 개의 Web Site, 3 개의 COM+ 서버응용프로그램이컴퓨터에구성된예를보여주고있 그림 3-1 IIS 와 COM+ 의모니터링가능한응용프로그램 17

18 제니퍼닷넷구성 (IIS, COM+) "Web Garden" 우측의 "Enable AutoStart" 옵션은 2012 년 11 월 8 일이후릴리즈된버전부터적 용된다. 자세한사항은 11. w3wp 자동시작옵션절을참고한다. 3.1.2 구성 ACT 도구를이용하면모니터링해야할웹응용프로그램및 COM+ 서버응용프로그램을지정 / 해제할수있다. 3.1.2.1 모니터링을원하는 IIS/COM+ 응용프로그램설정.1.2.1.1 설정파일생성모니터링하기를원하는응용프로그램항목을트리에서선택하고, 마우스오른쪽버튼을눌러나오는메뉴의 Install 을실행한다. 그림 3-2 에이전트적용을위한 conf 파일생성 실행하고나면, [ 제니퍼에이전트설치폴더 ]\conf 폴더에대상응용프로그램에대한제니퍼모니터 링을할수있는.conf 파일이생성된다. 새롭게생성된 conf 파일은제니퍼설치시기본제공되는 app_pool.conf 파일의복사본이므 로반드시 app_pool.conf 파일이있어야한다..1.2.1.2 설정생성된 conf 파일에는필수적으로 Jennifer Server, UDP Port, Listen Port, LWST Port 및해당응용프로그램을대표하는 Agent ID 를지정해주어야한다. 아래의그림에서와같이오른쪽패널에서이러한값들을지정할수있으며변경후 Save 버튼을눌러서저장해준다.

IIS 웹응용프록램 / COM+ 구성 19 그림 3-3 응용프로그램과연결된제니퍼닷넷의에이전트설정.1.2.1.3 응용프로그램재실행에이전트설정파일이생성되었으면이제응용프로그램이모니터링되도록새롭게재시작을해야한다. 웹응용프로그램 w3wp.exe 재시작설정을새롭게반영하기위해좌측트리에서마우스오른쪽버튼을눌러나오는메뉴의 IIS Reset 을실행한다. 그림 3-4 IIS Reset COM+ dllhost.exe 재시작 COM+ 의경우모든응용프로그램을재시작하는방법은없고, 필요한응용프로그램마다마우스오른쪽 버튼을눌러나오는메뉴의 "Recycle" 명령을실행한다.

20 제니퍼닷넷구성 (IIS, COM+) 그림 3-5 COM+ 응용프로그램재시작 3.1.2.2 모니터링해제.1.2.2.1 설정파일제거모니터링에서제외될응용프로그램항목을트리에서선택하고, 마우스오른쪽버튼을눌러나오는메뉴의 Uninstall 을실행한다. 그림 3-6 모니터링해제.1.2.2.2 IIS / COM+ 재실행 설정을새롭게반영하기위해응용프로그램을재시작한다. ( 웹응용프로그램의경우 "IIS Reset", COM+ 의경우 "Recycle")

4. COM+ 구성 (2013-06-04 이전 ) 제니퍼 4.5.0(2010-10-29.2) 버전부터 COM+ 응용프로그램을모니터링하기위한설정방법이기존과비교해서대폭간소화되었다. 이전버전에서는.config,.manifest 및그에대한폴더를만들어서 Application Root Directory 에설정하는복잡함뿐만아니라, COM+ 개체가새로등록되는과정에서 Application Root Directory 설정이초기화되는문제로인해그때마다재설정해야하는어려움이있었는데, 새로운환경설정구성방법은이러한문제를모두해결하였다. 제니퍼 "4.5.0(2013-06-05)" 버전부터 COM+ 응용프로그램을모니터링하기위한설정방법이 IIS ConfigHelper.exe 에통합되었다. 4.1 에이전트구성 4.1.1 구성환경 아래의표는제니퍼에이전트설치에따른설치자이해를돕기위해제니퍼에이전트가설치될서버의환 경정보를보여주고있다. 본설치가이드는 [ 표 1] 의환경값을기준으로설명되며, 실제작업시는사용자 서버의환경정보에맞추어설치작업을진행해야한다. 표 4-1 기본구성환경 구분 제니퍼에이전트홈디렉토리 모니터링대상 COM+ 응용프로그램이름 A 설명 C:\Jennifer MyComponentServer 4.1.2 COM+ 응용프로그램이름의 conf 파일구성 제니퍼에이전트가시스템에설치된후, 모니터링하려는 COM+ 구성요소의이름에해당하는 conf 파일 을생성한다. 21

22 COM+ 구성 (2013-06-04 이전 ) 4.1.2.1 COM+ 응용프로그램이름확인 구성요소관리자 (Component Services) 에서모니터링을원하는 COM+ 응용프로그램의 이름 을확 인한다. 아래의화면에서는 MyComponentServer 임을알수있다. 그림 4-1 COM+ 응용프로그램의이름을구하는방법 4.1.2.2 설정파일생성 COM+ 와연결될모니터링구성을담는 conf 파일생성규칙은다음과같다. [ 제니퍼에이전트설치폴더 ]\conf\complus.[com+ 응용프로그램이름 ].conf 따라서, 이번예제에서는다음과같다. C:\Jennifer\conf\complus.MyComponentServer.conf 나머지내부 conf 파일구성규칙 (udp_server_host, ) 은동일하지만, agent_pool 의수는 COM+ 서 버응용프로그램의 Application Pooling 에설정된 Pool Size 에따르도록한다. COM+ 구성요소의 Application Pool 수를알아내는방법은 COM+ Application Pool 확인 을참고한다

에이전트구성제거 23 4.1.2.3 구성요소재실행 COM+ 구성요소서비스관리자에서, 현재실행되어있는 dllhost.exe 실행파일들에제니퍼닷넷이반영 되도록개별프로세스마다 Recycle 메뉴를실행한다. 4.2 에이전트구성제거 제품설치는그대로유지하고, 모니터링만을그만두려는경우그응용프로그램과연결된 [ 제니퍼서버설치폴더 ]\conf\complus.[com+ 응용프로그램이름 ].conf 파일을삭제한다. ( 예 : C:\Jennifer\ conf\complus.mycomponentserver.conf ) 이후, 만약서비스중인 COM+ 구성요소가있다면 COM+ 구성요소관리자 에서실행중인인스턴스에대해각각 Recycle 명령을실행해서모니터링상태를해제한다.

5. 독립실행형응용프로그램및 NT 서비스 이장에서는 IIS/COM+ 이외의응용프로그램인일반적인독립실행형응용프로그램 (Console, WinForm, WPF, ) 또는 NT 서비스형식의응용프로그램을모니터링하기위한방법을설명한다. 5.1 에이전트구성 5.1.1 구성환경 아래의표는제니퍼에이전트설치에따른설치자이해를돕기위해제니퍼에이전트가설치될서버의환 경정보를보여주고있다. 본설치가이드는 [ 표 1] 의환경값을기준으로설명되며, 실제작업시는사용자 서버의환경정보에맞추어설치작업을진행해야한다. 표 5-1 예제환경설정 구분 설명 제니퍼에이전트홈디렉토리 C:\Jennifer 제니퍼서버 IP Address 192.168.0.139 5.1.2 [ 응용프로그램이름 ].exe.config 변경및환경변수설정 제니퍼에이전트가시스템에설치된후, 모니터링하려는대상응용프로그램과 1:1 관계로.conf 파일을하나씩지정한다. 5.1.2.1 conf 파일설정 만약테스트 exe 프로그램의이름이 test.exe 라고가정해보자. C:\Jennifer\agent.net\conf 폴더에기본설정값을담은 app_pool.conf 를복사해서 test.exe. conf 라는파일명으로저장한다. udp_server_host 에는제니퍼서버가설치된컴퓨터의주소를입력하고 agent_pool 에는고유 ID 와 25

26 독립실행형응용프로그램및 NT 서비스 포트값을적절하게설정한다. 5.1.2.2 환경변수설정 환경변수설정방법은일반적인독립실행형응용프로그램과 NT 서비스응용프로그램에대해서달라진다. 독립실행형응용프로그램의경우다음과같은배치파일을이용해서 exe 실행이전에환경변수를설정하도록바꾼다. REM ===== startapp.bat ===== REM ===== 반드시 exe 파일명을소문자로지정한다. SET JENNIFER_PROFILE=test.exe test.exe 반면, NT 서비스응용프로그램 을모니터링하려면위와같이환경변수를설정하는배치파일을만들어줄수없으므로컴퓨터의 " 시스템환경변수설정 " 창에서 " 시스템환경변수 " 영역에 JENNIFER_PROFI LE 과 NT 서비스의 exe 파일이름을소문자로등록해준다. ( 물론, 독립실행형응용프로그램도배치파일이아닌시스템환경변수에등록해줘도무방하다.) 5.1.2.3 txserver 옵션설정 독립실행형 EXE나 NT 서비스는 Request/Response에대한처리를일반소켓으로입출력할가능성이크기때문에그런트랜잭션단위가되는메소드를알아내서 [ 설치폴더 ]\profiler.ini 의 [txserver] 섹션에등록해주어야한다. txserver 지정단위는메소드와클래스가허용된다. 다음은각각의예를보여준다. [txserver] BizServer.BizClass.SelectProduct=1 ; 메소드단위지정 ; 1 은 enable 을의미 BizServer.DacClass=c ; 1 대신 c 값을지정해서클래스단위지정이가능 ; 따라서 BizServer.DacClass 안의모든메서드를 ; txserver 로동작하게됨 참고로일부 EXE 프로그램에서는소켓이아닌닷넷의원격호출규약으로서비스를제공하는경우도있다. 예를들어, NT 서비스프로그램내에서 WCF,.NET Remoting 등의방법을사용해서원격호출을제공하는데그런경우에는굳이 txserver를지정하지않아도모니터링이가능하다. 5.1.2.4 응용프로그램재시작 모니터링대상이되는응용프로그램을새롭게설정한환경변수들이적용되기위해재시작을한다.

에이전트구성제거 27 5.2 에이전트구성제거 제품설치는그대로유지하고, 모니터링만을그만두려는경우 JENNIFER_PROFILE 환경변수에서해당 e xe 이름을제거하면모니터링이중지된다. 만약, 프로세스가실행중이라면재시작한다.

6. 닷넷배치프로세스모니터링 이장에서는닷넷버전의제니퍼에이전트를이용하여배치 (Batch) 작업을모니터링하는방법을설명한다. 제니퍼에서구현되는배치모니터링의개념및자바에서의설치방법은 Batch JOB Monitorin g 문서를참고한다. 6.1 MasterAgent 설치및실행 6.1.1 conf 파일설정 [ 에이전트설치폴더 ]\conf\app_pool.conf 파일을복사해서 batchjob_master.conf 파일을생성 한다. batchjob_master.conf 파일을메모장에서열고, 제니퍼서버주소와마스터에이전트임을알리는 설정을추가한다. udp_server_host = [ 제니퍼서버주소 ] MASTER_AGENT = true 6.1.2 마스터에이전트실행 마스터에이전트실행파일은 JENNIFER 와함께설치되므로별도의설치작업은필요없고단순히아래의경 로에제공되는모듈을실행하면된다..NET 1.1: [ 에이전트설치폴더 ]\bin\masteragent.clr10.exe.net 2.0 ~ 3.5: [ 에이전트설치폴더 ]\bin\masteragent.clr20.exe.net 4.0 이상 : [ 에이전트설치폴더 ]\bin\masteragent.clr40.exe 29

30 닷넷배치프로세스모니터링 6.2 SubAgent 설치및실행 서브에이전트는모니터링해야할대상을의미하는데, 제니퍼에이전트가활성화되는배치프로세스 (exe) 가이에해당한다. 6.2.1 conf 파일설정 서브에이전트가종속될마스터에이전트의 conf 파일을복사해서새롭게 conf 파일을생성하고서브에 이전트임을명시하기위해다음의설정을추가한다. [ 예 : youragent.conf] SUB_AGENT = true 6.2.2 배치프로세스에 conf 파일연결 모니터링하려는배치프로세스의실행파일경로가다음과같다고가정할때, C:\BatchJobs\DailyWorker.exe 해당프로세스명에.config 파일을연결하여 conf 폴더에새롭게파일을생성한다. [ 에이전트설치폴더 ]\conf\dailyworker.exe.config 파일의내용은아래와같이이전에서브에이전트용으로만들어둔 conf ( 예 : youragent.conf) 를지정 한다. <?xml version="1.0" encoding="utf-8"?> <configuration> <appsettings> <add key="jennifer.filename" value="youragent.conf" /> </appsettings> </configuration>

제니퍼에이전트환경변수설정 31 6.2.3 사용자정의메서드프로파일링설정 일반적으로배치프로세스에서는사용자가정의한메서드를트랜잭션단위로여기게된다. 따라서, 닷넷메서드프로파일링 에서설명한방법에따라 [txserver] 절을별도로구성해야한다. 또한, 배치프로세스의경우반드시 [batchjob] 절을정의하고해당응용프로그램의 Main 함수를정의해줘야한다. 예를들어사용자코드가다음과같이정의된경우, namespace BatchJob1 { class Program { static void Main(string[] args) { DoBatchJob(); } } } void DoBatchJob() { } 만약, DoBatchJob 이실제배치작업을처리하는메서드이고 txserver 로모니터링해야할대상이라면 profiler.ini 파일에는다음과같이설정해주어야한다. [batchjob. 프로세스명 ] BatchJob1.Program.Main=1 [txserver. 프로세스명 ] BatchJob1.Program.DoBatchJob=1 6.3 제니퍼에이전트환경변수설정 배치프로세스가프로파일링되기위해서는 JENNIFER_PROFILE 이라는별도의환경변수를지정해야한 다. 만약사용자의배치프로세스명이 DailyWorker.exe 이고, 마스터에이전트의프로세스명이 "Mast eragent.clr40.exe" 인경우다음과같이환경변수를등록한다.

32 닷넷배치프로세스모니터링 환경변수이름 : JENNIFER_PROFILE 값 : dailyworker.exe;masteragent.clr40.exe 프로세스명은반드시소문자로지정해야한다. 배치프로세스가여러개인경우세미콜론 (;) 을구분자로해서다음과같이지정하는것이가능하다. 환경변수이름 : JENNIFER_PROFILE 값 : dailyworker.exe;weeklyworker.exe;monthlyworker.exe;masteragent.clr40.exe 설정을마치고, 해당배치프로세스를실행하면정상적으로모니터링이이뤄진다. 6.4 에이전트모니터링해제 / 제거 제니퍼에이전트가설치된상태에서, 배치프로세스에대한모니터링만을해제하고싶다면환경변수에서 COR_ENABLE_PROFILING 값을 0 으로변경하면된다. ( 또는 JENNIFER_PROFILE 로설정된경우라면, 프로세스명을빼거나 JENNIFER_PROFILE 환경변수자체를지우면된다.) 만약, 제니퍼에이전트까지모두제거하고싶다면현재모니터링중인배치프로세스를모두종료하고 [ 에이전트설치폴더 ]/uninstall_jennifer.bat 을관리자권한으로실행한후, 설치폴더를수동으로삭제해준다.

7..NET Data Provider 호출모니터링방법 7.1 사용중인 Data Provider 어셈블리버전확인.NET Framework 에서제공되는기본.NET Data Provider 이외에제니퍼닷넷에서모니터링이가능한 3 rd-party Data Provider 는다음과같다. Oracle.DataAccess.Client (Oracle ODP.NET) MySql.Data Npgsql (PostgreSQL) CoreLab.Oracle 그외, Data Provider는별도문의 하지만, 이와같은 Data Provider를모니터링하기위해서는대상어셈블리의정확한버전을알아야한다. 이를위해서제니퍼닷넷설치후해당 Data Provider를사용하는웹페이지를한번이라도방문한후에 [ 장애진단 유틸리티 시스템환경변수 ] 를통해서현재사용중인 Data Provider의버전을알아낼수있다. 아래의화면에서는 K11 에이전트가설치된응용프로그램이 PostgreSQL 에대한접속을위해 Npgsq l.net Data Provider를 2.0.11.0 버전으로사용하고있으며, ODP.NET 은 2.111.6.0 버전을사용하고있다는것을보여준다. 그림 7-1 시스템환경변수 33

34.NET Data Provider 호출모니터링방법 참고로, CoreLab.Oracle 의경우예외적으로 "#1" 과 "#2" 항목으로나뉘어져버전표시가된다. 7.2 버전을 Profiler.ini 파일에명시 모니터링하려는대상어셈블리의버전을제니퍼에알리기위해서 [ 제니퍼닷넷설치폴더 ]\agent.net 폴더에 Profiler.ini 파일이제공된다. 이파일을메모장으로열면다음과같이 PostgreSQL, ODP.NET 섹션을확인할수있다....[ 생략 ]... [PostgreSQL] ; 2.0.10.0 [ODP.NET] ; 2.111.7.20 ; 2.111.6.0 ; 2.102.3.2 ; 2.102.2.20 ; 10.2.0.100 [MySql.Data] ; 6.6.4.0 [CoreLab.Oracle] ; 4.75.43.0 ; 4.70.24.0 이곳에예제에서확인했던 Npgsql 2.0.11.0, ODP.NET 2.111.6.0 을다음과같이반영해줄수있다. [PostgreSQL] 2.0.11.0 [ODP.NET] 2.111.6.0 변경사항을저장하고, 다시모니터링대상응용프로그램을재시작하면정상적으로모니터링된다.

8. 닷넷프레임워크 제니퍼의닷넷버전지원에따른추가설명이필요한환경설정을기술한다. 8.1 윈도우환경 8.1.1 관리자권한으로실행 프로그램을실행시킬때 관리자권한 을획득하여실행하는방법이 Windows Server 2003과 Windows Server 2008에서다르기때문에각각그방법을나눠서설명한다. 8.1.1.1 Windows Server 2003 2가지방법으로관리자권한을획득할수있다. 1. 관리자권한으로시스템에로그인한경우 : 모든실행프로그램들에관리자권한이부여된다. 2. 비-관리자권한으로시스템에로그인한경우 : 탐색기에서해당프로그램을마우스오른쪽버튼클릭, 메뉴에서 Run as 를선택하고관리자계정을입력하여실행한다. 참고로배치파일 (.bat) 인경우, Run as 메뉴가제공되지않기때문에, 시작 / 모든프로그램 / 보조프로그램 / 명령프롬프트 를 Run as 메뉴를이용하여관리자계정으로실행한다음, 명령행에서배치파일을실행한다. 8.1.1.2 Windows Server 2008, Windows Server 2008 R2 Windows Server 2008 이후부터는, 사용자계정컨트롤 (UAC: User Access Control) 기능이 Admini strator 계정이외의관리자계정에적용되기때문에다음과같이 3가지상황에따라그에알맞는방법을선택해야한다. Administrator계정으로로그인한경우 : 실행되는모든응용프로그램은기본적으로 관리자권한 으로실행된다. 관리자그룹 에속한계정으로로그인한경우 : 탐색기에서실행하고자하는응용프로그램을마우스오른쪽버튼클릭후, 관리자권한으로실행 메뉴를선택한다. 사용자계정컨트롤 창이뜨고 확인 버튼을선택하면 관리자권한 으로실행된다. 관리자그룹 이외의일반사용자계정으로로그인한경우 : 탐색기에서실행하고자하는응용프로그 35

36 닷넷프레임워크 램을마우스오른쪽버튼클릭후, 관리자권한으로실행 메뉴를선택하고, 관리자그룹에속한사용 자계정정보를입력한다. 8.1.2 NT 서비스명 (Service name) 찾는방법 시작 / 관리도구 / 서비스 관리자를실행하고대상 NT 서비스의 속성창 을연다. 예를들어, 다음은 예제 NT 서비스인 RemoteTestService 의속성창에서 Service name 을확인하는방법을보여준다. 그림 8-1 Services 이예제에서는 NT 서비스명이 RemoteTestService 임을알수있다. 8.2 IIS 환경 8.2.1 Windws Server 2008 에서 web.config 에 conf 파일을지정하는방법 IIS 7(R2 의경우 IIS 7.5) 관리자를실행하고모니터링하려는 웹사이트 또는 가상응용프로그램 을선 택한후 Features View 기능중에서 Application Settings 아이콘을더블클릭한다.

IIS 환경 37 그림 8-2 Application Settings 우측 Actions 메뉴에서 Add 버튼을누르고아래와같이값을입력한다. Name: Jennifer.FileName Value: [conf 파일명 ] 만약설정된 conf 파일명이 app_pool.conf 라면다음과같이입력될수있다. Name: Jennifer.FileName Value: app_pool.conf 8.2.2 응용프로그램의 web.config 위치확인방법 8.2.2.1 IIS 6 에서확인하는방법 IIS 관리자를실행하고, 모니터링하려는 웹사이트 또는 가상응용프로그램 의속성창을띄우고 Hom

38 닷넷프레임워크 e Directory 탭을선택한다. 그림 8-3 Local Path 위의예제에서는해당응용프로그램의설치폴더가 D:\Jennifer40.WebSiteTest 로지정된것을확인할수있는데, 이폴더에 web.config 파일이있다. 8.2.2.2 IIS 7 이상에서확인하는방법 IIS 관리자를실행하고, 모니터링하려는 웹사이트 또는 가상응용프로그램 을선택한후 Advanced S ettings 링크를누른다.

IIS 환경 39 그림 8-4 Advanced Settings... 대화창에서다음과같이해당응용프로그램이설치된폴더를확인할수있는데, 이예제에서는 web.co nfig 파일이 C:\inetpub\wwwroot 에있음을알수있다. 그림 8-5 Physical Path

40 닷넷프레임워크 8.2.3 Web Garden 수확인하는방법 8.2.3.1 IIS 6 에서확인하는방법 IIS 관리자를실행하고, 모니터링하려는 웹사이트 또는 가상응용프로그램 의속성창을띄우고 Hom e Directory 탭을선택한다. 그림 8-6 Application pool 위의예제에서는해당응용프로그램의 Application Pool 이 DefaultAppPool 로지정된것을확인할 수있다. 이제 IIS 관리자의 Application Pools 노드에서 DefaultAppPool 이름에해당하는노드를선 택하고속성창을띄운다.

IIS 환경 41 그림 8-7 Properties 1) 마지막으로 Performance 탭을선택하면아래와같이 Web Garden 의수를확인할수있다. ( 기본값 : 그림 8-8 Web garden

42 닷넷프레임워크 8.2.4 IIS 7 이상에서확인하는방법 IIS 관리자를실행하고, 모니터링하려는 웹사이트 또는 가상응용프로그램 을선택한후 Advanced S ettings 링크를누른다. 그림 8-9 Advanced Settings... 대화창에서다음과같이해당응용프로그램이활성화되는 Application Pool 을확인할수있다.

IIS 환경 43 그림 8-10 Application Pool IIS 관리자의 Application Pools 노드에서위의예제에서확인한 DefaultAppPool 이름을선택하고 Advanced Settings 링크를누른다. 그림 8-11 Application Pools

44 닷넷프레임워크 그럼, 다음화면과같이 Maximum Worker Processes 의수를확인할수있는데, 이값이바로 IIS 6 버전에서지정되던 Web Garden 값이다. 그림 8-12 Maximum Worker Processes 8.2.4.1 응용프로그램의단위 IIS 에서 응용프로그램 이란 웹사이트 와그하위의 가상응용프로그램 을의미한다. 다음과같은 IIS 환경을예를들어설명하면,

IIS 환경 45 그림 8-13 Web Sites 총 11 개의 응용프로그램 이있는데각각다음과같이나뉜다. 웹사이트 Default Web Site ScrumEvent Team Foundation Server WCFTest TFSWSS SharePoint Central Administration 가상응용프로그램 ScrumforTeamSystem Build Services

46 닷넷프레임워크 VersionControl Warehouse WorkItemTracking 8.3 COM+ 구성요소서비스 8.3.1 COM+ Application Pool 확인 서버활성화유형의 COM+ 서비스는 IIS의 Web Garden과유사하게 Application Pool 설정을통해서같은 COM+ 구성요소를호스팅하는프로세스를다중으로실행해준다. 설정된 Pool 의수를확인하기위해서다음과같은순서를따른다. 3. 시작 / 관리도구 (Administrative Tools) / 구성요소서비스 (Component Services) 를실행한다. 4. 아래와같이원하는구성요소를선택하고마우스오른쪽버튼을눌러 속성 (Properties) 메뉴를선택한다. 그림 8-14 COM+ Applications

닷넷프레임워크환경 47 5. 속성창에서 Pooling & Recycling 탭을선택하면아래와같이 Pool Size 를확인할수있다. 그림 8-15 Application Pooling 8.4 닷넷프레임워크환경 8.4.1 설치된닷넷프레임워크버전확인 닷넷프레임워크는버전 2.0 을기반으로 WCF, WF, WPF 기능에해당하는 DLL 들이추가되어 3.0 이되고, LINQ 등이추가되면서 3.5 가된다. 따라서해당시스템에 3.5가설치되어있다는것은곧 3.0과 2.0 이함께추가되어있다는것을의미하며, 마찬가지로 3.0이설치되어있다는것은 2.0이기본적으로설치되어있다는것을의미한다. 설치된닷넷프레임워크버전은다음의레지스트리키를통해서가능하다. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP

48 닷넷프레임워크 아래의그림은 Windows 2003 운영체제에서버전 1.1, 2.0, 3.0, 3.5 가설치되어있는것을보여준다. 그림 8-16.NET Framework Setup 이때, 주의할것은해당레지스트리키에속한 Install (REG_DWROD) 값이반드시 1 임을확인한다. 8.4.2 64 비트운영체제에설치된 32 비트닷넷프레임워크버전확인 기본적으로설치된닷넷프레임워크버전확인에서설명한레지스트리경로 HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\NET Framework Setup\NDP 는 32비트운영체제에서는 32비트닷넷프레임워크설치여부를알려주고, 64비트운영체제에서는 64비트닷넷프레임워크설치여부를알려준다. 추가적으로 64비트의경우, 32비트닷넷프레임워크가별도로설치되는것이가능한데이를확인하기위해서는아래와같이 Wow6432Node 를포함한레지스트리경로값을확인해야한다. HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP

9. 제니퍼닷넷구성 IIS (.NET Framework 1.1 용 ) 이장에서는 IIS 웹응용프로그램을모니터링하는방법을설명한다. 9.1 에이전트구성 9.1.1 구성환경 아래의표는제니퍼에이전트설치에따른설치자이해를돕기위해제니퍼에이전트가설치될서버의환 경정보를보여주고있다. 본설치가이드는 [ 표 1] 의환경값을기준으로설명되며, 실제작업시는사용자 서버의환경정보에맞추어설치작업을진행해야한다. 표 9-1 기본구성환경 구분 대상 제니퍼에이전트홈디렉토리 C:\Jennifer 제니퍼서버 IP Address 192.168.0.139 9.1.2 web.config 및 conf 파일구성 제니퍼에이전트가시스템에설치된후, 모니터링하려는응용프로그램을대상으로 web.config 을변경 하고, 1:1 관계로.conf 파일을하나씩지정한다. 모니터링대상이되는응용프로그램에대해서는응용프로그램의단위를참조한다. 9.1.2.1 하나의응용프로그램만모니터링할경우.1.2.1.1 conf 파일설정 C:\Jennifer\agent.net\conf\app_pool.conf 파일에서제니퍼서버주소를명시적으로지정해준다. 49

50 제니퍼닷넷구성 IIS (.NET Framework 1.1 용 ) udp_server_host = 192.168.0.139 모니터링대상이되는응용프로그램을위해제니퍼서버에서식별할고유이름을제공한다. agent_pool=n10:9000 agent_pool 값은 [ 식별자 ]:[ 포트번호 ] 형식으로, 2 개이상을지정하는경우컴마 (,) 를구분자 로연결할수있다. 이때, 만약해당응용프로그램을호스팅하는 AppPool 의 Web Garden 수가 2 개라면그수에해당 하는 agent_pool 값을설정해야한다. (Web Garden 에대해서는 Web Garden 수확인하는방법을참조 한다.) agent_pool=n10:9000,n11:9001 마찬가지로 Web Garden 의수가 3 이라면다음과같이설정한다. agent_pool=n10:9000,n11:9001,n12:9002.1.2.1.2 web.config에 conf파일을지정 시작 / 관리도구 / IIS( 인터넷정보서비스 ) 관리자 를실행하고, 모니터링하기를원하는대상응용프로그램을선택하고 속성 메뉴를선택한다. 예를들어, 아래의화면에서처럼 웹사이트 또는 웹가상응용프로그램 을선택해야한다. 그림 9-1 Properties

에이전트구성 51 속성창에서 ASP.NET 탭을선택하고 Edit Configuration 버튼을눌러서 ASP.NET Configuratio n Settings 창을띄워서 Add 버튼을누른다. 그림 9-2 Configuration Settings 새로운값을입력받는창에서다음과같은값을넣는다. Key: Jennifer.FileName Value: [Step 1] 단계에서구성한 conf 파일명 만약 app_pool.conf 파일을사용한다면, Key: Jennifer.FileName Value: app_pool.conf 와같이입력하고 확인 버튼을누른다. 이렇게입력되고나면, web.config 파일의내용에다음과같은 설정이추가된다.

52 제니퍼닷넷구성 IIS (.NET Framework 1.1 용 ) <appsettings> <!-- web.config에이미 appsettings 노드가있다면내부에아래의내용만추가해준다. --> <add key="jennifer.filename" value="app_pool.conf" /> </appsettings> 따라서, IIS 관리자에서제공되는 UI 를통해서입력될뿐만아니라메모장등의편집기를통해서직접내 용을추가하는것이가능하다. Windows Server 2008 의경우, Windws Server 2008 에서 web.config 에 conf 파일을지정 하는방법을참고한다..1.2.1.3 w3wp.exe 재실행 iisreset 을실행하여변경사항을응용프로그램에반영한다. 9.1.2.2 두개이상의응용프로그램을모니터링할경우.1.2.2.1 응용프로그램수에따라 conf 파일생성모니터링대상이 2개이상이라면그수에맞게 conf 파일을생성해준다. 예를들어, 응용프로그램이 3개라면다음과같이 3개의 conf 파일을생성해두어야한다. C:\Jennifer\agent.net\conf\app_pool.conf C:\Jennifer\agent.net\conf\app_pool_2.conf C:\Jennifer\agent.net\conf\app_pool_3.conf 이름규칙은없으며간단히기존의 app_pool.conf 파일을복사해서다른이름으로설정하면된다..1.2.2.2 conf 파일의내용설정하나의응용프로그램만모니터링할경우의 [Step 1] 에서설명한데로 udp_server_host 값과 agent_p ool 값을모니터링대상이되는응용프로그램의상황에맞게설정한다..1.2.2.3 web.config에 conf 파일을지정하나의응용프로그램만모니터링할경우의 [Step 2] 에서설명한데로개별응용프로그램에속한 web. config 마다다음과같이 <add /> 로연결해준다. <appsettings> <add key="jennifer.filename" value="app_pool.conf" /> </appsettings>

에이전트구성제거 53 <appsettings> <add key="jennifer.filename" value="app_pool_2.conf" /> </appsettings> <appsettings> <add key="jennifer.filename" value="app_pool_3.conf" /> </appsettings>.1.2.2.4 w3wp.exe 재실행 iisreset 을실행하여변경사항을응용프로그램에반영한다. 9.2 에이전트구성제거 제품설치는그대로유지하고, 모니터링만을그만두려는경우 web.config 에구성한 Jennifer.FileName 값을삭제해서.conf 파일과의관계를끊어주면모니터링이중지된다. 9.2.1 설정제거 웹응용프로그램의 web.config 에서제니퍼에이전트설정을지운다. <?xmlversion"1.0"?> <configurationxmlns"http://schemas.microsoft.com/.netconfiguration/v2.0"> [ 생략 ] <appsettings> <!--add key="jennifer.filename" value="app_pool.conf" /--> </appsettings> [ 생략 ] </configuration> 9.2.2 iis 재실행 만약, 서비스중인웹응용프로그램이있다면 iisreset 명령어를실행해서모니터링이중지된서비스가 실행되도록한다.

10. COM+ 구성 (.NET Framework 1.1 용 ) 이장에서는 서버활성화 유형의 COM+(.NET Framework 1.1 용 ) 패키지를모니터링하는방법을설명 한다. 10.1 에이전트구성 0.1.1 구성환경 아래의표는제니퍼에이전트설치에따른설치자이해를돕기위해제니퍼에이전트가설치될서버의환 경정보를보여주고있다. 본설치가이드는 [ 표 1] 의환경값을기준으로설명되며, 실제작업시는사용자 서버의환경정보에맞추어설치작업을진행해야한다. 표 10-1 기본구성환경 구분 설명 제니퍼에이전트홈디렉토리 C:\Jennifer 제니퍼서버 IP Address 192.168.0.139 모니터링대상 COM+ 응용프로그램 A MyComponentServer 모니터링대상 COM+ 응용프로그램 B SecondEntLibServerApp 0.1.2 conf 파일구성및 COM+ 응용프로그램설정 제니퍼에이전트가시스템에설치된후, 모니터링하려는 COM+ 구성요소를대상으로 application.confi g을설정하고, 1:1 관계로.conf 파일을하나씩지정한다. 0.1.2.1 conf 파일설정 C:\Jennifer\agent.net\conf 폴더의기본설정값을담은 app_pool.conf 를복사한다. ( 예, defaul t_pool.conf) 복사된 conf 파일에서제니퍼서버주소를명시적으로지정해준다. udp_server_host 에는제니퍼서버가설치된컴퓨터의주소를입력하고 agent_pool 에는고유 ID 와 55

56 COM+ 구성 (.NET Framework 1.1 용 ) 포트값을적절하게설정한다. 에이전트의고유 ID 수는, 모니터링대상이되는 COM+ 서버응용프로그램 의 Application Pooling 에설정된 Pool Size 에따르도록한다. COM+ 구성요소의 Application Pool 수를알아내는방법은 COM+ Application Pool 확인 을참고한다 0.1.2.2 application.config, application.manifest 생성 COM+ 구성요소하나에대해서, 임의의폴더를하나생성한다. 예를들어, MyComponentServer, Sec ondentlibserverapp 라는이름의 COM+ 구성요소 2개를모니터링하려면다음의예에서보는것처럼 2개의폴더를생성해둔다. d:\manifest\mycomapp d:\manifest\secondapp 생성된 2개의폴더모두에 [ 제니퍼홈폴더 ]\agent.net\sample\complus 폴더에있는 applicati on.config, application.manifest 파일을복사한다. 복사된 2개의파일중에서 application.manifest 파일은변경없이사용하지만, application.config 파일은 web.config 파일을편집했던것처럼 Jennif er.filename 값을 [Step 1] 에서생성해두었던 conf 파일명으로지정해주어야한다. <?xml version="1.0" encoding="utf-8"?> <configuration> <appsettings> <add key="jennifer.filename" value="default_pool.conf" /> </appsettings> </configuration> 0.1.2.3 Application Root Directory 지정 생성해두었던폴더를가리키도록해당 COM+ 응용프로그램설정에서 Application Root Directory 값 을지정해준다. COM+ 응용프로그램 MyComponentServer SecondEntLibServerApp Application Root Directory d:\manifest\mycomapp d:\manifest\secondapp

에이전트구성 57 그림 10-1 Application Root Directory 0.1.2.4 구성요소재실행 아래와같이 COM+ 구성요소서비스관리자에서현재실행되어있는 dllhost.exe 실행파일들에제니퍼 닷넷이반영되도록개별프로세스마다 Recycle 메뉴를실행한다. 그림 10-2 Recycle

58 COM+ 구성 (.NET Framework 1.1 용 ) System Applicatoin 구성요소는시스템에의해서등록된구성요소서비스이므로 Recycle 명령을실행하지않는다. 10.2 에이전트구성제거 제품설치는그대로유지하고, 모니터링만을그만두려는경우 COM+ 응용프로그램설정에적용된 Appli cationrootdirectory 설정을해제한다. 만약, 제니퍼적용이전에이미 ApplicationRootDirectory 설정을가진응용프로그램이었다면 application.config 파일안의 Jennifer.FileName 속성만을삭제해준다. 이후, 만약서비스중인 COM+ 구성요소가있다면 COM+ 구성요소관리자 에서실행중인인스턴스에대해각각 Recycle 명령을실행해서모니터링상태를해제한다.

11. w3wp 자동시작옵션 IIS 에서호스팅되는 w3wp.exe는클라이언트로부터의요청이 20분 ( 기본값 ) 동안없는경우스스로종료하게되어있다. 이와함께제니퍼닷넷에이전트도내려가기때문에제니퍼콘솔에서는해당에이전트가 S topped로표시된다. 문제는, Stopped가실제응용프로그램의오류로인해 IIS가강제로실행되지못하도록한것인지, 20분동안요청이없어서내려간것인지에대한구분이없으므로장애모니터링을하는데불편하므로, 이를해결하기위해 IIS 7.5부터제공되는 "Start Mode: AlwaysRunning" 기능을이용한 JenniferPreload.dll을활용할수있다. 2012년 11월 8일이후릴리즈된제니퍼닷넷의 IISConfigHelper는이를위해 "Web Garden" 우측에 "Enable AutoStart" 라는옵션을제공한다. 이옵션은오직다음의조건을만족하는경우에만활성화된다. IIS 7.5 Web Application 이.NET 4.0 이상의응용프로그램 "Enable AutoStart" 옵션을켜고 "Save" 버튼을누르면 2가지변경사항이시스템에적용된다. 1. "%WINDIR%\system32\inetsrv\config\applicationHost.config" 파일에 AutoStart 관련옵션변경 JenniferPreload.dll 이실행되도록설정 2. 제니퍼의에이전트.conf 파일에 startup_url 옵션변경 startup_url 키에 w3wp.exe 프로세스가시작되면서방문하게될페이지에대한 URL 경로설정 startup_url 옵션은기본적으로 http://localhost:[ 포트번호 ] 로간단하게구성되는데, 고객사마다도메인명을특별하게구성하는변경이있다면그런경우에만 " 제니퍼콘솔 " 의 " 구성관리 " / " 구성설정 " 에서변경해준다. 59

색인 61