JEUS 소개

JEUS v6.0 Fix#8

Copyright © 2011 TmaxSoft Co., Ltd. All Rights Reserved.

Copyright Notice

Copyright © 2011 TmaxSoft Co., Ltd. All Rights Reserved.

대한민국 경기도 성남시 분당구 서현동 272-6 우) 463-824

Restricted Rights Legend

All TmaxSoft Software (JEUS®) and documents are protected by copyright laws and the Protection Act of Com

puter Programs, and international convention. TmaxSoft software and documents are made available under the

terms of the TmaxSoft License Agreement and may only be used or copied in accordance with the terms of this

agreement. No part of this document may be transmitted, copied, deployed, or reproduced in any form or by any

means, electronic, mechanical, or optical, without the prior written consent of TmaxSoft Co., Ltd.

이 소프트웨어(JEUS®) 사용설명서의 내용과 프로그램은 저작권법, 컴퓨터프로그램보호법 및 국제 조약에 의해

서 보호받고 있습니다. 사용설명서의 내용과 여기에 설명된 프로그램은 TmaxSoft Co., Ltd.와의 사용권 계약 하에

서만 사용이 가능하며, 사용권 계약을 준수하는 경우에만 사용 또는 복제할 수 있습니다. 이 사용설명서의 전부 또

는 일부분을 TmaxSoft의 사전 서면 동의 없이 전자, 기계, 녹음 등의 수단을 사용하여 전송, 복제, 배포, 2차적 저

작물작성 등의 행위를 하여서는 안 됩니다.

Trademarks

JEUS® is registered trademark of TmaxSoft Co., Ltd. Other products, titles or services may be registered trademarks

of their respective companies.

JEUS®는 TmaxSoft Co., Ltd.의 등록 상표입니다. 기타 모든 제품들과 회사 이름은 각각 해당 소유주의 상표로서

참조용으로만 사용됩니다.

Open Source Software Notice

This product includes open source software developed and/or licensed by "OpenSSL", "RSA Data Security, Inc.",

"Apache Foundation", and "Jean-loup Gailly and Mark Adler". Information about the aforementioned and the related

open source software can be found in the "${INSTALL_PATH}/license/oss_licenses" directory.

본 제품은 “OpenSSL”, “RSA Data Security, Inc.”, “Apache Foundation” 및 “Jean-loup Gailly와 Mark Adler”에 의

해 개발 또는 라이선스된 오픈 소스 소프트웨어를 포함합니다. 관련 상세 정보는 제품의 디렉터리 “${IN

STALL_PATH}/license/oss_licenses”에 기재된 사항을 참고해 주십시오.

안내서 정보

안내서 제목: JEUS 소개

발행일: 2011-11-04

소프트웨어 버전: JEUS v6.0 Fix #8

안내서 버전: v2.1.3

내용 목차

안내서에 대하여 ........................................................................................................................... xi

제1장 소개 ................................................................................................................................. 1

1.1. 개요 ............................................................................................................................ 1

1.2. 시스템 개념과 역할 ....................................................................................................... 3

1.3. 구성 요소와 아키텍처 ................................................................................................... 4

1.3.1. Client Layer ....................................................................................................... 5

1.3.2. JEUS WAS Layer .............................................................................................. 5

1.3.3. Source Layer ..................................................................................................... 7

1.4. 상호 운용 모듈 ............................................................................................................. 7

1.5. Edition ......................................................................................................................... 8

제2장 JEUS 환경 ...................................................................................................................... 11

2.1. 관리 툴 ...................................................................................................................... 11

2.2. 디렉터리 구조 ............................................................................................................ 12

2.3. 환경변수 .................................................................................................................... 14

2.4. 환경설정 파일 ............................................................................................................ 15

2.4.1. XML 환경설정 파일 .......................................................................................... 15

제3장 WebAdmin ..................................................................................................................... 19

3.1. WebAdmin 시작 ......................................................................................................... 19

3.2. 로그인 (login) ............................................................................................................. 19

3.3. 로그아웃(logout) ......................................................................................................... 20

제4장 JEUS 안내서 구성 ........................................................................................................... 21

4.1. 개요 ........................................................................................................................... 21

4.2. 안내서의 구성 ............................................................................................................ 21

JEUS 소개 iii

그림 목차

[그림 1.1] JEUS의 기능과 역할 .................................................................................................... 3

[그림 1.2] JEUS 웹 애플리케이션 아키텍처 다이어그램 ................................................................. 4

[그림 2.1] JEUS 설치 후 디렉터리 구조 ...................................................................................... 12

[그림 3.1] WebAdmin 로그인 화면 .............................................................................................. 20

[그림 3.2] WebAdmin의 [로그아웃] 메뉴 ..................................................................................... 20

[그림 4.1] JEUS 안내서 구성 ...................................................................................................... 22

JEUS 소개 v

표 목차

[표 1.1] JEUS 6가 지원하는 JavaEE 스펙 ..................................................................................... 2

[표 1.2] JEUS Client Layer ........................................................................................................... 5

[표 1.3] JEUS Manager ............................................................................................................... 5

[표 1.4] JEUS Engine .................................................................................................................. 6

[표 1.5] JEUS 관리 툴 .................................................................................................................. 6

[표 1.6] Source Layer .................................................................................................................. 7

[표 1.7] 상호 운용 모듈 ................................................................................................................ 7

[표 1.8] JEUS Edition .................................................................................................................. 8

[표 2.1] JEUS 관리 툴 ................................................................................................................ 11

[표 2.2] JEUS 환경변수 ............................................................................................................. 14

JEUS 소개 vii

예 목차

[예 3.1] <<JEUSMain.xml>> 설정 ............................................................................................... 19

JEUS 소개 ix

안내서에 대하여

안내서의 대상

본 안내서는 JEUS 시스템 관리자를 위한 안내서로 JEUS 6 서버에 대한 전반적인 소개를 하고, JEUS의

아키텍처를 포함하여 각 구성 요소들에 대해서 설명한다. 또한 제공되는 JEUS 안내서의 구성에 대해서

설명한다.

안내서의 전제 조건

