jeus gui 안내서 - tmaxsoft · 2019. 4. 9. · jeus gui 툴 jeus안내서 tmax soft 13...

JEUS GUI 툴 안내서

Copyright © 2004 Tmax Soft Co., Ltd. All Rights Reserved.

Copyright Notice Copyright©2004 Tmax Soft Co., Ltd. All Rights Reserved. Tmax Soft Co., Ltd. 대한민국 서울시 강남구 대치동 946-1 글라스타워 18 층 우)135-708 Restricted Rights Legend This software and documents are made available only under the terms of the Tmax Soft License Agreement and may be used or copied only in accordance with the terms of this agreement. No part of this document may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, or optical, without the prior written permission of Tmax Soft Co., Ltd. 소프트웨어 및 문서는 오직 TmaxSoft Co., Ltd.와의 사용권 계약 하에서만 이용이 가능하며, 사용권 계약에 따라서 사용하거나 복사할 수 있습니다. 또한 이 매뉴얼에서 언급하지 않은 정보에 대해서는 보증 및 책임을 지지 않습니다. 이 매뉴얼에 대한 권리는 저작권에 보호되므로 발행자의 허가 없이 전체 또는 일부를 어떤 형식이나, 사진 녹화, 기록, 정보 저장 및 검색 시스템과 같은 그래픽이나 전자적, 기계적 수단으로 복제하거나 사용할 수 없습니다. Trademarks Tmax, WebtoB, WebT, and JEUS are registered trademarks of Tmax Soft Co., Ltd. All other product names may be trademarks of the respective companies with which they are associated. Tmax, WebtoB, WebT, JEUS 는 TmaxSoft Co., Ltd.의 등록 상표입니다. 기타 모든 제품들과 회사 이름은 각각 해당 소유주의 상표로서 참조용으로만 사용됩니다. Document info Document name: “JEUS GUI 툴 안내서” Document date: 2004-05-20 Manual release version: 2 Software Version: JEUS 4.2

JEUS GUI 툴 안내서 JEUS

Tmax Soft 3

차 례

1 소개........................................................................................................... 19

2 JEUS GUI Tool 의 개요.......................................................................... 21

2.1 소개............................................................................................... 21

2.2 Swing 기반 GUI Tool................................................................... 21

2.3 Web 기반 GUI Tool ..................................................................... 22

2.4 GUI Tool 의 디렉토리 구조와 파일 ........................................... 23

2.5 결론............................................................................................... 23

3 JManager Swing Tool............................................................................. 25

3.1 소개............................................................................................... 25

3.2 JManager 에 대한 구성 ................................................................ 25

3.2.1 소개 .................................................................................. 25

3.2.2 XML 핸들링 설정 ............................................................ 25

3.2.3 부트 옵션 설정 ................................................................ 27

3.2.4 EJB 옵션 설정................................................................... 27

3.2.5 JManager 에서의 설정...................................................... 28

3.2.6 결론 .................................................................................. 31

3.3 기본적인 JManager 사용법......................................................... 31

3.3.1 소개 .................................................................................. 31

3.3.2 JManager 의 시작.............................................................. 31

3.3.3 Mode Switching(모드전환) .............................................. 33

3.3.4 JManager 의 종료.............................................................. 34

3.4 Administration Mode .................................................................... 35

3.4.1 소개 .................................................................................. 35

JEUS JEUS GUI 툴 안내서

Tmax Soft 4

3.4.2 Administration Mode GUI................................................. 35

3.4.3 Window View 모드와 Tab View 모드 ............................. 40

3.4.4 XML 설정 편집 ................................................................ 42

3.4.5 컴포넌트 모니터링 ......................................................... 44

3.4.6 컴포넌트 컨트롤 ............................................................. 45

3.4.7 결론 .................................................................................. 46

3.5 Deployment Mode ....................................................................... 46

3.5.1 소개 .................................................................................. 46

3.5.2 Deployment GUI ............................................................... 46

3.5.3 Module 생성...................................................................... 48

3.5.4 Module 보기와 편집......................................................... 51

3.5.5 모듈 Deploy ..................................................................... 52

3.5.6 EJB 모듈 Deploy............................................................... 53

3.5.7 WEB 모듈 Deploy............................................................. 54

3.5.8 Application Client 모듈 Deploy........................................ 54

3.5.9 RAR 모듈 Deploy ............................................................. 55

3.5.10 Application 모듈 Deploy................................................. 55

3.5.11 결론 ................................................................................ 55

3.6 Analysis Mode .............................................................................. 56

3.6.1 소개 .................................................................................. 56

3.6.2 JEUS 로깅 ......................................................................... 56

3.6.3 Analysis GUI ..................................................................... 57

3.6.4 System/Error log 분석....................................................... 58

3.6.5 Access log 분석................................................................. 60

3.6.6 로깅 이벤트 핸들러 등록 ............................................... 61

3.6.7 결론 .................................................................................. 62

3.7 유틸리티....................................................................................... 62


Tmax Soft 5

3.7.1 소개 .................................................................................. 62

3.7.2 XML 에디터 ..................................................................... 63

3.7.3 FTP 유틸리티 ................................................................... 64

3.7.4 직렬화 유틸리티(Serialization Utility)........................... 66

3.7.5 Deployment Descriptor 생성 유틸리티............................ 67

3.7.6 Conversion 유틸리티........................................................ 71

3.7.7 결론 .................................................................................. 75

3.8 결론............................................................................................... 75

4 웹 기반의 WebManager Tool ................................................................ 77

4.1 소개............................................................................................... 77

4.2 WebManager 의 기본적인 사용법 .............................................. 77

4.2.1 소개 .................................................................................. 77

4.2.2 WebManager 의 사용........................................................ 77

4.2.3 WebManager 의 시작........................................................ 78

4.2.4 기본적인 메뉴 ................................................................. 81

4.2.5 WebManager 의 종료........................................................ 81

4.2.6 Web Manager 로그 ........................................................... 81

4.2.7 결론 .................................................................................. 82

4.3 WebManager 를 이용한 JEUS 관리............................................ 82

4.3.1 소개 .................................................................................. 82

4.3.2 Configuration..................................................................... 82

4.3.3 Monitoring ......................................................................... 83

4.3.4 Controlling......................................................................... 85

4.3.5 Access Control................................................................... 86

4.3.6 결론 .................................................................................. 87

4.4 WebManager 를 사용한 JEUS Deployment ................................ 87

4.4.1 소개 .................................................................................. 87


Tmax Soft 6

4.4.2 Deploy 절차 ...................................................................... 87

4.5 결론............................................................................................... 89

5 결론........................................................................................................... 91

A Deployment 유틸리티 레퍼런스 ................................................................... 93

A.1 소개............................................................................................... 93

A.2 프로그래밍 API (jeus.tool.deployment 패키지) ......................... 93

class EJBDeploymentManager ..................................................... 93

class WEBDeploymentManager................................................... 98

class AppCliDeploymentManager .............................................. 103

A.3 Command Line Deployment Tool .............................................. 104

B 유틸리티 콘솔 툴 레퍼런스 ................................................................. 107

B.1 소개............................................................................................. 107

B.2 DD 생성 유틸리티 콘솔 툴....................................................... 107

base 방식의 호출 ....................................................................... 107

package 방식의 호출 ................................................................. 108

property 방식의 호출 ................................................................. 109

B.3 Conversion 유틸리티 콘솔 툴 ................................................... 109

WebLogic 의 ‘domain’으로부터의 변환 .................................. 110

Weblogic Deployment Descriptor 와 EJB 모듈로부터의 변환 110

C tool-option.xml XML Configuration Reference................................. 113

C.1 소개............................................................................................. 113

C.2 DTD/XML Tree .......................................................................... 114

C.3 Element Reference ...................................................................... 114

C.4 tool-option.xml 의 샘플.............................................................. 119

D Monitoring API 레퍼런스 .................................................................... 121

D.1 소개............................................................................................. 121

D.2 package jeus.tool.monitorapi ...................................................... 121

Class JeusMonitorFactory........................................................... 121


Tmax Soft 7

D.3 package jeus.tool.monitorapi.monitorinfo .................................. 123

Class ClusterMonitorInfo............................................................ 123

Class EJBEngineMonitorInfo ..................................................... 124

Class EngineContainerMonitorInfo ............................................ 125

Class GroupMonitorInfo............................................................. 130

Class JMSEngineMonitorInfo .................................................... 131

Class NodeMonitorInfo .............................................................. 133

Class ServletEngineMonitorInfo ................................................ 137

D.4 package jeus.tool.monitorapi.exceptions .................................... 140

Class MonitorException.............................................................. 140

색 인................................................................................................................... 141


Tmax Soft 8

그림 목차

그림 1. GUI Tool 의 디렉토리 구조. .............................................................................. 23

그림 2. XML 옵션 메뉴................................................................................................... 28

그림 3. XML 옵션 다이얼로그....................................................................................... 29

그림 4. 부트 옵션 메뉴.................................................................................................... 29

그림 5. 부트 옵션 다이얼로그........................................................................................ 30

그림 6. EJB 옵션 메뉴. .................................................................................................... 30

그림 7.부트 옵션 다이얼로그......................................................................................... 31

그림 8. JManager login 다이얼로그................................................................................ 32

그림 9. JManager 초기화면. ............................................................................................ 33

그림 10. JManager 의 모드 선택 메뉴. ........................................................................... 34

그림 11. JManager 의 Administration Mode. .................................................................. 35

그림 12. Tab view 모드.................................................................................................... 41

그림 13. Information Window 화면의 Layout................................................................. 42

그림 14. Information Window 설정 탭의 설명과 설정을 저장하는 버튼. ................... 43

그림 15. 작성할 설정 파일을 선택하는 Admin Config 메뉴. ..................................... 43

그림 16. Information Window Panel 의 모니터링 탭의 설명과 설정을 저장하는 버튼.

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

그림 17. System tree 안의 컴포넌트에 대한 마우스 오른쪽 버튼을 클릭했을 때의

명령들....................................................................................................................... 45

그림 18. Deployment Information Window Panel 에 2 개의 묘듈을 열어놓은 화면. . 47

그림 19. JManager 의 새로운 모듈을 생성하는 첫 번째 다이얼로그. ........................ 49

그림 20.파일 컨텐츠 선택 다이얼로그.......................................................................... 49


Tmax Soft 9

그림 21. EJB 모듈의 Deployment descriptor 페이지. .................................................... 51

그림 22. 저장 버튼과 모듈 정보..................................................................................... 52

그림 23. JManager 의 Analysis Mode............................................................................. 58

그림 24. System/Error 로그 분석에 대한 rule 세팅 다이얼로그. ................................ 59

그림 25. Information Window 에 System/Error log 분석의 결과화면. ........................ 60

그림 26. Access log 분석을 위한 Analysis Rule Setting 다이얼로그. .......................... 60

그림 27. Information Window 에 나타난 Access log 분석에 대한 결과. ..................... 61

그림 28. 로깅 이벤트 헨들러 등록 창............................................................................ 62

그림 29. XML Edit 메뉴와 Admin Config 메뉴의 하위 메뉴. ...................................... 63

그림 30. JEUSMain.xml 에 대한 XML 편집 다이얼로그. ............................................ 64

그림 31. FTP 유틸리티 메뉴........................................................................................... 65

그림 32. FTP 다이얼로그................................................................................................ 65

그림 33. Serialization 다이얼로그. ................................................................................. 66

그림 34. Deployment Descriptor 생성 다이얼로그. ....................................................... 67

그림 35. 예제 EJB 클래스의 디렉토리. ......................................................................... 68

그림 36. Deployment Descriptor 를 생성하는 첫 번째 화면 ......................................... 69

그림 37. Deployment Descriptor 생성을 하는 두 번째 예제 페이지. ........................... 70

그림 38. Deployment descriptor 생성의 세 번째 페이지............................................... 71

그림 39. Conversion 유틸리티의 첫 번째 페이지. ........................................................ 72

그림 40. Conversion 유틸리티의 두 번째 페이지인 EJB 모듈 변환페이지. .............. 73

그림 41. EJB Module Conversion 유틸리티의 Pre-Deployment 옵션 설정 페이지... 74

그림 42. Domain Conversion 의 실행 페이지. ............................................................... 75

그림 43.JManager 에서의 WebManager 기능 선택 ....................................................... 78

그림 44. WebManager 의 로그인 페이지. ...................................................................... 79

그림 45. Tmax Soft 의 전자 서명을 신뢰할 지 여부를 묻는 대화상자....................... 80

그림 46. WebManager 초기 페이지 ................................................................................ 80

그림 47. WebManager 를 사용한 JEUS node 설정 화면. ............................................. 83


Tmax Soft 10

그림 48. WebManager 의 모니터링 페이지에 대한 Repeat 버튼 설명........................ 84

그림 49. Engine 의 Status Table 화면. ............................................................................ 85

그림 50. WebManager 의 EJB Engine 컨트롤 화면. ...................................................... 86

그림 51. WebManager 의 deployment 페이지 ............................................................... 88


Tmax Soft 11


Tmax Soft 12

표 목차

표 1. System tree 의 컴포넌트와 노드. ........................................................................... 36

표 2. Deployment tree 의 각 모듈에 대한 아이콘. ......................................................... 48


Tmax Soft 13

매뉴얼에 대해서

매뉴얼의 대상 본 매뉴얼은 GUI Tool 을 이용해서 JEUS 에 대해 상호 작용을 원하는 사용자

를 위해 만들었다. 본 매뉴얼은 JEUS 관리자와 Deployer 에게 특별히 유용하

다. 또한 관리와 Deployment 를 위한 도움이 되는 몇몇 기능들에 대한 정보를 찾을 수 있다.

매뉴얼의 전제 조건 본 매뉴얼을 사용하기 전에 반드시 JEUS 소개 뿐 아니라 JEUS Server 안내서

의 내용에 대한 지식이 있어야 한다. 본 매뉴얼을 읽기에 앞서 JEUS Server 안내서를 읽을 것을 권한다. 그리고, JEUS Server 안내서를 포함한 기타 다른 매뉴얼을 읽으면서 본 매뉴얼을 참조할 수 있다.

매뉴얼 구성 시스템을 관리하는 가장 편리한 방법을 제공하는 GUI Tool 에 대하여 알아

야 한다.

비록 GUI 를 사용하는 구체적인 방법이 각 매뉴얼에 상세하게 설명이 될지

라도, 당신은 GUI Tool 의 일반적인 사용에 대한 지식이 필요할 것이다.

본 매뉴얼은 첫째, 관리자와 Deployer 를 위해 GUI 그 자체의 일반적인 개요

를 제공한다. 또한, GUI Tool 에 대한 참조 안내자로서 매뉴얼을 사용할 수 있다.

이 매뉴얼은 5 개의 장과 3 개의 부록으로 되어 있다.

1. 소개: 인사말과 개요.

2. JEUS GUI Tool 의 개요: JEUS 웹 모듈의 기본 개념들과 요소.


Tmax Soft 14

3. JManager Swing Tool: Java 어플리케이션 GUI Tool 인 JManager 를 설명한다.

4. WebManager Web-based Tool: 웹 브라우저로 접근할 수 있는 GUI Tool 인 WebManager 를 설명한다.

5. 결론.

부록

A. Deployment Utility Reference: JEUS 와 Command Line Deployment Tool 의 Deployment API 를 설명한다.

B. Utility Console Tool Reference: Console Tool 유틸리티에 대한 설명을 한다.

C. tool-option.xml XML Configuration Reference: GUI Tool 의 tool-option.xml 에 대한 설명을 한다.

관련 매뉴얼 본 매뉴얼은 GUI Tool 사용자에게 도움을 줄 것이다. 다음의 매뉴얼을 읽으

면서 본 매뉴얼을 참조할 수 있다.

• JEUS Server 안내서

• JEUS Web Container 안내서

• JEUS EJB 안내서

• JEUS JMS 안내서

• JEUS Client Application 안내서

일러두기

표기 예 내용

텍스트 본문, 12 포인트, 바탕체 Times New Roman


Tmax Soft 15

표기 예 내용

Roman

텍스트 본문 강조

CTRL+C Ctrl 과 C 를 동시에 누름

public class myClass { } Java 코드

<system-config> XML 문서

참고: / 주의: 참고 사항과 주의할 사항

Configuration 메뉴를 연다 GUI 의버튼과 같은 컴포넌트

JEUS_HOME JEUS 가 실제로 설치된 디렉토리

jeusadmin nodename 콘솔 명령어와 문법

[ 파라미터 ] 옵션 파라미터

< xyz > ‘<’와 ‘>’ 사이의 내용이 실제 값으로 변경됨

| 선택사항

… 파라미터 등이 반복 되어서 나옴

?, +, * 보통 XML 문서에 각각 “없거나, 한 번”, “한 번 이상”,”없거나 여러 번”을 나타낸다.

. . . XML 이나 코드 등의 생략


Tmax Soft 16

표기 예 내용

<<FileName.ext>> 코드의 파일명

그림 1. 그림 이름이나 표 이름

OS에 대해서 본 문서에서는 모든 예제와 환경 설정을 Microsoft Windows™의 스타일을 따랐다. 유닉스같이 다른 환경에서 작업하는 사람은 몇 가지 사항만 고려하

면 별무리 없이 사용할 수 있다. 대표적인 것이 디렉토리의 구분자인데, Windows 스타일인 “\”를 유닉스 스타일인 “/”로 바꿔서 사용하면 무리가 없다. 이외에 환경 변수도 유닉스 스타일로 변경해서 사용하면 된다.

그러나 Java 표준을 고려해서 문서를 작성했기 때문에, 대부분의 내용은 동일하게 적용된다.

용어 설명 다음에 소개되는 용어는 본 문서 전체에 걸쳐서 사용되는 용어이다. 용어가 이해하기 어렵거나 명확하지 않을 때는 아래 정의를 참조하기 바란다.

Term Definition

JEUS DD JEUS Deployment Descriptor 의 약어.

JManager JEUS 의 Java 어플리케이션 GUI Tool.

Module DD J2EE Specific Deployment Descriptor 의 약어

WebManager JEUS 의 웹 기반 GUI Tool.


Tmax Soft 17

연락처 Korea Tmax Soft Co., Ltd 18F Glass Tower, 946-1, Daechi-Dong, Kangnam-Gu, Seoul 135-708 South Korea Tel: 82-2-6288-2114 Fax: 82-2-6288-2115 Email: [email protected] Web (Korean): http://www.tmax.co.kr USA Tmax Soft, Inc. 560 Sylvan Ave, Englewood Cliffs NJ 07632 USA Tel: 1-201-567-8266 FAX: 1-201-567-7339 Email: [email protected] Web (English): http://www.tmaxsoft.com Japan Tmax Soft Japan Co., Ltd. 6-7 Sanbancho, Chiyoda-ku, Tokyo 102-0075 Japan Tel: 81-3-5210-9270 FAX: 81-3-5210-9277 Email: [email protected] Web (Japanese): http://www.tmaxsoft.co.jp China Beijing Silver Tower, RM 1507, 2# North Rd Dong San Huan, Chaoyang District, Beijing, China, 100027 Tel: 86-10-6410-6148 Fax: 86-10-6410-6144 E-mail : [email protected] Web (Chinese): http://www.tmaxchina.com.cn


Tmax Soft 18


Tmax Soft 19

1 소개

JEUS GUI Tool 은 사용자가 JEUS 를 통해서 상호 작용할 수 있는 가장 쉬운 방법 중 하나이다. 비록 Command Line 에서 제공하는 툴이 있기는 하지만 모듈에 비해 제공하는 기능이 제한적이다. GUI Tool 은 JEUS 의 모든 모듈에 대한 포괄적인 관리 기능을 제공한다. 우선 종합적인 시스템을 관리할 수 있는 통합된 인터페이스를 제공한다. 그것은 각 구성요소의 상태를 실시간으

로 나타내준다. 또한 각 컴포넌트에 대한 모니터링과 컨트롤을 할 수 있다.

여기서는 JEUS 의 GUI Tool 에 대해서 알아본다. JEUS 가 제공하는 GUI Tool은 두 가지가 있는데, JManager Tool 과 WebManager Tool 이 그것이다. 우선 두 가지의 GUI Tool 에 대한 일반적인 개요를 설명한다. GUI Tool 의 각각의 아이콘에 대한 기능들도 물론 설명한다. GUI Tool 의 XML 구성에 대한 유용

한 기능과 부록들에 대한 설명을 끝으로 설명을 마칠 것이다.


Tmax Soft 20


Tmax Soft 21

2 JEUS GUI Tool의 개요

2.1 소개 JEUS 는 JManager 와 WebManager 를 제공한다. JManager 는 Java 어플리케이

션으로 구현된 GUI Tool 이며, JEUS 를 운영하기 위한 모든 기능을 가지고 있다. JManager 의 기능은 관리, Deployment, 분석, 이 세가지로 분류된다.

JManager 는 모든 컴포넌트의 상태를 시각적으로 모니터링할 수 있고, 시스

