제니퍼 4.5 설치가이드 - JenniferSoftdocs.jennifersoft.com › installguide.pdf · | v 4.1.3.2 WebLogic자바옵션설정 4.1.3.3 WebLogic재시작및확인사항 4.1.3.4 제니퍼에이전트구성제거

제니퍼 4.5 설치가이드

JenniferSoft

목차

iii

목차

1. 제니퍼 서버 설치

1.1 제니퍼 서버 사양

1.2 UNIX에 제니퍼 서버 설치

1.3 WINDOWS에 제니퍼 서버 설치

1.4 클라이언트 설정

1.4.1 웹 브라우져

1.4.2 자바 플러그인

1.4.2.1 설치와 제거

1.4.3 메모리 설정

1.4.4 웹 브라우져 설정

1.4.4.1 자바 애플릿

1.4.4.2 자바스크립트

1.4.4.3 플래시 플레이어

1.4.5 윈도우 서비스 등록

2. 일반적인 제니퍼 에이전트 설치

2.1 pre-installation 에서의 작업

2.1.1 lwst를 build한다.

2.1.2 해당 시스템에 맞는 JNI library 파일을 찾는다.

2.1.3 에이전트 설정을 한다.

2.2 post-installation 에서의 작업

2.2.1 Java Application Server의 자바옵션에 설정을 추가한다.

2.2.2 생성된 libjennifer20.so(sl) 파일을 복사한다.

2.2.3 agent config 수정해야할 부분

2.2.4 JDBC 설정

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

. . . . . . . . . . . . . . . . . . . . . . . . 12

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

. . . . . . . . . . . . . . . . 12

. . . . . . . . . . . . . . . . . . . . . . . . . 12

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

iv | 목차

2.2.5 라이센스 설정

3. WebSphere에 제니퍼 에이전트 설치

3.1 UNIX 환경

3.1.1 WebSphere 설치 환경

3.1.2 사전설치(Pre-Installation) 작업

3.1.2.1 JAVA_HOME 지정

3.1.2.2 Native Library 설정

3.1.2.3 에이전트 설정

3.1.2.4 요약 및 설정해야할 옵션

3.1.3 사후설치(Post-Installation) 작업

3.1.3.1 JNI 파일 복사

3.1.3.2 WebSphere 자바옵션 설정

3.1.3.3 WebSphere 재시작 및 확인 사항

3.1.3.4 제니퍼 에이전트 구성제거

3.2 Windows 환경




3.2.2.2 Native Library 지정


3.2.2.4 요약 및 설정해야 할 옵션


3.2.3.1 WebSphere 자바 옵션 설정


3.2.3.3 제니퍼 에이전트 구성 제거

4. WebLogic에 제니퍼 에이전트 설치

4.1 UNIX 환경

4.1.1 WebLogic 설치 환경








. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

| v

4.1.3.2 WebLogic 자바옵션 설정

4.1.3.3 WebLogic 재시작 및 확인 사항


4.2 Windows 환경








4.2.3.1 WebLogic 자바 옵션 설정



5. Tomcat에 제니퍼 에이전트 설치

5.1 UNIX 환경

5.1.1 Tomcat 설치 환경








5.1.3.2 Tomcat 자바옵션 설정

5.1.3.3 Tomcat 재시작 및 확인 사항


5.2 Windows 환경








. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

vi | 목차

5.2.3.1 Tomcat 자바 옵션 설정



6. Resin에 제니퍼 에이전트 설치

6.1 UNIX 환경

6.1.1 Resin 설치 환경








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

6.1.3.3 Resin 3.1.x 자바옵션 설정

6.1.3.4 Resin 4.x 자바 옵션 설정

6.1.3.5 Resin 재시작 및 확인 사항


6.2 Windows 환경













7. JEUS에 제니퍼 에이전트 설치

7.1 UNIX 환경

7.1.1 JEUS 설치 환경


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

| vii







7.1.3.2 JEUS 자바옵션 설정

7.1.3.3 JEUS 재시작 및 확인 사항


7.2 Windows 환경








7.2.3.1 JEUS 자바 옵션 설정



8. JBoss에 제니퍼 에이전트 설치

8.1 UNIX 환경

8.1.1 JBoss 설치 환경








8.1.3.2 JBoss 자바옵션 설정

8.1.3.3 JBoss 재시작 및 확인 사항


8.2 Windows 환경


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

viii | 목차







8.2.3.1 JBoss 자바 옵션 설정



9. Oracle Application Server 설치

9.1 UNIX 환경

9.1.1 Oracle Application Server 설치 환경








9.1.3.2 Oracle Application Server 자바옵션 설정

9.1.3.3 Oracle Application Server 재시작 및 확인 사항


9.2 Windows 환경








9.2.3.1 Oracle Application Server 자바 옵션 설정



10. GlassFish에 제니퍼 에이전트 설치

10.1 UNIX 환경

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

. . . . . . . . . . . . . . . . . . . . . . . 84

. . . . . . . . . . . . . . . . . . . 84

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

. . . . . . . . . . . . . . . . . . . . . . . 89

. . . . . . . . . . . . . . . . . . . 89

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

| ix

10.1.1 GlassFish 설치 환경




10.1.2.3 에이전트 설정



10.1.3.1 JNI 파일 복사

10.1.3.2 GlassFish 자바옵션 설정

10.1.3.3 GlassFish 재시작 및 확인 사항


10.2 Windows 환경





10.2.2.3 에이전트 설정



10.2.3.1 GlassFish 자바 옵션 설정



11. SUN Application Server에 제니퍼 에이전트 설치

11.1 UNIX 환경

11.1.1 SUN Application Server 설치 환경




11.1.2.3 에이전트 설정



11.1.3.1 JNI 파일 복사

11.1.3.2 SUN Application Server 7 자바옵션 설정

11.1.3.3 SUN Application Server 8.x / 9.x / 10.x 자바옵션 설정

11.1.3.4 SUN Application Server 재시작 및 확인 사항

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

. . . . . . . . . . . . . . . . . . . . . 105

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

. . . . . . . . . . . . . . . . . . . . . . . 108

. . . . . . . . . . . . 108

. . . . . . . . . . . . . . . . . . . . 109

x | 목차


11.2 Windows 환경





11.2.2.3 에이전트 설정



11.2.3.1 SUN Application Server 7 자바 옵션 설정

11.2.3.2 SUN Application Server 8.x/9.x/10.x 자바 옵션 설정



12. AS400에 제니퍼 에이전트 설치

12.1 AS400 WebSphere에 제니퍼 에이전트 설치

12.1.1 WebSphere 6.0 ND, Express 버전

12.1.1.1 사전 준비 작업

12.1.1.2 WebSphere 구성 설정 작업

12.1.2 WebSphere 6.1 설치


12.1.3 AS400 WebSphere 모니터링 시 제약사항

13. OS390 z/WAS에 제니퍼 에이전트 설치

13.1 IBM WebSphere on ZOS 설치 가이드

13.1.1 LWST Build

13.1.2 wmond 실행

13.1.3 WebSphere 자바 옵션 설정

14. 제니퍼 에이전트 설치 트러블슈팅

14.1 제니퍼 서버 구성 변경

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

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

14.1.3 에이전트 TCP연결 옵션

14.2 한 서버에 복수의 제니퍼 에이전트 설치

14.3 제니퍼 에이전트 설치 트러블 슈팅

14.3.1 에이전트 설치후 웹 애플리케이션 서버가 기동이 안되는 경우

14.3.2 제니퍼 에이전트가 서버에 등록이 안된경우

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

. . . . . . . . . . . . . . . . . . . . . . 113

. . . . . . . . . . . . . . 114

. . . . . . . . . . . . . . . . . . . . 114

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

. . . . . . . . . . . . . . . . . . . . . . . . . . . 117

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

. . . . . . . . . . . . . . . . . . . . . . . . . 119

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

. . . . . . . . . . . . . 126

. . . . . . . . . . . . . . . . . . . . . . . . . 127

| xi

14.3.3 제니퍼 에이전트가 등록은 되지만 애플리케이션이 실행되지 않을 경우

14.3.4 Invalid LicenseKey 메세지가 나오는 경우

14.3.5 CPU / Memory 정보가 안나오는 경우

14.3.6 X-View 에 점이 표시되지 않는 경우

14.3.7 X-View 프로파일에서 SQL이 보이지 않는 경우

14.3.7.1 유형 3으로 설정시 유의사항

14.3.7.2 프레임워크별 JDBC 설정방법

14.3.7.3 애플리케이션 내에서 사용하는 JDBC Connection 방법을 모르는 경우

14.3.7.4 X-View 프로파일에서 SQL 파라미터가 정상적으로 표시되지 않을 경우

14.3.7.5 제니퍼 에이전트 설치 후 네이티브 메모리릭 발생할 경우

14.3.7.6 에이전트 설치 후 애플리케이션 쿠키정보가 유실된 경우

14.3.7.7 동일한 설정으로 다중프로세스에 설치할 경우

14.3.7.8 온라인 설치 기술지원 요청

색인

. . . . . . 127

. . . . . . . . . . . . . . . . . . . . . . . . . . 128

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

. . . . . . . . . . . . . . . . . . . . . . . 129

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

. . . 131

. . 131

. . . . . . . . . . . . . 132

. . . . . . . . . . . . . 132

. . . . . . . . . . . . . . . . . . . . . 132

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

제니퍼 서버 설치

1.

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에 제니퍼 서버 설치

제니퍼 서버 설치에 따른 사용자의 이해를 돕기 위해, 아래의 표는 제니퍼 서버 설치에 필요한

서버의 환경정보 예제를 보여주고 있다. 본 설치가이드는 아래의 환경 값을 기준으로 설명되며,

실제 값은 사용자 서버의 환경 정보에 맞추어 실제 설치 작업을 진행해야 한다.

2 | 제니퍼 서버 설치

환경변수 값

제니퍼 서버 HOME 디렉토리 /home/jennifer/server

JAVA_HOME /usr/java15

IP Address 192.168.0.139

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

WINDOWS에 제니퍼 서버 설치 | 3

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

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_HOM

E환경변수 지정 후 제니퍼 서버를 기동시킬 수 있다.

환경변수 값

제니퍼 서버 HOME 디렉토리 c:\jennifer\server

JAVA_HOME C:\Java\jdk16u13

IP Address 192.168.0.139

http://192.168.0.139:7900