JEUS를 설치하기 전에 본 안내서를 참고해서 기본 개념을 숙지하면 이해하는 데 도움이 될 것이다.

본 안내서를 원활하게 이해하기 위해서는 다음과 같은 사항을 미리 알고 있어야 한다.

● UNIX 사용법

● Java와 Java EE에 대한 기본 지식

참고

JEUS의 설치와 시작에 대한 설명은 "JEUS 설치 및 시작하기"를 참고한다.

안내서에 대하여 xi

안내서 구성

본 안내서는 다음과 같이 총 4개의 장으로 구성되어 있다.

● “제1장 소개”

JEUS 6 서버에 대해서 설명한다.

● “제2장 JEUS 환경”

JEUS 디렉터리 구조와 환경변수, XML 설정 파일에 대해 설명한다.

● “제3장 WebAdmin”

WebAdmin의 시작과 종료하는 방법에 대해서 설명한다.

● “제4장 JEUS 안내서 구성”

JEUS 안내서의 구성에 대해 간략히 설명한다.

xii JEUS 소개

안내서 규약

의미표기

프로그램 소스 코드의 파일명<<AaBbCc123>>

Ctrl과 C를 동시에 누름<Ctrl>+C

GUI의 버튼 또는 메뉴 이름[Button]

강조진하게

다른 관련 안내서 또는 안내서 내의 다른 장 및 절 언급" "(따옴표)

화면 UI에서 입력 항목에 대한 설명'입력항목'

메일계정, 웹 사이트하이퍼링크

메뉴의 진행 순서>

하위 디렉터리 또는 파일 있음+----

하위 디렉터리 또는 파일 없음|----

참고 또는 주의사항참고

주의할 사항주의

그림 이름[그림 1.1]

표 이름[표 1.1]

Java 코드, XML 문서AaBbCc123

옵션 파라미터[ command argument ]

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

선택 사항. 예) A|B: A나 B 중 하나|

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

안내서에 대하여 xiii

시스템 사용 환경

본 안내서는 모든 예제와 환경 구성을 Microsoft Windows™의 스타일을 따랐다. UNIX와 같은 다른 환경

에서 작업하는 사람은 몇 가지 사항만 고려하면 별 무리없이 사용할 수 있다. 대표적인 것이 디렉터리 구

분자인데, Windows 스타일인 “\”를 UNIX 스타일인 “/”로 바꿔서 사용하면 무리가 없다. 이외에 환경변수도

UNIX 스타일로 변경해서 사용하면 된다.

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

관련 안내서

설명안내서

JEUS에 대한 소개와 설치 및 시작 방법에 대해 기술한 안내서이다.JEUS 설치 및 시작하기

JEUS의 새로운 기능과 이전 버전의 업그레이드 방법에 대해 기술한

안내서이다.

JEUS 릴리즈 노트

xiv JEUS 소개

연락처

Korea

TmaxSoft Co., Ltd

272-6, Seohyeon-dong, Bundang-gu,

Seongnam-si, Gyeonggi-do, 463-721

South Korea

Tel: +82-31-8018-1000

Fax: +82-31-8018-1115

Email: info@tmax.co.kr

Web (Korean): http://www.tmax.co.kr

기술지원: http://technet.tmaxsoft.com

USA

TmaxSoft, Inc.

560 Sylvan Avenue Englewood Cliffs, NJ 07632

U.S.A

Tel: +1-201-567-8266

Fax: +1-201-567-7339

Email: info@tmaxsoft.com

Web (English): http://www.tmaxsoft.com

Japan

TmaxSoft Japan Co., Ltd.

5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073

Japan

Tel: +81-3-5765-2550

Fax: +81-3-5765-2567

Email: info@tmaxsoft.co.jp

Web (Japanese): http://www.tmaxsoft.co.jp

안내서에 대하여 xv

China

TmaxSoft China Co., Ltd.

Beijing Silver Tower, RM 1508, 2# North Rd Dong San Huan,

Chaoyang District, Beijing, China, 100027

China

Tel: +86-10-6410-6145~8

Fax: +86-10-6410-6144

Email: info.cn@tmaxsoft.com

Web (Chinese): http://www.tmaxsoft.com.cn

xvi JEUS 소개

제1장 소개

본 장에서는 JEUS에 대한 기본적인 이해와 Java EE 스펙에 대해서 설명하고, JEUS 시스템의 개념 및 구

성 요소와 에디션별 기능에 대해 기술한다.

1.1. 개요JEUS는 “Java Enterprise User Solution”의 약자이다. JEUS는 웹 환경에서 애플리케이션을 개발, 운용,

실행할 수 있는 플랫폼 역할을 하면서, 포괄적인 Java 기반의 웹 애플리케이션 서비스와 관리를 제공한다.

JEUS는 Java EE 애플리케이션을 구동할 때 필요한 플랫폼과 다음의 같은 구성 요소를 제공한다.

● EJB 컨테이너

● 웹 컨테이너(JSP/서블릿 엔진)

● 보안 모듈(Security Module)

● Naming 서버

● 트랜잭션 매니저

● JDBC Connection Pool

● 세션 매니저

Java EE

JEUS는 Sun Microsystems사의 Java Enterprise Edition 스펙을 준수하며, Java EE 5인증을 획득했다. 다

음은 Sun Microsystems사의 웹 사이트에 있는 문구로 JEUS는 나열된 모든 기술들을 제공한다.

"The Java Platform, Enterprise Edition (Java EE) defines the standard for developing multitier enterprise

applications. The Java EE platform simplifies enterprise applications by basing them on standardized,

modular components, by providing a complete set of services to those components, and by handling

many details of application behavior automatically, without complex programming."

"The primary technologies in Java EE are: Enterprise JavaBeansTM (EJBsTM), JavaServer PagesTM

(JSPsTM), Java Servlets, the Java Naming and Directory InterfaceTM (JNDITM), the Java Transaction

API (JTA), CORBA, and the JDBCTM data access API."

참고

Java EE에 대해서 보다 자세한 정보를 알아보기 위해서는 Oracle사의 홈페이지(http://www.ora

cle.com/technetwork/java/javaee/overview/index.html)를 참고한다.

제1장 소개 1