템에 대한 관리를 가능하게 해준다. 또한 편리하게 어플리케이션을 Deployment 할 수 있는 기능을 제공해주며, 분석 기능을 사용함으로써 모듈

들에 대한 모든 정보를 분석할 수 있다.

어떠한 상황에서는 웹을 이용해서 시스템을 조작하고자 할 때가 있다. WebManager 는 웹을 바탕으로 한 GUI Tool 로서, 기본적으로 JSP 와 Servlet 어플리케이션을 다룰 수 있고, 웹 브라우저를 사용해서 JEUS 를 연결하고 제어할 수 있다. WebManager 는 JManager 와 비슷한 기능을 제공하며, 다른 점은 Deployment 와 분석에 대한 관리를 위한 기능의 차이다.

이번 절에서는 각 GUI Tool 에 대한 구조와 기능을 포함한 일반적인 설명을 한다.

2.2 Swing 기반 GUI Tool JEUS 는 ‘JManager’라고 불리는 Swing 기반의 GUI Tool 을 제공한다. 이것은 JEUS 의 여러 가지 기능들을 제공하며 주요 기능들을 나열하자면 아래와 같다.

• 관리기능: JEUS 의 각 컴포넌트를 모니터링, 제어, 설정할 수 있다. 시각적인 System tree 로써 JEUS 의 전체적인 조직 구성을 보여준다. 또한 Panel 에는 설정 값과 모니터링 상태가 구성되어 있고, 각 컴포넌트

의 상세한 정보를 볼 수 있다. 각 컴포넌트를 제어하는 것 또한 System tree 를 통해 수행된다.


Tmax Soft 22

• Deployment 기능: JManager 는 다양한 J2EE Module 을 편리하게 Deploy 하는 기능을 제공한다. 툴의 다이얼로그 명령을 따라 하면, JEUS 에서 J2EE Module 을 생성, 수정, Deployment 를 쉽게 할 수 있다. 특히 JManager 는 사용자에게 J2EE Module 의 모든 형태의 Deployment Descriptor 를 생성할 수 있다. Deployment Descriptor 를 직접 만들어야 한다면 상당한 시간과 노력이 필요하다.

• 분석 기능: JEUS 의 동작에 대한 분석 기능을 제공한다. JEUS 의 각 컴포넌트의 활동에 대한 로그는 system log, user log, error log 로 구분되

어 있고, 이 로그들은 연대순으로 이름이 지어져 있으며 로그를 추적

하기가 복잡할 수도 있다. JManager 의 분석 기능은 이런 복잡한 작업

을 능률적으로 할 수 있게 해준다.

JManager 는 주요 기능별로 분리된 인터페이스를 제공한다. 이 인터페이스

는 현재 작업 중인 주기능 나타내 준다. 예를 들어 툴이 관리에 대한 인터페

이스를 보여준다면 현재가 관리 모드임을 나타낸다. 모드 변경에 대한 내용

은 3 장에서 설명한다.

이외에 관리자와 Deployer 를 위해 몇 가지 편리한 유틸리티를 제공한다. 이 유틸리티를 사용하면, 파일을 JEUS 시스템 디렉토리로 파일을 옮기거나, XML 설정의 직렬화된 객체를 생성할 수 있다. Deployment Descriptor 생성 툴을 사용하면 Deployer 가 쉽게 Deployment Descriptor(이하 DD)를 생성할 수 있다. 자세한 내용은 3.7 절에서 설명한다.

2.3 Web 기반 GUI Tool JEUS 는 ‘WebManager’라고 하는 또 다른 GUI Tool 을 제공한다. 이것은 JEUS 에서 동작하는 JSP 와 Servlet 어플리케이션이다. WebManager 는 System tree 를 제공하는데 JManager 가 제공하는 System tree 와 동일하다.

사용자가 System tree 를 사용하면 각 구성요소의 정보가 보여진다. 그러나 JManager 와 비교 해서 Deployment 기능에 다소 제한이 있다. Deploy 를 하려

면 DD(Deployment Descriptor) 파일을 미리 만들어 놓아야 한다. 그리고, WebManager 에서는 로그 분석 기능도 제공하지 않는다. 4 장에서 WebManager 에 대한 좀 더 자세한 사항을 다룰 것이다.


Tmax Soft 23

2.4 GUI Tool의 디렉토리 구조와 파일 GUI Tool 에 대한 디렉토리 구조는 아래 그림과 같다 [그림 1].

01 jmanager

JEUS_HOME\

config\

X tool-option.xml

Legend:0I: binary or executable fileX: XML documentJ: JAR fileT: Text file

T tool-option.dtd

dtds\

bin\

그림 1. GUI Tool 의 디렉토리 구조.

GUI Tool 은 자신의 설정 사항을 저장하기 위한 파일을 하나 가지고 있다. 그 파일은 JEUS_HOME\config 에 위치한 tool-option.xml 파일이다. 여기에는 XML 파싱이나 GUI 옵션과 같은, 툴의 일반적인 정보가 저장된다. 설정 파일

에 대해서는 3.2 절에서 더 자세히 설명한다. Swing 기반의 툴 인 JManager 는 JEUS_HOME/bin 디렉토리 밑에 실행파일인 ‘jmanager’에 의해서 실행된다.

2.5 결론 JEUS GUI 툴은 JManager 와 WebManager 가 있는데 JEUS 를 운영하는데 매우 편리한 방법을 제공한다. 기능은 Administration, Deployment 그리고, Analysis 의 세가지 형태로 분류 된다. 이 툴을 사용함으로써 JEUS 의 보다 많은 장점을 경험할 수 있을 것이다. 다음 장에서는 툴에 대한 상세한 설명을 한다.


Tmax Soft 24


Tmax Soft 25

3 JManager Swing Tool

3.1 소개 JManager 는 JEUS 가 제공하는 대부분의 주요 기능을 제공하는 GUI Tool이다. 이것은 관리자, Deployer, 그리고 어플리케이션 개발자들을 위해 많은 편리한 기능을 제공한다. 이 장에서는 JManager 에 대한 기본적인 설정, 작동 그리고, 세 가지 운영방식에 대해 배울 것이다. 대략적인 운영 방식을 배우면, 자신의 목적에 맞는 툴의 사용법을 곧 알 수 있을 것이다. 또한 툴을 구성한 각각의 아이콘들과 버튼에 대해서 설명을 한다. 이외에 유용한 기능들에 대한 설명은 마지막에 설명을 한다.

다음절에서는 기본적인 구성에 대해서 설명을 한다.

3.2 JManager에 대한 구성 3.2.1 소개

GUI Tool 은 그 자신의 최신 상태를 저장하는 설정 파일을 가지고 있다. 이

파일은 주로 XML 에 관련된 항목들과 GUI 고유 항목에 대한 정보를 관리한

다. 이 설정은 GUI Tool 의 동작 뿐만 아니라 XML 파싱에도 영향을 미친다.

이 장에서는 툴에 대한 설정을 관리 하는 방법을 설명한다. 내용을 XML

핸들링과 툴 옵션으로 구분해서 설명한다.

3.2.2 XML 핸들링 설정

GUI Tool 의 주요 일 중 하나는 JEUS 의 모든 컴포넌트의 설정을 다루는 것이다. 모든 설정들은 XML 포맷으로 저장이 되며, XML 설정을 파싱하고 생성하는 것은 GUI Tool 의 주요한 기능이다.

XML 을 파싱하는 방법은 여러 가지가 있다. 가끔 파싱을 할 때 Validation 을 하고 싶지 않을 때가 있다. 또 특정 DTD 에 대한 Validation 을 위해 경로를 지정할 수도 있다. 이런 사용자의 성향에 맞춰 XML 처리 방식을 커스터마이징

하기 위해서 설정 파일을 제공한다.


Tmax Soft 26

이 설정 파일은 이름이 tool-option.xml 이며, JEUS_HOME\config 디렉토리 아래에 위치한다. tool-option.xml 파일은 GUI Tool 이 XML 구문 해석과 구조

를 어떻게 다룰 것인지에 대한 정보를 포함한다. <xml-option> 태그는 다음

의 항목들로 구성되어 있다.

• Enable Validation: 파싱하려는 XML 을 DTD 정보에 의해서 Validation 실시할 지 여부를 설정한다. Validation 을 위한 DTD 파일은 XML 안에 지정한 DTD 파일을 사용하거나 JEUS_HOME\config \dtds\디렉토리에 있는 DTD 파일을 사용한다. 이 사항은 ‘Local DTD Validation’ 옵션에서 선택을 한다.

• local DTD Validation: 위에서 언급 했듯이 Validation 을 할 때, JEUS_HOME\config\dtds 에 있는 로컬 DTD 파일을 사용할 것인지 지정한다. 로컬 Validation 을 사용하도록 권장한다. 로컬 DTD 파일은 JEUS 를 설치할 때 위치가 지정되므로, 여러 XML 설정 파일에 지정

된 DTD 경로의 일관성을 확인하지 않아도 되기 때문이다.

• ignoring element order: 기본적인 Validation 정책은 DTD 파일에 따라

서 태그의 순서를 확인 하는 것이다. 이런 세밀한 Validation 을 원할 수 있지만 이런 Validation 을 생략하는 옵션이 없다면 너무 불편할 수도 있다. JEUS 는 이 옵션 사용해서 이런 Validation 을 생략할 수 있다.

• default value: GUI 툴이 XML 파일을 만들 때, 기본값들은 파일에 기록하지 않는다. 만약 XML 설정 파일에 모든 값들이 나오도록 하기 원한다면, <show-default> 태그 값을 true 로 설정한다.

• DTD path: 기본적으로 GUI Tool 이 XML 파일을 생성할 때, DOCTYPE 에 지정된 DTD 경로를 보존한다. 그러나 <force-default-dtd> 태그가 true 이면 <default-dtd-dir>의 값으로 DTD 경로로 갱신된

다.

아래는 ‘tool-option.xml’의 <xml-option> 이 어떻게 사용되는지를 보여준다. 다음의 예는 기본값으로 구성되었다.

<<tool-option.xml>> <tool-option> <xml-option> <xml-parsing> <enable-validation>true</enable-validation> <local-dtd-validation>true</local-dtd-validation>


Tmax Soft 27

<ignore-element-order>true</ignore-element-order> </xml-parsing>

<xml-writing> <show-default>false</show-default> <force-default-dtd>false</force-default-dtd> <default-dtd-dir> http://www.tmaxsoft.com/jeus/dtd/4.0/ </default-dtd-dir> </xml-writing> </xml-option> </tool-option>

부록 B 에서 각 태그의 상세한 정보를 볼 수 있다.

참고: 만약 GUI 툴의 설정을 바꾸고, 그 변경사항을 바로 보려면 GUI 툴의 메뉴를 통해서 갱신해야 된다. 이 메뉴는 “Option Label” 아래 “XML Option Label”이다. 만일 직접 tool-option.xml 파일을 수정했다면 GUI 툴을 재기동 시켜야 한다.

참고: 특히, 노드 내의 모든 XML 파싱 동작은 XML parsing 이라는 설정에 의해서 적용이 된다. 예를 들어 JEUS 의 부팅에 의해 JEUSMain.xml 이 파싱 될 때 파싱의 동작은 tool-option.xml 의 설정에 의해서 결정된다.

3.2.3 부트 옵션 설정

GUI Tool 로 부트방식을 설정할 수 있다. 기본적으로, GUI Tool 은 동적인 옵션이 없이 XML 방식으로 노드들을 부팅한다. 사용자는 tool-option.xml 의 <boot-option> 설정을 함으로써 JEUS 의 부트 형식을 바꿀 수 있다. 또한 GUI Tool 의 메뉴를 통해서 변경할 수도 있다. 다음의 설정은 부트 옵션을 정의한 ‘tool-option.xml’의 일부분이다.

<<tool-option.xml>> <tool-option> <boot-option> <dynamic>false</dynamic> <xml-boot>true</xml-boot> </boot-option> </tool-option>

3.2.4 EJB 옵션 설정

EJB 에 관한 툴의 동작을 설정을 할 수 있다.


Tmax Soft 28

• fast reload 옵션을 사용 할 때 EJB 모듈에 Reload 명령이 가해지면 모든 EJB 파일들이 다시 컴파일 되지 않도록 해줌으로써 Reloading 을 빠르게 실행시킬 수 있도록 해준다.

예:

<tool-option> <ejb-option> <fast-reload>true</fast-reload> </ejb-option> </tool-option>

3.2.5 JManager에서의 설정

Java 어플리케이션 GUI 툴인 JManager 는 나중에 설명한다. 그러나 우선 JManager 에서 어떻게 XML 핸들링, boot 옵션, EJB 옵션을 변경할 수 있는지 간단히 알아보자.

1. 명령 프롬프트에 ‘jmanager’를 입력을 하여 JManager 를 시작 한다.

2. Option 메뉴를 클릭 한다.

3. Option 의 하위 메뉴인 XML Option 을 클릭한다[그림 2].

그림 2. XML 옵션 메뉴.


Tmax Soft 29

4. XML Option 다이얼로그 창이 뜬다[그림 3]. 선택 항목들을 선택해서 XML 핸들링을 설정할 수 있다.

그림 3. XML 옵션 다이얼로그.

5. GUI Tool 의 작동과 동시에 tool-option.xml 이 갱신되는 것을 볼 수 있다.

다음은 간단하게 JManager 의 부트방식을 변경하기 위한 설정을 바꿔 주는 방법이다.

1. JManager 를 시작한다.

2. Option 메뉴를 클릭한다.

3. Option 메뉴의 하위 메뉴인 Boot Option 을 클릭한다[그림 4].

그림 4. 부트 옵션 메뉴.


Tmax Soft 30

4. Boot Option 다이얼로그 창이 뜨면 옵션을 선택하고, OK 버튼을 클릭

한다[그림 5].

그림 5. 부트 옵션 다이얼로그.

5. GUI 툴의 작동과 동시에 tool-option.xml 의 갱신되는 것을 볼 수 있다.

다음은 간단하게 JManager 의 EJB 옵션을 변경하기 위한 설정을 바꿔주는 방법이다.

1. JManager 를 시작한다.

2. Option 메뉴를 클릭한다.

3. Option 메뉴의 하위 메뉴인 EJB Option 클릭한다 [그림 6].

그림 6. EJB 옵션 메뉴.


Tmax Soft 31

4. EJB Option 다이얼로그가 팝업하면 옵션을 설정하고 OK 버튼을 클릭한다[그림 7].

그림 7.부트 옵션 다이얼로그.

5. GUI 툴의 작동과 동시에 tool-option.xml 이 갱신되는 것을 볼 수 있다.

3.2.6 결론

지금까지 GUI Tool 자체의 설정에 대한 방법을 알아 보았다. GUI 툴에서 XML 헨들링과 Boot Mode 를 변경할 수 있다. 다음 절에서는 기본적인 사용 방법에 대해서 설명을 한다.

3.3 기본적인 JManager 사용법 3.3.1 소개

이 절에서는 JManager 의 시작과 정지와 같은 기본적인 동작에 대해서 알아

본다. 그리고 JManager 의 ‘mode switching’(모드전환)에 대해서 설명을 한다.

3.3.2 JManager의 시작

JManager 는 ‘jmanager’라고 하는 명령 스크립트를 호출해서 시작한다. 만약

에 작업하는 운영체제 환경이 MS Windows 라면 시작 메뉴에서도 시작할 수 있다.

JManager 가 시작이 되면 다음 그림처럼 노드 명과 로그인 명 그리고, 패스

워드를 입력하는 화면이 뜬다[그림 8].


Tmax Soft 32

그림 8. JManager login 다이얼로그.

입력한 로그인 명은 ‘system’ 롤을 가지고 있어야만 로그 인할 수 있다. 로컬

노드에 접근할 때는 JEUS Manager(jeus 스크립트로 실행)가 동작하고 있지 않아도 JManager 를 시작할 수 있다 (JEUS Server 안내서 참조).

반면에 로컬 노드가 아닌 원격 노드라면 JManager 를 시작하기 전에 JEUS Manager 가 실행되어 있어야만 한다. 만약 JEUS Manager 를 실행하지 않고 JManager 를 실행하였다면 단순히 노드 내에서 로컬 파일을 수정하는 것만 가능하다.

JManager 를 사용하여 원격 노드들을 관리하기 위해서는 타깃 노드에 JEUS Manager 가 확실히 동작하고 있어야 한다.

로그 인이 성공하면 다음 그림과 같이 JManager 의 초기 화면을 볼 수 있다

[그림 9].


Tmax Soft 33

그림 9. JManager 초기화면.

3.3.3 Mode Switching(모드전환)

여기서는 각 모드에 대한 전환을 빠르고 쉽게 변경하는 기능에 대해서 설명

을 한다.

JManager 의 초기화면에서는 왼쪽 위 부분에 1 개의 버튼과 1 개의 콤보박스

를 볼 수 있다. 콤보박스는 3 개의 아이템으로 구성되는데 ‘Admin’, ‘Deployment’, ‘Analysis’로 구성된다. 각각은 JManager 가 제공하는 3 가지 모드에 대응된다.


Tmax Soft 34

그림 10. JManager 의 모드 선택 메뉴.

이름에 따라 분류를 하자면, 먼저 Admin Mode 는 JEUS 의 모든 컴포넌트들

을 관리 한다. 각 컴포넌트를 구성하고 제어하는 것에 대한 모니터링을 가능

하게 해준다.

Deployment Mode 는 JAR, WAR, EAR, RAR 와 같은 J2EE 모듈을 관리하도

록 도와준다. 모듈을 생성, 수정이 가능하며 JEUS 에 그 모듈들을 Deploy 할 수 있다

Analysis Mode 는 사용자가 access log, error log 그리고, system log 를 포함하

여 JEUS 의 여러 가지 로그들을 분석하는 것을 가능하게 한다.

참고: JManager 의 초기 화면이 기본값으로 Admin Mode 로 나타나는데, 이것

은 실제적인 Admin Mode 가 아니고 아무런 방식이 결정되지 않은 상태이다. JManager 를 시작하고 나서 항상 선택을 해줘야만 한다.

3.3.4 JManager의 종료

JManager 를 종료 할 때는 반드시 File 메뉴의 Exit 를 클릭한다던가 화면의 오른쪽 윗부분의 윈도우를 닫는 아이콘을 클릭해서 종료하는 방법이 있는데, 이 두 가지 방법을 권장 한다. JManager 를 구동시킨 콘솔 창에서 Ctrl+C 를 누른다던가 하는 방법으로 종료하는 것은 올바른 방법이 아니다. JManager를 올바르게 종료를 하지 않는다면, 임시파일을 삭제 하는 등의 마무리 작업

이 수행되지 않을 수 있다.


Tmax Soft 35

3.4 Administration Mode 3.4.1 소개

JEUS 의 각 컴포넌트를 모니터링하고 제어하기 위해서는 Administration Mode 를 사용해야만 한다.

Administration Mode 는 JEUS 에 대한 관리에 중점을 둔 JManager 의 관리방

식 이다. 이 절에서 JEUS 에 대한 관리를 목적으로 JManager 를 조작하는 방법을 설명한다.

3.4.2 Administration Mode GUI

Administration Mode 에 대한 GUI 는 크게 두 가지로 나뉜다. 하나는 System tree 부분으로서 화면의 왼쪽 Panel 을 말하고, 다른 하나는 Information Window 부분으로 화면의 오른쪽 Panel 을 말한다. 다음 [그림 11]은 Administration Mode 에 대한 그림이다. 아래 그림의 System tree 는 계층적으

로 모든 컴포넌트를 나타내고, 왼쪽 Panel 에 위치한다.

그림 11. JManager 의 Administration Mode.


Tmax Soft 36

System tree 의 각 컴포넌트는 특정 아이콘으로 표시가 되며, 그들의 상태는 아이콘의 색이 변함으로써 구분이 된다. 각 컴포넌트에 대한 정보는 다음 표에서 설명한다 [표 1].

표 1. System tree 의 컴포넌트와 노드.

Component Icon Detail

System 가장 상위의 컴포넌트로서 하위에 노드들

과 Security 컴포넌트가 있다.

Node / JEUS 를 구성하는 물리적인 호스트를 표

시하는 아이콘이며 이 아이콘 위에서 마우

스 오른쪽 버튼을 클릭함으로써 Boot, Down, Exit, Bind DataSoruce 명령을 수행할

수 있다. 하위 컴포넌트에는 Engine

Group 이 있다. 자세한 사항은 JEUS Server 안내서를 참조 하기 바란다.

Engine Group / 하위 노드인 Engine Container 들의 상태에

따라서 이 노드의 상태가 결정이 되며, 색

상이 Color 일 땐 활성화 되어있는 상태이

고, Gray 일 땐 비활성화 된 상태이다. 이

노드는 Engine Container 라는 하위 노드를

가진다. 더 자세한 사항은 JEUS Server 안내서를 참조 하기 바란다.

Engine Container / 하나 또는 여러 개의 Engine 들을 모아서

관리 하도록 하는 노드 이다. 이 노드 또한

