[Jennifer4] Jennifer 4 설치 가이드 (4.5, 4.6)

End Of Service 이유

 

---

 

<제니퍼 서버 설치>

 

0. 지원하는 JDK

Server 는1.5 이상

Agent 는 1.8 미만 (End Of Service 로 인해 1.8 버전을 지원하지 않음)

 

1. 설치 파일 압축 해제

설치 파일 압축 해제 시 아래와 같다

 

2. 제니퍼 Server 의 JAVA_HOME 지정

server/bin 디렉토리의 catalina.sh 에서 설정한다.

startup.sh 이 catalina.sh start 명령어를 수행한다

 

3. 제니퍼 Server 의 IP Address 지정

server/bin 디렉토리의 jennifer.properties 에서 설정한다

0.0.0.0 으로 놔둬도 상관 없으나 직접 IP 주소를 지정해 주는 것을 권장

 

4-1. 제니퍼 Server 에서 사용할 Port - catalina.sh 에서 설정하는 부분

STARTUP_PORT : 제니퍼 화면에 접속하는 데에 사용하는 Port

 

4-2. 제니퍼 Server 에서 사용할 Port - jennifer.properties 에서 설정하는 부분

• Agent 와의 통신을 위한 3개의 UDP Port (Agent config 파일과 동일하게 맞춰야 함)
  • udp_runtime_port : 모든 트랜잭션의 시작과 종료와 관련한 데이터를 전송. 데이터 크기 작음
  • udp_listen_port : 1초마다 반복적으로 서비스 요청률, 평균 응답 시간 등의 일반 성능 데이터를 전송
  • udp_lwst_call_stack_port : X-View 트랜잭션 프로파일 데이터를 수집
• tcp_port : 웹브라우저와의 GUI 데이터 송수신에 사용

 

---

<제니퍼 에이전트 설치>

 

1. LWST Build (4.5에만 해당) 

4.6 버전은 LWST Build 과정 생략한다

제니퍼 4.5 설치가이드 문서 참고 : https://docs.jennifersoft.com/installguide#bc2f12f6178850e9

 

2. JNI Library 생성

시스템 리소스 정보를 수집하는 데에 필요한 라이브러리를 JDK에 추가해 주어야 한다

OS 에 맞는 파일을 libjennifer20.so 라는 이름으로 copy 한다

test.sh 을 실행시켜 적절한 파일을 copy 했는지 확인

libjennifer20.so 를 sun.boot.library.path 라는 변수에 해당하는 디렉토리에 복사한다

Server Control Center -> 시스템 환경 변수

sun.boot.library.path 라는 변수에 해당하는 디렉토리에 복사

 

3. Agent Config 파일 생성

최초 설치 시 agent 디렉토리에 들어있는

jennifer.conf 혹은 W11.conf 를 원하는 이름으로 copy 하여 사용

Agent 끼리 TCP 포트 겹치지 않도록 주의

udp_server_host 는 jennifer server 가 설치된 시스템의 IP Address 기입

 

4-1. WAS 에 제니퍼 연동 옵션 추가 (Jennifer 4.5)

총 3개 옵션 추가해야 함

- Xbootclasspath/p:{AGENT_HOME}/lwst.jdk.jar:{AGENT_HOME}/lwst.boot.jar:{AGENT_HOME}/jennifer.boot.jar

-Djennifer.config={AGENT_HOME}/m11.conf 

-javaagent:{AGENT_HOME}/lwst.javaagent.jar

 

4-2. WAS 에 제니퍼 연동 옵션 추가 (Jennifer 4.6)

Xbootclasspath/p 옵션을 제외한 2개의 옵션만 추가하면 된다

-Djennifer.config={AGENT_HOME}/m11.conf 

-javaagent:{AGENT_HOME}/jennifer.javaagent.jar

 

4-3. libjennifer20.so 파일을 sun.boot.library.path 디렉토리에 복사하지 않았을 경우

WAS의 JAVA_OPTIONS 에 jni_jennifer20_file 옵션을 추가로 넣어준다

jni_jennifer20_file=/jennifer/jennifer4/4.6/agent/jni/linux/libjennifer20.so

libjennifer20.so 파일을 WAS 기동시 선언하느냐 / 직접 path 경로 상에 넣어두느냐의 차이

 

---

 

<JBoss 설치 시 JAVA_OPTIONS>

Djboss.modules.system.pkgs 옵션이 추가로 작성되어야 한다

-Djennifer.config=/jennifer/jennifer4/4.6/agent/m11.conf 

-javaagent:/jennifer/jennifer4/4.6/agent/jennifer.javaagent.jar

-Djboss.modules.system.pkgs=org.jboss.byteman,com.javaservice