다음은 JavaEE의 스펙 중에서 JEUS 6에서 구현한 기능 목록이다. 스펙에 대한 내용은 http://www.ora

cle.com/technetwork/java/javaee/tech/index.html에서 확인할 수 있다.

[표 1.1] JEUS 6가 지원하는 JavaEE 스펙

Version supported in JEUS 6Specification/Technology

5.0Java Platform, Enterprise Edition 5 Specification

3.0Enterprise JavaBeans Specification

2.1Java Server Pages Specification

2.5Java Servlet Specification

1.2.1Java Naming and Directory Interface Specification

1.1Java Message Service Specification

3.0JDBC Specification

1.4JavaMail API Specification

1.1Java Transaction API Specification

1.0Java Persistence API

1.0.1JNLP Specification

1.5JCA

1.1JavaBeans Activation Framework

1.1Java EE Management

1.2Java EE Deployment

1.2JSTL

1.2JSF

1.0.1JAAS

1.2SOAP

1.2WSDL

1.1JAX-RPC (Full)

2.1JAX-WS

2.1JAXB

1.0JAXR

1.3SAAJ (Full)

1.0StAX

1.2Enterprise Web Services

1.1JACC

2 JEUS 소개

사용하는 JEUS 에디션에 따라서 위 표에 나열된 모든 기능이 구현되지 않을 수 있다. 자세한 내용은 각

JEUS 에디션 소개 자료를 참조한다.

1.2. 시스템 개념과 역할다음은 엔터프라이즈 애플리케이션 솔루션을 제공하기 위해서 JEUS가 다른 웹 서버나 DBMS등과 어떻

게 통합되는지 보여준다.

[그림 1.1] JEUS의 기능과 역할

EIS Layer

Node

Engine Container

EJB Engine

Servlet/JSP Engine

JMS Engine

Web Server

Databa

seHTML

Applet

JNLP

Client

Java

Corba

Application

HTTP

HTTP/

RMI

JNLP

RMI/II

OP

Client

TP

Monitor

Directory

Server

Other

ORB

Legacy

EIS

JEUS/WAS LayerWeb/Internet

LayerClient Layer

Other JEUS Nodes

WS Engine

Other Services

Java

ApplicationRMI

JEUS Manager

Security Service

Other Services

JNDI Service

위 그림에서 나타난 4가지 Layer는 다음과 같다.

● Client Layer

웹 서버나 Java 애플리케이션 또는 Native 애플리케이션으로 구성된다. 최종 사용자는 WAS의 서비스

를 사용하기 위해서 다양한 클라이언트를 사용하며, 이 클라이언트는 다양한 프로토콜 중에 하나를 사

용해서 WAS의 서비스에 접근한다.

● Web/Internet Layer

클라이언트와 WAS 사이의 중간에서 작동하는 웹 서버나 프로토콜로 정의된다. 이 Layer에서는 정적인

콘텐츠와 부하 분산을 처리한다.

● JEUS Java EE WAS Layer

Java 기반의 미들웨어로 구성되며, Web Layer나 Client Layer로부터 오는 요청을 받아서 처리한다.

● EIS Layer

비즈니스 데이터나 기존의 Legacy 서비스를 나타낸다. WAS는 JDBC나 디렉터리 서비스, Java EE

Connector 등의 다양한 메커니즘을 통해서 Legacy 서비스와 상호 작용한다.

제1장 소개 3

1.3. 구성 요소와 아키텍처JEUS는 많은 서로 다른 모듈들로 구성되어 있다. 이러한 모듈들은 다음의 [그림 1.2]에서 클라이언트 애

플리케이션과 데이터 저장장치, JEUS 사이의 통신 기술에 따라서 사용된다.

[그림 1.2] JEUS 웹 애플리케이션 아키텍처 다이어그램

Client Layer는 다양한 형태의 클라이언트 애플리케이션과 통신 프로토콜을 보여주고 있다. Source Layer

는 다양한 형태의 back-end 데이터 저장장치들이 나열되어 있다. TmaxSoft의 JEUS 제품은 WebtoB와 더

불어 그림의 중간부분인 Middleware layer를 구성한다. 웹 서버는 클라이언트 애플리케이션과 연결되어

있으며, 웹 서버는 웹 애플리케이션 서버와 밀접하게 통합되어 있다. 또한 웹 게이트웨이(WebT)는 WAS

와 TP-Monitor를 연계시키며, 마지막으로 MainFrame 게이트웨이(Host-Link)는 MainFrame과 TP-Monitor

사이의 연결을 제공한다.

다음 절에서는 그림에서 보이는 3가지 Layer의 구성 요소(Client Layer, JEUS WAS Layer, Source Layer)

에 대해 알아본다.

4 JEUS 소개

1.3.1. Client Layer

Client Layer(클라이언트 계층)는 JEUS를 사용할 수 있는 원격 혹은 지역 애플리케이션을 나타낸다.

다음은 Client Layer를 구성하는 유형에 대한 설명이다.

[표 1.2] JEUS Client Layer

설명Client Layer

가장 일반적인 클라이언트 애플리케이션은 HTML 콘텐츠를 얻기 위해 JEUS

서블릿 엔진과 WebtoB Light 웹 서버에 요청을 하는 표준 웹 브라우저이다. 통

신 프로토콜은 HTTP이다.

HTML/Web browser

웹 서비스의 구현을 제공한다.Web Service Client

JEUS 자신의 구성 요소를 참조할 수 있는 애플릿 컨테이너를 제공한다.Applet

일반적인 독립된 Java 애플리케이션들은 JEUS에 의해 제공되는 클라이언트

컨테이너 내에서 RMI를 사용하여 실행된다. 이러한 클라이언트들을 Java EE

스펙에서는 애플리케이션 클라이언트라고 한다.

Java Application

CORBA 기술을 사용한 애플리케이션도 RMI/IIOP를 통해 JEUS를 사용할 수

있다.

CORBA Application

네트워크 관리 시스템은 JMX를 통해 JEUS를 관리하고 사용할 수 있다.NMS

JNLP(Java Network Lanuching Protocol) 클라이언트들은 JEUS 6에서 지원된

다.

JNLP Client