활성과 비활성의 두 가지 아이콘을 가지고

있다. 이 노드의 하위 노드에는 Engine 들

과 DBConnection Pool 을 가진다. 자세한

사항은 JEUS Server 안내서를 참조하기 바

란다.


Tmax Soft 37


EJB Engine / Enterprise Java Beans 컴포넌트들의 실행을

책임지는 EJB Engine 을 표시한다. 아이

콘 위에서 마우스 오른쪽 버튼을 클릭함으

로써 Engine 을 시작 하거나 종료를 할 수

있다. 하위 노드에는 EJB 모듈이 있다. 자

세한 사항은 JEUS EJB 안내서를 참조 하

기 바란다.

Servlet Engine / Servlet Engine 을 표시하며 Servlet 과 JSP페이지를 취급하는데 책임을 진다. 아이콘

위에서 마우스 오른쪽 버튼을 클릭함으로

써 Engine 을 시작 하거나 종료를 할 수

있다. 하위 노드에는 Context group 과 DB connection pool 이 있다. 자세한 사항은

JEUS Web Container 안내서를 참조하기 바

란다.

JMS Engine / JMS Engine 을 표시하며 메시지 서비스를

취급한다. 이 노드는 하위 노드로 client, destination, connection factory, server session pool factory 그리고, durable subscriber 를 가

지고 있다. 자세한 사항은 JEUS JMS 안내

서를 참조 하기 바란다.

WS Engine / 실제로 JEUS 에 내장된 웹 웹서버 에이전

트인 WS Engine 을 표시한다. 자세한 사

항은 JEUS Web Server 안내서를 참조하기 바란다.

Context Group Context Group 들을 표시하는 노드이며,

Servlet Engine 의 하위 노드로 구성 된다.

이 노드의 하위 컴포넌트에는 Context 와 Connector 가 있다. 자세한 사항은 JEUS Web Container 안내서를 참조 하기 바란다.


Tmax Soft 38


Context Context 를 표시하며 컨텍스트 그룹 안에

서 등록된 웹 어플리케이션에 대응한다.

하위 노드로는 Servlet 이 있다. 자세한 사

항은 JEUS Web Container 안내서를 참조

하기 바란다.

Connetor Connector 를 표시 하며, 자세한 사항은 JEUS Web Container 안내서를 참조 하기

바란다.

Servlet Servlet Engine 의 노드를 나타내 주며 자

세한 사항은 JEUS Web Container 안내서를

참조 하기 바란다.

EJB Module EJB Engine 에 Deployment 된 EJB module을 나타내는 노드이며, 자세한 사항은 JEUS EJB 안내서 를 참조 하기 바란다.

EJB Bean EJB 모듈의 하위 노드인 Bean 을 나타내며

자세한 사항은 JEUS EJB 안내서를 참조

하기 바란다.

DB Connection Pools (J)

JEUS 에 의해 제공되는 DB Connection pool Group 을 나타낸다.

DB Connection Pool(J)

JEUS 에 의해 제공되는 DB Connection pool Group 을 나타낸다.

DB Connection Pools(W)

Servlet 에 의해 제공되는 DB Connection pool Group 을 나타낸다.

DB Connection Pool(W)

Servlet 에 의해 제공되는 DBConnection pool 을 나타낸다.


Tmax Soft 39


Connector Pools Connector pool Group 을 나타낸다.

Connector Pool 각 Engine Container 에 대해 생성된 Connector Pool 을 나타낸다.

Clients JMS Engine 의 모든 클라이언트들에 대한

하나의 부모노드를 나타낸다.

Client JMS Engine 에 연결된 각 클라이언트를 나

타낸다.

Destinations JMS Engine 의 모든 Destination 에 대한 하

나의 부모노드를 나타낸다.

Destination / JMS Engine 에 등록된 각각의 Destination으로 아이콘에 Q 가 표시된 것은 Queue, T가 표시된 것은 Topic 을 나타낸다.

Connection Factory

JMS Engine 의 모든 Connection factory 들을

위한 부모 노드이다.

Connection factory

/ JMS Engine 에 등록된 각각의 Connection factory 를 나타낸다.

Durable Subscribers

JMS Engine 의 모든 Durable Subscriber 들에

대한 부모노드를 나타낸다.

Durable Subscriber

JMS Engine 에 등록된 각각의 Durable Subscriber 를 나타낸다.

Security 보안 서비스를 나타낸다.

Users 사용자들의 세팅을 나타낸다.


Tmax Soft 40


User 단일 사용자를 나타낸다.

Anyone ‘anyone’이라는 기본 사용자를 나타낸다.

Groups 그룹들에 대한 세팅을 나타낸다.

Group 단일 그룹을 나타낸다.

Guest ‘guest’라는 기본 그룹을 나타낸다.

Roles Role 들에 대한 세팅을 나타낸다.

Role 단일 Role 을 나타낸다.

ANYONE ‘anyone’이라는 기본 Role 을 나타낸다.

ACL ACL 들에 대한 세팅을 나타낸다.

ACL 단일 ACL 을 나타낸다.

오른쪽 부분은 JEUS 컴포넌트들에 대한 Information Window 이다. 어떤 컴포

넌트가 System tree 에서 클릭 될 때 Information Window Panel 에는 실행상

태와 설정과 같은 컴포넌트의 자세한 정보가 나타난다. Information Window Panel 에는 컴포넌트들의 설정과 상태에 대한 정보를 보여주는 인터페이스

를 가지고 있는 탭과 그 탭에 따른 하위 탭을 포함하고 있다. Information Window Panel 의 오른 쪽 상위에 뷰 방식을 바꾸기 위한 3 개의 버튼이 있다. Information Window Panel 의 정렬방식은 2 가지가 있는데, window view mode 와 tab view mode 가 있다. 다음 두 절에서 뷰 방식에 대해서 설명을 한다.

3.4.3 Window View 모드와 Tab View 모드

JEUS 의 여러 컴포넌트에 대해 동시에 모니터링 하기를 원할 때도 있고, 하나의 컴포넌트만 모니터링을 원할 때도 있다. 사용자가 원하는 형태로


Tmax Soft 41

Information Window Panel 을 정렬하는 것을 가능하게 하기 위해서 JManager는 ‘view mode’를 제공한다. 주로 두 가지 종류의 view mode 를 제공하며, ‘tab view mode’ 와 ‘window view mode’가 있다.

처음으로 Administration Mode 를 시작 할 때 Information Window Panel 은 아래의 그림처럼 View mode 가 보여진다[그림 12]. View mode 는 모든 모니터

링된 컴포넌트의 리스트를 보고자 할 때 편리하며 1 개의 컴포넌트를 전체 화면에 모니터링하는 방식이다.

그림 12. Tab view 모드.

Window View 모드는 아래 그림처럼 보여진다. 동시에 여러 개의 Information Window Panel 을 볼 수 있고, 정렬할 수도 있다. 아래 그림처럼 Tile Layout 버튼을 누르거나 Cascade Layout 버튼을 누르게 되면 두 가지 형태의 정방형과 겹쳐진 형태를 변경할 수 있다[그림 13].


Tmax Soft 42

그림 13. Information Window 화면의 Layout

3.4.4 XML 설정 편집

Information Window Panel 은 하위 탭으로 여러 개의 디스플레이 설정 정보

를 가질 수 있고, 1 개의 설정 탭은 1 개의 설정파일에 대응된다.

예를 들면 System tree 의 JEUS System 노드를 클릭한 후 그 하위 탭을 통하여 JEUSMain.xml 을 볼 수 있고, 편집할 수도 있다.

EJBMain.xml, WEBMain.xml 그리고, JMSMain.xml 과 같은 Engine 에 대한 설정은 각 Engine 의 설정 탭들을 통하여 편집할 수 있다. 이것은 설정에 대한 파일이나 디렉토리를 찾는 수고를 덜어주는 편리한 기능을 제공한다.

설정 탭들의 값들을 수정한 후에 아랫 부분의 Save 버튼을 반드시 눌러줘야 한다. Save 버튼을 누르지 않으면 설정에 대한 변경은 절대 XML 파일에 반영이 되지 않기 때문이다. 구성 설정을 할 수 있는 버튼은 2 가지가 더 있으며 Distribute 와 Save As 버튼이 있다. Distribute 버튼을 사용하면, 파일을 여러 위치로 배포할 수 있으며, 특히 클러스터링을 조작하는데 유용하다.


Tmax Soft 43

그림 14. Information Window 설정 탭의 설명과 설정을 저장하는 버튼.

아래 그림의 XML 편집 유틸리티의 Edit Admin Config 메뉴를 이용하면 JEUS System 디렉토리가 아닌, 다른 곳의 설정 파일을 편집할 수 있다[그림 15]. 자세한 사항은 3.7 장에서 설명을 한다.

그림 15. 작성할 설정 파일을 선택하는 Admin Config 메뉴.


Tmax Soft 44

3.4.5 컴포넌트 모니터링

또한, Information Window Panel 은 컴포넌트들의 활동들을 모니터링 하는 것에 대한 하위 탭들을 제공하고, 각 컴포넌트의 세부적인 변화를 모니터링 해준다. Engine Container 와 Engine 에 사용되는 메모리의 상태와 값을 나타내

준다. 모니터링에 대한 상세한 정보를 원한다면 해당 Engine 의 매뉴얼을 참조한다.

아래 그림은 Information Window Panel 의 모니터링을 나타낸 그림이다[그림 16].

그림 16. Information Window Panel 의 모니터링 탭의 설명과 설정을 저장하는 버튼.

화면의 오른쪽 아래에 모니터링 탭의 하위 탭인 3 개의 버튼이 있다.

Refresh 버튼은 디스플레이 된 모니터링 정보를 refresh 하도록 사용된다.

Repeat 버튼은 계속적으로 모니터링을 할 때 사용된다.

Repeat Setting 버튼은 그래프의 모니터링 간격과 지속시간을 설정하는데 사용된다.


Tmax Soft 45

일단 Repeat button 을 눌러서 실시간 모니터링이 시작되었다면 Repeat button 버튼은 Stop 버튼으로 바뀐다. 이때 Stop 버튼을 누르게 되면 실시간 모니터링이 멈추게 된다.

3.4.6 컴포넌트 컨트롤

JManager 를 사용해서 JEUS 컴포넌트들의 활동을 제어할 수 있다.

각 컴포넌트의 제어는 주로 시스템 트리 위에서 마우스 오른쪽 버튼을 클릭

할 때 표시되는 팝업 메뉴에서, 어떠한 명령을 클릭 함으로써 명령이 실행된

다.

1. 명령을 내리고자 하는 컴포넌트를 선택한다.

2. 마우스 오른쪽 버튼을 클릭한다.

3. 선택된 컴포넌트의 제어 동작 리스트를 볼 수 있을 것이다. 그 중에서 원하는 한 가지를 선택하여 클릭한다[그림 17].

그림 17. System tree 안의 컴포넌트에 대한 마우스 오른쪽 버튼을 클릭했을 때의 명령들.

4. 대기하라는 메시지가 보일 것이며 명령이 실행된다.

5. 실행이 끝난 후에 결과를 보여주는 다이얼로그가 뜬다.

예를 들어 JEUS node(여기서는 johan) 컴포넌트를 선택해서 마우스 오른쪽 버튼을 클릭하면 boot, down, exit, bind datasource 의 컨트롤 메뉴를 볼 것이

다. 그 명령들 중 하나를 클릭하게 되면 그 선택한 명령이 실행된다. Datasource 에 대한 binding 을 하려고 한다면 JEUS Server 안내서의 JDBC부분을 참조하기 바란다.


Tmax Soft 46

3.4.7 결론

JEUS 의 각 컴포넌트를 설정, 모니터링, 컨트롤을 JManager 의 Administration Mode 에서 어떻게 사용하는 것인지 살펴 보았다. JManager 는 주로 System tree Panel 과 Information Window Panel 로 구성 되고, System tree 를 클릭함으

로써 모든 컴포넌트들을 쉽게 관리할 수 있다.

이제부터는 JManager 의 Deployment Mode 에 대한 사용법을 알아 본다.

3.5 Deployment Mode 3.5.1 소개

Administration Mode 는 관리자를 위해 많은 기능을 제공하는 반면, Deployment Mode 는 어플리케이션을 Deployment 하는 사용자에게 보다 쉽게 어플리케이션에 대한 패키징을 하는 인터페이스를 제공해준다. 이것은 J2EE Application 모듈, EJB 모듈, WEB 모듈, Application Client 모듈 그리고, Connector RAR 파일들과 같은 J2EE 모듈들을 패키징 하거나 수정하는 것을 가능하게 한다.

또한 JEUS 에 이 모듈들을 Deploy 할 수 있도록 도와주는 편리한 GUI 를 제공한다. 이 절에서는 JManager 를 이용해 Deployment 를 하는 방법을 설명한

다.

3.5.2 Deployment GUI

이번 절에서는 Deployment Mode 의 구조에 대해 알아본다. 앞서 설명을 했듯이 JManager 의 왼쪽 위 부분의 콤보박스에서 Deploy 를 클릭 함으로써 Deployment Mode 를 시작할 수 있다. Deployment GUI 는 System tree Panel과 Deployment Information Window Panel 의 두 부분으로 구성된다.

Administration Mode 와는 다르게 Deployment Mode 에서의 System tree 는 컴포넌트를 제어하거나 모니터링하기 위한 어떠한 기능도 제공되지 않는다. 단지 Engine 들의 리스트 정보와 그들의 상태정보를 보여주는 기능만 제공

된다.

Deployment Information Window Panel 은 여러 개의 모듈을 열 수 있고, 그 다음에 검사, 변경, 배포하는 작업 공간이다.

Deployment Mode 초기 화면에서는 단지 왼쪽의 System tree 만 보인다. Deployment Information Window Panel 은 모듈을 열 때 나타난다. 모듈을 열기 위해서는 Information Window Panel 의 오른쪽 위 부분에 Open Module 버


Tmax Soft 47

튼을 클릭 하면 된다. 아래는 Deployment Mode 에서 2 개의 Deployment unit을 담고 있는(2 개의 모듈을 열어 놓은) 상태인 Deployment Information Window Panel 을 보여주는 그림이다.

아래 그림의 오른쪽 위 부분에 표시되어있는 3 개의 버튼은 모듈에 대한 Deploy 작업을 할 수 있는 주요 버튼이다 [그림 18].

첫 번째 버튼은, Open Module ( ) 버튼이며 J2EE Module 을 열 때 사용한다. 여기서 열 수 있는 모듈은 JAR, WAR, RAR 과 그리고, JAR 을 확장한 EAR과 같은 파일이다. 모듈을 관리하기 위해서 J2EE Deployment Descriptor 를 포함을 시켜야 한다. 만일 모듈을 열 때 J2EE Deployment Descriptor 가 없거나 잘 못 되었다면 에러 메시지가 출력된다.

두 번째 버튼은, Create Module ( ) 버튼이며 모듈을 생성할 때 사용한다. 새로운 모듈을 생성하는 방법에 대해서는 다음 절에서 설명을 한다.

세 번째 버튼은, Deployment Module ( ) 버튼이며 JEUS 에 J2EE 모듈을 Deployment 하는 기능을 한다. Deployment 에 대한 절차는 각각의 매뉴얼에

서 설명을 한다.

그림 18. Deployment Information Window Panel 에 2 개의 묘듈을 열어놓은 화면.


Tmax Soft 48

아래의 표는 Deployment tree 의 각 모듈들에 대한 아이콘을 나타낸다.

표 2. Deployment tree 의 각 모듈에 대한 아이콘.


EJB Module EJB 모듈 (JAR).

EJB Bean EJB bean 을 나타내며, EJB 모듈의 하위

컴포넌트이다.

WEB Module WEB module (WAR).

Servlet/JSP Servlet 과 JSP page.

Application Client J2EE 어플리케이션 클라이언트.

RAR Module Connector RAR 모듈 (resource adapter).

Application J2EE EAR 어플리케이션 모듈.

3.5.3 Module 생성

다음은 JManager 에서 J2EE 모듈을 생성하기 위한 절차이다.

1. Create Module 버튼을 클릭하여 모듈 생성을 시작한다.

2. 모듈 작성 다이얼로그 팝업 창이 뜰 것이다[그림 19]. 첫 번째 페이지

에서는 타깃 경로와 모듈 타입과 같은 설정을 한다. 타깃 경로는 모듈

이 저장될 파일의 전체 경로 이다.


Tmax Soft 49

그림 19. JManager 의 새로운 모듈을 생성하는 첫 번째 다이얼로그.

3. 다음 페이지는 File Contents 페이지이며, 모듈에 들어갈 파일을 선택

하는 인터페이스이다[그림 20].

그림 20.파일 컨텐츠 선택 다이얼로그.

4. File Contents 는 하단에 File Info List 를 가지며, File Info List 를 채워서 모듈에 파일들을 포함시킨다. 첫 번째로 패키지의 루트를 선택


Tmax Soft 50

하기 위해서 상위 디렉토리를 설정한다. 왼쪽의 Browse 버튼은 쉽게 디렉토리를 탐색할 수 있다. 예를 들면, Browse 버튼을 클릭해서 상위 디렉토리에 ‘d:\jeustemp’ 경로를 설정을 할 수 있다. 지정한 디렉토리

의 파일 내용들은 다이얼로그 박스의 중앙에 리스트로 보여진다. 그 다음 add 버튼을 클릭해서 패키징 할 파일들을 선택 한다. 예를 들면 [그림 20]처럼, Counter 라는 디렉토리를 선택해서 File Info List 안에 모든 하위 파일들이 포함 되도록 할 수 있다.

5. 디렉토리를 설정하면, 파일과 디렉토리 리스트들이 보인다. 파일 또는 디렉토리를 선택하고, 그 다음에 add 버튼을 클릭하면 파일 정보 리스트에 선택된 파일들이 들어간다. [그림 20] 을 보면, counter 디렉

토리를 선택하고 나서 add 버튼을 클릭해서 3 개의 클래스가 File Info List 에 추가가 된 것을 볼 수 있다.

External lib 버튼은 파일 정보 리스트의 클래스들을 로드할 때 필요

한 외부 라이브러리들(JAR)을 지정할 때 사용된다. 이 라이브러리는 여기서 생성할 JAR 파일에 포함되지 않으며, 단지 Next 버튼을 누를 때 라이브러리에 포함시킨 클래스들이 JVM 에 로딩이 된다.

6. File Content 페이지를 설정한 다음에, Deployment Descriptor(DD) 파일을 생성하는 페이지를 볼 수 있을 것이다. 이 화면은 초기 화면에서 선택했던 모듈에 따라서 종류가 다르다. [그림 21]은 EJB 모듈 작성을 위한 Deployment Descriptor 설정 Page 를 보여준다.


Tmax Soft 51

그림 21. EJB 모듈의 Deployment descriptor 페이지.

7. View descriptor 버튼은 XML 파일 형식의 Descriptor 를 보여준다. Save to XML 버튼은 Deployment Descriptor 를 따로 저장을 하도록 사용된다.

8. 마지막으로 Finish 버튼은, 모듈 생성을 실행하는 버튼이다. 최근에 생성한 모듈이 Deployment Information Window Panel 에 나타나고, 지정했던 타깃 경로에 지정한 파일이 생성되는 것을 볼 수 있다.

3.5.4 Module 보기와 편집

모듈의 컨텐츠를 어떻게 보고 편집하는지 알아보도록 한다.

Deployment Information Window Panel 은 System tree Panel 과 Information Window Panel 의 중간에 위치 하며, 모듈 리스트를 표시한다. 리스트는 모듈

의 계층을 tree 로 나타낸다. 모듈 또는 그 하위 엘리먼트를 클릭할 때, 그 모듈에 대한 상세한 정보가 오른쪽 Information Window Panel 에 나타나는 것을 볼 수 있다. 나타나는 정보 중 하나는 모듈에 포함된 파일들이고, 다른 하나

는 J2EE Deployment Descriptor 이다.


Tmax Soft 52

여기서 모듈의 내용을 수정할 수 있다. File Info 탭을 통해서 파일을 추가 하거나 삭제를 할 수 있다. J2EE XML Descriptor 을 통해서는 Deployment Descriptor 를 수정할 수 있다.

변경을 한 후에, 반드시 Save 버튼을 클릭해야 한다[그림 22]. 변경한 모듈을 다른 이름으로 저장하기 위해서는 Save as 버튼을 클릭하면 된다. Save to XML 버튼은 해당 모듈(JAR 파일)이 아닌 다른 곳에 XML descriptor 를 각각 저장하도록 할 때 사용된다.

그림 22. 저장 버튼과 모듈 정보.

3.5.5 모듈 Deploy

JEUS 에 J2EE 모듈을 어떻게 Deploy 할 것인지를 설명한다.