1. 다운로드 받은 제니퍼패키징 파일을 압축유틸리티를 사용하여 제니퍼 설치 디렉토리(예:

c:\jennifer) 해제한다.

2. 명령프롬프트로 이동 [ 시작선택 |실행선택 | cmd 입력 후 실행]

3. 윈도우 시스템 환경변수에 JAVA_HOME이 설정되었는지 확인 한다.

C:\Java>echo %JAVA_HOME%

C:\Java\jdk16u13

4. 환경변수가 설정되어 있지 않았을 경우 [내컴퓨터 아이콘 우클릭| 속성선택 |고급탭 선택 |

환경변수]에 JAVA_HOME환경변수 값을 설정한다.

5. 명령프롬프트상에서 제니퍼서버 디렉토리(예:c:\jennifer\server\bin)이동 후 startu

p.bat을 실행한다. 환경변수를 새로 입력했을 경우 새로 명령프롬프트를 생성한 후 진행

한다. 탐색기상에서 직접 startup.bat파일을 더블 클릭해 실행 할 수도 있다. 제니퍼 서버

의 최초 기동시만 데이터베이스 테이블 생성작업이 진행된다. 서버 머신의 사양에 따라서

제니퍼 서버의 기동 시간이 차이가 있을 수 있다.

6. 로그인 한다.

웹 브라우저의 주소 창에 제니퍼 서버를 설치한 서버의 IP 혹은 도메인 주소와 포트 번호로

구성된 URL을 입력하면 로그인 화면이 나타난다. 제니퍼의 모든 기능은 로그인 후에 사용할

수 있다. 제니퍼 서버의 기본 포트 번호는 7900인다.

http://192.168.0.139:7900

로그인을 하려면 아이디와 패스워드를 입력하고 [Login] 버튼을 클릭한다. 초기 관리자 계

정의 아이디는 admin이며 패스워드도 admin이다. 처음 로그인을 한 후에 패스워드를 수정하

는 것을 권장한다. 제니퍼 클라이언트의 일부는 플래시로 구현되어 있기 때문에 어도비 플래시

플레이어 9.0 이상을 설치해야 한다.

1.4 클라이언트 설정

제니퍼 클라이언트는 웹에 기반한다. 따라서 사용자는 웹 브라우저를 통해서 제니퍼 사용자 인

터페이스에 접근한다. 클라이언트에 표시되는 차트 표시를 위한 자바 플러그인이 필요하고, 그

리드 표시를위한 플래시 플레이어가 필요하다. 운영 체계 제니퍼 클라이언트는 마이크로소프

트 윈도우즈 XP와 비스타를 지원한다. 단, 현재 사용중인 윈도우즈 테마에 따라 스타일이 정상

http://192.168.0.139:7900

클라이언트 설정 | 5

적으로 나타나지 않을 수 있다. 현재, 윈도우즈 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을 사용하는 것을 권장한다.

제니퍼를 사용하려면 쿠키와 자바 스크립트를 사용할 수 있도록 웹 브라우저를 설정해야 한

다. 대부분의 웹 브라우저는 기본적으로 이 기능들을 사용하도록 설정되어 있다.

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 탭을 선택한다.

http://java.sun.com/javase/downloads/index.jsp

http://java.sun.com/javase/downloads/index.jsp


3. Java 애플릿 런타임 설정 영역의 보기 버튼을 클릭하면 Java 런타임 설정 화면이 나타난

다. 여러 개의 자바를 설치한 경우에는 [사용 가능] 칼럼을 통해서 사용할 자바를 선택한

다.


예를 들어, 자바 힙 메모리 최소 값을 100 MB, 최대 값을 150 MB로 설정하려면 J

RE의 Java 런타임 매개 변수 칼럼에 다음과 같이 입력한다.

-Xms100m -Xmx150m

설정 가능한 자바 힙 메모리 최대 값은 머신의 사양과 환경에 영향을 받는다. 설정 가능한 값

보다 큰 값을 지정하면 오류가 발생하거나 웹 브라우저가 비정상적으로 종료될 수 있다. 설정

가능한 자바 힙 메모리 최대 값에 대한 명확한 규정이 없기 때문에 시행 착오를 통해서 자바 힙

메모리 최대 값을 설정해야 한다.

1.4.4 웹 브라우져 설정

1.4.4.1 자바 애플릿

마이크로소프트 IE 7.0, IE 8.0, IE 9.0 을 사용하는 경우에는 [도구 | 인터넷 옵션] 메뉴에서 자

바 플러그인 사용 여부를 설정한다. 인터넷 옵션 창에서 고급 탭을 선택하면 설치된 자바 플러

그인 정보가 나타난다. 여기서 선 자바 플러그인을 사용하도록 설정한다.


모질라 파이어 폭스 3.X을 사용하는 경우에는 [도구 | 인터넷옵션 | 보안 | 사용자정의지정]

메뉴에서 액티브스크립팅 사용 여부를 확인한다. 기본적으로 허용으로 선택되어 있다.

1.4.4.2 자바스크립트

마이크로소프트 IE 7.0, IE 8.0, IE 9.0 을 사용하는 경우에는 [도구 | 인터넷 옵션 | 보안 | 사용

자레벨 지정] 메뉴에서 스크립팅 사용 여부를 설정한다. 기본적을 사용되도록 설정되어 있다.


모질라 파이어 폭스 3.5를 사용하는 경우에는 [도구 | 설정] 메뉴에서 자바 플러그인 사용 여

부를 설정한다. 설정 화면에서 내용 탭을 선택한 후에 자바 스트립트 사용을 선택한다. 기본으

로 선택되어 있다.


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.

11

제니퍼 에이전트를 일반적인 방법으로 설치하는 방법을 설명한다. 제니퍼 에이전트 설치는 사

전설치(pre-installation), 사후설치(post-installation) 그리고 설치확인 작업으로 구성되어

있다.

2.1 pre-installation 에서의 작업

제니퍼 에이전트 설치에 앞서 구성설정에 필요한 파일을 찾거나 생성하는 작업을 한다.

2.1.1 lwst를 build한다.

애플리케이션의 소스 코드를 수정하지않고 성능 데이터 수집에 필요한 추적 코드와 프로파일

정보 추출 코드를 자바 애플리케이션을 구성하는 클래스에 삽입할수 있어야 한다. 제니퍼에서

는 이를 LWST라고 부른다. Application Server 에서 사용중인 JAVA의 rt.jar(sun 과 ibm 1.

6), core.jar(ibm 1.4,1.5) , vm.jar(ibm1.5) 파일을 참조하여 lwst.jdk.jar 파일을 생성한다.

JDK 버전이 1.5 이상인 경우

lwst40.sh jdk15 $JAVA_HOME/jre/lib/rt.jar

JDK 버전이 1.5 미만인 경우

lwst40.sh safe $JAVA_HOME/jre/lib/rt.jar

12 | 일반적인 제니퍼 에이전트 설치

2.1.2 해당 시스템에 맞는 JNI library 파일을 찾는다.

$JENNIFER_AGENT_HOME/jni/OS 디렉토리에 있는 파일을 테스트하여 해당 시스템에 맞

는 library파일을 $JENNIFER_AGENT_HOME 디렉토리에 복사한다.

2.1.3 에이전트 설정을 한다.

에이전트에서 에이전트명, 제니퍼 서버의 IP/PORT들을 환경에 맞게 설정한다.

2.2 post-installation 에서의 작업

제니퍼 에이전트가 설치될 WAS(java)에서 해당 WAS에 맞게 옵션을 설치하고 파일을 복사하

는 작업을 한다.

2.2.1 Java Application Server의 자바옵션에 설정을 추가한다.

-Djennifer.config=/home/jennifer/agent/w11.conf

-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lw

st.boot.jar:/home/jennifer/agent/jennifer.boot.jar

-javaagent:/home/jennifer/agent/lwst.javaagent.jar

2.2.2 생성된 libjennifer20.so(sl) 파일을 복사한다.

● ${agent_home}/tuning/env.jsp 로 확인하는 방법

해당 WAS에서 env.jsp파일을 실행시키면 sun.boot.library.path 해당 WAS의 sun.boot.l

ibrary.path 디렉토리에 ${agent_home}/libjennifer20.so(sl) 파일을 복사한다.

● agent를 등록시킨 후 확인하는 방법

제니퍼 화면에서 장애진단 → 시스템환경변수 에서 sun.boot.library.path에 등록된 디렉토

리에 ${agent_home}/libjennifer20.so(sl) 파일을 복사한다.

post-installation 에서의 작업 | 13

2.2.3 agent config 수정해야할 부분

agent 설정파일의 마지막 부분을 아래와같이 변경한다.

TX_SERVER로 설정한 경우에는 이 설정을 하지 않는다.

2.2.4 JDBC 설정

자바 애플리케이션에서 JNDI(Java Naming and Directory Interface)를 이용해서 javax.sql.

DataSource 객체를 획득하고, 이 객체로부터 java.sql.Connection 객체를 획득하는 경우를

유형 1이라고 한다. 유형 1은 추가적인 설정없이 JDBC모니터링이 가능하다.

자바 애플리케이션에서 java.sql.DriverManager 클래스를 통해서 java.sql.Connection

객체를 획득하는 경우를 유형 2라고 한다. 이 경우에는 JDBC 커넥션을 풀링하지 않기 때문에

JDBC 커넥션 개수를 체크하지 못한다.

자바 애플리케이션이 커넥션 풀의 역할을 담당하는 임의의 클래스를 통해서 java.sql.Conn

ection 객체를 획득하는 경우를 유형 3이라고 한다. 아파치 DBCP와 같은 커넥션 풀 라이브러

리를 사용하거나 레드햇 Hibernate 혹은 아파치 iBATIS 등의 프레임워크를 사용하는 경우가

이에 해당한다.

위에있는 유형 세가지가 모두 불가능한 경우 JDBC Driver의 connect()를 call 하는 부분에

서 추적하는데 이 경우를 유형 4라고 한다.

2.2.5 라이센스 설정

agent 설정파일에 명시적으로 설정할 수도 있고, 제니퍼 화면의 구성관리 → 라이센스키관리

메뉴에서 설정할 수 있다.

WebSphere에 제니퍼 에이전트 설치

3.

15

3.1 UNIX 환경

제니퍼 에이전트 설치는 사전설치(pre-installation), 사후설치(post-installation) 그리고 설