1.3.2. JEUS WAS Layer

[그림 1.2]에서 JEUS WAS Layer는 Java EE 5 스펙을 인증받은 JEUS 6 제품을 나타내며 구성 요소는 다

음과 같다.

● JEUS Manager

JEUS의 핵심적인 서버로 전체 JEUS 시스템의 기반과 관리를 제공한다. 몇 개의 JEUS Manager들이

클러스터링을 구성할 수도 있다.

[표 1.3] JEUS Manager

설명서비스

Naming 시스템이다.JNDI

인증과 권한 서비스이다.Security

웹 애플리케이션 서버에서 구동되는 다양한 애플리케이션들에 대한 완전한 트

랜잭션을 제공한다.

JTA

미리 정해진 시간에 이벤트를 발생시키는 타이머 기능을 제공한다.Scheduler

제1장 소개 5

설명서비스

클러스터링이 필요한 경우 신뢰성있는 방식으로 클라이언트의 세션 정보를 저

장한다.

Session Manager

데이터베이스 Connection Pool이 설정될 수 있다.JDBC

NMS/JMX 클라이언트가 JEUS 시스템을 관리할 수 있도록 한다.JMX

JCA는 Java EE Connector Architecture로, JCA를 지원하는 어떠한 Lagacy

EAI(Enterprise Application Integration)에 대해서도 JEUS의 연결을 지원한다.

JCA

● JEUS Engine Container

JEUS 시스템에서 구성될 수 있는 다양한 형태의 엔진에 대한 기반을 제공하며, 다음과 같은 4가지의

유형이 있다.

[표 1.4] JEUS Engine

설명Engine

EJB 3.0 비즈니스 애플리케이션을 구동한다.EJB Engine

웹 컨테이너로, 정적인 콘텐츠(HTML)뿐만 아니라 JSP/서블릿 애플리케이션을

구동한다.

Servlet Engine

JMS 기반 구조를 제공한다.JMS Engine

JEUS 웹 서버의 인스턴스로서 서블릿 엔진의 front-end로 구동된다.WS Engine

● WebtoB(or Apache) Web Server

웹 서버는 HTML과 같은 정적인 콘텐츠와 CGI와 같은 동적인 콘텐츠를 전송한다. 또한 서블릿 엔진의

front-end로서 상호 작용한다. WebtoB는 2개의 버전이 있는데, 하나는 TmaxSoft의 WebtoB 웹 서버로

서 모든 기능을 지원하며, 또 다른 하나는 WebtoB 버전의 일부 축소된 기능 만을 가진 JEUS 웹 서버가

있다.

JEUS 웹 서버는 JEUS에 포함되어 있으며, WebtoB에는 포함되어 있지 않다. 그리고 오픈 소스 웹 서버

인 Apache 또한 JEUS에서 사용할 수 있다.

● JEUS Administration Tools

JEUS는 다음과 같은 2가지의 주요한 관리 툴이 있다.

[표 1.5] JEUS 관리 툴

설명툴

JEUS의 모듈 패키징, 설정 이외의 모든 구성 요소들을 관리하고 웹 브라우저에

서 사용될 수 있는 웹 툴이다.

WebAdmin

그래픽 툴을 통해 사용될 수 있는 모든 기능은 명령행 기반의 콘솔 툴을 사용해

서 수행될 수 있다. 이 툴은 그래픽 환경을 사용하지 않을 때 사용한다.

Console Tool

6 JEUS 소개

1.3.3. Source Layer

[그림 1.2]의 오른쪽의 Source Layer는 back-end의 리소스와 JEUS 시스템에 의해 사용될 수 있는 데이터

저장소를 나타내며, 종류는 다음과 같다.

[표 1.6] Source Layer

설명Source 계층

JEUS에서 JDBC를 통해서 접속할 수 있다.Database

LDAP와 같은 것들이 있으며, JNDI를 통해서 사용된다.Directory Server

JEUS는 타 벤더의 Java EE 서버와 상호 작용이 가능하다.Other Java EE Server

TmaxSoft에서 개발한 TP-Monitor로, WebT API 라이브러리는 JEUS와 Tmax

를 통합하는 데 사용된다.

Tmax Server

IIOP(Internet Inter-ORB Protocol)를 통해 참조될 수 있다.ORB

IBM MainFrame들은 특별히 Host-Link(혹은 Java EE Connector) 제품을 통

해 사용된다.

Mainframe

Java EE Connector Architecture를 지원하는 Legacy EIS로 JEUS와 상호 작

용이 가능하다.

Legacy EIS

1.4. 상호 운용 모듈상호 운용성이란 예상되는 결과를 얻기 위해 2개 혹은 그 이상의 시스템(컴퓨터, 통신장치, 네트워크, 소

프트웨어 혹은 다른 정보 기술 요소)에서 정의된 방법을 통한 데이터 교환이나 상호 작용을 의미한다(ISO

ITC-215).

JEUS는 서로 다른 프로토콜과 웹 서비스, JBuilder Bridge, JNLP, RMI-IIOP와 같은 기술들을 완벽히 지원

한다. 다음은 JEUS의 상호 운용을 위해 제공되는 모듈이다.

[표 1.7] 상호 운용 모듈

설명모듈

IIOP(Internet Inter-ORB Protocol) 프로토콜에서 수행되는 RMI 기술로서,

JAVA 플랫폼에서 CORBA의 분산 컴퓨팅 작업을 가능하게 한다.

RMI-IIOP

다른 웹 애플리케이션의 사용을 가능하게 하며, 웹 서비스 또한 지원한다.JEUS

TP-Monitor와 JEUS를 연계하는 게이트웨이이다.WebT

Legacy EIS에 있는 서비스를 클라이언트가 사용할 수 있도록 하는 어댑터 모

듈이다.

Host-Link

JEUS와 JEUS 클라이언트가 가상적으로 어떠한 Legacy의 EIS에 대한 상호

작용도 가능하게 한다.

Java EE Connector Archi

tecture

제1장 소개 7

1.5. Edition다음은 JEUS 6에 대한 Edition에 대한 설명이다.

[표 1.8] JEUS Edition

주요 특징Edition