Information Window Panel 의 오른쪽 상위의 Deployment Module 버튼( )을 클릭 함으로써 Deployment 를 시작할 수 있다. 먼저 Deployment Information Window Panel 의 모듈 중 하나는 선택이 되어져야 한다. 특정 모듈의 형태에 따른 Deployment Dialog 가 팝업 하게 된다. 기본적으로 Deployment Dialog에서 순차적으로 클릭을 하고, 마지막으로 Finish 버튼을 누르게 되면 Deploy 는 끝나게 된다.


Tmax Soft 53

Deployment Dialog 에서 모듈 명, 타깃 Engine 그리고, 다른 Deployment Option 들을 선택한다. 이 과정을 거치는 동안에 EJB 와 WEB 모듈을 위한 JEUS Deployment Descriptor 가 만들어 진다.

3.5.6 EJB 모듈 Deploy

EJB Module Deployment Dialog 는 선택된 EJB 모듈에 Deploy 버튼을 클릭할 때 나타난다. 다른 종류의 Deployment Dialog 와 나타나는 방식이 동일하다. 이 Dialog 는 4 개의 하위 페이지를 갖는데, Basic Setting Page, JEUS EJB DD Creation Page, Deployment Option Page 그리고, Progress View Page 가 있다.

첫 번째 Basic Setting Page 에는 고유한 모듈명을 입력을 해야 한다. 그리고 Deploy 를 할 Engine 을 목록에서 선택한다.

JEUS DD 파일을 생성하기 위해서 기존의 JEUS DD 파일을 사용할 수 있다. ‘Deployment Mode’ 라는 항목에 JAR 와 DIR 두 가지 방식이 있는데 Disabled 된 상태로 표시가 된다. Engine 옵션에서 이미 고정이 되어 있어서 Deployment Mode 를 바꿀 수가 없기 때문이다. Deployment Mode 에 대한 자세한 설명은 JEUS EJB 안내서를 참조하기 바란다. 다음 페이지로 가기 위해

서는 1 개의 Target Engine 과 Module Name 을 선택해야 한다.

두 번째 페이지는 JEUS EJB DD Creation Page 이다. EJB Module 을 Deployment 하기 위해서는 jeus-ejb-dd 파일이 Engine 설정 디렉토리 밑에 존재 해야 한다. JEUS EJB DD Creation Page 는 Deploy 를 위한 JEUS EJB DD 파일을 생성한다. 이 페이지에서 할 일은 파란색으로 표시된 필수 입력 사항

을 입력하는 것이다.

세 번째 페이지는 Deployment 의 옵션에 대한 세팅을 하는 페이지이다. 이 페이지에서는 EJB Engine 의 <module-list> 태그에 Deployment 한 모듈을 등록

하게 선택을 할 수도 있고, 동작 중인 Engine 에 동적으로 모듈을 갱신할 수도 있다. Deployment Option 의 자세한 사항에 대해서는 JEUS EJB 안내서를 참고하기 바란다.

마지막으로 Progress View Page 는 Module Deploy 와 Deploy 의 실행을 모니

터링하기 위해 지정하였던 모든 설정과, Deploy 가 성공적으로 수행되는지 보여준다.

EJB Module 을 Deploy 한 후에 타깃 Engine 디렉토리 밑에서 ejb-jar_<module name>.xml 과 jeus-ejb-dd_<module name>.xml 을 볼 수 있을 것이다. jeus-ejb-dd.xml 은 다이얼로그 창의 두 번째 페이지에 생성하였던 파일이다. Class 파일과 Helper 클래스 파일은 EJB Home 디렉토리에 복사가 된다. 만약


Tmax Soft 54

Deployment 에 대한 설정 중간에 모듈 리스트에 등록하는 것을 선택하였다

면 EJBMain.xml 의 모듈 리스트에 방금 지정했던 모듈명이 포함된다. 그리

고 동작 중인 Engine 에 모듈을 Deploy 하면, System tree 의 EJB Engine 아래

에 모듈이 표시된다.

EJB Module Deployment 에 대한 더 자세한 정보를 원한다면 JEUS EJB 안내

서를 참조하라.

3.5.7 WEB모듈 Deploy

WEB Module 을 위한 Deployment dialog 는 앞에서 설명한 EJB Deployment Dialog 와 거의 동일 하다. 유일한 차이점은 타깃 Engine 을 선택하는 것 외에 Context Group 을 추가로 선택해야 한다는 것이다. 알고 있겠지만, Context 는 어떤 하나의 Application 을 표현하는 JEUS Web Engine 의 개념이다. 이 Context 들은 Context Group 아래에서 관리되므로 Context Group 을 선택해야 한다. WEB Module 에 대한 Deployment 옵션의 상세한 내용은 JEUS Web Container 안내서에 설명이 되어 있다.

Deployment 를 위한 두 번째 페이지는 JEUS WEB DD 를 생성하는 것이고, EJB Module Deployment 다이얼로그와 유사하다. Deployment Descriptor 파일

은 이름이 jeus-web-dd_<context name>.xml 로, 타깃 Engine 디렉토리 밑에 생성이 된다. 만약에 Context Registration Option 을 설정 하였다면, WEBMain.xml 의 <context-list> 라는 태그 안에 모듈이 등록된다. 그리고, Set Runtime Update Option 을 설정 하였다면, Engine 이 실행 되면서 Context 가 업데이트된다. 마지막 페이지는 Deployment Progress 를 보여준다. WEB Module Deployment 에 대한 더 자세한 설명은 JEUS Web Container 안내서를 참조하기 바란다.

3.5.8 Application Client 모듈 Deploy

Application Client Module Deployment Dialog 는 4 개의 페이지를 가지며, Basic Setting Page, JEUS Application Client DD Creation Page, JNLP Descriptor Creation Page 그리고, Progress View Page 가 있다. 만일 Basic Setting Page 에

서 JNLP 서비스를 위해 JNLP Export 항목을 선택한다면, JNLP Descriptor Page 에 JNLP Descriptor 를 생성해야 한다. Basic Setting Page 에서는 유일한 모듈 명을 설정하고 또한, 타깃 노드가 Deployment 를 수행 하도록 설정한다.

Application Client 모듈을 Deploy 하면 JAR 파일과 JEUS DD 파일(jeus-client-dd.xml) 을 Client Home 디렉토리로 전송한다. 클라이언트 홈 디렉토리는 하나의 노드에서는 유일해야 하므로, Deployment 를 위해 타깃 노드를 지정해

야 한다.


Tmax Soft 55

두 번째 페이지에서는, 기본적인 필수 기록란들만 채워서 JEUS Client DD 를 생성한다. 마지막 페이지는 다른 Deployment 타입과 마찬가지로 Deploy 의 진행을 볼 수 있는 페이지다.

Deployment 를 수행하면, Deployment 의 진행과정이 보여지며, 지정한 모듈 명으로 디렉토리가 CLIENT_HOME 아래 생성된다. 생성된 디렉토리로 JAR파일이 옮겨지며, jeus-client-dd.xml 이 생성 된다. Application Client 모듈의 Deployment 에 대해 상세한 정보를 알고 싶다면 JEUS Client Application 안내

서를 참조하기 바란다.

3.5.9 RAR 모듈 Deploy

RAR 모듈 Deployment 다이얼로그는 기본 세팅 페이지와 진행을 보여주는 2개의 페이지로 이루어져 있다. 첫 번 째 페이지에서는 모듈 명을 입력하고, 타깃 노드를 설정해야 한다.

RAR 모듈을 Deploy 하기 위해서는, 기본적으로 JAR 파일과 Deployment Descriptor 가 JEUS_HOME\lib\datasource 디렉토리에 있어야 하고, 시스템 라이브러리 파일들이 JEUS_HOME\lib\system 디렉토리에 있어야 한다.

RAR 모듈을 Deploy 하면 .jar 파일과 Deployment Descriptor 인 rar.xml 파일이 JEUS_HOME\lib\datasource 디렉토리로 전송되며 사용자가 선택한 시스템 라이브러리는 JEUS_HOME\lib\system 으로 전송된다. 사용자가 선택한 시스

템 라이브러리 파일들은 JEUS_HOME\lib\system 디렉토리에 옮겨 질 것이며, RAR 모듈의 Deployment 에 대한 더 자세한 사항은 JEUS Server 안내서를 참조 하기 바란다.

3.5.10 Application 모듈 Deploy

Application Module 은 실제로 다른 J2EE 모듈들(예를 들어 JAR 와 WAR)의 집합체이다. Application Module 의 Deploy 절차는 이미 설명했던 하위 모듈

들(JAR 와 WAR)의 연속된 작업으로 수행 된다.

3.5.11 결론

지금까지 JManager 에서의 Deployment Mode 의 사용방법에 대해서 알아 보았고, 모듈에 대한 패키징, 변경, Deployment 에 대해 설명 했다.

다음 절에서 Analysis Mode 에 대해서 설명을 한다.


Tmax Soft 56

3.6 Analysis Mode 3.6.1 소개

JManager 는 여러 가지 로그들을 능률적으로 관리하게 하기 위한 Analysis Mode 를 제공한다. Analysis Mode 에서는 로그 메시지 처리를 위한 여러 기능을 제공한다. 이 절에서는 Analysis 기능을 자세하게 설명한다.

3.6.2 JEUS 로깅

Analysis Mode 를 시작하기 전에, JEUS 에 로깅이 어떻게 수행이 되는지 간단하게 설명을 한다. 로깅에 대한 정보는 JEUS Server 안내서나 각각의 Engine 에 따른 매뉴얼을 참고하길 바란다. JEUS 의 주요 로그 타입은 system log, error log, access log 그리고, user log 가 있다. Analysis Mode 는 user log 를 제외한 모든 로그 메시지를 처리할 수 있다.

System log 는 JEUS 서버에 의해 생성된 메시지를 다룬다. 각 컴포넌트는 설정에 따라서 로그 메시지를 생성한다. System 로그와 Error 로그는 유사한 구성 요소를 가지고 있다.

<logging> 태그 내에 포함된 <level>태그는 로그 메시지의 레벨을 지정한

다. 로그 레벨은, 치명적인 메시지만 보여주는 ‘fatal’부터 모든 메시지를 보여줘서 디버깅을 하기 쉽도록 해주는 ‘debug’까지 나타낸다.

<target>태그에서는 타깃을 설정하며, 메시지를 Standard-Out 으로 출력을 할 것인지 아니면 로컬파일에 저장을 할 것인지를 결정한다. 만일 파일로 설정

을 했는데, 저장할 경로를 지정하지 않았다면 로그 메시지는 기본 경로에 파일을 저장한다.

JEUS Server 에 대한 에러로그의 기본 경로는 아래와 같다.

JEUS_HOME\logs\JEUSServer\JEUSServer_MMDDYYYY.log.

JMS Engine 에 대한 에러로그의 기본 경로는 아래와 같다.

JEUS_HOME\logs\<engine_name>\error_log\error_MMDDYYYY.log.

Servlet Engine 의 에러 로그는 각 Context Group 에 의해 생성된다. 에러 로그

는 아래와 같은 경로에 저장이 된다.

JEUS_HOME\logs\<engine_name>\error_log\<context_group_name>\error_MMDDYYYY.log


Tmax Soft 57

시스템 로그의 포맷은 아래와 같다.

<YYYY.MM.DD HH:MM:SS> <message level> <module name> <message>

에러 로그의 포맷은 시스템 로그의 포맷에 ‘error level’이 추가된 것이다.

<YYYY.MM.DD HH:MM:SS> <message level> <module name> <error level> <message>

첫 번째 항목은 로그의 시간이다. 두 번째 항목인 ‘message level’은 정수로 쓰여진다. 메시지에 대한 중요도는 0 부터 3 까지 인데 0 은 ‘fatal’이고 3 은 ‘debug’이다. ‘module name’은 모듈을 표현한다. Error 로그의 포맷은 시스템 로그의 포맷에 ‘error level’이 추가된 것이다. 설명하자면, ‘F’는 Fatal, ‘E’는 Error, ‘W’는 Warning, ‘I’는 Information 이다. 마지막에는 상세한 로그 메시지

가 나온다.

System log 와 Error log 는 유사한 포맷이므로 하나의 카테고리로 처리한다.

Access log 는 클라이언트에 대한 접근 내역을 기록한다. Servlet Engine 과 JMS Engine 에 대한 Access log 를 구성할 수 있다. 기본 파일 경로는 Error log와 유사하고, ‘accesslog’의 아래에 저장된다. Servlet Engine 에 대한 Access log 의 포맷은 아래에 다음과 같다.

<YYYY.MM.DD HH:MM:SS> <client-IP> <request-URL> <response-code> <response-time>

Access log 는 접근 시간, 클라이언트 정보, 응답 정보를 기록한다.

User log 는 어플리케이션에 의해 기록된 메시지를 의미하며, 포맷은 지정되

어 있지 않다. user logging 의 포맷을 결정하는 것은 어플리케이션 프로그램

이므로, Analysis Mode 는 아직 user logging 을 지원하지 않는다.

지금까지 JEUS 의 여러 가지 로그들을 살펴보았다.

3.6.3 Analysis GUI

이 절에서는 Analysis Mode 의 구조에 대해서 알아 볼 것이다. 툴의 왼쪽 위 부분의 콤보박스에서 Analysis 를 선택함으로써 Analysis Mode 를 시작할 수 있다. 다른 방식과 마찬가지로 Analysis GUI 는 System tree 와 Analysis Information Window 로 나뉜다[그림 23].


Tmax Soft 58

그림 23. JManager 의 Analysis Mode.

System tree 의 아이콘들은 Administration Mode 에서의 아이콘들과 동일하다. 각 아이콘의 설명은 [표 1]의 Administration 아이콘의 표를 참조하면 된다. 그렇지만 Analysis Mode 의 System tree 는 로깅정보를 간단하고, 구조적으로 보여준다. System tree 는 오직 로깅에 관련된 컴포넌트들만 보여주고, 컴포넌

트의 상태에 대한 정보는 제공하지 않는다.

Analysis 는 System tree 의 로깅 컴포넌트를 더블 클릭할 때 수행 된다. JEUS node, EJB Engine, JMS Engine 그리고, Servlet Engine 의 Context Group 은 분석 결과를 만들 수 있는 로깅 컴포넌트이다. 다음 절에서는, 로깅 분석

(Logging Analysis)를 어떻게 실행하는지 설명한다.

3.6.4 System/Error log 분석

‘system/error’ 로그 포맷을 구성하는 컴포넌트는 Node, Engine Container, EJB Engine, 그리고 Servlet Engine 의 Context Group 으로 이루어진다. 각 컴포넌

트를 더블 클릭하면 Analysis Rule Setting dialog 가 나타난다[그림 24].


Tmax Soft 59

그림 24. System/Error 로그 분석에 대한 rule 세팅 다이얼로그.

위에서 보았던 system/error log 는 아래의 포맷을 따른다.

<YYYY.MM.DD HH:MM:SS> <message level> <module name> <error level> <message>

다이얼로그에서 Logging Time, Message Level, Module Name 같은 분석 기준

으로 설정한다. 분석 기준으로는 4 가지 항목이 있는데 Logging Date, Message Level, Error Level 그리고, Message Location 이 있다. ‘OR’나 ‘AND’연산도 사용할 수 있다. Operator 옵션은 Log Analysis Information Panel 의 상단에 있다.

Servlet Engine 의 에러 로그를 분석을 위해서, 에러 레벨을 설정할 수 있다. 특정 날짜의 fatal 메시지만 보고 싶으면, 날짜 정보(Start Data, End Date)와 에러 레벨(Message Level)을 ‘Level0 [FATAL]’로 설정한다.

그리고, 분석하려는 JEUS 의 버전을 지정할 수 있고, ‘save report file’ 옵션을 설정할 수 있다. 이 옵션을 설정을 했다면, JEUS_HOME\logs\AnalysisReports 디렉토리 아래에 파일이 생성된다. ‘Analysis’버튼을 클릭 하면 Information Window Panel 에 아래와 같은 결과가 나타난다[그림 25].


Tmax Soft 60

그림 25. Information Window 에 System/Error log 분석의 결과화면.

이 결과는 Rule Option 에 따라 필터링된 로깅파일의 결과이다.

3.6.5 Access log 분석

Access log 는 Servlet Engine 과 JMS Engine 에서만 있으며, 시스템 트리의 해당 컴포넌트에 대한 Access log 정보를 분석한다. System tree 내의 Access log 컴포넌트를 클릭하면 다음과 같은 Analysis Rule Setting 다이얼로그가 나타

난다[그림 26].

그림 26. Access log Analysis R분석을 위한 ule Setting 다이얼로그.


Tmax Soft 61

system/error log 분석 다이얼로그처럼, 필터링 옵션을 설정한다. 분석할 기간

을 정하거나, 파일의 결과를 저장할 수 있다. 분석 결과는 Information Window Panel 에 리소스당 Hit Ratio, 날짜, 클라이언트 IP 가 출력된다. 아래

는 결과의 예이다.

그림 27. Information Window 에 나타난 Access log 분석에 대한 결과.

3.6.6 로깅 이벤트 핸들러 등록

Analysis Mode 에는 어떤 특정 로깅 메시지를 처리하기 위한 핸들링을 등록

할 수 있다. 예를 들면, 치명적인 메시지를 발견할 때 ‘삑’ 하는 소리가 나도

록 등록할 수 있다.

로깅 이벤트의 핸들러를 등록하려면, Panel 의 우측 상단에서 을 누른다. 그런 후, Information Window Panel 에서 로깅 메시지의 리스트를 확인한다

[그림 28].


Tmax Soft 62

그림 28. 로깅 이벤트 헨들러 등록 창.

Information Window Panel 왼쪽 부분의 로깅 메시지 리스트에서 등록하려는 로깅 메시지를 선택한다. 선택된 메시지 리스트는 우측 Panel 에 보여진다. 하단의 ‘Exec Filename’ 항목에서, 핸들러로써 처리할 프로세스 명을 입력하

여야 한다 (로그 메시지에 반응할 일종의 실행 스크립트이다).

3.6.7 결론

이번 절에서는 JManager 의 Analysis Mode 를 설명 하였다. Analysis Mode 는 system 로그, error 로그, access 로그 처리가 가능하며 확실한 로깅 메시지 처리를 위한 핸들링 처리의 등록도 가능하다.

다음 절은 JManager 에 포함된 몇 개의 유틸리티에 대해 설명한다.

3.7 유틸리티 3.7.1 소개

지금까지 설명했던 3 가지의 주 기능과 함께 JManager 는 여러 가지 유틸리

티들을 제공 한다. 이들은 메뉴를 통하여 접근이 가능하다. 이 절에서는 유틸

리티들을 어떻게 사용하고 실행 시킬 수 있는지에 대해서 알아볼 것이다.


Tmax Soft 63

XML 에디터, FTP 유틸리티 그리고, 직렬화 유틸리티에 대해서 설명할 것이

며, 또한 Deployment Descriptor 생성 툴과 변환 툴을 설명한다.

3.7.2 XML 에디터

JManager 는 JEUS 설정 파일들의 XML 편집을 위한 유틸리티를 제공한다. 아래 그림처럼 툴 화면의 왼쪽 맨 상단에 있는 메뉴를 통해 접근이 가능하며, Edit 메뉴는 Admin Config, Module DD 그리고, JEUS DD 의 3 가지 하위 메뉴를 가진다.

그림 29. XML Edit 메뉴와 Admin Config 메뉴의 하위 메뉴.

Admin Config 메뉴는 JEUS 의 설정 파일들을 생성 또는 변경할 수 있으며, JEUSMain.xml(system), EJBMain.xml(ejb main), WEBMain.xml(web main), JMSMain.xml(jms main), JNLPMain.xml(jnlp resource) 그리고, file-realm.xml (security)를 위한 편집 메뉴가 있다

Module DD 메뉴는 ejb-jar.xml, web.xml, application.xml, application-client.xml 그리고, ra.xml 과 같은 J2EE-specific Deployment Descriptor 들을 생성하거나 수정할 수 있다.

JEUS DD 메뉴는 jeus-ejb-dd.xml, jeus-web-dd.xml 그리고, jeus-client-dd.xml과 같은 JEUS–Specific Deployment Descriptor 파일을 생성하거나 수정하는 기능을 한다.

위와 같은 파일들을 생성, 수정을 하고 난 후에 Save 나 Save as 버튼으로 저장을 한다. 특히 Edit 다이얼로그는 Admin Config 메뉴를 통해 Distribute 버튼을 제공한다. 이 버튼은 여러 JEUS 노드들의 설정 디렉토리에 XML 파일


Tmax Soft 64

을 배포하는 기능을 제공한다. 아래 그림은 Distribute 버튼을 가진 Admin Config(JEUSMain.xml)의 예이다.

그림 30. JEUSMain.xml 에 대한 XML 편집 다이얼로그.

3.7.3 FTP 유틸리티

JManager 는 JEUS_HOME, EJB_HOME, SERVLET_HOME 과 같은 디렉토리

들에 파일들을 옮기는 기능을 제공한다. 이 기능은 특히 멀티 노드 환경의 JEUS 를 관리 할 때 편리하다.