치확인 작업으로 구성되어 있다.


아래의 표는 제니퍼 에이전트 설치에 따른 작업자의 이해를 돕기 위해 제니퍼 에이전트가 설치

된 서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 We

bSphere가 운영중인 서버로 복사한다. 본 설치가이드는 아래의 환경값을 기준으로 설명되며,

실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야 한다.

표 3-1 제니퍼 에이전트 구성 예

구 분 설정 환경

제니퍼 에이전트 홈 디렉토리 /home/jennifer/agent

자바 홈 디렉토리 /was/WebSphere/AppServer/java

제니퍼 서버 IP Address 192.168.0.139


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

16 | WebSphere에 제니퍼 에이전트 설치


WebSphere가 사용하는 JAVA_HOME 디렉토리를 지정한다. WebSphere가 사용하는 JAV

A_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. ===>>

/was/WebSphere/AppServer/java

[/was/WebSphere/AppServer/java] is set as JAVA_HOME

Creating lwst.jdk.jar ....

LWST(lwst.jdk.jar) build successful


제니퍼 에이전트에서 시스템의 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

UNIX 환경 | 17


제니퍼 에이전트의 설정파일을 구성하는 작업을 한다. 에이전트명을 반드시 3자로 지정하여

야 한다. 지정한 에이전트명으로 설정파일이 생성된다. agent명을 제외한 다른 입력값들은 값

을 기입하지 않고 엔터를 입력하면 기본 값을 사용하게 된다. 생성작업을 원하지 않을 경우(‘n’

을 선택한 경우) 새로운 설정파일은 생성되지 않는다. 이 경우 제니퍼가 제공하고 있는 w11.c

onf혹은 jennifer.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]

표 3-2 옵션설명

옵 션 설 명

agent_name 영어와 숫자의 조합으로된 3글자의 에이전트 구분

자를 지정한다.

license_filename 라이센스키를 저장할 파일 경로 및 파일명을 지정

한다.

logfile 제니퍼 에이전트 로그기록파일의 경로 및 파일명

을 지정한다.

agent_tcp_port 제니퍼 에이전트에서 바인딩 할 포트를 지정한다.

udp_server_host 제니퍼 서버가 설치된 서버의 IP Address를 지정

한다.


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

다.


[ Pre-Installation Summary ]

JDK Home Directory : /was/WebSphere/AppServer/java

Jennifer Agent Home Directory : /home/jennifer/agent

Agent config file : /home/jennifer/agent/X11.conf

Jennifer LWST file : 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



사후설치 작업에서는 사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를

WebSphere 자바옵션에 설정하는 작업을 한다.


JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 WebSphere가 사

용하는 JDK의 sun.boot.library.path 위치에 복사한다.

3.1.3.2 WebSphere 자바옵션 설정

WebSphere 관리콘솔 에서 [ 애플리케이션 서버 선택 | 프로세스정의 | 자바 가상 시스템 ] 메

뉴를 선택한다.

1. 부트 클래스 경로에 아래의 값을 입력한다.

/home/jennifer/agent/jennifer.boot.jar

/home/jennifer/agent/lwst.jdk.jar

/home/jennifer/agent/lwst.boot.jar

2. 일반 JVM인수에 아래의 값을 입력한다.

UNIX 환경 | 19

-Djennifer.config=/home/jennifer/agent/W11.conf


WebSphere에서 사용하는 JDK가 1.5 미만인 경우 -javaagent:/home/jennifer/a

gent/lwst.javaagent.jar 옵션을 적용하지 않는다.

3. 해당 설정값을 저장한다.


1. 라이센스키 등록

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

● 제니퍼 에이전트 로그가 지정한 파일에 생성되었는지 확인하고, 로그파일에 아래와 같이

에이전트가 시작되었다는 메세지가 있는지 확인한다.

JENNIFER 4.5.3(2011-10-04) started.

agent_name=X11

jennifer.config=/home/jennifer/agent/X11.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

----------------------

jvm.current.directory=/was/WebSphere/AppServer/bin

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=/was/WebSphere/AppServer/java/jre/lib/i386

...

JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully.

---------------------------------------

위와 같이 “JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully.”

라는 메세지가 아닌경우 설치가이드의 트러블슈팅 부분을 참조한다.

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

2. 모니터링 데이터 확인

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

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

SQL이 나오지 않을 경우 제니퍼 메뉴얼의 “리소스 및 JDBC모니터링” 부분을 참조

한다.

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

인한다.


1. WebSphere 관리콘솔에서 [ 애플리케이션 서버 선택 | 프로세스정의 | 자바 가상 시스템

] 메뉴를 선택한다.

2. 부트 클래스 항목에서 jennifer.boot.jar, lwst.boot.jar, lwst.jdk.jar 를삭제한다.

3. 일반 JVM 인수 항목에서 -Djennifer.config 항목과 -javaagent항목을 삭제한다.

4. 제니퍼 네이티브 라이브러리 파일(예의 경우 /was/WebSphere/AppServer/java/jre/lib

/i386/libjennifer20.so)을 삭제한다.

5. WebSphere를 재기동 한다.

Windows 환경 | 21

3.2 Windows 환경




아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가설치된

서버의 환경정보를 보여주고 있다. 본 설치가이드는 아래의 환경값을 기준으로 설명되며, 실제

작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야 한다.


구 분 설 명

제니퍼 에이전트 홈 디렉토리 c:\jennifer\agent

자바 홈 디렉토리 c:\was\WebSphere\AppServer\java



제니퍼 에이전트 디렉토리에서 preinstall.bat를 administrator 권한으로 실행한다.


WebSphere가 사용하는 JAVA HOME 디렉토리를 지정한다. WebSphere가 사용하는 JAV

A HOME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

###################################################

Step 1. Build LWST

###################################################

Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to

quit):c:\was\WebSphere\AppServer\java

c:\was\WebSphere\AppServer\java is set as JAVA_HOME

"Creating lwst.jdk.jar..."

"LWST build successful"


lwst.jdk.jar is created successfully


제니퍼 에이전트에서 시스템의 CPU, 메모리 정보를 수집하기 위하여 네이티브 모듈을 설치한

다. 설치하는 시스템 메모리가 2 GB이상인 경우 Y, 이하인 경우 n를 선택한다.

###################################################


###################################################

Does your system have more than 2GB ?(Y/N) : y

jennifer20.dll has been copied to c:\was\WebSphere\AppServer\java\bin

successfully.



야 한다. 지정한 에이전트명으로 설정파일이 생성된다. 값을 기입하지 않고 엔터를 입력하면,

기본 값을 사용하게 된다. 생성작업을 원하지 않을 경우(‘n’을 선택한 경우) 새로운 설정파일은

생성되지 않는다. 이 경우 제니퍼가 제공하고 있는 w11.conf혹은 jennifer.conf파일을 환경

에 맞춰 수정한 후 사용할 수 있다.

###################################################


###################################################

Do you want to customize agent configuration file at this time? (Y/N) : y

license_filename [ex: C:\jennifer\agent\license.txt] :

Pleaes enter AGENT name. AGENT name must be 3 characters long, first

charater must be alphabet anemaining characters must be numbers e.g. [W11] :

X11

logfile [ex: C:\jennifer\agent\X11.log] :

agent_tcp_port [7750] :

udp_server_host [localhost] : 192.168.0.139

server_udp_runtime_port [6901] :

server_udp_listen_port [6902] :

server_udp_lwst_call_stack_port [6703] :

Do you have any option(s) that you want to change?(Y/N)n

Windows 환경 | 23


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

다.

[Pre-Installation Summary]

JAVA HOME DIRECTORY :

C:\was\WebSphere\AppServer\java

JENNIFER AGENT DIRECROTY : C:\jennifer\agent

JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf

JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :

C:\was\WebSphere\AppServer\java\bin\jennifer20.dll

[Post-Installation options]

-Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennifer

.boot.jar;C:\jennifer\agent\lwst.jdk.jar

-Djennifer.config=C:\jennifer\agent\X11.conf

-javaagent:C:\jennifer\agent\lwst.javaagent.jar


사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 WebSphere 자바 옵션에

설정한다.

3.2.3.1 WebSphere 자바 옵션 설정