- JEUS ServerJEUS Base Edition

- JEUS Web Server

- Servlet 2.5

- JSP 2.1

- JSF 1.2

- JSTL 1.2

- Security

- JDBC connection pooling

- XML 유틸리티

- JNDI

- JMX

- WebAdmin

- JEUS node clustering

- Base EditionJEUS Base Plus Edition

- Session clustering

- Base EditionJEUS Standard Edition

- EJB 3.0

- JMS 1.1

- 2 Phase-Commit 지원 JTA

- JCA 1.5

- SNMP

- Web service

- JEUS Standard EditionJEUS Enterprise Edition

- Session clustering

- JMS clustering

- JEUS Enterprise EditionJEUS Developer Edition

- 최초 기동(Booting)할 때부터 접속한 클라이언트 5개(HTTP)

8 JEUS 소개

참고

제공되는 JEUS 안내서는 위의 표에서 언급된 모든 주제들을 포함하고 있다. 안내서에 기술된 기능

들이 실제로 사용 가능한지 여부를 이 표에서 확인하기 바란다. JEUS를 설치하면 Developer Edition

라이선스는 기본적으로 내장되어 있다.

제1장 소개 9

제2장 JEUS 환경

본 장에서는 JEUS에서 사용하는 관리 툴과 디렉터리 구조와 환경변수에 대해서 설명한다. 그리고 JEUS

와 관련 XML 설정 파일의 전반적인 내용에 대해서 소개한다.

2.1. 관리 툴다음은 JEUS에 접속해서 사용하는 툴에 대한 설명이다.

[표 2.1] JEUS 관리 툴

설명툴

HTML 기반의 관리 툴로, JEUS의 제어, 모니터링, 관리 등의 기능을 제공한다. 자

세한 내용은 "JEUS WebAdmin 안내서"를 참고한다.

WebAdmin

JEUS Manager를 실행하는 가장 기본적인 툴이다. 자세한 내용은 “JEUS Reference

Book”의 “제3장 jeus”를 참고한다.

jeus

콘솔 툴은 command prompt에서 JEUS를 컨트롤하는 데 사용된다. 자세한 내용은

“JEUS Reference Book”의 “4.2. jeusadmin”을 참고한다.

jeusadmin

참고

위에서 언급한 것 이외에도 EJB와 서블릿 엔진을 위한 툴이 존재한다. 자세한 내용은 해당 안내서를

참고한다.

제2장 JEUS 환경 11

2.2. 디렉터리 구조다음은 JEUS를 설치했을 때의 전체 디렉터리 구조이다.

[그림 2.1] JEUS 설치 후 디렉터리 구조

lib\

datasource\

webhome\

J

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

XSecurity configuration file

(XML)

0I

J

.dll, .so native library

System JARs

jeus.jar

system\

JDBC Drivers

schemas\

JEUS XML Schema

application\

endorsed\

shared\

client\

admin_home\

app_home\

autodeploy\

system_app\

uddi\

<node_name>_

<container_name>\

J Application archive filesworkspace\

samples\

license\

TM\

JeusSystem

logs\

webserver\

security

DOMAIN_NAME

security

Engine configuration file (XML)X

<node name>_<engine type>

_<engine name>\

X JEUSMain.xml

<nodename>\

config\

0I Applications launch scripts

bin\

JEUS_HOME\

X

J

다음은 디렉터리와 파일의 설명이다.

JEUS_HOME

JEUS의 최상위 디렉터리로, 실제 디렉터리 이름과 위치는 설치할 때 결정된다.

예) c:\jeus

12 JEUS 소개

bin

jeus, jeusadmin과 같은 실행 파일이나 스크립트가 모여있다.

config

서버 설정이 저장되는 서브 디렉터리를 가지고 있다.

● config\<nodename>

이름이 <nodename>인 설정 파일이 위치한다. <nodename>은 JEUS 가 설치된 서버의 이름(일반

적으로 hostname)이다. 만약 현재 JEUS가 백업 노드로 작동되도록 설정되었다면 백업하는 노드의

<nodename> 디렉터리가 존재해야 한다.

JEUS Manager의 설정 파일은 JEUSMain.xml이며, 이 디렉터리에 존재한다. <nodename>이 jeus

일 때 "c:\jeus\config\jeus”가 된다.

● config\<nodename>\<nodename>_<enginetype>_<enginename>

엔진별로 설정 파일을 가지고 있다. <enginetype>은 ejb, jms, servlet 셋 중 하나이며, <enginename>

은 JEUSMain.xml에서 설정한 이름이다.

“c:\jeus\config\jeus\jeus_servlet_Engine1”일 때, <nodename>은 'jeus', <enginetype>은 'servlet'이

며, 사용자가 지정하는 <enginename>은 'Engine1'이 된다.

● config\<nodename>\security

해당 노드에서 사용하는 security configuration이 들어가 있다. 자세한 내용은 "JEUS Security 안내

서"를 참조한다.

webserver

JEUS가 설치될 때 JEUS 웹 서버가 설치되는 디렉터리이다. 자세한 내용은 "JEUS Web Service 안내

서"를 참조한다.

license

JEUS 라이선스 파일을 가지고 있다. 라이선스 파일은 JEUS가 실행되기 위해서 반드시 필요한 파일

이다.

logs

시스템 로그가 기록된다.

설명하위 디렉터리

트랜잭션 매니저의 로그 정보를 기록한다.logs\TM

node, engine container, engine들이 생성하는 로그를 기록한다.logs\JeusSystem

samples

JEUS의 예제들이 있다.

lib

JEUS가 기동될 때, 이 디렉터리의 모든 서브 디렉터리를 스캐닝해서 ".jar" 파일이나 ".zip" 파일을 클

래스 패스로 추가한다. 서브 디렉터리 스캐닝 순서는 system → application → datasource 순이다.

제2장 JEUS 환경 13

설명하위 디렉터리

사용자 애플리케이션에서 사용하는 클래스 파일이 위치한다. 이 디렉터리의

모든 '.zip' 파일이나 '.jar' 파일, 디렉터리 형태의 일반 클래스들은 클래스 패

스로 추가된다. 클래스 파일은 '.jar'나 '.zip' 파일보다 먼저 읽힌다.