FTP 유틸리티는 아래의 [그림 31]의 Tool 메뉴에서 실행한다. FTP 메뉴를 클릭 하면 [그림 32]와 같은 다이얼로그 창이 열린다.


Tmax Soft 65

그림 31. FTP 유틸리티 메뉴.

그림 32. FTP 다이얼로그.

사용법은 다음과 같다.

1. Set 버튼을 눌러서 로컬 파일 시스템에 소스파일을 설정을 한다.

2. 타깃이 되는 Node 와 FTP home 그리고, URI 의 이름을 설정해야 한다.

3. FTP home 은 시스템 환경 변수들 중 하나에 설정된 타깃 디렉토리의 루트 디렉토리를 의미하며, JEUS 는 JEUS_HOME 을, EJB 는 EJB_HOME 을, SEVLET 은 SERVLET_HOME 을 의미한다.

4. URI 는 지정했던 FTP home 의 위치에서 타깃 파일이 놓일 상대 경로

이다.

5. OK 버튼을 눌러서 파일 전송을 완료 한다.


Tmax Soft 66

3.7.4 직렬화 유틸리티(Serialization Utility)

XML 정보를 직렬화된 객체로 저장해야 할 때가 있다. 예를 들어 ser 방식으

로 부팅을 해야 한다거나 Engine 설정을 ser 방식으로 사용하고 싶다면 표준 XML 형식 대신에 직렬화 된 Java 객체로 설정 파일을 저장해야 한다.

직렬화 유틸리티는 XML 설정 파일에 대한 직렬화된 객체를 만들어 낸다. JManager 의 Tool 메뉴에서 Serialize 를 클릭하면 아래 그림과 같은 다이얼로

그가 보여진다[그림 33].

그림 33. Serialization 다이얼로그.

사용법은 다음과 같다.

1. 직렬화하기를 원하는 XML 파일을 선택한다.

2. 직렬화하려는 Descriptor 의 타입을 선택한다. 타입에는 3 가지 카테고

리로 분류되며, XML Editor 유틸리티와 비슷하다. Admin 은 JEUS 의 Configuration Descriptor 들을 위한 것이며, Module DD 는 J2EE 스펙

의 Deployment Descriptor, JEUS DD 는 JEUS-Specific Deployment Descriptor 를 위한 것이다.

3. 카테고리 타입을 선택한 후에 콤보박스의 리스트에 디스크립터의 상세한 타입을 선택한다.

4. OK 버튼을 누르면, 직렬화된 .conf 파일이 소스 파일과 같은 디렉토리

에 생성된다.


Tmax Soft 67

3.7.5 Deployment Descriptor 생성 유틸리티

이 유틸리티를 사용해서 EJB 클래스들로부터 EJB Deployment Descriptor 를 생성할 수 있다. 이 유틸리티는 J2EE Specific EJB Deployment Descriptor(ejb-jar.xml) 와 JEUS Specific EJB Deployment Descriptor(jeus-ejb-dd.xml)를 만들

어 준다.

JManager 의 Tool 메뉴에서 DD Generate 를 클릭한다. 이 다이얼로그는 차례

로 3 페이지로 진행된다.

1. 첫 번째 페이지에서, Module Name, Base Directory, Source Directory, Saving Directory 를 설정 한다.

2. 두 번째 페이지에서, jeus-ejb-dd.xml 를 생성하는 것에 대한 선택 항목

들을 상세하게 설정한다.

3. 마지막 3 번째 페이지에서 생성을 실행 한다.

아래 그림은 DD Generation 의 기본적인 설정 화면이다[그림 34].

그림 34. Deployment Descriptor 생성 다이얼로그.


Tmax Soft 68

Save Setting 버튼을 사용하면 지정한 파일에 설정을 저장할 수 있고, Load Setting 을 사용하면 파일로부터 GUI 로 설정을 다시 읽어 들일 수 있다. 설정

은 Property Format 으로 파일에 저장된다.

DD 샘플을 생성해 보자. 우선 EJB 클래스가 c:\sample 디렉토리에 있고 기본

적인 DD 파일을 생성한다고 가정한다. sample 디렉토리에는 “hello”, “counter”, “pkproduct”과 같은 다른 패키지를 가진 EJB 클래스들이 있다. 아래 그림은 디렉토리 구조를 나타낸다[그림 35].

sample\

hello\

Hello.class

C HelloEJB.class

HelloHome.classC

C

counter\

Counter.class

C CounterEJB.class

CounterHome.classC

C

pkproduct\

Product.class

C ProductEJB.class

ProductHome.classC

C

dd_save\ 그림 35. 예제 EJB 클래스의 디렉토리.

모든 EJB 클래스의 DD 파일을 만들 수도 있고, 어느 하나의 패키지만을 사용할 수도 있다. 두 가지 모두 DD 생성 유틸리티에서 지원된다.

다음은 사용 순서이다.

1. 첫 번째 페이지에서, 모든 클래스들을 베이스 디렉토리로 Base Directory 항목에 ‘c:\sample’을 설정을 한다. Source Directory 는 EJB 클래스들이 있는 위치이다. Base Directory 아래의 모든 EJB 클래스들

을 사용하는 것은 소스 디렉토리와 베이스 디렉토리를 같게 설정한다


Tmax Soft 69

는 것이다. 체크박스에서의 선택 중에 same as base 를 선택하면 DD 파일이 생성 될 때, 베이스 디렉토리 아래의 모든 클래스를 포함하며, sub directory 를 체크 하면 오직 베이스 디렉토리의 어느 한 부분만을 포함한다는 것을 의미한다.

예를 들어 sub directory 의 ‘pkproduct’ 에서 DD 파일을 생성하도록 한다고 가정을 하면, 첫 번째 페이지에서는 다음 그림 [그림 36] 과 같이 설정을 해야 한다. 만들어진 XML 파일들은 Saving Directory 필드에 지정된 ‘dd_dave’로 저장된다..

그림 36. Deployment Descriptor를 생성하는 첫 번째 화면

2. 두 번째 페이지에, JEUS DD XML 파일에 상세한 옵션을 설정을 할 수 있다. 기본적으로 디폴트 값이 JEUS DD XML 파일에 적용된다. 예를 들면 <data-source-name> 은 JEUS DD XML 파일의 <data-source-name>에 대한 디폴트 값을 정의한다. “<<ejb-class>>s” 와 같이 설정

을 하면 JEUS DD 파일인 jeus-ejb-dd_pkproduct.xml 에서는 EJB 클래

스 이름인 ‘Product’에 ‘s” 가 포함된 값이 세팅이 되며, <table-name>에도 마찬가지로 적용된다. 또한 <db-vendor>, <creating-table>, <deleting-table> 그리고, <local-invoke-optimize> 태그들에 대해서도 디폴트 값을 정의할 수 있다. 다음은 그 예제 화면이다[그림 37].


Tmax Soft 70

그림 37. Deployment Descriptor 생성을 하는 두 번째 예제 페이지.

나머지 선택 항목들에서 설정 항목들을 세팅을 마치고, 세 번째 페이

지에서 생성을 실행한다.

3. 세 번째 페이지에서는 생성이 진행 되는 동안 Message Level 을 세팅

한다. 만약에 메시지 레벨을 ‘quiet’으로 설정을 했다면, 최종 결과만 표시된다. 생성되는 동안 모든 상세한 절차를 보고 싶다면 Message Level 을 ‘debug’로 설정한다 [그림 38].


Tmax Soft 71

그림 38. Deployment descriptor 생성의 세 번째 페이지.

4. Generation Start 버튼을 누르면 DD 생성이 진행된다. 만약에 어떤 문제가 발생 했다면 << Back 버튼을 눌러 이전 설정화면으로 이동해서 다시 생성할 수 있다. 만약 생성이 성공적으로 완료가 됐다면, 저장 디렉토리에 생성된 DD 파일을 볼 수 있다. ejb-jar_pkproduct.xml 과 jeus-ejb-dd_pkproduct.xml 파일이 “c:\sample\dd_save” 디렉토리에 생성된

다.

5. 언제든지 원하는 설정을 파일로 저장을 할 수 있고, 나중에 그 파일들

을 사용할 수 있다. 저장하려면, Save Setting 버튼을 클릭하고, 프로퍼

티 파일의 위치를 입력해서 저장한다. 프로퍼티 파일을 읽으려면, Load Setting 버튼을 클릭해서 저장된 파일을 선택한다.

3.7.6 Conversion 유틸리티

Conversion 유틸리티는 다른 벤더의 J2EE Web Application Server 의 어플리

케이션을 JEUS 의 어플리케이션으로 옮겨준다. 각 WAS 는 특유의 시스템 설정 파일들을 가지고 있다. 그리고, J2EE 어플리케이션 모듈을 Deployment하기 위해 각 벤더의 스펙에 따른 Deployment Descriptor 를 필요로 한다. 어


Tmax Soft 72

떤 하나의 WAS 제품으로부터 다른 벤더의 WAS 제품으로 어플리케이션들

을 마이그레이션시키기는 서로 다른 벤더의 스펙 설정들 때문에 중요하고 어려운 일이다. JEUS 는 이러한 일들을 간편하게 할 수 있는 편리한 툴을 제공한다.

Auto Convert 를 사용하려면 Tool 메뉴에서 Auto Convert 클릭한다. 아래 그림은 Conversion 유틸리티의 첫 페이지이다[그림 39].

그림 39. Conversion 유틸리티의 첫 번째 페이지.

현재는 WebLogic(BEA 사의 J2EE WAS)으로 부터의 변환 기능을 제공한다.

변환을 하는 방법은 두 가지가 있다. WebLogic 의 도메인으로 부터의 변환을 하는 방법과 WebLogic Specific Deployment Descriptor 를 포함한 EJB 모듈로

부터 변환하는 방법이 있다.

도메인으로부터의 변환은 JEUS 의 Engine Container 로 WebLogic 의 도메인

을 이동시킬 때 사용된다. 변환 유틸리티는 JEUSMain.xml, EJBMain.xml, WEBMain.xml 그리고, JMSMain.xml 같은 JEUS 의 설정 파일들을 생성한다.

EJB Module 로부터의 변환은 사용자가 모듈을 Deploy 하는 것을 가능하게 하기 위해 Deployment Descriptor 를 만들어 준다.

변환 과정에 대한 설명은 다음과 같다.

1. 첫 번째 페이지는, 외부의 WAS 제품인 Source Type 을 선택할 수 있다. Convert From 메뉴에서 모든 도메인을 위한 것인지 아니면 EJB 모듈을 위한 것인지를 선택한다[그림 39].


Tmax Soft 73

2. 두 번째 페이지는 이전 페이지에서 Domain Directory 를 선택 했을 때와 EJB Module 을 선택 했을 때가 서로 다르게 나타난다. 아래 그림

은 EJB Module 을 선택했을 때 나타나는 그림이다[그림 40].

그림 40. Conversion 유틸리티의 두 번째 페이지인 EJB 모듈 변환페이지.

두 개의 옵션을 선택하는 항목이 나타나는데, 그 중에 JEUS DD Creation Only 를 선택하면 JEUS EJB DD 만을 생성하고, PRE Deployment 를 선택하면 JEUS System 에 EJB Engine 들의 Pre-Deployment 를 수행 한다. 그리고, 그들에 대한 하위 메뉴는 옵션의 선택에 따라 변한다. Pre-Deployment 옵션에 대한 하위 메뉴는 다음 그림과 같다[그림 41].


Tmax Soft 74

그림 41. EJB Module Conversion 유틸리티의 Pre-Deployment 옵션 설정 페이지.

3. Pre-Deployment 옵션 페이지에서는 적어도 하나의 타깃 Engine 을 선택 해야 한다. 그러면 그에 따른 JEUS EJB DD 파일들이 생성 하고, 그 파일을 Engine Configuration 디렉토리에 옮긴다. 아래의 ftp jeus dd only 를 선택하면 EJB Class 들의 전송은 하지 않는다.

4. 실행을 위한 마지막 페이지가 나타나고, 변환을 실행할 수 있다. 페이

지의 상단에는 간단한 변환 정보를 나타내며, 변환 정보는 변환 소스

에 따라 다르게 출력된다. ‘domain’ 변환에 대한 실행 페이지는 다음 그림과 같다[그림 42].


Tmax Soft 75

그림 42. Domain Conversion 의 실행 페이지.

5. 변환 정보를 확인 한 후에 Start 버튼을 클릭한다. 변환이 끝나면 다이

얼로그 창에 그 결과가 출력된다.

3.7.7 결론

지금까지 JManager 의 유틸리티들을 사용하는 방법에 대해서 설명을 하였다. 유틸리티로는 XML 편집, FTP, Serialization, DD Generation 그리고, Automatic Conversion 이 있다.

3.8 결론 이 장에서 JManager 에 대해서 배웠다. JManager 는 JEUS Server 를 관리 하는

데 있어서 매우 편리한 방법을 제공한다. JManager 에는 관리자를 위한 Application Deployment 나 Assembler 와 같은 기능을 제공한다. 또한 사용자

가 JEUS Server 의 로그를 분석하도록 도와주고, FTP 와 직렬화 기능과 같은 몇 가지 유틸리티도 제공한다.

다음 절에서는 WebManager 에 대해서 살펴본다.


Tmax Soft 76


Tmax Soft 77

4 웹 기반의 WebManager Tool

4.1 소개 JManager 외에도 WebManager 라는 GUI 툴이 있다.

WebManager 는 JEUS Server 와 상호 작용하도록 도와주는 웹 기반의 GUI 툴 이다. 웹 브라우저가 사용 가능한 어떤 곳에서든 WebManager 로 JEUS Server 와 접속할 수 있다. WebManager 는 JManager 와 다루는 방법은 다소 다르지만, 근본적으로 비슷한 기능을 제공한다.

WebManager 사용법에 대해서 알아보자.

4.2 WebManager의 기본적인 사용법 4.2.1 소개

이 절에서는 WebManager 를 어떻게 설정, 조작하는 지에 대해서 설명하고, JEUSMain.xml 에서 WebManager 를 사용 가능하게 설정하는 것과, 메뉴 사용법의 기본적인 방향을 제시 한다.

4.2.2 WebManager의 사용

WebManager 를 사용하기 위해서는 JEUSMain.xml 에 설정을 해야 한다. 아래는 WebManager 를 사용할 수 있도록 한 예제이다.

<<JEUSMain.xml>> <jeus-system> <node> <name>dekim</name> <class-ftp>true</class-ftp> <sequential-start>false</sequential-start> <enable-webadmin>true</enable-webadmin>

. . . </node> . . .


Tmax Soft 78

</jeus-system>

<enable-webadmin>태그는 WebManager 를 사용할 수 있게 해 준다. JManager Tool 을 사용해서 이 구성을 수정 할 수도 있다. JManager 의 Administration Mode 에서 JEUS System 노드를 선택한다. Configuration 탭 안에서 node 를 선택하고, modify 버튼을 클릭하면 아래 그림과 같이 노드에 대한 Configuration 다이얼로그 박스가 뜬다[그림 43]. enable-webadmin 옵션을 체크하고 ok 버튼을 클릭하고 나서 반드시 JEUS 를 재부팅을 한다.

그림 43.JManager 에서의 WebManager 기능 선택

4.2.3 WebManager의 시작

JEUS 가 기동이 되었고, JEUSMain.xml 에 WebManager 가 설정이 되어 있다

면 웹 브라우저에서 WebManager 를 사용할 수 있다. 웹 브라우저로 WebManager 에 접속을 하기 위해서는 아래와 같이 URL 입력 창에 JEUS 가 설치된 원격 머신의 IP 나 HostName 을 입력을 해야 하며 Port 번호는 JEUS_BASEPORT 에 8 을 더해야 한다. 예를 들어 JEUS_BASEPORT 가 9736이라고 하면 WebManager 에 접속하기 위한 Port 번호는 9744 가 된다. 그리고, 맨 뒤에는 “/webadmin” 을 덧붙인다. 실행 예는 다음과 같다.


Tmax Soft 79

http://192.168.1.94:9744/webadmin

브라우저로 위의 URL 로 접근하면, 사용자 인증을 위한 로그인 페이지가 나타난다. 적절한 아이디와 비밀번호를 입력한 다음, OK 버튼을 클릭한다 [ 그림 44].

그림 44. WebManager 의 로그인 페이지.

, Tmax Soft Applet 사용자 인증이 성공적이라면 가 전자 서명한 을 신뢰할지 [여부를 묻는 대화상자가 팝업된다 그림 45]. session 이 번 에만 신뢰할 경우에 YES , 를 이후에도 계속 신뢰할 경우에는 Always , 를 결코 신뢰하지

않을 경우 NO . 를 선택한다 NO , WebManager 를 선택한 경우 의 일부 기능이 .정상적으로 작동하지 않을 수 있다


Tmax Soft 80

그림 45. Tmax Soft 의 전자 서명을 신뢰할 지 여부를 묻는 대화상자

초기화 작업이 완료되면, 다음과 같은 Applet 과 HTML 로 구성된 WebManager 의 초기 페이지가 보여진다 [그림 46].

그림 46. WebManager 초기 페이지


Tmax Soft 81

4.2.4 기본적인 메뉴

WebManager 는 왼쪽에 System Tree Panel, 오른쪽에 Information Window Panel 이 있다. System Tree Panel 에서 해당 노드를 클릭 함으로써 각 컴포넌

트를 운영할 수 있다. 각 컴포넌트의 상세한 정보는 Information Window Panel 에 보여진다.

4.2.5 WebManager의 종료

간단히 웹 브라우저를 닫으면 된다.

4.2.6 Web Manager 로그

WebManager 는 실제로 JEUS_HOME\webhome\admin_home 디렉토리 밑에 있으며, 하나의 Servlet 어플리케이션이다.

WebManager 의 로그는 다음의 디렉토리에 생긴다.

JEUS_HOME\logs\<node name>_system_engine\

이 디렉토리의 아래에 있는 에러 로그들은 내부 Servlet Engine 에 의해 만들

어지며, 이 Servlet Engine 은 WebManager 어플리케이션을 실행시키는데 사용된다. 이 디렉토리의 파일들은 “stderr_MMDDYYYY.log”의 포맷을 가지

며, Exception 도 포함한다. 또한 이 디렉토리 아래에 JeusSystem 디렉토리가 있다.

JEUS_HOME\logs\<node name>_system_engine\JeusSystem\

이 디렉토리는 3 개의 하위 디렉토리를 포함한다.

• accesslog: 어플리케이션에 대한 접근 정보.

• errorlog: WebManager 어플리케이션 그 자체에서 만들어진 에러 데이터와 예외처리.

• userlog: ServletContext.log() 메소드의 사용을 통해 출력된 메시지들

은 각각 userlog 에 기록된다.

WebManager 를 위해 기록된 사항은 Web Context Group 의 기록 사항과 동일

하다. 로깅에 관한 더 자세한 사항은 JEUS Web Container 안내서를 참조하기 바란다.


Tmax Soft 82

4.2.7 결론

WebManager 의 기본동작과 WebManager 를 사용할 수 있게 하는 방법을 알았고, 로그파일의 저장에 관련된 정보 뿐 아니라 HTML 을 바탕으로 한 WebManager Tool 의 기본적인 메뉴 사용법에 대해서 알아봤다.

다음 절에서는 JEUS 관리를 위해 WebManager 를 사용하는 방법에 대해서 설명한다.

4.3 WebManager를 이용한 JEUS 관리 4.3.1 소개

WebManager 는 주로 설정 파일 편집, 컨트롤, 모니터링 기능을 제공한다. 이번 절에서 JEUS 관리를 위한 WebManager 를 사용하는 방법을 설명한다.

WebManager 의 Information Window Panel 에는 주로 Configuration, Monitoring, Controlling 탭으로 이뤄져 있다.

4.3.2 Configuration

Configuration 탭은 설정을 수정할 수 있는 곳이며, 몇 개의 하위 탭으로 이뤄져 있다. 그리고 Add, Delete, Modify 를 위한 버튼들을 가지고 있고, 각각

의 변경 사항은 이 버튼들을 누른 후에 저장된다 [그림 47].


Tmax Soft 83

그림 47. WebManager 를 사용한 JEUS node 설정 화면.

변경 사항을 반영하기 위해서는 컴포넌트를 재 시작해야 한다. 하지만 JEUS node 에 대해서는 WebManager 서비스에 대한 지속성을 유지 하면서 재부팅

할 수는 없다. 노드를 재부팅하기 위해서는 JManager 또는 jeusadmin 콘솔 툴을 이용하기 바란다.

4.3.3 Monitoring

Information Window Panel 에 Monitoring 탭이 있다. 이 탭을 클릭하면 실행 중인 컴포넌트의 상태와 데이터를 보여준다. 모니터링 페이지의 오른쪽 위 부분의 Repeat 버튼을 클릭하면 지속적인 모니터링을 할 수 있다[그림 48].


Tmax Soft 84

그림 48. WebManager 의 모니터링 페이지에 대한 Repeat 버튼 설명.

