제니퍼(Jennifer) 에이전트 설치 - Resin(3)

Resin에 제니퍼 에이전트 설치

 

[지원 OS]

AIX 4.3.3, 5.x 32bit, 64bit

HP-UX 11.x 32bit, 64bit, Itanium 64bit

Sun Solaris 2.8, 2.9, 10 32bit, 64bit, x68

Intel Linux 32bit, Redhat Itanium 64bit

Microsoft Windows 2000, XP, 2003, Vista

 

 

[제니퍼 에이전트 설치]

• 사전설치(pre-installation)
• 사후설치(post-installation)
• 설치확인 작업

 

 

---

 

[Resin 설치 환경]

 아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치된 서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 Resin 이 운영중인 서버의 디렉토리로 복사한다. 본 설치가이드는 아래의 환경값을 기준으로 설명되 며, 실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야 한다

구 분	설정 환경
제니퍼 에이전트 홈 디렉토리	/home/jennifer/agent
자바 홈 디렉토리	/usr/java
제니퍼 서버 IP Address	192.168.0.139

    

---

 

 

[사전설치(Pre-Installation) 작업]

제니퍼 에이전트 디렉토리에서 preinstall.sh 을 실행한다.

 

1 JAVA_HOME 지정

Resin이 사용하는 JAVA_HOME 디렉토리를 지정한다. Resin이 사용하는 JAVA_HOME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

######################################################## Step 1. Build LWST ######################################################## Type the JAVA_HOME directory which is used by Java Application Server. Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME Creating lwst.jdk.jar ....  LWST(lwst.jdk.jar) build successful

 

2 Native Library 설정

제니퍼 에이전트에서 시스템의 CPU, 메모리 정보를 수집하기 위하여 네이티브 라이브러리를 찾기위해 test.sh 로 테스트 한 후, 성공한 libjennifer20.so(sl) 파일을 agent home 디렉토리 에 복사한다.

######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ######################################################## Is Web Application Server running with the -d64 option? [y/n] libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail libjennifer20_linux_32_32.so test success  /home/jennifer/agent/libjennifer20.so file is copied successfully

 

3. 에이전트 설정

제니퍼 에이전트’ 을 선택한 경우) 새로운 설정파일은 생성되지 않는다. 이 경우 제니퍼가 제공하고 있는 w11.c onf혹은 jennif의 설정파일을 구성하는 작업을 한다. 에이전트명을 반드시 3자로 지정하여 야 한다. 지정한 에이전트명으로 설정파일이 생성된다. agent명을 제외한 다른 입력값들은 값 을 기입하지 않고 엔터를 입력하면 기본 값을 사용하게 된다. 생성작업을 원하지 않을 경우(‘ner.conf파일을 환경에 맞춰 수정한 후 사용할 수 있다.

######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n] Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ?  logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ?  udp_server_host [ localhost ] ? server_udp_runtime_port [ 6901 ] ? server_udp_listen_port [ 6902 ] ? server_udp_lwst_call_stack_port [ 6703 ] ? The Agent configuration is completed... Please, proceed with Post Installation tasks [Pre-Installation is finished]

 

옵션설명

옵 션	설 명
agent_name	영어와 숫자의 조합으로된 3글자의 에이전트 구분자를 지정한다.
license_filename	라이센스키를 저장할 파일 경로 및 파일명을 지정한다.
logfile	제니퍼 에이전트 로그기록파일의 경로 및 파일명을 지정한다.
agent_tcp_port	제니퍼 에이전트에서 바인딩 할 포트를 지정한다.
udp_server_host	제니퍼 서버가 설치된 서버의 IP Address를 지정한다.

 

4. 요약 및 설정해야할 옵션

마지막으로 설정정보를 확인하고 Resin의 옵션 설정하는 부분에 아래의 옵션을 추가한다.

[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) ####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/l wst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar

 

---

 

 

[사후설치(Post-Installation) 작업]

사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를 Resin 자바옵션에 설 정하는 작업을 한다.

 

1 JNI 파일 복사

JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 Resin에서 사용하는 JDK의 sun.boot.library.path 위치에 복사한다.

 

2 Resin 2.x/3.0.x 자바옵션 설정

● 해당 버전은 $RESIN_HOME/bin/httpd.sh 파일이 실행 스크립트이다.

● Resin 설정 파일의 JAVA_OPTIONS 에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출 력된 옵션을 설정한다.

자바옵션중에 -Xbootclasspath/p 와 -javaagent 옵션 앞에 -J 옵션을 추가해야 한다. -J-Xbootclasspat/p -J-javaagent Resin이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.

 

 Resin 3.1.x / Resin 4.x 자바옵션 설정

● Resin 3.1.x / Resin 4.x 의 설정 파일은 기본적으로 $RESIN_HOME/conf/resin.conf 파일이다.

● Resin 설정 파일의 JAVA_OPTIONS 에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출 력된 옵션을 설정한다.

아래와 같이 태그 안에 3개 혹은 2개의 옵션을 설정한다. <jvm-arg>-Xbootclasspath/p:..... </jvm-arg> <jvm-arg>-Djennifer.config=.... </jvm-arg> <jvm-arg>-javaagent:.... </jvm-arg> Resin이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.

 

---

 

[설치 확인]

Resin 재시작 및 확인 사항

1. 라이센스키 등록

Resin을 재시작 하면 제니퍼 에이전트가 동작하게 되며, 아래의 내용들을 확인한다.

 * 제니퍼 에이전트 로그가 지정한 파일에 생성되었는지 확인하고, 로그파일에 아래와 같이 에이전트가 시작되었다는 메세지가 있는지 확인한다.

JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ---------------------- OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/a gent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar  ... sun.boot.library.path=/usr/java/jre/lib/i386  ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ---------------------------------------

 

● [구성관리 | 라이센스키 관리] 매뉴에서 발급받은 라이센스 키를 등록한다.

 

2. 모니터링 데이터 확인

● 사용자가 서비스 요청를 했을 경우, X-View 에 점들이 생성되는지 확인한다.

● X-View 의 점들을 선택했을때 메소드 및 SQL 정보들이 정상적으로 나오는지 확인한다.

● [ 장애진단 | 유틸리티 | 로딩 클래스 목록] 에 로딩된 클래스들이 정상적으로 나오는지 확 인한다.

 

---

 

 

[제니퍼 에이전트 구성제거]

1. Resin을 중지한다

2. Resin 2.1.x, 3.0.x 의 경우 시작 스크립트에서 제니퍼 에이전트 관련 옵션을 삭제한다.

3. Resin 3.1.x 의 경우 $RESIN_HOME/conf/resin.conf 파일에서 제니퍼 에이전트 관련 옵션을 삭제한다.

4. Resin 4.x 의 경우 $RESIN_HOME/conf/resin.xml 파일에서 제니퍼 에이전트 관련 옵션을 삭제한다.

5. 제니퍼 네이티브 라이브러리 파일을 삭제한다.

6. Resin을 재기동 한다.

 

https://docs.jennifersoft.com/4.5manual

 

---

2021/01/20 - [IT Knowledge] - 제니퍼(jennifer) - APM 모니터링 솔루션(1)

2021/01/20 - [IT Knowledge] - 제니퍼(Jennifer) 서버 설치(2)

제니퍼(Jennifer) 서버 설치(2)