lib\application

JEUS가 사용하는 라이브러리가 있는 디렉터리이므로 사용자는 이 디렉터리

를 수정해서는 안 된다. '.so' 나 '.dll'같은 Native Driver(예를 들면, Connector

lib\system

Resource Adapter에서 필요한 드라이버 등…)는 이 디렉터리에 위치해야 한

다. 또 여기에는 JEUS의 클래스인 jeus.jar가 있다.

JDBC 드라이버의 '.jar' 파일과 설정 파일이 위치한다.lib\datasource

XML 설정 파일을 위한 XML Schema 파일이 위치한다.lib\schemas

Java 런타임이 기본 JDK 클래스들에 우선하여 읽어들일 클래스들이 JAR 파

일 형태로 위치한다.

lib\endorsed

애플리케이션 간에 공유되는 라이브러리들이 위치한다.lib\shared

Standalone과 애플릿 등의 클라이언트가 사용하는 라이브러리가 위치한다.lib\client

webhome

JavaEE 애플리케이션(웹 애플리케이션, EJB)이 Deploy되는 홈 디렉터리이다.

설명하위 디렉터리

WebAdmin에서 사용되는 서블릿/JSP 파일이 있다.webhome\admin_home

애플리케이션의 기본 경로이다.webhome\app_home

AutoDeploy할 애플리케이션의 기본 경로이다.webhome\autodeploy

<node_name>_<container_name>에 해당하는 엔진 컨테이너에서

사용되는 애플리케이션이 존재한다.

webhome\<node_name>_<con

tainer_name>

workspace

JEUS가 동작하면서 필요한 작업을 하는 임시 디렉터리로 이 디렉터리를 수정해서는 안 된다.

2.3. 환경변수환경변수는 모두 "JEUS_HOM\bin\jeus.properties"에서 설정되어 있으며, JEUS_HOME\bin 디렉터리의

모든 스크립트에서 사용된다.

다음은 JEUS에서 사용하는 환경변수이다.

[표 2.2] JEUS 환경변수

내용환경변수

JEUS가 설치된 홈 디렉터리로, 필수 사항이다.JEUS_HOME

예 ) JEUS_HOME=C:\Jeus

14 JEUS 소개

내용환경변수

JEUS Manager로 접속하기 위한 TCP/IP 포트이며, 다른 기능을 위한 포

트를 계산하는 데 기본이 된다.(기본값 : 9736)

JEUS_BASEPORT

예) JEUS_BASEPORT=9736

JEUS 웹 서버의 홈 디렉터리이다.(기본값 : C:\Jeus\webserver)JEUS_WSDIR

예) JEUS_WSDIR = C:\Jeus\webserver

JEUS 웹 서버인 내장 WebtoB가 IPv6를 사용할지 여부를 설정한다.WEBTOB_PREFER_IPV6

(Y/y/1 : IPv6 사용. 환경변수가 없으면 IPv4 사용)

예) WEBTOB_PREFER_IPV6=Y

JDK의 홈 디렉터리이다.JAVA_HOME

예) JAVA_HOME = c:\jdk1.5

해당 변수는 필요한 경우 수정해서 사용한다. 단, XML 설정 파일에서는 이들 환경변수를 사용할 수 없다.

모든 환경변수는 설치할 때 기본값으로 정해진다. 대부분의 경우 설정된 값을 그대로 사용하면 된다.

참고

환경변수를 변경하는 방법은 OS에 따라 다르므로, 이에 대해서는 각 OS 안내서를 참고한다.

2.4. 환경설정 파일

2.4.1. XML 환경설정 파일

JEUS는 환경설정을 위해서 각각 고유의 XML 포맷을 사용하며, 직접 수정하거나 툴을 사용해서 수정할

수 있다. 다음은 JEUS의 XML 설정 파일과 내용, 위치를 정리한 내용이다.

● JEUSMain.xml (jeus-main.xsd)

JEUS_HOME\config\<nodename>\위치

JEUS Manager와 노드를 관리하는 기본 설정 파일이다.목적

JEUS Server 안내서참고 안내서

● WEBMain.xml (web-main.xsd)

JEUS_HOME\config\<nodename>\<Servlet Enginedir>\위치

서블릿/JSP 엔진 설정 파일이다.설명

JEUS Web Container 안내서참고 안내서

제2장 JEUS 환경 15

● jeus-web-dd.xml (jeus-web-dd.xsd)

웹 애플리케이션 Archive의 WEB-INF위치

JEUS 웹 애플리케이션(Servlet app) Deployment Descriptors 파일이다.설명

JEUS Web Container 안내서참고 안내서

● EJBMain.xml (ejb-main.xsd)

JEUS_HOME\config\<nodename>\<EJB Enginedir>\위치

EJB 엔진 설정 파일이다.설명

JEUS EJB 안내서참고 안내서

● jeus-ejb-dd.xml (jeus-ejb-dd.xsd)

EJB 애플리케이션 Archive의 META-INF위치

JEUS EJB Module Deployment Descriptors 파일이다.설명

JEUS EJB 안내서참고 안내서

● jeus-client-dd.xml (jeus-client-dd.xsd)

클라이언트 애플리케이션 Archive의 WEB-INF위치

애플리케이션 클라이언트 Deployment Descriptor 파일이다.설명

JEUS 애플리케이션 안내서참고 안내서

● jeus-connector-dd.xml (jeus-connector-dd.xsd)

리소스 어댑터 Archive의 META-INF위치

리소스 어댑터 Deployment Descriptor 파일이다.설명

JEUS JCA 안내서참고 안내서

● JMSMain.xml (jms-main.xsd)

JEUS_HOME\config\<nodename>\<JMS Enginedir>\위치

JMS 엔진 설정 파일이다.설명

JEUS MQ 안내서참고 안내서

● policies.xml (policies.xsd)

JEUS_HOME\config\<nodename>\security\<domainname>\위치

JEUS Security 정책을 설정한 파일이다.설명

16 JEUS 소개

JEUS Security 안내서참고 안내서

● accounts.xml (accounts.xsd)

JEUS_HOME\config\<nodename>\security\<domainname>\위치