JEUS System 레벨에서는 모든 Engine 들의 상태를 요약해서 표로 보여 준다. System tree 의 JEUS System 노드를 클릭하면 모니터링 페이지의 Status Table 이 보인다. Status Table 탭에서는 현재 Servlet Engine 에 대한 정보만을 제공한다. 이 화면에서는 Thread pool, Datasource pool 그리고 Session server 등에 대한 정보를 보여준다. 아래 그림은 Status Table 에 대한 페이지이다[그림 49].


Tmax Soft 85

그림 49. Engine 의 Status Table 화면.

어떤 상태가 되면 관리자에게 통보하도록 하기 위해서, 데이터 모니터링을 위한 Threshold 값을 설정할 수 있다. 만약에 모니터링 데이터가 규정된 Threshold 값을 초과 한다면, 그 컬럼이 붉은 색으로 표시된다. 모니터링 화면의 Threshold Setting 항목을 클릭하여 Threshold 값을 설정할 수가 있다.

Status Table 모니터링에 대한 몇 가지 옵션을 Monitoring Setting tab 에서 설정할 수 있다. 설정 옵션에는 Enable Servlet Monitoring, Data Update Interval, Monitoring Data Logging 이 있다. 모니터링 data 는 설정한 Data Update Interval 간격으로 업데이트된다. 따라서, 브라우저는 해당 간격으로 monitoring 페이지를 재로딩하게 된다. logging 옵션을 선택한 경우, 모니터링 data 는 각 엔진별 log 파일에 기록되며, 해당 위치는 JEUS_HOME/logs/moni tor 디렉토리이다.

4.3.4 Controlling

마지막으로 Controlling 탭이 있으며, 이 탭을 누르면 아래 그림과 같은 Control 메뉴를 볼 수 있다. 이 페이지 아래 부분의 Perform 버튼을 클릭하면 명령이 수행된다[그림 50].

참고: System tree 의 컴포넌트 타입에 따라 Controlling 탭을 클릭했을 때 보여주는 내용이 다르다.


Tmax Soft 86

그림 50. WebManager 의 EJB Engine 컨트롤 화면.

4.3.5 Access Control

WebManager 에 대한 접근 권한을 구성할 수 있다. WebManager 에 대한 접근 권한을 가진 Role 이 2 개가 있는데, system 과 webmonitor 이다. 롤이 system인 사용자는 WebManager 의 모든 페이지에 접근이 가능하다. 하지만 Role 이 webmonitor 인 사용자는 오직 Monitoring 에 관련된 페이지에만 접근이 가능

하다.

예를 들면, 만약 사용자 ‘webadmin’이 webmonitor 의 역할만 가지고 있다면 Monitoring 권한과 Configurtion 을 읽는 것에 대한 권한으로만 접근이 되며, 컴포넌트를 제어 하고 구성을 변경하기 위한 페이지에 접근하려고 한다면 에러가 발생한다. 아래의 표는 webmonitor 와 webadmin 의 Role 을 가진 사용자를 지정한 file-realm.xml 의 일부이다.

<<file-realm.xml>> <file-realm> <role> <role-name>webmonitor</role-name> <description>web monitoring</description> </role> <user>


Tmax Soft 87

<user-name>webadmin</user-name> <password>...</password> <role-name>webmonitor</role-name> </user> <acl> <resource-type>jeus</resource-type> <resource-name>admin</resource-name> <resource-action>monitor</resource-action> <role-name>webmonitor</role-name> </acl> . . .

4.3.6 결론

WebManager 를 사용해서 JEUS 의 컴포넌트를 설정, 모니터링, 제어하는 방법을 설명 했다. 주로 System tree 에서 마우스 오른쪽 버튼을 클릭해서 메뉴

에 접근 하고, 오른쪽 윈도우 창에 여러 가지 하위 탭을 이용해서 실행할 수 있다.

다음 절에서는 WebManager 로 Deploy 를 수행하는 방법에 대해서 알아본다.

4.4 WebManager를 사용한 JEUS Deployment 4.4.1 소개

이 절에서는 WebManager 를 사용해서 JEUS 에 J2EE 모듈을 Deploy 하는 방법을 설명한다. WebManager 에서는 기본적으로 JAR 파일을 업 로드 하고, Deploy 를 실행 한다.

4.4.2 Deploy 절차

1. system tree 하단의 Deployment 노드( ) 를 찾아 본다.

2. Deployment 노드를 클릭하면, 오른쪽 창에 다음과 같이 deploy 모드

를 선택하는 화면을 볼 수 있다[그림 51]

3. Deployment 노드 아래에 5 가지의 서로 다른 deployment 를 나타내는 하위 노드가 있다. Application 노드는 EAR 모듈을 deploy 하는 것이

고, EJB 노드는 EJB 모듈을 deploy 한다. 그리고, Servlet 노드는 WEB


Tmax Soft 88

모듈을 , Application Client 노드는 J2EE client 모듈을, RAR 노드는 J2EE connector 모듈을 각각 deploy 한다 [그림 51].

그림 51. WebManager 의 deployment 페이지

4. Application 을 deploy 할 경우, 우선 EAR 파일을 업로드 하고, Target Engine Container 와 Context Group Name 을 지정한다. 그리고, 설정 파일에 deploy 된 EAR 모듈을 등록할 지 말지를 선택한다.

5. EJB 와 Servlet 을 deploy 할 경우, 공통으로 다음 4 개의 입력 항목이 필요하다. : Deploy Mode Target Engine, JAR/WAR Source Path, JEUS DD Path. 이와 별도로 Servlet 을 deploy 하기 위해서는 Context Group Name, Context Path , Context Registration option 이 필요하다.

6. Deploy Mode 는 pre-deployment 를 할지 runtime-deployment 를 할 지 결정하는데 사용되며, source path 는 업로드할 source JAR/WAR 파일

의 위치를 지정하는데 사용된다. 원칙적으로 JAR/WAR 는 JEUS 고유의 deployment descriptor(이하 JEUS DD 파일)를 포함해야 한다. 그러나, 포함되어 있지 않을 경우, 특정 JEUS DD 파일을 선택할 수 있다.


Tmax Soft 89

7. 만약, JAR 파일이 JEUS DD 파일을 포함하고 있지 않다면, 반드시 JEUS DD 파일 경로를 설정해 주어야 한다. JEUS DD 파일 이름은 끝에 모듈 이름을 포함해야 한다 (e.g. “jeus-ejb-dd_MyModule.xml”).

8. Application client 모듈을 deploy 할 경우, target node name 과 JAR source path, JEUS DD path 를 지정해 주어야 한다.

9. RAR 모듈을 deploy 할 경우, RAR source path 와 target node name 을 지정해 주어야 한다.

10. 각 deployment 에서 요구하는 입력 사항을 기재한 다음, Deploy 버튼

을 클릭한다.

11. deployment 가 이루어 지고, deploy 결과를 나타내는 페이지가 로딩된

다.

4.5 결론 WebManager 는 JEUS 를 관리하는 웹 기반의 GUI Tool 이다. 웹 브라우저를 사용 할 수 있는 환경이라면 어디서나 WebManager 를 통해서 JEUS 에 대한 Configuration, Monitoring, Controlling 을 할 수 있다.


Tmax Soft 90


Tmax Soft 91

5 결론

JEUS 를 관리 하는 2 개의 주요 GUI Tool 인 JManager 와 WebManager 는 JEUS 의 모든 시스템을 쉽게 관리 할 수 있는 통합된 System Tree Panel 을 제공하며, System Tree Panel 로부터 자세한 정보의 모니터링, 관리, 설정 정보

를 자세하게 확인할 수 있다. Deploy 와 로그 분석 기능도 수행할 수 있다. 이 외에도 JManager 에서는 여러 가지 편리한 유틸리티들을 제공한다.


Tmax Soft 92


Tmax Soft 93

A Deployment 유틸리티 레퍼런스

A.1 소개 JEUS 는 다양한 Deployment 유틸리티들을 제공한다. 이 유틸리티를 사용해

서 JEUS Deployment Descriptor 를 생성하고 J2EE 모듈을 Deploy 할 수 있다. 또한, JEUS Deployment 유틸리티를 사용해서 여러 종류의 개발툴에서 Deployment Bridge 모듈을 작성 할 수 있다.

Deployment 유틸리티들은 2 가지 타입이 있다. 하나는 어플리케이션에서 Deploy 를 할 수 있도록 해주는 API 이고, 다른 하나는 간단하게 Deploy 할 수 있는 Console Tool 이다.

참고: EJB 어플리케이션에 대한 Deployment 를 위해, JAR 방식과 DIR 방식을 선택할 수 있다. Deployment 어플리케이션에 대한 java 명령을 수행 할 때 ‘-Djeus.ejb.classloadingmode=JAR’라는 옵션을 사용하면 JAR 모드로 Deploy가 수행 된다. Default 값은 DIR mode 이다.

A.2 프로그래밍 API (jeus.tool.deployment패키지) 모든 Deployment API 는 jeus.tool.deployment 패키지에 속한다.

class EJBDeploymentManager

public class EJBDeploymentManager

이 클래스는 EJB 모듈의 Deployment 를 수행하는 클래스이다. EJB Engine 에 Deployment 가 수행 되기를 원한다면 이 객체를 생성해야 한다.

생성자

public EJBDeploymentManager(String nodename, String enginename, String loginname, String password)

설명


Tmax Soft 94

• 생성자의 파라미터인 노드명과 Engine 명으로 EJB Engine 을 구분하는 EJBDeploymentManager 를 생성한다.

파라미터

• String nodename: Deploy 하는 JEUS node name

• String enginename: Deploy 하는 EJB Engine name

• String loginname: ‘System’ role 을 가진 login name

• String password: login name 에 대한 패스워드.

메소드

Public boolean executeDeploy(String sourcePath, String jeusDDPath, boolean moduleRegist, Hashtable results)

설명

• 이 메소드는 EJBDeploymentManager 가 주어진 EJB 모듈을 Deploy 한다. EJB Engine 의 모듈 리스트에 모듈 명을 등록할 것인지의 여부를 결정할 수 있다. 모듈 명은 주어진 JEUS EJB DD 파일의 이름에 의해서 결정된다.

파라미터

• String sourcePath: EJB 모듈의 전체적인 경로이다. EJB 모듈은 J2EE 스펙을 따르는 ejb-jar.xml 을 포함해야 한다. 이 파일에는 JEUS Deployment Descriptor 를 포함할 수도 있다.

• String jeusDDPath: JEUS Deployment Descriptor file path 의 전체적인 경로이다. 만약 인자 값이 주어지지 않는다면, EJB 모듈 패키지에서 JEUS DD 를 찾는다.

• boolean moduleRegist: 이 값이 참일 경우 EJB 모듈의 이름은 EJB 환경파일의 모듈 리스트에 등록이 된다.

• Hashtable results: Deployment 과정에 발생하는 fail 또는 success의 상태가 result 에 저장이 된다.

리턴 값


Tmax Soft 95

• boolean: 만약 Deployment 가 성공하면 true 를 리턴하고, 실패

하면 false 를 리턴한다.

Public boolean executePredeploy(String sourcePath, String jeusDDPath, boolean moduleRegist, Hashtable results)

설명

• 이 메소드는 EJBDeploymentManager 가 Deployment 를 위해 필요한 파일들(JAR 파일들)을 EJB_HOME 디렉토리에 옮기고, JEUS DD 파일들을 Engine Configuration 디렉토리에 옮긴다.

파라미터

• String sourcePath: EJB 모듈에 대한 전체적인 경로이다. EJB 모듈은 J2EE 스팩에 따르는 ejb-jar.xml 을 포함해야 하며, JEUS Deployment Descriptor 를 포함할 수도 있다.

• String jeusDDPath: JEUS Deployment Descriptor 파일 패스의 전체경로이다. 만약 인자 값이 주어지지 않는다면, EJB 모듈 패키지에서 JEUS DD 를 찾는다.

• boolean moduleRegist: 만약 이 값이 참이라면 EJB 모듈의 이름

이 EJB Engine 구성파일의 모듈 리스트에 등록된다.


리턴 값

• boolean: Deployment 과정에 발생하는 fail 또는 success 의 상태

가 result 에 저장이 된다.

Public boolean executeRedeploy(String sourcePath, String jeusDDPath, Hashtable results)

설명

• 이 메소드는 이미 Deployment 된 EJB 모듈을 Undeploy 한 다음 다시 Deploy 를 실행 해준다. 모듈 명은 주어진 JEUS EJB DD파일의 이름에 의해 결정된다. 이 메소드는 모듈이 성공적으로 Deployment 된 후에 호출이 되어야 한다.


Tmax Soft 96

파라미터

• String sourcePath: EJB 모듈에 대한 전체적인 경로이다. EJB 모듈은 J2EE 스팩에 따르는 ejb-jar.xml 을 포함해야 하며, JEUS Deployment Descriptor 를 포함할 수도 있다.

• String jeusDDPath: JEUS Deployment descriptor 파일 패스의 전체적인 경로이다. 만약 이 인자 값이 주어지지 않는다면, EJB 모듈 패키지에서 JEUS DD 를 찾는다.

• Hashtable results: Deployment 과정에 발생하는 fail 또는 success의 상태가 result 에 저장이 된다..

리턴 값

• boolean: 성공하면 true 를 리턴하고, 실패하면 false 를 리턴한

다.

public boolean executeDeploy(String moduleName, Hashtable results)

설명

• 이 메소드는 주어진 모듈 명을 가지고 EJB 모듈을 Deploy 하도

록 사용된다. 이 메소드가 수행되기 전에 pre-deploy 로 사전에 이미 필요한 파일들이 전송 되어 있어야 한다.

파라미터

• String modulename: Deployment 할 EJB 모듈 이름이다.


리턴 값


다.

Public boolean executeUndeploy(String modulename, boolean deregist, Hashtable results)

설명


Tmax Soft 97

• 이 메소드는 EJB 모듈에 대한 Undeploy 를 위한 것이다. EJB Engine 의 모듈 리스트에 모듈 명의 등록을 취소할 것인지의 여부를 결정 할 수 있다.

파라미터

• String modulename: Undeployment 를 원하는 EJB 모듈 이름이

다.

• boolean deregist: 만일 이 값이 참이면, EJB 모듈의 모듈 명은 EJB Engine 의 구성파일의 모듈 리스트로부터 삭제된다.


리턴 값


다.

Public boolean executeReload(String modulename, Hashtable results)

설명

• EJB 모듈을 Reload 하기 위한 메소드이다.

파라미터

• String modulename: Reload 할 EJB 모듈의 이름이다.


리턴 값


다.

public String[] executeModuleList(Hashtable results)

설명

• 이 메소드는 EJB Engine 의 모듈 리스트를 찾아준다.


Tmax Soft 98

파라미터


리턴 값


다.

public String[] executeEJBNames(String moduleName, Hashtable results)

설명

• 이 메소드는 EJB Engine 의 해당 모듈에 대한 EJB 의 리스트를 찾아준다.

파라미터

• String moduleName: EJB 모듈이름으로 원하는 EJB 의 리스트

를 얻어준다.


리턴 값


다.

class WEBDeploymentManager

public class WEBDeploymentManager

이 클래스는 WEB 모듈의 Deployment 를 담당하는 에이전트이다. 각 Servlet Engine 에 Deployment 가 수행 되기를 원한다면 객체를 생성해주어야 한다.

생성자

public WEBDeploymentManager(String nodeName, String engineName, String loginName, String password)

설명


Tmax Soft 99

• 생성자의 인자인 NodeName 과 EngineName 을 이용하여 WEBDeploymentManager 는 특정 Servlet Engine 을 식별한다.

파라미터

• String nodename: Deployment 를 수행하고자 하는 JEUS node 명이다.

• String enginename: Deployment 를 수행하고자 하는 Servlet Engine 명이다.

• String loginname: System Role 을 가진 login 명

• String password: 로그인 명에 대한 패스워드.

메소드

public boolean executeDeploy(String sourcePath, String jeusDDPath, String contextGroupName, String ctxPath, boolean moduleRegist, Hashtable results)

설명

• 이 메소드는 WEBDeploymentManager 를 이용하여 주어진 WEB 모듈의 Deployment 를 수행하도록 해준다. Servlet Engine의 Context Group 이 지정하여야 하며, Servlet Engine 의 Context 리스트에 모듈 명을 등록할 것인지 아닌지를 결정 할 수가 있다. 모듈 명은 주어진 JEUS WEB DD 파일 이름에 의해 결정 된다.

파라미터

• String sourcePath: WEB 모듈의 전체적인 패스 경로이다. WEB 모듈은 J2EE 스펙을 따르는 web.xml 을 포함해야 하며, JEUS Deployment Descriptor 를 포함할 수도 있다.

• String jeusDDPath: JEUS Deployment Descriptor 파일의 전체적

인 패스 경로이다. 만약 이 인자 값이 주어지지 않는다면, WEB 모듈 패키지에서 JEUS DD 를 찾는다.


Tmax Soft 100

• String contextGroupName: Deployment 를 수행 할 때 Context Group 이름이 지정 된다. 반드시 Servlet Engine 의 Context Group 을 지정해야 한다.

• String ctxPath: Deployment 된 WEB 모듈에 생성될 Context 에 대한 경로이다. 이 Context 경로를 지정하지 않는다면 기본으

로 ‘/<context name>’ 형태로 지정이 될 것이다.

• boolean moduleRegist: 만일 이것이 참이라면, WEB 모듈의 모듈 명이 WEB Engine 의 구성파일의 Context 리스트에 등록이 된다.


리턴 값

• boolean: Deployment 가 성공하면 true 를 리턴 하고, 실패하면 false 를 리턴한다.

public boolean executePredeploy(String sourcePath, String jeusDDPath, String contextGroupName, String ctxPath, boolean moduleRegist, Hashtable results)

설명

• 이 메소드는 WEBDeploymentManager 가 Deployment 를 위해 WEB_HOME 디렉토리에 필요한 클래스 파일들을 옮기고, Engine 구성 디렉토리에 JEUS DD 파일을 옮긴다.

파라미터

• String sourcePath: WEB 모듈의 전체적인 경로이다. WEB 모듈

은 J2EE 스펙을 따르는 web.xml 을 포함해야 하며, JEUS Deployment Descriptor 를 포함할 수도 있다.

• String jeusDDPath: JEUS Deployment Descriptor 파일 패스의 전체적인 경로이다. 만약 이 인자 값이 주어지지 않는다면, WEB 모듈 패키지에서 JEUS DD 를 찾는다.


Tmax Soft 101

• String contextGroupName: Deployment 를 수행 할 때 Context Group 이름이 지정 된다. 반드시 Servlet Engine 의 Context Group 을 지정해야 한다.

• String ctxPath: Deployment 된 WEB 모듈에 생성될 Context 에 대한 경로이다. 이 Context 경로를 지정하지 않는다면 기본으

로 ‘/context name’ 형태로 지정이 될 것이다.

• boolean moduleRegist: 만일 이것이 참이라면, WEB 모듈의 모듈 명이 WEBEngine 의 구성파일의 Context 리스트에 등록이 된다.


리턴 값

• boolean: 만일 Deployment 가 성공하면 true 를 리턴하고, 실패

하면 false 를 리턴한다.

public boolean executeRedeploy(String sourcePath, String jeusDDPath, String contextGroupName, String ctxPath, Hashtable results)

설명

• 이 메소드는 이미 Deployment 된 WEB 모듈을 Undeployment 한 다음 다시 Deployment 를 수행 하도록 사용된다. 모듈 명은 주어진 JEUS WEB DD 파일의 이름에 의해 결정된다. 이 메소드

는 모듈이 성공적으로 Deploy 된 후에 호출되어야 한다.

파라미터

• String sourcePath: WEB 모듈의 전체적인 패스 경로이다. WEB모듈은 J2EE 스펙에 따르는 web.xml 을 포함해야 하며, JEUS Deployment Descriptor 를 포함할 수도 있다.

• String jeusDDPath: JEUS Deployment Descriptor 파일 패스의 전체적인 경로이다. 만약 이 인자 값이 주어지지 않는다면, WEB 모듈 패키지에서 JEUS DD 를 찾는다.


Tmax Soft 102

• String contextGroupName: Redeployment 할 때 Context Group 이름을 지정한다. 반드시 Servlet Engine 의 Context Group 을 지정

해야 한다.

• String ctxPath: Redeployment 된 WEB 모듈에 생성될 Context 에 대한 경로이다. 이 Context 경로를 지정하지 않는다면 기본으

로 ‘/<context name>’ 형태로 지정이 될 것이다.


리턴 값


다.

public boolean executeUndeploy(String contextGroupName, String contextName, boolean deregist, Hashtable results)

설명

• 이 메소드는 주어진 WEB 모듈의 Undeployment 를 수행 한다. WEBEngine 의 Context 리스트에 등록된 모듈 명을 제거할 것인지 아닌지의 여부를 결정 할 수 있다.

파라미터

• String contextGroupName: Undeployment 를 수행 할 Context Group 이름이다.

• String contextName: Undeployment 를 수행 할 Context name 이

다.

