제니퍼 닷넷 에이전트 설치 및 제거

이 장에서는 닷넷 버전의 제니퍼 에이전트를 설치 및 제거하는 방법을 설명한다.

제니퍼 닷넷 에이전트 설치 환경

닷넷 버전의 제니퍼 에이전트를 설치하기 위한 운영 환경은 아래와 같다.

제니퍼 에이전트 지원환경
구분	대상
운영체제	Microsoft Windows Server 2003, 2008/R2, 2012/R2
닷넷 프레임워크	프레임워크 2.0, 3.0, 3.5, 4.0, 4.5

시스템에 설치된 닷넷 프레임워크 확인 방법은 ”설치된 닷넷 프레임워크 버전 확인“을 참고한다.

에이전트 설치

설치환경

아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치될 서버의 환경 정보를 보여주고 있다. 본 설치 가이드는 [표 1]의 환경 값을 기준으로 설명되며, 실제 작업 시는 사용자 서버의 환경 정보에 맞추어 설치작업을 진행해야 한다.

기본 구성 환경
구분	대상
제니퍼 에이전트 홈 디렉토리	C:\Jennifer
제니퍼 서버 IP Address	192.168.0.139

사전 설치

닷넷 프레임워크 기반의 응용 프로그램을 모니터링 하는 제품이기 때문에 해당 서버에 이미 닷넷 프레임워크가 설치되었음을 가정할 수 있지만, 만약 새로 구성되는 서버에 미리 제니퍼 에이전트를 설치해야 한다면 제품 설치에 앞서 닷넷 프레임워크를 미리 설치해야 한다.

에이전트 설치

닷넷 버전의 제니퍼 에이전트를 모니터링 해야 할 응용 프로그램이 설치된 서버에 설치한다.

제니퍼소프트로부터 제공받은 라이선스 키를 “C:\Jennifer\agent.net\license.txt” 파일에 입력하고 저장한다.

C:\Jennifer\agent.net\install_Jennifer.bat 을 관리자 권한으로 실행한다. 실행 후, 반드시 출력되는 메시지에서 "Installation completed." 를 확인한다. 만약 이 메시지가 없으면 설치에 실패한 것이다.

제니퍼 에이전트가 시스템에 설치된 후, 모니터링 하려는 대상 응용 프로그램에 따라서 해야 할 작업이 달라진다.

구성을 완료한 이후 해당 응용 프로그램을 구동하여 동작시키면 C:\Jennifer\agent.net\log 폴더에 다음과 같은 형식의 로그 파일이 생성된다.

Jennifer_[AppPool 이름]_[에이전트 식별 ID]_[날짜].log

예를 들어, 2010년 3월 8일, 웹 응용 프로그램이 활성화 되는 AppPool 의 이름이 “DefaultAppPool”이고, 그와 연결된 conf 파일에 agent_pool 값을 N10:9000과 같이 주었다면 “jennifer_DefaultAppPool_N10_20100308.log” 파일이 생성된다.

에이전트 제거

닷넷 버전의 제니퍼 에이전트를 서버로부터 제거하고 파일을 삭제한다.

“C:/Jennifer/agent.net/uninstall_Jennifer.bat”을 관리자 권한으로 실행한다.

운영체제별 관리자 권한 실행 방법은 ”관리자 권한으로

실행” 내용을 참조한다.

만약, 모니터링하고 있는 응용 프로그램이 서비스 중이라면 종료하고, 폴더를 삭제한다.

제니퍼 서버 구성 변경

이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는 방법에 대해 설명한다.

클라이언트를 위한 설정 변경

제니퍼 서버는 웹 기반 사용자 인터페이스 제공을 위해서 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이다.

제니퍼 에이전트를 위한 설정

제니퍼 에이전트는 성능 데이터를 UDP 방식으로 제니퍼 서버에 전송한다. 제니퍼 서버는 제니퍼 에이전트가 보내는 성능 데이터를 3개의 UDP 포트로 분리해서 받아들인다. 제니퍼 에이전트는 제니퍼 서버의 server_udp_runtime_port 옵션으로 설정한 UDP 포트를 통해서 모든 트랜잭션의 시작과 종료와 관련한 데이터를 전송한다. 이 데이터는 크기는 매우 작으며 주로 X-View 차트를 표현하는데 사용된다. 기본 포트 번호는 6901이다.

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 IPEndPoint(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

만약 네트워크 연결이 지연되는 현상이 발생하면, 제니퍼 서버에 에러가 로그 파일에 출력된다. 이때는 옵션 값을 바꾸기 전에 먼저 제니퍼 에이전트와 서버 사이의 네트워크 환경을 튜닝 할 것을 권고한다.

제니퍼 사용을 위한 방화벽 설정

제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면, 앞에서 설정한 포트 번호가 방화벽을 정상적으로 통과하도록 설정해야 한다.

사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할 수 있어야 한다.
제니퍼 에이전트에서 제니퍼 서버로 UDP 6901, 6902, 6703 포트를 통해서 접근할 수 있어야 한다.
제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다.

설치 트러블 슈팅

이 절에서는 제니퍼 에이전트 설치 및 확인 작업 중 발생할 수 있는 문제와 그에 대한 대응책을 기술한다.

설치 오류

Q: 설치 및 제거 과정에 대한 로그 파일을 남기는 것이 가능한가?

A: install_jennifer.bat 와 uninstall_jennifer.bat 파일은 각각 로그를 남길 수 있는 버전인 install_with_log.bat, uinstall_with_log.bat 배치 파일이 동일 폴더에 제공됩니다. 설치/제거 과정에서 문제가 발생하면 로그 버전의 배치 파일을 실행해서 출력되는 파일을 기술 지원팀에 보내주십시오.

라이선스 오류 유형

Q: 전달받은 라이선스 키를 입력했는데, “Trial license key is not available” 오류가 발생합니다.

A: 이 오류가 발생할 수 있는 유형은 라이선스 발행 날짜가 현재 날짜보다 이후의 경우입니다. 라이선스를 발급한 컴퓨터의 시간대와 에이전트가 설치된 컴퓨터의 시간대가 틀린 경우에도 동일한 오류가 발생할 수 있습니다.

대시 보드 동작 오류 유형

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 연결 수에 대한 성능 카운터를 제공하지 않는 문제일 수 있습니다. 윈도우의 “관리 도구”에서 “성능 카운터”를 실행하여 오라클의 연결 개수 정보를 확인하십시오.

Q: 여전히 “최근 DB 커넥션 개수”가 0으로 나온다면?

A: 연결 문자열에서 “Pooling=false”로 설정된 경우 DB 연결 관련한 성능 카운터가 제공되지 않습니다. 또한, .NET 1.1 웹 사이트 역시 DB 연결 정보가 제공되지 않습니다.