---

---

 

Elevisor for J2EE Mate Agent는 타 APM이 적용되어 있는 WAS에 설치가 가능한 Agent로서 Lite 버전과 기능이 동일하며, 설치 방법이 다르다.

 

 

v 설치 파일 압축 해제

 

 

v Agent Config 파일 생성

   Agent 설치 경로에 Sample config 파일을 설치 대상 인스턴스 개수대로 copy한 후 설정한다.

 

   - agent naming rule

     agent name은 반드시 영문 4자로 설정해야 하며, agent name과 동일하게 config 파일을 설정하는 것이 좋다.

     또한 로드 발란스 및 클러스터링이 되어 있을 경우 "대표이름 2자리 + 서버구분1자리 + 인스턴스구분 1자리"

     로 naming 하는 것이 좋다.

     ex) 홈페이지 WAS서버가 2대, 각 서버에 컨테이너가 2개씩 구성되어 있는 경우

           WAS 1번 : HO11, HO12

           WAS 2번 : HO21, HO22

 

   - Sample config 파일 copy( 인스턴스명을 HO11와 HO12로 설정하는 경우 )

   $/home>cd elevisor/agent/config

   $/home/elevisor/agent/config>cp EFJ.conf HO11.conf

   $/home/elevisor/agent/config>cp EFJ.conf HO12.conf

 

v Agent Config 설정

 

   생성된 Agent 파일을 편집기로 열어 항목을 설정한다.

($/home/elevisor/agent/config>vi HO11.conf )

 

   - Elevisor 서버 정보 설정

  server_info.ip=192.168.0.100     -> Elevisor 서버 IP    

  server_info.udp.port.common=7701 -> Elevisor 서버에서 설정한 j2ee.udp.port.common 와 동일하게 설정

  server_info.udp.port.trace=7702  -> Elevisor 서버에서 설정한 j2ee.udp.port.trace 와 동일하게 설정

   

   - Agent 정보 설정

  agent_info.name=HO11 -> Agent Name

  agent_info.port=7701

* 서버의 요청처리를 위한 Agent Listen Port로 Agent 별로 다르게 설정 해야 한다.

    ex) HO11 -> 7701, HO12 -> 7702

 

   - Agent 라이선스 설정

   agent.license=TPEA-T6NJ-T6EX-E7N8-T6NJ-EEET6EX

*  라이선스가 Invalid 하면 Lite 버전으로 동작한다.

 

 ※ 보다 자세한 Agent 환경 설정은 본 메뉴얼 "운영관리->에이전트 관리" 참조

 

v JDK 패치 작업 불필요

 

v Elevisor Agent support JAR 파일(elevisor_agent_support.jar) 설정 작업 불필요

 

v Elevisor Agent JAR 파일 적용

 

* JDK 1.3~1.4의 경우 "elevisor_agent_jdk134.jar"  JDK 1.5 ~ 1.7의 경우 "elevisor_agent_jdk156.jar" 파일을 적용한다.

 

       - CLASSPATH에 설정하는 경우

                Weblogic의 경우 기동 스크립트의 CLASSPATH에 추가 설정

                ex) startManagedWeblogic.sh

                     ELEVISOR_HOME="/weblogic/elevisor/agent"

                     CLASSPATH="$CLASSPATH:$ELEVISOR_HOME/elevisor_agent_jdk156.jar"

 

       - WAS 엔진의 Lib 디렉터리에 복사

                 JEUS 4.x, 5.x                     cp elevisor_agent_jdk156.jar $JEUS_HOME/lib/system

                 OracleAS 10gR3               cp elevisor_agent_jdk156.jar $OAS_HOME/j2ee/home/lib 

                 Tomcat 4.x , 5.x                cp elevisor_agent_jdk156.jar $TOMCAT_HOME/common/lib 

                 Tomcat 6.x                        cp elevisor_agent_jdk156.jar $TOMCAT_HOME/lib  

                 Resin 2.x,3.x/3.x/4.x          cp elevisor_agent_jdk156.jar $RESIN_HOME/lib  

                 Jboss 3.x                           cp elevisor_agent_jdk156.jar $JBOSS_HOME/server/default/deploy/jbossweb-tomcat50.sar   

                 Jboss 4.x                           cp elevisor_agent_jdk156.jar $JBOSS_HOME/server/default/lib        

                 Sun AppServer 7.x,8.x,9.x cp elevisor_agent_jdk156.jar $SUNAPP_HOME/lib  

 

 

v Mate Filter 설정

 

* Web Application 설정 파일("WEB-INF/web.xml") 에 아래와 같이 Filter 설정을 추가한다.

 

 

* Web Application이 여러개 Deploy 되는 경우 동일하게 Filter 설정을 추가 후 JEUS 엔진 설정에 아래와 같이 설정 한다.

 

* 파란색 부분은 환경에 맞게 수정한다..

 

* Web Application 경로 확인 방법