1. WebSphere 관리콘솔 에서 [ 애플리케이션 서버 선택 | 프로세스정의 | 자바 가상 시스템


2. 부트클래스 경로에 아래의 값을 각각 입력한다.

c:\jennifer\agent\lwst.boot.jar

c:\jennifer\agent\lwst.jdk.jar

c:\jennifer\agent\jennifer.boot.jar



-Djennifer.config=c:\jennifer\jenniferagent\X11.conf

-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar

WebSphere가 사용하는 JDK 버전이 1.4 이하 경우 -javaagent:c:\jennifer\ag

ent\lwst.javaagent.jar 을 사용하지 않는다.

4. 해당 값을 저장한다.


1. 라이센스 키 등록

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


에이전트가 start 되었다는 메세지가 있는지 확인한다.


agent_name=X11

jennifer.config=C:\jennifer\agent\X11.conf

agent_tcp_port=7751





enable=true

license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28

logfile=c:\jennifer\agent\X11.log

LWST enabled=true




위와 같이 “jennifer20.dll shared library loaded successfully.” 라는 메세지가 아

닌경우 설치가이드의 트러블슈팅 부분을 참조한다.


Windows 환경 | 25




한다.


인한다.

3.2.3.3 제니퍼 에이전트 구성 제거

1. WebSphere 관리콘솔에서 [ 애플리케이션 서버 선택 | 프로세스정의 | 자바 가상 시스템


2. 부트 클래스 항목에서 jennifer.boot.jar, lwst.boot.jar, lwst.jdk.jar 를삭제한다.

3. 일반 JVM 인수 항목에서 -Djennifer.config 항목과 -javaagent항목을 삭제한다.

4. 제니퍼 네이티브 라이브러리 파일(예의 경우, C:\was\WebSphere\AppServer\jav

a\bin\jennifer2ll

5. .dll)을 삭제한다.

6. WebSphere를 재기동 한다.

WebLogic에 제니퍼 에이전트 설치

4.

27

4.1 UNIX 환경




아래의 표는 제니퍼 에이전트 설치에 따른 설치자 이해를 돕기 위해 제니퍼 에이전트가 설치된

서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 WebL

ogic이 운영중인 서버의 디렉토리로 복사한다. 본 설치가이드는 아래의 환경값을 기준으로 설

명되며, 실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야 한다




자바 홈 디렉토리 /usr/java



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

28 | WebLogic에 제니퍼 에이전트 설치


WebLogic이 사용하는 JAVA_HOME 디렉토리를 지정한다. WebLogic이 사용하는 JAVA_

HOME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

########################################################

Step 1. Build LWST

########################################################



/usr/java

[/usr/java] is set as JAVA_HOME






에 복사한다.

########################################################


########################################################






UNIX 환경 | 29







########################################################


########################################################














옵 션 설 명

agent_name 영어와 숫자의 조합으로된 3글자의 에이전트 구분자를 지정한다.

license_filename 라이센스키를 저장할 파일 경로 및 파일명을 지정한다.

logfile 제니퍼 에이전트 로그기록파일의 경로 및 파일명을 지정한다.


udp_server_host 제니퍼 서버가 설치된 서버의 IP Address를 지정한다.


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


Java Application Server Home Directory :

JDK Home Directory : /usr/java


Jennifer Agent Directory : /home/jennifer/agent

Jennifer LWST file :




#######################################################################


#######################################################################






사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를 WebLogic 자바옵션

에 설정하는 작업을 한다.


JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 WebLogic에서 사

용하는 JDK의 sun.boot.library.path 위치에 복사한다.

4.1.3.2 WebLogic 자바옵션 설정

● WebLogic의 환경 설정 파일은 기본적으로 $DOMAIN_HOME/bin/startWebLogic.sh

이다.

● WebLogic 설정 파일의 JAVA_OPTIONS 에 설치가이드 1.2.4 요약 및 설정해야 할 옵션

에 출력된 옵션을 설정한다.

WebLogic이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.



UNIX 환경 | 31

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




agent_name=X11

jennifer.config=/home/jennifer/agent/W11.conf

agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...

sun.boot.library.path=/usr/java/jre/lib/i386

...


---------------------------------------









한다.


인한다.


1. WebLogic을 중지한다

2. WebLogic의 $DOMAIN_HOME/bin/startWebLogic.sh 파일에서 제니퍼 에이전트 관

련 옵션을 삭제한다.

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

4. WebLogic을 재기동 한다.

4.2 Windows 환경








구 분 설 명


자바 홈 디렉토리 C:\Program Files\Java\jdk1.6.0_15


Windows 환경 | 33




WebLogic이 사용하는 JAVA HOME 디렉토리를 지정한다. WebLogic이 사용하는 JAVA H

OME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

###################################################

Step 1. Build LWST

###################################################


quit):C:\Program Files\Java\jdk1.6.0_15

C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME







###################################################


###################################################


jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15

successfully.








###################################################


###################################################





X11









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


JAVA HOME DIRECTORY : C:\Program

Files\Java\jdk1.6.0_15



JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program

Files\Java\jdk1.6.0_15\bin\jennifer20.dll






Windows 환경 | 35


사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 WebLogic 자바 옵션에 설

정한다.

4.2.3.1 WebLogic 자바 옵션 설정

● WebLogic의 환경 설정 파일은 기본적으로 %WEBLOGIC_HOME%\bin\startWebL

ogic.cmd 이다.

● WebLogic 설정 파일의 JAVA_OPTIONS 에 설치가이드 2.2.4 요약 및 설정해야 할 옵션

에 출력된 옵션을 설정한다.

WebLogic이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.



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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true





...


---------------------------------------








한다.


인한다.


1. WebLogic을 중지한다

2. WebLogic의 $DOMAIN_HOME\bin\startWebLogic.cmd 파일에서 제니퍼 에이전

트 관련 옵션을 삭제한다.


4. WebLogic을 재기동 한다.

Tomcat에 제니퍼 에이전트 설치

5.

37

5.1 UNIX 환경





서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 Tomc

at이 운영중인 서버의 디렉토리로 복사한다. 본 설치가이드는 아래의 환경값을 기준으로 설명

되며, 실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야 한다








38 | Tomcat에 제니퍼 에이전트 설치


Tocmat 이 사용하는 JAVA_HOME 디렉토리를 지정한다. Tomcat이 사용하는 JAVA_HOM

E을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

########################################################

Step 1. Build LWST

########################################################



/usr/java







에 복사한다.

########################################################


########################################################






UNIX 환경 | 39







########################################################


########################################################














옵 션 설 명







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










#######################################################################


#######################################################################






사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를 Tomcat 자바옵션에

설정하는 작업을 한다.


JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 Tomcat 에서 사용

하는 JDK의 sun.boot.library.path 위치에 복사한다.

5.1.3.2 Tomcat 자바옵션 설정

● Tomcat의 설정파일은 기본적으로 ${TOMCAT_HOME}/bin/catalina.sh 파일이다.

● Tomcat 설정 파일의 JAVA_OPTIONS 에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에

출력된 옵션을 설정한다.

Tomcat 이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.



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

UNIX 환경 | 41




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...


...


---------------------------------------









한다.


인한다.


1. Tomcat을 중지한다

2. Tomcat의 JAVA_OPTIONS을 설정한 ${TOMCAT_HOME}/bin/catalina.sh 파일에서

제니퍼 에이전트 관련 옵션을 삭제한다.


4. Tomcat을 재기동 한다.

5.2 Windows 환경








구 분 설 명




Windows 환경 | 43




Tomcat 이 사용하는 JAVA HOME 디렉토리를 지정한다. Tomcat 이 사용하는 JAVA HOM

E을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

###################################################

Step 1. Build LWST

###################################################










###################################################


###################################################



successfully.








###################################################


###################################################





X11









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













Windows 환경 | 45


사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 Tomcat 자바 옵션에 설정

한다.

5.2.3.1 Tomcat 자바 옵션 설정

● Tomcat의 설정파일은 기본적으로 %TOMCAT_HOME%\bin\catalina.bat이다. 예

에서는 %TOMCAT_HOME%\bin\catalina.bat 이다.

● Tomcat 설정 파일의 JAVA_OPTIONS 에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에

출력된 옵션을 설정한다.

Tomcat 이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.



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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true





...


---------------------------------------








한다.


인한다.


1. Tomcat 을 중지한다

2. Tomcat 환경 설정 파일인 %TOMCAT_HOME%\bin\catalina.bat 에서 제니퍼 에

이전트 설정 옵션을 제거한다.


4. Tomcat을 재기동 한다.

Resin에 제니퍼 에이전트 설치

6.

47

6.1 UNIX 환경





서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 Resin

이 운영중인 서버의 디렉토리로 복사한다. 본 설치가이드는 아래의 환경값을 기준으로 설명되

며, 실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야 한다








48 | Resin에 제니퍼 에이전트 설치


Resin이 사용하는 JAVA_HOME 디렉토리를 지정한다. Resin이 사용하는 JAVA_HOME을

확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

########################################################

Step 1. Build LWST

########################################################



/usr/java







에 복사한다.

########################################################


########################################################






UNIX 환경 | 49







########################################################


########################################################














옵 션 설 명







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










#######################################################################


#######################################################################






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

정하는 작업을 한다.


JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 Resin에서 사용하는

JDK의 sun.boot.library.path 위치에 복사한다.


● 해당 버전은 $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 옵션을 설정하지 않는다.

UNIX 환경 | 51


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



아래와 같이 태그 안에 3개 혹은 2개의 옵션을 설정한다.

<jvm-arg>-Xbootclasspath/p:.....</jvm-arg>

<jvm-arg>-Djennifer.config=....</jvm-arg>

<jvm-arg>-javaagent:....</jvm-arg>



● Resin 4.x 버전에서의 설정 파일은 $RESIN_HOME/conf/resin.xml 파일이다.










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





agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...


...


---------------------------------------








한다.

Windows 환경 | 53


인한다.


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 파일에서 제니퍼 에이전트 관련 옵

션을 삭제한다.


6. Resin을 재기동 한다.

6.2 Windows 환경








구 분 설 명








Resin이 사용하는 JAVA HOME 디렉토리를 지정한다. Resin이 사용하는 JAVA HOME을 확

인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

###################################################

Step 1. Build LWST

###################################################










###################################################


###################################################



successfully.





Windows 환경 | 55



###################################################


###################################################





X11









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















사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 Resin 자바 옵션에 설정한

다.


● Resin 기동명령어에 제니퍼 에이전트 구성정보를 입력하고 Resin을 기동한다.

● Resin 기동명령어는 %RESIN_HOME%\httpd.exe이다.

● Resin 설정 구성파일에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출력된 옵션을 설정

한다.

기동명령어에 -Xbootclasspath/p 와 -javaagent 옵션 앞에 -J 옵션을 추가해야 한

다.

-J-Xbootclasspat/p -J-javaagent



● Resin 3.1 버전에서의 설정 파일은 %RESIN_HOME%\conf\resin.conf 파일이다.








Windows 환경 | 57


● Resin 4.x 버전에서의 설정 파일은 %RESIN_HOME%\conf\resin.xml 파일이다.










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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true





...


---------------------------------------








한다.


인한다.


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 파일에서 제니퍼 에이전트 관

련 옵션을 삭제한다.


6. Resin을 재기동 한다.

JEUS에 제니퍼 에이전트 설치

7.

59

7.1 UNIX 환경





서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 JEUS










60 | JEUS에 제니퍼 에이전트 설치


JEUS이 사용하는 JAVA_HOME 디렉토리를 지정한다. JEUS이 사용하는 JAVA_HOME을 확


########################################################

Step 1. Build LWST

########################################################



/usr/java







에 복사한다.

########################################################


########################################################






UNIX 환경 | 61







########################################################


########################################################














옵 션 설 명







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










#######################################################################


#######################################################################






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

하는 작업을 한다.


JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 JEUS에서 사용하는


7.1.3.2 JEUS 자바옵션 설정

● JEUS 설정 파일은 $WAS_HOME/config/hostname/JEUSMain.xml 파일이다.

● JEUSMain.xml 파일에서 <command-option></command-option> 태그안에 추가한

다.

● JEUS 설정 파일의 JAVA_OPTIONS 에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출


JEUS이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.


UNIX 환경 | 63


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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...


...


---------------------------------------









한다.


인한다.


1. JEUS을 중지한다

2. $JEUS_HOME/config/hostname/JEUSMain.xml파일에서 제니퍼 에이전트 관련 옵션

을 삭제한다.


4. JEUS을 재기동 한다.

7.2 Windows 환경








구 분 설 명




Windows 환경 | 65




JEUS이 사용하는 JAVA HOME 디렉토리를 지정한다. JEUS이 사용하는 JAVA HOME을 확


###################################################

Step 1. Build LWST

###################################################










###################################################


###################################################



successfully.








###################################################


###################################################





X11









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













Windows 환경 | 67


사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 JEUS 자바 옵션에 설정한다.

7.2.3.1 JEUS 자바 옵션 설정

● JEUS 의 환경설정파일은 %JEUS_HOME%\config\hostname\JEUSMain.xml 파

일이다.

● JEUSMain.xml 파일에서 <command-option></command-option> 태그안에 추가한

다.

● JEUS 설정 파일의 JAVA_OPTIONS 에 설치가이드 2.2.4 요약 및 설정해야 할 옵션에 출


JEUS이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.



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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true





...


---------------------------------------








한다.


인한다.


1. JEUS을 중지한다

2. %JEUS_HOME%\config\hostname\JEUSMain.xml 파일에서 제니퍼 에이전트

설정을 제거한다.


4. JEUS을 재기동 한다.

JBoss에 제니퍼 에이전트 설치

8.

69

8.1 UNIX 환경





서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 JBoss










70 | JBoss에 제니퍼 에이전트 설치


JBoss이 사용하는 JAVA_HOME 디렉토리를 지정한다. JBoss이 사용하는 JAVA_HOME을

확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

########################################################

Step 1. Build LWST

########################################################



/usr/java







에 복사한다.

########################################################


########################################################






UNIX 환경 | 71







########################################################


########################################################














옵 션 설 명







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










#######################################################################


#######################################################################






사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를 JBoss 자바옵션에 설

정하는 작업을 한다.


JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 JBoss에서 사용하는


8.1.3.2 JBoss 자바옵션 설정

● JBoss의 설정 파일은 기본적으로 $JBOSS_HOME/bin/run.sh 이다.

● JBoss 설정 파일의 JAVA_OPTS 에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출력된

옵션을 설정한다.

JBoss7 의 경우 OSGI 클래스 로더 구조로 standalone.conf 혹은 domain.conf에

아래와 같이 추가로 적용해야 한다.

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

JBoss이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.

UNIX 환경 | 73



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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...


...


---------------------------------------









한다.


인한다.


1. JBoss을 중지한다

2. JBoss 설정 파일인 run.sh 에서 제니퍼 에이전트 설정옵션을 삭제한다.


4. JBoss을 재기동 한다.

8.2 Windows 환경








구 분 설 명



Windows 환경 | 75


구 분 설 명




JBoss이 사용하는 JAVA HOME 디렉토리를 지정한다. JBoss이 사용하는 JAVA HOME을 확


###################################################

Step 1. Build LWST

###################################################










###################################################


###################################################



successfully.








###################################################


###################################################





X11









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










Windows 환경 | 77





사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 JBoss 자바 옵션에 설정한

다.

8.2.3.1 JBoss 자바 옵션 설정

● 기본적인 JBoss 기동명령어는 %JBOSS_HOME%\bin\run.bat 이다.

● JBoss 설정 파일의 JAVA_OPT 에 설치가이드 2.2.4 요약 및 설정해야 할 옵션에 출력된


JBoss7 의 경우 OSGI 클래스 로더 구조로 standalone.conf 혹은 domain.conf에

아래와 같이 추가로 적용해야 한다.

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

JBoss이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.



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




agent_name=X11


agent_tcp_port=7751






enable=true



LWST enabled=true




...


---------------------------------------








한다.


인한다.


1. JBoss을 중지한다

2. JBoss 기동파일 %JBOSS_HOME%\bin\run.bat 파일에서 제니퍼 에이전트 설정 옵

션을 제거한다.


Windows 환경 | 79

4. JBoss을 재기동 한다.

Oracle Application Server 설치

9.

81

9.1 UNIX 환경





서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 Oracl

e Application Server이 운영중인 서버의 디렉토리로 복사한다. 본 설치가이드는 아래의 환경

값을 기준으로 설명되며, 실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해

야 한다








82 | Oracle Application Server 설치


Oracle Application Server이 사용하는 JAVA_HOME 디렉토리를 지정한다. Oracle Applic

ation Server이 사용하는 JAVA_HOME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을

한다.

########################################################

Step 1. Build LWST

########################################################



/usr/java







에 복사한다.

########################################################


########################################################






UNIX 환경 | 83







########################################################


########################################################














옵 션 설 명







마지막으로 설정정보를 확인하고 Oracle Application Server의 옵션 설정하는 부분에 아래의

옵션을 추가한다.










#######################################################################


#######################################################################






사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를 Oracle Application S

erver 자바옵션에 설정하는 작업을 한다.


JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 Oracle Applicatio

n Server에서 사용하는 JDK의 sun.boot.library.path 위치에 복사한다.

9.1.3.2 Oracle Application Server 자바옵션 설정

● Oracle Application Server 의 환경 설정은 $ORACLE_WAS/opmn/conf/opmn.xml

파일이다.

● Oracle Application Server 설정 파일인 opmn.xml 내에 <data id="java-options" valu

e=" "> 부분에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출력된 옵션을 설정한다.

Oracle Application Server가 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을

설정하지 않는다.


UNIX 환경 | 85


Oracle Application Server를 재시작 하면 제니퍼 에이전트가 동작하게 되며, 아래의 내용

들을 확인한다.




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...


...


---------------------------------------









한다.


인한다.


1. Oracle Application Server를 중지한다

2. $ORACLE_WAS/opmn/conf/opmn.xml 파일에서 제니퍼 에이전트 관련 옵션을 삭제

한다.


4. Oracle Application Server를 재기동 한다.

9.2 Windows 환경








구 분 설 명


Windows 환경 | 87



구 분 설 명




Oracle Application Server가 사용하는 JAVA HOME 디렉토리를 지정한다. Oracle Applica

tion Server가 사용하는 JAVA HOME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한

다.

###################################################

Step 1. Build LWST

###################################################










###################################################


###################################################



successfully.








###################################################


###################################################





X11









마지막으로 설정정보를 확인하고 Oracle Application Server의 옵션 설정하는 부분에 아래의










Windows 환경 | 89






사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 Oracle Application Serve

r 자바 옵션에 설정한다.

9.2.3.1 Oracle Application Server 자바 옵션 설정

● Oralce Application Server 환경설정파일은 %ORACLE_HOME%\opmn\conf\op

mn.xml이다.

● Oracle Application Server 설정 파일인 opmn.xml 내에 <data id="java-options" valu

e=" "> 부분에 설치가이드 2.2.4 요약 및 설정해야 할 옵션에 출력된 옵션을 설정한다.

윈도우의 경우 반드시 -Xbootclasspath/p 대신에 -Xbootclasspath^/p 로 설정해

야한다.

Oracle Application Server이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을

설정하지 않는다.



Oracle Application Server을 재시작 하면 제니퍼 에이전트가 동작하게 되며, 아래의 내용

들을 확인한다.





agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




...


---------------------------------------








한다.


인한다.


1. Oracle Application Server를 중지한다

Windows 환경 | 91

2. %ORACLE_HOME%\opmn\conf\opmn.xml 파일에서 제니퍼 에이전트 설정을

제거한다.


4. Oracle Application Server을 재기동 한다.

GlassFish에 제니퍼 에이전트 설치

10.

93

10.1 UNIX 환경





서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 Glass

Fish가 운영중인 서버의 디렉토리로 복사한다. 본 설치가이드는 아래의 환경값을 기준으로 설

명되며, 실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야 한다








94 | GlassFish에 제니퍼 에이전트 설치


GlassFish가 사용하는 JAVA_HOME 디렉토리를 지정한다. GlassFish가 사용하는 JAVA_H

OME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

########################################################

Step 1. Build LWST

########################################################



/usr/java







에 복사한다.

########################################################


########################################################






UNIX 환경 | 95

10.1.2.3 에이전트 설정






########################################################


########################################################














옵 션 설 명







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










#######################################################################


#######################################################################






사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를 GlassFish 자바옵션에

설정하는 작업을 한다.

10.1.3.1 JNI 파일 복사

JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 GlassFish에서 사용

하는 JDK의 sun.boot.library.path 위치에 복사한다.

10.1.3.2 GlassFish 자바옵션 설정

● GlassFish 관리콘솔에서 [ Application Server | JVM Setting | JVM Setting | JVM Opti

ons ] 메뉴를 선택한다.

● GlassFish 의 관리콘솔에서 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출력된 옵션을

설정한다.

GlassFish이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.

GlassFish 3의 경우 $GLASSFISH_HOME/osgi/felix/conf에 아래와 같이 추가로

제니퍼 에이전트 라이브러리를 기술한다.

UNIX 환경 | 97

org.osgi.framework.bootdelegation=javax.transaction, javax.transaction.*, \

org.omg.CORBA, \

${eclipselink.bootdelegation}, \

com.sun.btrace, com.sun.btrace.*, \

com.javaservice, com.javaservice.*, \

org.netbeans.lib.profiler,

org.netbeans.lib.profiler.*



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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...


...



---------------------------------------








한다.


인한다.


1. GlassFish 관리콘솔에서 [ Application Server | JVM Setting | JVM Setting | JVM Opt

ions ] 제니퍼 에이전트 설정 옵션을 제거하고, 설정값을 저장한다.

2. GlassFish 3의 경우 ($GLASSFISH_HOME/osgi/felix/conf) 제니퍼에이전트 관련 모듈

설정을 제거한다.

3. GlassFish을 중지한다


5. GlassFish을 재기동 한다.

Windows 환경 | 99

10.2 Windows 환경








구 분 설 명







GlassFish가 사용하는 JAVA HOME 디렉토리를 지정한다. GlassFish가 사용하는 JAVA HO

ME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

###################################################

Step 1. Build LWST

###################################################











###################################################


###################################################



successfully.

10.2.2.3 에이전트 설정






###################################################


###################################################





X11







Windows 환경 | 101



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














사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 GlassFish 자바 옵션에 설

정한다.

10.2.3.1 GlassFish 자바 옵션 설정

● GlassFish 관리 콘솔에서 [ Application Server | JVM Setting | JVM Options ] 메뉴를

선택한다.

● GlassFish의 관리콘솔에서 에 설치가이드 2.2.4 요약 및 설정해야 할 옵션에 출력된 옵션

을 설정한다.

GlassFish이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설정하지 않는다.


GlassFish 3의 경우 %GLASSFISH_HOME%\osgi\felix\conf에 아래와 같이

추가로 제니퍼 에이전트 라이브러리를 기술한다.

org.osgi.framework.bootdelegation=javax.transaction, javax.transaction.*, \

org.omg.CORBA, \

${eclipselink.bootdelegation}, \

com.sun.btrace, com.sun.btrace.*, \

com.javaservice, com.javaservice.*, \

org.netbeans.lib.profiler,

org.netbeans.lib.profiler.*



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




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




...


---------------------------------------









한다.


인한다.


1. GlassFish 관리 콘솔에서 [ Application Server | JVM Setting | JVM Options ]메뉴에

서 제니퍼 에이전트 설정을 제거하고 저장한다.

2. GlassFish 3의 경우 (%GLASSFISH_HOME%\osgi\felix\conf) 제니퍼에이전트 관

련 모듈 설정을 제거한다.

3. GlassFish을 중지한다


5. GlassFish을 재기동 한다.

SUN Application Server에 제니퍼 에이전트

설치

11.

105

11.1 UNIX 환경





서버의 환경정보를 보여주고 있다. 제니퍼 에이전트 디렉토리 하위 파일 및 디렉토리를 SUN

Application Server가 운영중인 서버의 디렉토리로 복사한다. 본 설치가이드는 아래의 환경값

을 기준으로 설명되며, 실제 작업시는 사용자 서버의 환경정보에 맞추어 설치작업을 진행해야

한다








106 | SUN Application Server에 제니퍼 에이전트 설치


SUN Application Server가 사용하는 JAVA_HOME 디렉토리를 지정한다. SUN Applicatio

n Server가 사용하는 JAVA_HOME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

########################################################

Step 1. Build LWST

########################################################



/usr/java







에 복사한다.

########################################################


########################################################






UNIX 환경 | 107

11.1.2.3 에이전트 설정






########################################################


########################################################














옵 션 설 명







마지막으로 설정정보를 확인하고 SUN Application Server의 옵션 설정하는 부분에 아래의











#######################################################################


#######################################################################






사전설치 작업을 통해 작성된 라이브러리 및 에이전트 구성파일 경로를 SUN Application Ser

ver 자바옵션에 설정하는 작업을 한다.

11.1.3.1 JNI 파일 복사

JNI테스트가 완료된 /home/jennifer/agent/libjennifer20.so(sl) 파일을 SUN Application

Server에서 사용하는 JDK의 sun.boot.library.path 위치에 복사한다.

11.1.3.2 SUN Application Server 7 자바옵션 설정

● SUN Application Server의 설정 파일은 $SUNWAS_HOME/domains/domain1/serve

r1/config/server.xml 파일이다.

● SUN Application Server 설정 파일에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출


SUN Application Server이 사용하는 JDK가 1.4 이하인 경우 javaagent 옵션을 설

정하지 않는다.

11.1.3.3 SUN Application Server 8.x / 9.x / 10.x 자바옵션 설정

UNIX 환경 | 109

● 관리콘솔에서 [ Application Server | JVM Setting | JVM Setting | JVM Options ] 메뉴

를 선택한다.

● SUN Application Server 설정 옵션에 설치가이드 1.2.4 요약 및 설정해야 할 옵션에 출






SUN Application Server를 재시작 하면 제니퍼 에이전트가 동작하게 되며, 아래의 내용들

을 확인한다.




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




----------------------


VM,10.0-b23



...



...


---------------------------------------








한다.


인한다.


1. SUN Application Server를 중지한다

2. SUN Application Server 8.x/9.x/10.x의 경우 관리콘솔에서 [ Application Server | JV

M Setting | JVM Setting | JVM Options ] 메뉴에서 제니퍼 에이전트 설정을 삭제하고

설정값을 저장한다.

3. SUN Application Server 7 인 경우 $SUNWAS_HOME/domains/domain1/config/s

erver.xml 에서 제니퍼 에이전트 설정 옵션을 삭제한다


5. SUN Application Server를 재기동 한다.


11.2 Windows 환경








구 분 설 명







SUN Application Server가 사용하는 JAVA HOME 디렉토리를 지정한다. SUN Application

Server가 사용하는 JAVA HOME을 확인한 후, lwst.jdk.jar 파일을 생성하는 작업을 한다.

###################################################

Step 1. Build LWST

###################################################











###################################################


###################################################



successfully.

11.2.2.3 에이전트 설정






###################################################


###################################################





X11










마지막으로 설정정보를 확인하고 SUN Application Server의 옵션 설정하는 부분에 아래의















사전작업을 통해 작성된 라이브러리 및 에이전트 구성파일 설정을 SUN Application Server

자바 옵션에 설정한다.

11.2.3.1 SUN Application Server 7 자바 옵션 설정

● SUN Application Server의 설정파일은 %SUN_WAS_HOME%\domains\domain

1\server1\config\server.xml 이다.

● SUN Application Server 설정 파일에 설치가이드 2.2.4 요약 및 설정해야 할 옵션에 출





11.2.3.2 SUN Application Server 8.x/9.x/10.x 자바 옵션 설정

● 관리 콘솔에서 [ Application Server | JVM Setting | JVM Options]메뉴를 선택한다.

● SUN Application Server 설정에 설치가이드 2.2.4 요약 및 설정해야 할 옵션에 출력된






SUN Application Server를 재시작 하면 제니퍼 에이전트가 동작하게 되며, 아래의 내용들

을 확인한다.




agent_name=X11


agent_tcp_port=7751





enable=true



LWST enabled=true




...


---------------------------------------









한다.


인한다.


1. SUN Application Server를 중지한다

2. SUN Application Server 8.x/9.x/10.x의 경우 관리콘솔에서 [ Application Server | JV

M Setting | JVM Setting | JVM Options ] 메뉴에서 제니퍼 에이전트 설정을 삭제하고

설정값을 저장한다.

3. SUN Application Server 7 인 경우 %SUNWAS_HOME%\domains\domain1\c

onfig\server.xml 에서 제니퍼 에이전트 설정 옵션을 삭제한다


5. SUN Application Server를 재기동 한다.

AS400에 제니퍼 에이전트 설치

12.

117

12.1 AS400 WebSphere에 제니퍼 에이전트 설치

AS400 WebSphere 에 제니퍼를 설치할 경우 6.0의 경우 버전에 따라 설치하는 방법이 상이

하며, 6.1은 일반 UNIX에 설치하는것과 동일하지만 몇가지 제약사항이 있다.

12.1.1 WebSphere 6.0 ND, Express 버전

12.1.1.1 사전 준비 작업

WebSphere 6.0은 JDK1.4를 사용하고 있어서, 아래 이상의 시스템 패치가 설치되어 있어야

만 설치가 가능하다.

V5R3M0 ( SI27807 , MF41376 )

V5R3M5 ( SI27807 , MF41469 )

V5R4M0 ( SI27808 , MF41505 )

● 해당 시스템에 아래의 두개 파일이 존재해야 한다.

/QIBM/ProdData/Java400/jt400ntv.jar

/QIBM/ProdData/Java400/jdk14/lib/instrumentation.jar

시스템 패치가 설치되어 있어야만 해당 파일들이 존재하게된다.

118 | AS400에 제니퍼 에이전트 설치

jt400ntv.jar 파일이 없을 경우 cpu모니터링이 불가능하다.


1. WebSphere 관리콘솔의 부트클래스패스에 아래와 같이 설정한다.

/QIBM/ProdData/Java400/jt400ntv.jar

/QIBM/UserData/WebSphere/jennifer40/agent/jennifer.jar

/QIBM/ProdData/Java400/jdk14/lib/instrumentation.jar

/QIBM/UserData/WebSphere/jennifer40/agent/lwst.boot.jar

2. WebSphere 관리콘솔에서 JVM 일반 옵션에 아래와 같이 설정한다.

-agentlib:QJVAIAGENT=/QIBM/UserData/WebSphere/jennifer40/agent/lwst.javaagen

t.jar

-Dos400.jvmti.force.jitc

-Djennifer.confing=/QIBM/UserData/WebSphere/jennifer40/agent/w11.conf

3. cpu 정보를 가져오기 위해 agent 설정을 한다.

sysprof=As400

4. jennifer.log 파일안에 Jennifer AS400 sysprof initialized 메세지를 확인한다.

12.1.2 WebSphere 6.1 설치


1. WebSphere 관리콘솔의 부트클래스패스에 아래와 같이 설정한다.

/QIBM/UserData/WebSphere/jennifer40/agent/lwst.boot.jar

/QIBM/UserData/WebSphere/jennifer40/agent/jennifer.boot.jar

2. WebSphere 관리콘솔에서 JVM 일반 옵션에 아래와 같이 설정한다.

AS400 WebSphere에 제니퍼 에이전트 설치 | 119

-javaagent:/QIBM/UserData/WebSphere/jennifer40/agent/lwst.javaagent.jar

-Djennifer.confing=/QIBM/UserData/WebSphere/jennifer40/agent/w11.conf

3. cpu 정보를 가져오기 위해 agent 설정을 한다.

sysprof=As400

4. jennifer.log 파일안에 Jennifer AS400 sysprof initialized 메세지를 확인한다.

12.1.3 AS400 WebSphere 모니터링 시 제약사항

● 시스템 cpu 사용율을 볼수 없다.

● 시스템 전체 메모리, 프로세스 메모리 사용율을 볼 수 없다.

● File / Socket / Collection 모니터링이 불가능 하다.

OS390 z/WAS에 제니퍼 에이전트 설치

13.

121

13.1 IBM WebSphere on ZOS 설치 가이드

일반 UNIX환경과는 설치방법이 조금 상이하다. preinstall.sh로는 설치할 수 없으며 매뉴얼

방식으로 설치해야 한다. 제니퍼 에이전트 파일들을 WebSphere가 설치된 zOS 시스템으로

복사한다.

13.1.1 LWST Build

unix나 windows환경하에서는 lwst40.sh(bat) 명령을 이용해서 lwst.jdk.jar 파일을 생성하

지만 zOS환경하에서는 shell 파일을 실행할 수 없다.

1. $WEBSPHERE_HOME/java/jre/lib/rt.jar 파일을 pc로 다운로드 받는다.

2. c:\jennifer\agent 디렉토리에서 아래의 옵션으로 lwst를 빌드한 후 생성된 lwst.jdk.j

ar파일을 업로드 한다.

lwst40.bat jdk15 rt.jar

13.1.2 wmond 실행

zOS환경하에서는 JNI를 통해서 cpu와 memory를 가져올 수 없어서 wmond를 이용하여 cp

u만을 모니터링 하도록 하고 있다.

해당 시스템의 에이전트 디렉토리에서 아래와 같이 명령어를 입력한다.

122 | OS390 z/WAS에 제니퍼 에이전트 설치

nohup ./wmond_zos_v1.1 192.168.0.139 6901 Z01 &

정상적으로 실행이되면 이퀄라이져 그래프에 두개가 나오는데 0번은 General CP

U로 일반적인 MainFrame 의 cpu이고, 1번은 zAAP CPU로 java 전용 cpu이다.

13.1.3 WebSphere 자바 옵션 설정

WebSphere 관리콘솔 에서 [ 애플리케이션 서버 선택 | 프로세스정의 | 서번트 | 자바 가상 시

스템 ] 메뉴를 선택한다.

1. 부트클래스 경로에 아래의 값을 입력한다.

/home/jennifer/agent/jennifer.boot.jar


/home/jennifer/agent/lwst.boot.jar


-Djennifer.config=/home/jennifer/agent/W11.conf


3. 해당 설정값을 저장한다.

4. 에이전트 설정파일에서 아래의 설정값을 확인한다.

using_adaptable_http_agent=true

http_agent_classpath=/home/jennifer/agent/jennifer.http.jar

제니퍼 에이전트 설치 트러블슈팅

14.

123

14.1 제니퍼 서버 구성 변경

이 절에서는 제니퍼 서버 및 에이전트가 사용하고 있는 네트워크 통신 포트 구성을 변경하는

방법에 대해 설명한다.

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

제니퍼 서버와 제니퍼 클라이언트는 웹 기반 사용자 인터페이스 제공을 위해서 HTTP 프로토

콜을 사용한다. 이 때 사용하는 기본 HTTP 포트 번호는 7900이다. 그리고 제니퍼 서버 정지를

위한 기본 포트 번호는 7999이다. 이 포트 번호를 변경하려면 $JENNIFER_HOME/server/bi

n/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

124 | 제니퍼 에이전트 설치 트러블슈팅

윈도우즈의 경우에는 catalina.bat 파일의 다음 부분에서 포트 번호를 설정한다.

set JAVA_HOME=%JAVA_HOME%

if "%STARTUP_PORT%" == "" SET STARTUP_PORT=7900

if "%SHUTDOWN_PORT%" == "" SET SHUTDOWN_PORT=7999

자바 애플릿은 차트 구성에 필요한 데이터를 제니퍼 서버로부터 TCP 통신을 통해서 획득한

다. 이 때 사용되는 제니퍼 서버의 기본 TCP 포트 번호는 제니퍼 서버의 설정파일인 jennifer.

properties파일에 아래의 옵션으로 설정한다. 기본 포트 번호는 6701이다.

server_tcp_port = 6701

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

제니퍼 에이전트는 성능 데이터를 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 옵션으로 설정한 UD

P 포트를 통해서 2초마다 반복적으로 X-View 트랜잭션 프로파일 데이터를 전송한다. 기본 포

트 번호는 6703이다.

server_udp_lwst_call_stack_port = 6703

한 서버에 복수의 제니퍼 에이전트 설치 | 125

앞에서 설명한 UDP 포트 번호를 수정할 때는 제니퍼 서버가 바인딩하고 있는 포트

에 맞게 수정해야 한다.

그리고 제니퍼 에이전트가 UDP 방식으로 보내는 성능 데이터를 제니퍼 서버가 받을 때 사

용할 IP 바인딩 주소를 지정할 필요가 있다. 이는 자바 TCP 소켓 프로그래밍에서 new java.ne

t.DatagramSocket(port, ip) 생성자의 두번째 파라미터 IP에 해당하는 값이다. 하드웨어에

둘 이상의 네트워크 카드가 있다면, 특정 네트워크 카드로 들어오는 요청만 바인딩하고자 할

때 설정한다. udp_server_host 속성을 “0.0.0.0”으로 지정하면 모든 네트워크 카드에서 들어

오는 패킷을 받을 수 있다.

udp_server_host = 0.0.0.0

14.1.3 에이전트 TCP연결 옵션

제니퍼 서버와 제니퍼 에이전트 혹은 제니퍼 클라이언트 사이에 방화벽이 존재하면, 앞에서 설

정한 포트 번호가 방화벽을 정상적으로 통과하도록 설정해야 한다.

● 사용자 컴퓨터에서 제니퍼 서버로 HTTP 7900 포트와 TCP 6701 포트를 통해서 접근할

수 있어야 한다.

● 제니퍼 에이전트에서 제니퍼 서버로 UDP 6901, 6902, 6703 포트를 통해서 접근할 수

있어야 한다.

● 제니퍼 서버에서 제니퍼 에이전트로 TCP 7750 포트를 통해서 접근할 수 있어야 한다.

UDP 네트워크에 대한 방화벽 테스트는 제니퍼 에이전트가 서버에 등록이 안된경우

를 참조한다.

14.2 한 서버에 복수의 제니퍼 에이전트 설치

제니퍼 에이전트를 설치하다보면 물리적으로 하나의 서버에 복수의 인스턴스가 존재하는 경

우가 많다. 이 경우 제니퍼 에이전트를 구성하는 방법에 대해서 기술한다. 동일한 제니퍼 서버

로 성능데이터를 전송하는것을 가정하여 기술한다. 동일한 Java 애플리케이션 서버에서 동작


하고 있는 복수의 인스턴스에 제니퍼 에이전트를 설치할 경우, 기본적으로 사전설치작업(pre-i

nstallation)은 한 번만 수행을 한다. 두 번째 부터의 설치는 기 구성된 에이전트 구성파일(예,

w11.conf)의 복사 및 수정, 그리고 해당 인스턴스에의 설정 작업으로 이루어진다. 제니퍼 에

이전트를 설치하면서 구성된 에이전트 구성파일(예, w11.conf)을 적절한 파일(예, w12.conf)

로 복사하고 해당 파일의 내용중 아래의 옵션 부분을 변경해야한다.

표 14-1 반드시 변경해야하는 옵션

옵 션 설 명




에이전트를 설치할 Java 애플리케이션 서버의 자바 옵션에 변경된 에이전트 구성파일 경로

및 라이브러리를 설정한다.

14.3 제니퍼 에이전트 설치 트러블 슈팅

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

다.

14.3.1 에이전트 설치후 웹 애플리케이션 서버가 기동이 안되는 경우

1. 제니퍼 에이전트의 설정을 웹 애플리케이션서버에 기술할 때, 오타가 자주 발생한다. 정

확하게 기술되었는지 확인한다.

2. 오타가 없이 제니퍼 에이전트의 설정이 정상적인데도 기동이 되지 않을 경우는 lwst 의

생성이 잘 못 되었을 가능성이 높다. 이 경우 lwst40.sh(bat)명령으로 lwst파일을 재생성

한다.

lwst 생성시 인스톨 대상 웹 애플리케이션 서버가 사용하고 있는 JVM의 rt.jar(Sun

JDK), core.jar(IBM JDK), vm.jar(IBM JDK), jndi.jar(IBM JDK 1.6) 파일을 기반

으로 생성이 되어야 한다.

제니퍼 에이전트 설치 트러블 슈팅 | 127

lwst생성 방법 : lwst40.sh(bat) [command option] [rt.jar(core.jar)]

WAS가 사용하는 JDK가 1.4 까지는 [commnad option] 에 safe , 1.5부터는 jdk

15 를 넣는다.

14.3.2 제니퍼 에이전트가 서버에 등록이 안된경우

1. 웹 애플리케이션서버옵션 중 [-Djennifer.config] 옵션의 설정에 오타가 없는지, 설정한

파일이 해당 위치에 존재하며, 읽기 권한이 있는지 확인한다.

2. 제니퍼 에이전트 옵션파일(예, w11.conf) 중 udp_server_host, server_udp_runtime_

port, server_udp_listen_port,server_udp_lwst_call_stack_port 의 값이 제니퍼 서버

의 설정값과 동일한지 확인한다.

3. 제니퍼 에이전트와 서버사이의 방화벽과 같은 네트워크 장비의 제약으로 인해 통신이 정

상적으로 이루어지지 못할 경우가 있다. TCP의 경우 telnet 프로그램으로 확인이 가능하

며, UDP의 경우 제니퍼 에이전트에서 제공하는 udptest.sh(bat) 유틸리티를 실행하여

제니퍼 서버의 로그에 아래와같은 메세지가 출력되는지 확인한다.

RECV(6703) from=127.0.0.1 data=100 bytes

4. 간혹 server_udp_lwst_call_stack_port 포트를 테스트 할때 마지막 인자값이 작은경우

는 성공하고, 인자값이 큰 경우에 실패하는 경우가 있다. 이 경우는 시스템 혹은 네트워크

단에서 패킷의 크기를 제한하고 있는경우다. 제니퍼 에이전트에서도 한번에 전송할 수 있

는 패킷의 사이즈를 지정할 수 있는 옵션이 있다. xview_profile_udp_packet_size 값을

줄여가면서 정상적으로 통신이 되는지 확인한다.

14.3.3 제니퍼 에이전트가 등록은 되지만 애플리케이션이 실행되지

않을 경우

WAS의 로그나 화면에 아래와 같은 메세지가 나오는 경우가 있다.


java.lang.NoClassDefFoundError:

com/javaservice/jennifer/agent/HttpServiceTrace

javax.servlet.http.HttpServlet.service(HttpServlet.java)

에이전트 설정 중 아래의 설정이 정상적인지 확인한다.

using_adaptable_http_agent=true

http_agent_classpath=c:/tmp/agent/jennifer.http.jar

14.3.4 Invalid LicenseKey 메세지가 나오는 경우

● 라이센스파일에 쓰기권한이 있는지 확인한다.

● 제니퍼 서버에서 제니퍼 에이전트로의 TCP 연결이 가능한지 확인한다.(기본설정인 경우

7750 이며, 제니퍼 에이전트 옵션은 agent_tcp_port 옵션에 등록된 포트이다).

제니퍼 에이전트에서 agent_tcp_port 옵션에 등록된 포트가 연결이 되지 않을 경

우, 장애진단, 구성관리메뉴와 실시간 액티브 서비스 리스트 화면등이 메뉴가 정상

적으로 나오지 않는다.

14.3.5 CPU / Memory 정보가 안나오는 경우

제니퍼 에이전트의 libjennifer20.so(sl) (Windows의 경우 jennifer20.dll)파일은 시스템, 자

바 프로세스의 CPU 사용률 및 메모리 사용량을 보여준다. 해당 라이브러리가 설치되지 않은

경우 시스템/메모리 관련된 성능데이터를 수집하지 못한다. 그러나 제니퍼 에이전트가 동작하

는데는 문제가 없다.

제니퍼 네이티브 라이브러리가 정상적으로 로딩되지 않았다면, 제니퍼 에이전트 로

그파일에 아래와 같은 메세지가 보인다. 이 경우 제니퍼 클라이언트 화면의 [ 장애진

단 | 유틸리티 | 시스템 환경변수 ] 메뉴에서 해당 에이전트를 선택하여, sun.boot.li

brary.path 의 값을 확인한다. 해당 디렉토리내에 테스트 완료된 libjennifer20.so

(sl) (Windows의 경우 jennifer20.dll) 파일이 복사되었는지 확인한다.

● 제니퍼 에이전트의 jni/[OS] 디렉토리에서 제니퍼 네이티브 라이브러리를 테스트할 수 있


다. 파일명을 libjennifer20.so(sl) (Windows의 경우 jennifer20.dll)로 변경하면서 test.

sh(bat) 을 실행시키고 아래와 같은 메세지가 나오는지 확인한다.


test.sh 파일 내용중 java -Djava.library.path=. 이 부분에서 java 실행파일은 반드

시 웹 애플리케이션서버가 사용중인 java 실행파일이어야 한다.

● Linux의 경우 JNI에서 currentThreadCpuTime을 가져올 수 없다. 만약 JDK1.5이상일

경우에 한해서 ThreadCpuTime을 가져올 수 있도록 아래의 옵션을 설정한다.

sysprof=ThreadCpuJava5

14.3.6 X-View 에 점이 표시되지 않는 경우

제니퍼 에이전트가 서버에 등록되어 있고, 제니퍼 서버와 에이전트간의 네트워크도 문제가 없

는데도 X-View에 점이 표시되지 않는 경우 아래의 내용을 확인한다.

● 프레임워크중 struts2 를 사용하는지 확인한다. struts2를 사용한다면, 제니퍼 에이전트

설정파일에 아래와 같이 등록한다.

http_service_class =org.apache.struts2.dispatcher.FilterDispatcher

http_service_method=doFilter

● javax.servlet.http.HttpServlet 클래스의 service 메소드를 재정의(Override)하고 있는

클래스가 존재하는지 확인한다. 이 경우에도 제니퍼 에이전트 옵션(http_service_class )

에 재정의한 클래스명을 등록한다.

14.3.7 X-View 프로파일에서 SQL이 보이지 않는 경우

JDBC 커넥션 추적설정이라 함은 java.sql.Connection 객체를 JenniferConnection 객체로

Wrapping하는것을 말한다. 제니퍼에서는 3가지의 JDBC 커넥션 추적 설정 방법을 제공한다.

1. JNDI와 javax.sql.DataSource로 추적하는 경우를 유형1이라고 하며, 제니퍼 에이전트에

특별한 설정없이 운영할수 있다.


SQL/JDBC에 대한 정보는 Servlet/JSP Thread에서의 JDBC요청만 추출된다. 만약,

Non Servlet/JSP Thread에서 발생하는 JDBC/SQL정보를 추출하려면 명시적으로

enable_non_servlet_thread_jdbc_trace = true 로 설정한다.

2. 애플리케이션에서 java.sql.DriverManager 클래스를 통해서 java.sql.Connection 객체

를 획득하는 경우를 유형 2라고 한다.

3. 애플리케이션이 커넥션 풀의 역할을 담당하는 임의의 클래스를 통해서 java.sql.Connect

ion 객체를 획득하는 경우를 유형 3이라고 한다.

JDBC 커넥션 설정 유형 2 의 경우, 애플리케이션의 소스코드에 conn = DriverManager.g

etConnection(“jdbc:apache:commons:dbcp:/poolname”); 와 같이 사용하는 경우 에이전

트의 설정 파일에 다음과 같이 설정할 필요가 있다.

user_defined_jdbc_connectionpool_prefixes=jdbc:apache:commons:dbcp

JDBC 커넥션 설정 유형 3의 경우, java.sql.Connection을 반환하는 메소드를 아래와 같은

형식으로 설정해야 한다.

jdbc_connection_get=db.DBConnectionManager.getConnection(String)

14.3.7.1 유형 3으로 설정시 유의사항

● 패키지 이름을 포함한 클래스 이름을 사용해야 한다. 단, 메소드의 파라미터는 패키지 이

름을 제외한 클래스 이름만을 사용할 수 있다.

● jdbc_connection_get 혹은 jdbc_connection_justget 옵션으로 설정한 메소드의 반환

값은 java.sql.Connection 유형이어야 한다.

● jdbc_connection_close 옵션으로 설정한 메소드의 파라미터 중에 반드시 하나는java.sq

l.Connection 유형이어야 한다. 단, 파라미터 위치는 상관이 없다.

● 모든 옵션에 세미콜론[;]을 구분자로 두개 이상의 값을 설정할 수 있다.

해당 설정을 적용할려면 Java 애플리케이션 서버(인스턴스)를 재시작 해야만 적용

된다.


14.3.7.2 프레임워크별 JDBC 설정방법

● Hibernate 사용시

jdbc_connection_justget =

org.hibernate.jdbc.ConnectionManager.getConnection()

● iBatis 사용시

jdbc_connection_get=com.ibatis.sqlmap.engine.transaction.jdbcJdbcTransaction

.getConnection()

● Apache DBCP 사용시

jdbc_connection_get =

org.apache.commons.dbcp.PoolingDataSource.getConnection()

14.3.7.3 애플리케이션 내에서 사용하는 JDBC Connection 방법을 모르는 경우

1. 에이전트 설정파일에서 lwst_trace_remote_port의 옵션에 사용하는 DB의 포토 번호를

기술하고 해당 옵션을 활성화시킨다. (맨앞의 # 를 삭제).

2. 어플리케이션 서버를 재기동한다.

3. 제니퍼 관리 콘솔 화면의 「장해 진단」→「파일/소켓」화면에 해당 포트로 접속할 시점의 스

택트레이스를 확인한다.

4. 확인된 Connection 부분을 jdbc_connection_get 혹은 jdbc_connection_justget 에

이전트 옵션에 설정한다.

14.3.7.4 X-View 프로파일에서 SQL 파라미터가 정상적으로 표시되지 않을 경우

제니퍼 에이전트와 서버의 file.encoding이 다른 경우에 제니퍼 서버가 수집한 성능데이타가

정상적으로 표시되지 않을 수 있다. 이 경우에는 명시적으로 제니퍼 서버의 기동옵션의 file.en

coding값을 제니퍼 에이전트의 server_encoding옵션으로 설정한다.


14.3.7.5 제니퍼 에이전트 설치 후 네이티브 메모리릭 발생할 경우

Sun java 1.5, 6.0 등에서 Native Memory Leak 현상이 발생하면 웹 애플리케이션서버의 자

바 실행옵션에 아래의 옵션을 추가한다.

-XX:CompileCommand=exclude,org/apache/jennifer/bcel/classfile/Attribute,read

Attribute

14.3.7.6 에이전트 설치 후 애플리케이션 쿠키정보가 유실된 경우

제니퍼 에이전트는 방문자 수와 동시단말 사용자 수를 수집하기 위해서 쿠키를 사용한다. 그런

데 사용할 수 있는 쿠키의 숫자와 크기에는 제한이 있기 때문에, 기존 자바 애플리케이션에서

많은 쿠키를 사용하고 있으면 쿠키 정보가 유실될 수가 있다. 이 경우 아래의 옵션을 적용한다.

hotfix_remote_address_for_wmonid = true

14.3.7.7 동일한 설정으로 다중프로세스에 설치할 경우

제니퍼 에이전트는 자바 프로세스 단위로 설정해야 한다. 각 자바 프로세스의 -Djennifer.con

fig 옵션을 다르게 설정해야 하기 때문이다.

그러나 일부 WAS나 자바 데몬이 동일 실행 명령에 설정된 값을 이용하여 여러 개의 다중 프

로세스를 실행하는 경우가 있다. 이 경우에는 각 자바 프로세스를 위한 서로 다른 -Djennifer.

config 옵션을 개별적으로 설정할 수 없다.

이런 다중 프로세스 환경에 제니퍼 에이전트를 설치할 때는 공통으로 사용되는 자바 실행 옵

션에 -Dconfig.auto=true를 추가로 설정한다

자세한 내용은 메뉴얼 [제니퍼 에이전트 운영관리] 부분의 [다중 프로세스에 제니퍼 설치]

부분을 참조한다.

14.3.7.8 온라인 설치 기술지원 요청

기술지원 요청 전에 제니퍼소프트 웹사이트(www.jennifersoft.com)의 [도큐멘트]나 [Q&A]

를 확인해 주십시요. 최신 매뉴얼및 각종 문서, 과거 문의에 대한 답변이 게재되어 있습니다.

본 문서의 내용에 불명확한 곳이 있을 경우및 설치와 관련된 문제가 있을시, 제니퍼소프트

기술지원팀은 무상 기술지원을 제공하고 있습니다.

설치시 문제가 발생한 경우 Java 애플리케이션 서버, DBMS, 제니퍼 서버/에이전트의기본

정보 함께 설치트러블슈팅의 결과 파일을 첨부해서 [email protected]으로 보내주십시

요.

http://www.jennifersoft.com/


참고로 제니퍼 버전 정보는 제니퍼 에이전트 디렉토리에는 있는 version.sh 명령어를 실행

시켜 얻을 수 있다.

색인

135

Documents

제니퍼 4.5 설치가이드 - JenniferSoftdocs.jennifersoft.com › installguide.pdf · | v 4.1.3.2 WebLogic자바옵션설정 4.1.3.3 WebLogic재시작및확인사항 4.1.3.4 제니퍼에이전트구성제거