• boolean deregist: 이 값이 true 이면 WEB Engine 의 구성파일의 Context 리스트에서 Context name 을 삭제한다.


리턴 값


다.


Tmax Soft 103

public boolean executeReload(String contextGroupName, String contextName, Hashtable results)

설명

• 이 메소드는 주어진 Context 에 대한 Reload 를 수행 한다.

파라미터

• String contextGroupName: Reload 할 Context Group 의 이름이다.

• String contextName: Reload 할 Context 의 이름이다.


리턴 값

• boolean: 성공하면 true 를 리턴 하고, 실패하면 false 를 리턴 한다.

class AppCliDeploymentManager

public class AppCliDeploymentManager

이 클래스는 Application Client 모듈의 Deployment 를 수행 하는 클래스이다. 각 JEUS 노드에 대해서 Deployment 를 수행 하기 위해 이 객체를 생성해야 한다.

생성자

public AppCliDeploymentManager(String nodename, String loginname, String password )

설명

• JEUS 노드에 대한 EJBDeploymentManager 의 생성자이다.

파라미터

• String nodename: Deployment 를 호출할 JEUS node 명.

• String loginname: System Role 을 가진 login name.

• String password: 로그인 이름에 대한 패스워드.


Tmax Soft 104

메소드

public boolean executeDeploy(String sourcePath, String jeusDDPath, Hashtable results)

설명

• 이 메소드는 AppCliDeploymentManager 를 이용하여 주어진 어플리케이션 클라이언트 모듈의 Deployment 를 수행하도록 한다. 모듈 명은 인자로 지정한 JEUS Client DD 파일에 의해서 결정된다.

파라미터

• String sourcePath: Application Client 모듈의 전체적인 경로이다. Application Client 모듈은 반드시 J2EE 스펙을 따르는 application-client.xml 을 포함해야 한다.

• String jeusDDPath: JEUS Deployment Descriptor 파일 패스의 전체적인 경로이다.


리턴 값


다.

A.3 Command Line Deployment Tool Command Line Deployment Tool 은 실제로 Deployment API 에 의해 구현된 단순한 클래스이다. Command Line Tool 을 사용해서 EJB 모듈과 WEB 모듈

을 Deploy 할 수 있다.

EJB Module Deployment

만약 EJB 모듈을 관리하기 위해서는, jeus.tool.deployment.deployer 야 한다. 호출 방법은 다음과 같다.

java jeus.tool.deployment.deployer

[deploy|pre_deploy|undeploy|redeploy|reload] [-n node_name] [-e


Tmax Soft 105

engine_name] [-u id] [-p password] [-m module_name] [-s

src_jar_path] [-r true|false]

첫 번째 파라미터는 Action 타입으로 수행할 명령의 형태를 지정한다. deployer, pre_deploy, undeploy, redeploy, reload 중에서 선택을 할 수 있다. node name, engine name, user id, password 는 반드시 입력을 해야 하며, deploy, pre_deploy, redeploy 를 수행 하기 위해서는 [-s src_jar_path]옵션을 강제로 입력 해야 하고, undeploy, reload 의 수행을 위해서는 [-m module_name]옵션이 필요하다. [-r true|false]옵션은 EJB Engine 의 모듈 리스트에 모듈 명을 등록

해 주기 위한 옵션이다. 이 옵션을 이용하면 undeploy 수행 시 모듈 리스트에

서 해당 모듈을 제거를 할 수 있다.

WEB Module Deployment

WEB 모듈을 관리하기 위해서 jeus.tool.deployment.webdeployer 클래스를 사용한다. 호출 방법은 다음과 같다.

java jeus.tool.deployment.webdeployer

[deploy|pre_deploy|undeploy|redeploy|reload] [-n node_name] [-e

engine_name] [-u id] [-p password] [-cg context_group_name|] [-c

context_name|] [-cp context_path] [-s src_jar_path] [-r

true|false]

EJB 모듈 Deployment 와 동일하게 첫 번째 파라미터는 수행 할 명령의 형태

로, deploy, pre_deploy, redeploy, reload 이다. node name, engine name, user id, password, Context Group name 은 필수적으로 입력을 해야 한다. deploy, pre_deploy, redeploy 수행을 위해서 [-s src_jar_path]옵션을 지정하여야 하고, undeploy, reload 동작을 위해서는 [-c context_name]옵션을 지정 해야 한다. [-r true|false] 옵션은 WEB Engine 의 Context 리스트에 Context name 을 등록할 것인지 여부를 결정한다. 이 옵션은 undeploy 가 취해질 때 Context 리스트에

서 제거를 할 수 있다는 의미이다. 만일 Context path 를 지정하지 않는다면 기본적으로 ‘/<context name>’이 Context path 로 지정이 된다.


Tmax Soft 106


Tmax Soft 107

B 유틸리티 콘솔 툴 레퍼런스

B.1 소개 JEUS 는 여러 유틸리티를 제공한다. 이 유틸리티의 기능을 JManager 를 통해

서 모두 가능하지만, Console Command 를 사용하면 편리하게 사용할 수 있다. 이 절에서는 Console Utility Tool 에 대한 정보를 제공한다.

B.2 DD 생성 유틸리티 콘솔 툴 DD 생성 유틸리티를 이용해서 EJB Bean 클래스로부터 JEUS EJB DD 를 생성할 수 있다. 3.7.5 절에서 설명한 GUI Tool 처럼 기본 디렉토리, 모듈 명, 소스 디렉토리, 저장 디렉토리를 지정한다. DD 생성 콘솔 툴에는 ‘base’, ‘package, ‘property’ 이렇게 세가지 사용 방식이 있다.

base 방식의 호출

Base 방식은 Base 디렉토리가 Source 디렉토리와 동일하게 취급된다. DD 파

일은 Base 디렉토리 아래에서 모든 클래스들을 사용해서 생성이 된다. 사용 방법은 다음과 같다.

ddinit <module-name> -base [-quiet|-inform|-verbose|-debug]

<base-directory> [<destination-directory>]

파라미터에 대한 설명

<module-name>

이 속성은 JEUS EJB 모듈의 유일한 식별자를 지정한다. JEUS EJB DD 파일의 파일 명은 jeus-ejb-dd_<modulename>.xml 과 ejb-jar_<modulename>.xml 과 같이 설정된다. 나중에 EJB Engine 에 모듈

을 등록 할 때, 모듈 명은 EJBMain.xml 의 <module-list>와 맞춰야 한다.

-base

Base 방식으로 동작하게 하는 옵션으로 필수 항목이다.


Tmax Soft 108

[-quiet|-inform|-verbose|-debug]

그것은 툴의 실행을 확인하는 메시지 레벨을 지정한다. 최소 레벨인 ‘-quiet’ 부터 가장 상세한 레벨인 ‘-debug’까지 있다.

<base-directory>

DD 파일을 생성하기를 원하는 EJB 클래스들의 Base 디렉토리를 지정

한다. 이것은 모든 클래스의 패키지에 대한 루트 디렉토리를 의미한

다.

[<destination-directory>]

만들어진 파일들을 저장하기 위해 디렉토리를 지정한다. 만약 아무것

도 지정을 하지 않으면 현재 작업하는 디렉토리에 저장을 한다.

예) 현재의 디렉토리가 EJB_HOME 이고, 기본 EJB 예제 account 와 hello 가 EJB_HOME 에 있다고 가정할 때. 다음과 같이 실행한다.

> ddinit sample –base %EJB_HOME%

package 방식의 호출

Package 방식은 Base 디렉토리가 Source 디렉토리와 다를 경우에 사용된다. 생성을 원하는 Source 디렉토리와 함께 패키지 명을 같이 제공을 해야 한다. 호출 방법은 다음과 같다.

ddinit <module-name> -pkg [-quiet|-inform|-verbose|-debug]

<package-name> <source-directory> [destination-directory]


<module-name>, [-quiet|-inform|-verbose|-debug], [destination-

directory]

위의 파라미터와 옵션은 위의 Base 방식과 동일하다.

-pkg

Package 방식으로 동작하게 하는 옵션으로 필수 항목이다.


Tmax Soft 109

<package-name>

EJB 클래스의 패키지 명

<source-directory>

EJB 클래스들이 존재 하는 디렉토리 경로이다.

예) 현재의 디렉토리가 EJB_HOME 이고, 기본 EJB 예제 account 와 hello 가 EJB_HOME 에 있다고 가정할 때. 다음과 같이 실행한다.

> ddinit sample –pkg account %EJB_HOME%\account

property 방식의 호출

Property 방식은 property 파일을 사용 가능하게 해주는 방식으로 JManager 에

서 DD Generation Tool 을 사용하기 편리하게 해준다. Property 파일은 모듈 명, Base 디렉토리, 저장 디렉토리와 같은 기본적인 Conversion 옵션을 포함

한다. Property 파일을 생성하기 위해 3.7.5 절을 참조한다. Property 방식의 호출을 위한 방법은 다음과 같다.

ddinit -property <property-file-path>


-property

Property 방식으로 동작하게 하는 옵션으로 필수 항목이다.

<property-file-path>

Property 파일에 대한 경로이다.

B.3 Conversion 유틸리티 콘솔 툴 Conversion 유틸리티는 타사의 WAS 제품에 호환되는 어플리케이션을 JEUS환경으로 마이그레이션시켜주는 툴이다. 콘솔 유틸리티 변환 툴은 JManager에 의해 제공되는 변환기능과 본질적으로 동일하다. 3.5.6 절을 참조한다.


Tmax Soft 110

현재 JEUS 는 BEA Inc.의 Weblogic 에서 운영되는 어플리케이션 들에 대한 변환을 지원한다. Conversion Source 는 Weblogic 의 하나의 ‘domain’ 또는 EJB 모듈이다.

WebLogic의 ‘domain’으로부터의 변환

수행 방법은 다음과 같다.

wltojeus domain <-s domain-dir>


domain

Weblogic 의 ‘domain’으로부터 변환 시 필수 항목이다.

<-s domain-dir>

변환되기를 원하는 ‘domain’의 목적 경로를 설정한다.

Weblogic Deployment Descriptor와 EJB 모듈로부터의 변환

호출방법은 다음과 같다.

wltojeus ejb <-s source-path> [-m module_name] [-sd save_dir]


ejb

Weblogic 에서 운영되는 EJB 모듈로부터 변환하도록 하는 옵션으로 필수 항목이다.

<-s source-path>

Weblogic 의 Deployment Descriptor 를 포함한 EJB 모듈의 전체 경로를 설정한다. Conversion 유틸리티는 해당 모듈로부터 JEUS DD 파일을 생성한다.

[-m module_name]

Deployment Descriptor 의 모듈 명을 설정할 수 있다. 기본값으로 jar 파

일의 이름이 모듈 명으로 설정된다.


Tmax Soft 111

[-sd save_dir]

생성된 DD 파일을 저장하는 디렉토리를 설정하는 옵션이다. 만일 설정하지 않는다면, 현재 작업중인 디렉토리 아래에 ‘jeusdd’로 저장이 된다.

참고: EJB 어플리케이션에 대한 변환을 위해, JAR 또는 DIR 의 Deployment 방식을 선택할 수 있다. 예를 들어 JAR 방식으로 어플리케이션을 Deployment 하기 위해서 wltojeus.bat 파일에 ‘-Djeus.ejb.classloadingmode =JAR’옵션을 설정하면 된다. Default 방식은 DIR 방식이 된다.


Tmax Soft 112


Tmax Soft 113

C tool-option.xml XML Configuration Reference

C.1 소개 본 부록에서는 tool-option.xml 의 모든 XML 요소를 나열하고, 기술한다. tool-option.xml 은 JEUS 의 구성을 위한 설정 파일이다. 이 파일에 대한 DTD는 “JEUS_HOME/config/dtds”디렉토리에 위치한 tool-option.dtd 이다.

본 부록의 레퍼런스는 3 개 하위 절로 나뉜다.

1. DTD/XML tree 는, XML 구성 파일의 모든 엘리먼트의 계층적인 목록이다. 각 엘리먼트 트리의 형식은 다음과 같다.

a. index number (예 (11))는, 태그 레퍼런스로 각 태그마다 인덱

스를 붙여 놓은 것이다. 태그 레퍼런스는 이 번호순서대로 설명한다.

b. DTD 에서 정의한 XML 태그 명을 <tag name>형식으로 표시한

다.

c. DTD 에서 정의한 Cardinality 를 표시한다. “?” = 0 개나 1 개의 element, “+” = 1 개 이상의 element, “*” = 0 개 이상의 element, (기호가 없음) = 정확히 1 개의 element.

d. 몇몇 태그에는 “P”문자를 붙여 놓았는데, 해당 태그는 성능에 관계되는 태그라는 것을 뜻한다. 이 태그는 설정을 튜닝 할 때 사용된다.

2. 태그 레퍼런스: 트리에 있는 각 XML 태그를 설명한다.

a. Description: XML 태그에 대한 간단한 설명

b. Value Description: XML 태그에 입력하는 값과 타입

c. Value Type: 값의 데이터 타입


Tmax Soft 114

d. Default Value: 해당 XML 을 사용하지 않았을 때 기본적으로 사용되는 값

e. Defined values: 이미 정해져 있는 값

f. Example: 해당 XML 태그에 대한 예

g. Performance Recommendation: 성능 향상을 위한 추천 값

h. Child Elements: 자신의 태그 안에 다시 태그를 포함하는 경우

에 사용 가능한 태그

3. 예제 XML 파일: “tool-option.xml”에 대한 완전한 예제

C.2 DTD/XML Tree (1) <tool-option> (2) <xml-option>? (3) <xml-parsing>? (4) <enable-validation>? (5) <local-dtd-validation>? (6) <ignore-element-order>? (7) <xml-writing>? (8) <show-default>? (9) <force-default-dtd>? (10) <default-dtd-dir>? (11) <boot-option>? (12) <dynamic>? (13) <xml-boot>? (14) <ejb-option>? (15) <fast-reload>?

C.3 Element Reference

(1) <tool-option>

Description Tool 옵션 설정 XML 의 최상위 element


Tmax Soft 115

Child Elements (2) xml-option?, (11) boot-option?, (14) ejb-option?

(2) <tool-option><xml-option>?

Description XML 관련 설정

Child Elements (3) xml-parsing?, (7) xml-writing?

(3) <tool-option><xml-option><xml-parsing>?

Description XML Parsing 옵션(특히 Validation)에 대한 설정

Child Elements (4) enable-validation?, (5) local-dtd-validation?, (6) ignore-element-order?

(4) <tool-option><xml-option><xml-parsing><enable-validation>?

Description Validation 사용 여부에 대한 옵션

Value Description Boolean 값으로, 가능하게 하거나 불가능 하게 한다

Value Type Boolean

Default Value true

Defined values true 사용 가능 false 사용 불가능

Example <enable-validation>true</enable-validation>

(5) <tool-option><xml-option><xml-parsing><local-dtd-validation>?

Description JEUS_HOME\config\dtds\ 에 위치한 DTD 파일을 사용해서 Validation 하도록 한다.


Value Type Boolean


Tmax Soft 116

Default Value false

Defined values true 사용가능 false 사용 불가능

Example <local-dtd-validation>true</local-dtd-validation>

(6) <tool-option><xml-option><xml-parsing><ignore-element-order>?

Description element 의 순서를 무시하게 하는 구성


Value Type Boolean

Default Value true


Example <ignore-element-order>true</ignore-element-order>

(7) <tool-option><xml-option><xml-writing>?

Description XML Writing 옵션에 대한 구성. XML Writing 은 XML 정보가 파일로 저장되는 것을 의미한다.

Child Elements (8) show-default?, (9) force-default-dtd?, (10) default-dtd-dir?

(8) <tool-option><xml-option><xml-writing><show-default>?

Description 각 element 의 기본값을 파일로 기록하게 하는 구성. 만약 ‘disable’이라면 파일로 기본값이 저장이 되지 않는다.



Tmax Soft 117

Value Type Boolean

Default Value false


Example <show-default>true</show-default>

(9) <tool-option><xml-option><xml-writing><force-default-dtd>?

Description XML 파일의 DOCType DTD 경로에, tool-option.xml 의 default-dtd-dir 값으로 재설정한다. 만약 이 설정 값이 ‘disable’이라면 현재의 DTD 경로가 보존된다.


Value Type Boolean

Default Value false


Example <force-default-dtd>true</force-default-dtd>

(10) <tool-option><xml-option><xml-writing><default-dtd-dir>?

태그 설명 force-default-dtd element 가 사용 가능하게 되면 Default DTD Path 가 저장이 된다.

값 설명 XML 파일의 DOCType 으로써 DTD 경로의 모든 경로

기본 값 http://www.tmaxsoft.com/jeus/dtd/4.0/

예 <default-dtd-dir> http://www.tmaxsoft.com/jeus/dtd/4.0/ </default-dtd-dir>

(11) <tool-option><boot-option>?


Tmax Soft 118

Description JManager 에 의해 사용되는 부트옵션에 대한 구성을 한다

Child Elements (12) dynamic?, (13) xml-boot?

(12) <tool-option><boot-option><dynamic>?

Description 부팅을 동적으로 할 것인지 아닌지를 설정한다


Value Type Boolean

Default Value false


Example <dynamic>true</dynamic>

(13) <tool-option><boot-option><xml-boot>?

Description 부팅을 XML Descriptor 를 사용할 것인지 아니면 Serialized Descriptor 를 사용할 것인지 설정 한다


Value Type Boolean

Default Value true


Example <xml-boot>true</xml-boot>

(14) <tool-option><ejb-option>?

Description EJB 에 관한 Tool 의 동작을 구성한다.

Child Elements (15) fast-reload?


Tmax Soft 119

(15) <tool-option><ejb-option><fast-reload>?

Description 만일 이 값이 true 일 경우 모든 EJB 에 대한 ‘reload’명령이 EJB stub class 들과 skeleton class 들을 컴파일 하지 않고 수행 된다. EJB 모듈의 Reloading 을 더 빠르게 하기 위한 속성으로 만약 값이 "false"라면, ‘reaload’명령이 수행 될 때 모든 EJB 구현 클래스들을 다시 컴파일 한다.


Value Type Boolean

Default Value false


Example <fast-reload>true</fast-reload>

C.4 tool-option.xml 의 샘플 <<tool-option.xml>>

<tool-option> <xml-option> <xml-parsing> <enable-validation>true</enable-validation> <local-dtd-validation>true</local-dtd-validation> <ignore-element-order>true</ignore-element-order> </xml-parsing> <xml-writing> <show-default>true</show-default> <force-default-dtd>true</force-default-dtd> <default-dtd-dir>http://www.tmaxsoft.com/jeus/dtd/4.0/</default-dtd-dir> </xml-writing> </xml-option> <boot-option>


Tmax Soft 120

<dynamic>true</dynamic> <xml-boot>true</xml-boot> </boot-option> <ejb-option> <fast-reload>true</fast-reload> </ejb-option> </tool-option>


Tmax Soft 121

D Monitoring API 레퍼런스

D.1 소개 JEUS 는 다양한 시스템 컴포넌트에 대한 모니터링 정보를 제공하는 모니터

링 API 를 제공한다.

이것은 특히 모니터링 툴을 커스트마이징하거나, 상용 모니터링툴로 JEUS 컴포넌드를 모니터링할 때 유용하다.

모니터링 API 는 다음 3 가지 패키지로 구성된다 : jeus.tool.monitorapi, jeus.tool.monitorapi.monitorinfo, jeus.tool.monitorapi.exceptions.

각 패키지에 대해 자세히 설명하겠다.

D.2 package jeus.tool.monitorapi JeusMonitorFactory 클래스는 모든 모니터링의 시작이 되는 부분이다.

자세한 모니터링 정보는 다양한 MonitorInfo 객체로 리턴된다.

Class JeusMonitorFactory

public class JeusMonitorFactory

이 클래스는 모니터링 정보를 추출하는 기본 클래스인, 다양한 종류의 MonitorManager 를 생성한다.

MonitorManager 인터페이스를 구현한 객체는 JeusMonotorFactory 의 getMonitorManager 메소드를 통해서만 생성된다.

Constructors

생성자

public JeusMonitorFactory(String nodeName, String id, String password)


Tmax Soft 122

설명

• 다양한 MonitorManager 를 생성하는 JeusMonitorManager 클래

스의 생성자. 노드 명과 보안 정보가 제공되어야 한다.

파라미터

• String nodename: 모니터링 정보를 가져올 노드 이름.

• String id: 보안을 위해 제공된 아이디.

• String password: 보안을 위해 제공된 아이디에 대한 비밀번호.

Methods

메서드

public ClusterMonitorInfo getClusterMonitorInfo()

설명

• 이 메서드는 노드 클러스터 모니터링 정보를 보여준다.

리턴 값

• ClusterMonitorInfo: 노드 클러스터 정보를 담고 있는 MonitorInfo 객체를 리턴한다.

예외

• MonitorException

public java.util.Iterator getGroupMonitorInfo()

설명

• 이 메서드는 모든 엔진 그룹에 대한 모니터링 정보를 보여준다.