JEUS Security 계정을 설정한 파일이다.설명

JEUS Security 안내서참고 안내서

● jeus-web-dd.xml (jeus-web-dd.xsd), jeus-ejb-dd.xml (jeus-ejb-dd.xsd), jeus-client-dd.xml (jeus-client-

dd.xsd)

Webservice client archive의 META-INF위치

웹 서비스 클라이언트 정보를 설정한 파일이다.설명

JEUS Web Service 안내서참고 안내서

● jeus-webservices-config.xml (jeus-webservices-config.xsd)

Webservice client archive의 META-INF위치

웹 서비스 클라이언트 Ant Task에서 사용하는 설정 파일이다.설명

JEUS Web Service 안내서참고 안내서

참고

1. Java EE의 표준 Descriptor 파일인 “web.xml”이나 “ejb-jar.xml” 파일도 사용된다. 각 파일은 해당

Java EE 스펙을 참조한다.

2. 모든 XML Schema 파일은 JEUS_HOME\lib\schemas\jeus\에 위치한다.

제2장 JEUS 환경 17

제3장 WebAdmin

본 장에서는 WebAdmin의 시작과 종료하는 방법에 대해서 설명한다.

3.1. WebAdmin 시작WebAdmin을 시작하기 위해서는 JEUSMain.xml 파일의 <enable-webadmin> 요소("JEUS Server 안내서"

참조)를 true로 설정해야 한다. 다음은 JEUS를 기동할 때 WebAdmin이 기동되도록 설정한 JEUSMain.xml

의 예이다.

[예 3.1] <<JEUSMain.xml>> 설정

<jeus-system ...>

<node>

<name>enrique</name>

<class-ftp>true</class-ftp>

<sequential-atart>false</sequential-atart>

<enable-webadmin>true</enable-webadmin>

...

</node>

...

</jeus-system>

3.2. 로그인 (login)웹 브라우저의 주소창에 다음과 같이 입력하면 WebAdmin 로그인 페이지가 나타난다.

http://<IP주소>:9744/webadmin

화면에서 관리자의 'ID'와 'PW'를 입력한 후, [LOGIN] 버튼을 클릭한다. 로그인에 성공하면 관리자 메인

페이지로 이동하며, 실패할 경우에는 오류 메시지가 출력된다.

제3장 WebAdmin 19

[그림 3.1] WebAdmin 로그인 화면

3.3. 로그아웃(logout)메인 페이지의 오른쪽 상단에 [로그아웃] 메뉴가 있다. [로그아웃]을 클릭하면 WebAdmin 사용자 세션이

종료되며 로그인 페이지로 이동한다.

[그림 3.2] WebAdmin의 [로그아웃] 메뉴

20 JEUS 소개

제4장 JEUS 안내서 구성

본 장에서는 안내서를 어떻게 활용하면 좋은지와 안내서에서 사용된 약자들을 소개한다. JEUS 안내서에

서 필요한 정보를 얻기 위해서는 본 장을 주의 깊게 살펴보길 바란다.

4.1. 개요JEUS 안내서는 다음과 같은 3가지 방법으로 구할 수 있다.

● 소프트웨어와 함께 제공되는 html 문서

● JEUS Installer CD에서 제공되는 PDF 파일

PDF 파일을 보려면 Adobe Acrobat Reader나 혹은 다른 PDF를 지원하는 소프트웨어가 필요하다.

http://www.adobe.com/products/acrobat/readstep.html을 방문하면 Adobe Acrobat Reader를 다운로드

받을 수 있다.

● TmaxSoft의 TechNet 사이트에서 업데이트된 소프트웨어나 안내서

TechNet 주소는 http://technet.tmax.co.kr/kr/index.do이다.

다음은 JEUS 안내서에 대해 기본적으로 알아야 하는 4가지 사항이다.

● JEUS 안내서는 Java와 Java EE 기술에 대한 경험을 가진 Java EE 전문가를 위해 작성되었다.

● 안내서는 개별적이고 연관성을 배제한 문서들로 구성되어 있다.

● JEUS 안내서 문서는 몇 가지의 예외를 제외하고는 기본적으로 표준적인 문서 양식에 따라 구성되어 있

다.

● 안내서는 매우 다양한 방식으로 구성되어 있다.

참고

안내서의 내용을 이해하기 위해서는 Java와 Java EE 기술에 대한 지식이 필요하다. 그러한 지식은

서점에 있는 다양한 서적들로부터 얻길 바란다. 또한, Java 관련 웹 사이트인 http://www.ora

cle.com/technetwork/java/index.html에서 유용한 온라인 문서와 스펙, 자습서 등을 얻을 수 있다.

JEUS 안내서에서 Java EE 스펙에 서술되어 있는 모든 내용에 대해 다루는 것은 어렵다. 현재는 단

지 JEUS에 특화된 정보들에 대해서만 다룬다.

4.2. 안내서의 구성다음의 [그림 4.1]은 JEUS 안내서의 구성을 나타낸다. 화살표는 JEUS에 익숙하지 못한 사용자를 위해 읽

어야 할 우선순위를 나타낸 것이다. JEUS 안내서는 총 18권으로 구성되어 있다.

제4장 JEUS 안내서 구성 21

[그림 4.1] JEUS 안내서 구성

각각의 안내서에 대한 내용들은 다음의 목록에 명시되어 있다. 특정한 주제에 대해서 위치를 빨리 찾고 싶

다면 다음의 목록을 참조한다.

● JEUS 6 릴리즈 노트

– JEUS의 새로운 기능

– 이전 버전의 업그레이드 방법

● JEUS 소개

JEUS 6 서버에 대한 전반적인 소개와, JEUS의 아키텍처 및 각 구성 요소들에 대해 설명한다.

– JEUS6 서버에 대한 소개

– JEUS 환경

– JEUS 안내서의 구성

● JEUS 설치 및 시작하기

– Windows와 UNIX에서 Java 설치

– Windows와 UNIX에서 JEUS 설치

– 예제 애플리케이션에 대한 설명 포함(QuickStart)

– JEUS 시스템 입문서

22 JEUS 소개

– EJB 입문서

– 서블릿/JSP 입문서

● JEUS WebAdmin 안내서

JEUS의 웹 관리 툴로서, 일반 사용자부터 관리자까지 반드시 읽어야 한다.

– JEUS의 설정 및 제어, 모니터링

– JEUS 클러스터링

– Java EE Application Deployment

– 리소스 설정 및 관리

● JEUS Server 안내서

JEUS 관리 차원의 주요 안내서이며, JEUS 시스템 관리자들이 가장 많이 읽어야 하는 부분이다.

– JEUS 시스템과 서버에 대한 개요

– JEUS Manager

– JEUS JNDI Naming Server와 JNDI 구성

– External Resource: JDBC/Data Source 커넥션 풀, URL Source, Mailing Source, Tmax와 IBM MQ

Source와 Java EE Connector

– JDBC Connection Pool과 Connector

– JEUS 노드

– 세션 서버

– JEUS 엔진 컨테이너

– JEUS 트랜잭션 매니저

– JEUS 엔진: EJB, 웹 컨테이너, JMS, 웹 서버 엔진

– JEUS 클러스터링

– Java EE 애플리케이션의 Deploy

● JEUS EJB 안내서

JEUS EJB 엔진과 EJB 모듈을 Deploy하는 것에 대해 주로 설명한다.

– JEUS EJB에 대한 개요

– JEUS EJB 엔진

– EJB 모듈들

– 일반적인 EJB(각각의 Bean들에 대한 구성)

– JEUS EJB에 대한 보안

제4장 JEUS 안내서 구성 23

– JEUS EJB에 대한 보안의 상호작용

– JEUS EJB 클러스터링

– 세션 EJB

– Entity EJB

– MDB EJB

– EJB 클라이언트

● JEUS Web Container 안내서

JEUS 웹 컨테이너의 관리를 위한 안내서이며, Java EE WAR Archive와 서블릿/JSP의 관리와 Deploy

하는 방법에 대해 설명한다.

– JEUS 웹에 대한 개요

– JEUS 웹 컨테이너

– JEUS 웹 컨텍스트 그룹

– 웹 서버와의 연결과 클러스터링(WebtoB, Apache and built-in HTTP server connections and clusters)

– 클러스터된 환경에서의 세션 추적

– 웹 컨텍스트(웹 애플리케이션/WAR 파일들)

– 가상 호스팅

● JEUS MQ 안내서

JEUS 메시지 기반 시스템(JMS)을 설명한다.

– JEUS JMS의 개요

– JMS 엔진에 대한 환경설정 그리고, 모니터링과 제어

– JEUS에서의 JMS 프로그래밍

● JEUS Web Service 안내서

JEUS 내의 웹 서비스에 대해 설명한다.

– JEUS 웹 서비스에 대한 개요

– 웹 서비스 back-end 생성

– 웹 서비스 back-end를 사용하는 클라이언트 구현하기

– 데이터 타입과 JEUS 웹 서비스

– 웹 서비스에 관련된 Ant

– UDDI 이용

– 웹 서비스 보안

24 JEUS 소개

● JEUS JMX 안내서

JMX를 사용해서 JEUS를 관리하기 위한 안내서이다.

– JEUS JMX Manager 설정

– JMX 애플리케이션 개발

– JMX API 레퍼런스

● JEUS SNMP 안내서

산업 표준인 SNMP 프로토콜을 이용한 JEUS 모니터링에 대해 설명한다.

– JEUS SNMP Agent의 개요

– SNMP Agent의 구성

– JEUS SNMP 프로그래밍

– JEUS SNMP MIB

● JEUS JCA 안내서

JEUS와 legacy 시스템과 연결하기 위한 Connector에 대한 설명한다.

– Connector에 대한 내용

– Connector 패키징

– Connector 사용과 튜닝

● JEUS JPA 안내서

JEUS에 통합된 TopLink Essential을 사용해서 어떻게 사용되는지에 대해서 설명한다.

– Java Persistence API 소개

– 프로바이더 설정

– JEUS 설정

● JEUS Scheduler 안내서

JEUS의 Scheduler 기능에 대한 안내서이다.

– Scheduler Service 설정

– Scheduler Service 프로그래밍

● JEUS Application & Deployment 안내서

Java EE 애플리케이션을 JEUS에 Deploy하기 위한 여러 가지 방법과 툴에 대해 설명한다.

– Deployment 개요

– Deployment 관련 디렉터리

– Deployment Tool과 API

제4장 JEUS 안내서 구성 25

– 2-phase deployment

– Java EE Application Deployment Descriptor 설명

● JEUS Client Application 안내서

Java EE 클라이언트와 JEUS 사이의 상호 운용에 대해 설명한다.

– Java EE Java 애플리케이션 클라이언트

– 애플릿 클라이언트

– JNLP 클라이언트

– JEUS CAS: COM 애플리케이션과 JEUS의 상호 운용을 위한 것

● JEUS Security 안내서

JEUS에서 Security System을 어떻게 설정 운영할 것이며, Security 관련 프로그래밍에 대한 설명한다.

– Security 시스템의 개요와 설정

– 애플리케이션과 모듈의 Security 설정

– Security 시스템의 운영과 튜닝

– Security API를 이용한 프로그래밍

– Custom Security 서비스 개발하기

– JACC 제공자 사용하기

● JEUS Reference Book

JEUS를 사용하는 데 도움이 되는 Reference를 모아둔 안내서이다.

– 시스템 프로퍼티 내용

– 콘솔 명령어 사용법

– Ant Tasks 사용법

– JEUS에서 사용되는 API 모음

참고

위의 목록에서 보았듯이, JEUS Server 안내서는 그 범위가 매우 방대하다. JEUS Security, Naming

그리고 트랜잭션 매니저와 같은 서로 다른 많은 주제들을 포함하고 있다. 이러한 구성의 이유는 비록

주제들이 전혀 다른 것이라 할지라도 이러한 구성 요소들이 모두 동일한 환경설정 파일에서 구성되

고 동일한 JVM에서 수행되기 때문이다. 또한 각각의 안내서들의 수를 최소한으로 유지하기 위해서

이다.

26 JEUS 소개