리턴 값

•

• java.util.Iterator: 엔진 그룹 정보를 담고 있는 GroupMonitorInfo type 의 Iterator 리턴.


Tmax Soft 123

public NodeMonitorInfo getNodeMonitorInfo()

설명.

• 이 메서드는 특정 노드의 모니터링 정보를 가져온다.

리턴 값

• NodeMonitorInfo: 인자로 주어진 노드의 모니터링 정보를 담고 있는 MonitorInfo 객체를 리턴한다.

D.3 package jeus.tool.monitorapi.monitorinfo

Class ClusterMonitorInfo

public class ClusterMonitorInfo

이 클래스는 노드 클러스터링 정보를 보여준다.

Constructors

public ClusterMonitorInfo()

설명

• 노드 클러스터 정보를 담고 있는 ClusterMonitorInfo 클래스의 생성자.

Methods

public java.util.Iterator getAllNodeList()

설명

• 이 메서드는 노드 클러스터를 구성하는 모든 노드(부팅되지 않은 노드도 포함) 이름을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator 리턴. 각 String 은 클러스

터를 구성하는 노드 이름을 나타낸다.

public java.util.Iterator getClusteredNodeList()

설명


Tmax Soft 124

• 이 메서드는 클러스터를 구성하는 부팅된 노드 이름만 리턴한

다.

리턴 값

• java.util.Iterator: String type 의 Iterator 리턴. 각 String 은 부팅된 노드의 이름을 나타낸다.

public java.util.Iterator getMonitorInfo()

설명

• 이 메서드는 클러스터를 구성하는 모든 노드의 NodeMonitorInfo 객체를 리턴한다.

리턴 값

• java.util.Iterator: NodeMonitorInfo type 의 Iterator 를 리턴한다.

public NodeMonitorInfo getMonitorInfo(String nodeName)

설명

• 이 메서드는 특정 노드의 NodeMonitorInfo 객체를 리턴한다.

리턴 값

• NodeMonitorInfo: 노드의 모니터링 정보를 담고 있는 NodeMonitorInfo 객체를 리턴한다.

파라미터

• String nodename: 모니터링 정보를 가져올 노드 이름.

예외

• MonitorException

Class EJBEngineMonitorInfo

public class EJBEngineMonitorInfo

이 클래스는 EJB 엔진 모니터링 정보를 담고있다.

Constructors


Tmax Soft 125

public EJBEngineMonitorInfo()

설명

• EJB 엔진 정보를 담고 있는 EJBEngineMonitorInfo 클래스의 생성자.

Methods

public String getEJBEngineName()

설명

• 이 메서드는 EJB 엔진 이름을 보여준다.

리턴 값

• String: EJB 엔진 이름을 리턴한다.

public int getModuleCount()

설명

• 이 메서드는 deploy 된 모듈의 총 개수를 보여준다.

리턴 값

• int: deploy 된 모듈의 총 개수

public java.util.Iterator getModuleList()

설명

• 이 메서드는 deploy 된 모듈 목록을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 deploy 된 모듈의 이름을 나타낸다.

Class EngineContainerMonitorInfo

public class EngineContainerMonitorInfo

이 클래스는 엔진 컨테이너 모니터링 정보를 담고있다.


Tmax Soft 126

Constructors

public EngineContainerMonitorInfo()

설명

• 엔진 컨테이너 모니터링 정보를 담고 있 는 EngineContainerMonitorInfo 클래스의 생성자.

Methods

public boolean checkEngineAlive(String engineName)

설명

• 이 메서드는 true 또는 false 로 인자로 주어진 엔진의 상태를 보여준다.

리턴 값

• boolean: 인자로 주어진 엔진이 활성화된 상태라면 true 를 리턴

하고 그렇지 않다면 false 를 리턴한다.

public int getAliveEngineCount()

설명

• 이 메서드는 활성화된 엔진들의 총 개수를 보여준다.

리턴 값

• 활성화된 엔진들의 총 개수

public java.util.Iterator getAliveEngineList()

설명

• 이 메서드는 활성화된 엔진 목록을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator 리턴. 각 String 은 활성화

된 엔진 이름을 나타낸다.

public String getContainerName()


Tmax Soft 127

설명

• 이 메서드는 엔진 컨테이너의 이름을 보여준다.

리턴 값

• String: 엔진 컨테이너 이름을 나타내는 String 을 리턴한다.

public int getCurrentDBConnectionCount(String cpName)

설명

• 이 메서드는 해당 엔진 컨테이너의 특정 Connection Pool 에서 현재 맺고 있는 총 DB 커넥션 수를 리턴한다.

리턴 값

• Int: DB 커넥션의 수를 리턴한다.

파라미터

• String cpName: Pool 정보를 가져올 Connection Pool 의 이름.

public java.util.Iterator getDBConnectionList()

설명

• 이 메서드는 모든 DB Connection Pool 목록을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 DB Connectin Pool 의 이름을 나타낸다.

public EJBEngineMonitorInfo getEJBEngineMonitorInfo()

설명

• 이 메서드는 해당 엔진 컨테이너에 속한 EJB 엔진의 모니터링 정보를 리턴한다.

리턴 값

• EJBEngineMonitorInfo: EJB 엔진에 관한 모니터링 정보를 담고 있는 EJBEngineMonitorInfo 객체를 리턴한다.


Tmax Soft 128

public int getIdleDBConnectionCount()

설명

• 이 메서드는 해당 엔진 컨테이너의 총 idle DB Connection 수를 리턴한다.

리턴 값

• int: idle DB Connection 의 총 개수를 리턴한다.

public int getIdleDBConnectionCount(String cpName)

설명

• 이 메서드는 해당 엔진 컨테이너의 특정 Connection Pool 에 대해 총 idle DB Connection 의 수를 리턴한다.

리턴 값

• int: 특정 Connection Pool 의 총 idle DB Connection 수를 리턴한

다.

파라미터


public JMSEngineMonitorInfo getJMSEngineMonitorInfo

설명

• 이 메서드는 해당 엔진 컨테이너에에 속한 JMS 엔진에 대한 모니터링 정보를 리턴한다.

리턴 값

• JMSEngineMonitorInfo: JMS 엔진에 관한 모니터링 정보를 담고 있는 JMSEngineMonitorInfo 객체를 리턴한다.

public int getMaxDBConnectionCount(String cpName)

설명

• 해당 엔진 컨테이너의 특정 Connection Pool 에 대해 설정된 DB connection maximum size 값을 리턴한다.


Tmax Soft 129

리턴 값

• int: DB connection maximum size 에 설정된 값을 리턴한다.

파라미터


public int getMinDBConnectionCount(String cpName)

설명

• 해당 엔진 컨테이너의 특정 Connection Pool 에 대해 설정된 DB connection minimum size 값을 리턴한다.

리턴 값

• int: DB Connection minimum size 에 설정된 값을 리턴한다.

파라미터

• String cpName: Pool 정보를 가져올 Connection Pool 의 이름

public ServletEngineMonitorInfo getServletEngineMonitorInfo()

설명

• 이 메서드는 엔진 컨테이너에 속한 서블릿 엔진에 대한 모니터

링 정보를 리턴한다.

리턴 값

• ServletEngineMonitorInfo: 서블릿 엔진에 관한 모니터링 정보

를 담고 있는 ServletEngineMonitorInfo 객체를 리턴한다.

public boolean getWaitingDBConnection(String cpName)

설명

• 특정 Connection Pool 에서 DB 커넥션을 얻기 위해, 현재 큐에

서 대기하고 있는 클라이언트가 있는지 를 리턴한다.

리턴 값

• boolean: 클라이언트가 대기하고 있다면 true 를 리턴한다.


Tmax Soft 130

파라미터


public int getWorkingDBConnectionCount(String cpName)

설명

• 특정 Connection Pool 의 총 DB 커넥션 개수를 보여준다.

리턴 값

• int: 특정 Connection Pool 의 총 DB 커넥션 개수를 리턴한다.

파라미터


Class GroupMonitorInfo

public class GroupMonitorInfo

이 클래스는 엔진 그룹에 대한 모니터링 정보를 담고있다.

Constructors

public GroupMonitorInfo()

설명

• 엔진 그룹 모니터링 정보를 담고 있는 GroupMonitorInfo 클래

스의 생성자.

Methods

public boolean checkContainerAlive(String containerName)

설명

• 이 메서드는 특정 엔진 컨테이너가 활성화 되어 있는지 여부를 보여준다.

리턴 값

• boolean: 컨테이너가 활성화 상태이면 ‘true’를 비활성화 상태

이면 ‘false’를 리턴한다.


Tmax Soft 131

public int getAliveContainerCount()

설명

• 이 메서드는 활성화된 엔진 컨테이너의 총 개수를 보여준다.

리턴 값

• int: 엔진 그룹에 속한 활성화된 엔진 컨테이너의 총 개수를 리턴한다.

public java.util.Iterator getAliveContainerList()

설명

• 이 메서드는 해당 엔진 그룹에 속한 활성화된 엔진 컨테이너의 목록을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator 리턴. 각 String 은 그룹에 속한 엔진 컨테이너 이름을 나타낸다.

Class JMSEngineMonitorInfo

public class JMSEngineMonitorInfo

이 클래스는 JMS 엔진 모니터링 정보를 담고있다.

Constructors

public JMSEngineMonitorInfo()

설명

• JMS 엔진 모니터링 정보를 담고 있는 JMSEngineMonitorInfo 클래스의 생성자.

public java.util.Iterator getClientAddress()

설명

• 이 메서드는 클라이언트 주소 목록을 보여준다. 클라이언트란 JMS 서버와 메시지를 주고 받는 주체를 말한다. 클라이언트 주소는 IP 와 port 번호로 구성된다.


Tmax Soft 132

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 클라이언트 주소를 나타낸다.

public int getClientAddressSize()

설명

• 이 메서드는 총 클라이언트 수를 보여준다.

리턴 값

• int: 총 클라이언트 수를 리턴한다.

public java.util.Iterator getConnectionFactory()

설명

• 이 메서드는 Connection Factory 의 이름을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 Connection Factory 이름을 나타낸다.

public int getConnectionFactorySize()

설명

• 이 메서드는 Connection Factory 의 총 개수를 보여준다.

리턴 값

• Int: Connection Factory 의 총 개수를 리턴한다.

public int getDestinationNameSize()

설명

• 이 메서드는 destination 의 총 개수를 보여준다.

리턴 값

• int: destination 의 총 개수를 리턴한다.


Tmax Soft 133

public java.util.Iterator getDestination()

설명

• 이 메서드는 destination 의 이름을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 destination 이름을 나타낸다.

public java.util.Iterator getDurableSubscriber()

설명

• 이 메서드는 durable subscriber 의 이름을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 durable subscriber 이름을 나타낸다.

public int getDurableSubscriberSize()

설명

• 이 메서드는 durable subscriber 의 총 개수를 보여준다.

리턴 값

• int: durable subscriber 의 총 개수

public int getJMSEngineName()

설명

• 이 메소드는 JMS 엔진의 이름을 보여준다.

리턴 값

• String: JMS 엔진의 이름을 나타내는 String 을 리턴한다.

Class NodeMonitorInfo

public class NodeMonitorInfo


Tmax Soft 134

이 클래스는 노드 모니터링 정보를 담고있다.

Constructors

public NodeMonitorInfo()

설명

• 노드 모니터링 정보를 담고 있는 NodeMonitorInfo 클래스의 생성자.

Methods

public boolean checkEngineAlive(String engineName)

설명

• 이 메서드는 특정 엔진이 활성화 되었는지 아닌지를 보여준다.

리턴 값

• boolean: 엔진이 활성화 상태이면 true 아니면 false.

파라미터

• String enginename: 상태를 조회할 엔진의 이름.

public boolean checkGroupAlive(String groupName)

설명

• 이 메서드는 특정 엔진 그룹이 활성화 상태인지 아닌지를 보여

준다.

리턴 값

• boolean: 엔진 그룹이 활성화 상태라면 true 를 아니면 false 를 리턴한다.

파라미터

• String groupname: 상태를 조회할 엔진 그룹 이름.

public boolean checkNodeAlive(String nodeName)

설명


Tmax Soft 135

• 이 메서드는 특정 노드가 활성화 상태인지 아닌지를 보여준다.

리턴 값

• boolean: 노드가 활성화 상태라면 true, 아니면 false.

파라미터

• String nodename: 상태를 체크할 노드이름.

public int getAliveContainerCount()

설명

• 이 메서드는 활성화 상태의 컨테이너 총 개수를 보여준다.

리턴 값

• int: 활성화 상태의 컨테이너의 총 개수를 리턴한다.

public Iterator getAliveContainerList()

설명

• 이 메서드는 활성화 상태인 엔진 컨테이너의 목록을 보여준다.

리턴 값

• String type 의 Iterator, 각 String 은 활성화된 엔진 컨테이너 이름을 나타낸다.

public int getAliveEngineCount()

설명

• 이 메서드는 활성화 상태인 엔진의 총 개수를 보여준다.

리턴 값

• int: 활성화 상태인 엔진의 총 개수를 리턴한다.

public java.util.Iterator getAliveEngineList()

설명

• 이 메서드는 활성화 상태인 엔진 목록을 보여준다.


Tmax Soft 136

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 활성화된 엔진 이름을 나타낸다.

public int getAliveGroupCount()

설명

• 이 메서드는 활성화 상태인 엔진 그룹의 총 개수를 보여준다.

리턴 값

• int: 활성화 상태인 엔진 그룹의 총 개수를 리턴한다.

public java.util.Iterator getAliveGroupList()

설명

• 이 메서드는 활성화 상태인 엔진 그룹 목록을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 활성화된 엔진 그룹 이름을 나타낸다.

public int getAllEngineCount()

설명

• 이 메서드는 부팅되지 않은 것을 포함한 총 엔진 개수를 보여

준다.

리턴 값

• int: 엔진의 총 개수를 리턴한다.

public java.util.Iterator getAllEngineList()

설명

• 부팅되지 않은 것을 포함한 엔진 목록을 보여준다.

리턴 값


Tmax Soft 137

• java.util.Iterator: String type 의 Iterator, 각 String 은 엔진 이름을 나타낸다.

public java.util.Iterator getContainerMonitorInfo()

설명

• 이 메서드는 엔진 컨테이너 모니터 정보 목록을 보여준다.

리턴 값

• java.util.Iterator: EngineContainerMonitorInfo type 의 Iterator .

public EngineContainerMonitorInfo getContainerMonitorInfo(String engineContainerName)

설명

• 이 메서드는 특정 엔진 컨테이너대한 엔진 컨테이너 모니터 정보를 보여준다.

리턴 값

• EngineContainerMonitorInfo: 인자로 주어진 엔진 컨테이너에 대한 EngineContainerMonitorInfo 객체를 리턴한다.

Class ServletEngineMonitorInfo

public class ServletEngineMonitorInfo

이 클래스는 서블릿 엔진 모니터링 정보를 담고있다.

Constructors

public ServletEngineMonitorInfo()

설명

• 서블릿 엔진 모니터링 정보를 담고 있는 ServletEngineMonitorInfo 클래스의 생성자.

Methods

public int getIdleThreadCount()

설명


Tmax Soft 138

• 이 메서드는 서블릿 엔진의 쓰레드중에 비활성화 상태인 쓰레

드의 총 개수를 가져온다.

리턴 값

• int: 비활성화 상태인 쓰레드의 총 개수.

public int getIdleThreadCount(String poolID)

설명

• 이 메서드는 특정 쓰레드 풀에서 비활성화 상태인 쓰레드의 총 개수를 가져온다.

리턴 값

• int: 인자에 의해 주어진 쓰레드 풀에서 비활성화 상태인 쓰레

드의 총 개수.

파라미터

• String poolID: 비활성화 쓰레드 수를 체크할 pool ID.

public String getServletEngineName()

설명

• 이 메서드는 서블릿 엔진의 이름을 보여준다.

리턴 값

• String: 서블릿 엔진의 이름을 리턴한다.

public java.util.Iterator getThreadList()

설명

• 이 메서드는 쓰레드 목록을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 쓰레드 이름

을 나타낸다.

public java.util.Iterator getThreadPoolList()


Tmax Soft 139

설명

• 이 메서드는 쓰레드 풀 목록을 보여준다.

리턴 값

• java.util.Iterator: String type 의 Iterator, 각 String 은 쓰레드 풀 이름을 나타낸다.

public long getThreadRuntime(String threadID)

설명

• 이 메서드는 쓰레가 활성화 된 이후부터 지금까지 경과된 시간

을 보여준다.

리턴 값

• long: 인자에 의해 주어진 쓰레드의 총 실행 시간을 millisecond 단위로 리턴한다. 해당 쓰레드 아이디가 존재하지 않으면 -1을 리턴한다.

public int getThreadStatus(String threadID)

설명

• 이 메서드는 특정 쓰레드의 상태를 보여준다.

리턴 값

• int: 쓰레드의 상태는 THREAD_STATE_ACTIVE, THREAD_STATE_WAITING,THREAD_STATE_BLOCKED, THREAD_STATE_RECONNECTING 4 가지로 나타낸다. 쓰레드 상태를 얻지 못하면, THREAD_STATE_UNKNOWN 을 리턴한다.


Tmax Soft 140

D.4 package jeus.tool.monitorapi.exceptions

Class MonitorException

public class MonitorException

이 클래스는 모니터링 API 로부터 던져지는 예외 상황을 나타낸다.

Constructors

public MonitorException(String msg)

설명

• 자세한 예외 메시지를 담고 있는 MonitorException 클래스

의 생성자.


Tmax Soft 141

색 인

A

Access Control .................................... 86

Access log ........................................... 57

Admin Mode ..................................... 34

Administration Function .................. 21

Analysis Function.............................. 22

analysis information window.............. 57

Analysis Mode ................. 34, 56, 58, 62

AppCliDeploymentManager............. 103

Application Client 모듈 ...................... 54

Application 모듈................................. 55

Auto Convert....................................... 72

B

Boot Mode .......................................... 31

Boot Option................................... 29, 30

C

Cascade Layout ................................. 41

Controlling .......................................... 85

Conversion 유틸리티 ......................... 71

D

DD Generate ....................................... 67

ddinit ................................................. 107

Deployment Mode ...................... 34, 46

Deployment Function........................ 22

Deployment information window. 46, 47

Distribute............................................. 63

DTD .................................................... 26

E

EJB 모듈 ............................................. 53

EJBDeploymentManager.................... 93

executeDeploy ................ 94, 96, 99, 104

executeEJBNames ............................. 98

executeModuleList ............................ 97

executePredeploy....................... 95, 100

executeRedeploy ........................ 95, 101

executeReload ............................ 97, 103

executeUndeploy ....................... 96, 102

External lib.......................................... 50

F

File Contents ....................................... 49

File Info List ....................................... 49

FTP home........................................... 65

FTP 유틸리티..................................... 64

I

information window................ 35, 40, 41

Information window............................ 46

Information Window Panel................. 82


Tmax Soft 142

J

JEUS DD .......................... 16, 63, 66, 69

JEUS GUI Tool................................... 19

JEUS manager..................................... 32

JEUS Server ........................................ 35

JEUS 로깅 .......................................... 56

jeus.ejb.classloadingmode................... 93

jeus.tool.deployment ........................... 93

jeus.tool.deployment.deployer .......... 104

jeus.tool.deployment.webdeployer ... 105

jeus.tool.monitorapi .......................... 121

jeus.tool.monitorapi.exceptions ........ 140

jeus.tool.monitorapi.monitorinfo ...... 123

jeusadmin ...................................... 15, 83

JEUSMain.xml.................................... 42

JManager 16, 21, 25, 28, 29, 30, 31, 33,

35, 46, 48, 55, 62, 75

M

Mode Switching .................................. 33

Module DD............................. 16, 63, 66

Monitoring API Reference................ 121

P

Perform 버튼 ..................................... 85

R

RAR 모듈 ........................................... 55

Repeat Setting.................................... 44

Repeat 버튼........................................ 83

S

SchedulerManager ... 121, 123, 124, 126,

130, 131, 134, 137, 140

Status Table......................................... 84

system log ........................................... 56

system tree .................................... 35, 57

T

tab view mode ..................................... 41

Threshold Setting .............................. 85

Tile Layout......................................... 41

tool-option.xml.............................. 26, 29

V

validation............................................. 26

View descriptor................................... 51

view mode........................................... 41

W

WEB 모듈........................................... 54

WEBDeploymentManager.................. 98

WebManager . 16, 21, 22, 77, 83, 87, 89

window view mode ............................. 41

wltojeus ............................................. 110

X

XML.................................................. 113

XML Option........................................ 28

로

로깅 이벤트 헨들러 등록.................. 61


Tmax Soft 143

직

직렬화 유틸리티................................ 66

컨

컨트롤링............................................. 45

jeus gui 안내서 - tmaxsoft · 2019. 4. 9. · jeus gui 툴 jeus안내서 tmax soft 13...

Documents