다음은 JEUS의 주요 구성요소이다.

도메인은 Domain Administration Server(이하 DAS)와 Managed Server(이하 MS)로 구성된다.

DAS는 도메인을 관리하는 서버이다. 도메인에서 오직 하나만 존재한다. DAS의 역할은 도메인 설정을 관리하고, 도메인에서 서비스되는 애플리케이션을 관리 및 제어한다. 또한 도메인에 속하는 MS를 관리한다.

다음은 DAS에서만 사용할 수 있는 주요 서비스이다. 도메인 단위로 관리되어야 하는 서비스들이기 때문에 DAS에서만 실행된다. 사용자가 아래의 서비스들을 사용하기 위해서는 DAS와 연결된 콘솔 툴(jeusadmin)이나 WebAdmin을 이용해야 한다.

MS는 실제 애플리케이션을 서비스하기 위한 엔진들과 여러 서비스들을 관장하는 서버 인스턴스를 의미한다. MS는 도메인에 여러 개 존재할 수 있다. MS의 주요 역할은 사용자가 deploy하는 애플리케이션을 서비스하고, 애플리케이션이 필요로 하는 리소스나 서비스를 제공하는 것이다.

다음은 MS의 주요 서비스에 대한 설명이다.

본 절에서는 JEUS에서 지원하는 Isolated Class Loader에 대해서 설명한다.

JEUS는 애플리케이션 간에 클래스가 중복되어 발생하는 문제를 방지하기 위해 애플리케이션마다 서로 다른 클래스 로더(Class Loader)를 사용한다. 이를 Isolated Class Loader(이하 Isolated)라고 하는데, Java EE 표준은 이 방식을 기본으로 사용할 것을 권장하고 있으며 JEUS도 그 권고를 따르고 있다.

다음은 Isolated의 계층 구조이다.

이 구조에서는 각 애플리케이션의 웹 모듈의 클래스 로더가 해당 애플리케이션의 EJB 클래스 로더의 하위에 존재한다. 그리고 한 애플리케이션의 클래스 로더는 다른 애플리케이션의 클래스 로더에 클래스를 요청하지 않는다. Java EE 표준은 애플리케이션이 다른 애플리케이션의 인터페이스를 필요로 하는 경우 그 인터페이스들을 같이 패키징하도록 규정하고 있으므로 다른 애플리케이션의 클로스 로더를 참조할 수 없다.

클래스를 공유해서 사용하지 않기 때문에 한 애플리케이션을 다시 deploy할 때 다른 애플리케이션도 같이 다시 deploy할 필요가 없어진다. 이 클래스 로더 구조를 제대로 사용하기 위해서는 결국 연관된 애플리케이션 간에 EAR로 묶어서 하나의 애플리케이션으로 만드는 작업이 필요하다.

서버는 DOMAIN_HOME 하위에 각자 자신의 디렉터리를 갖는다. DOMAIN_HOME 하위에 servers 디렉터리에는 도메인에 속한 서버들의 디렉터리가 존재한다. 각 서버별로 DOMAIN_HOME/servers 하위에 서버 이름으로 디렉터리를 생성하고, 자신의 서버만의 공간에 운영 중에 필요한 정보나 서버 시작을 위해 필요한 정보 등을 저장한다. 이를 SERVER_HOME이라고 한다.

SERVER_HOME의 디렉터리 구조는 다음과 같다.

JEUS 7부터 DAS와 MS는 모두 Launcher를 통해서 기동된다. 스크립트를 통해서 서버를 시작시키거나 DAS를 통해서 MS를 시작시킬 때 모두 Launcher 프로세스를 실행한다. Launcher에서는 서버를 띄우기 위한 준비 작업과 실제 서버를 기동하는 작업을 수행한다.

Launcher의 역할은 크게 2가지가 있다.

Launcher는 먼저 DAS로부터 도메인의 설정 파일들을 받아온다. 대상이 되는 파일은 domain.xml과 security 설정 파일이다. 설정 파일을 받아오는 작업이 완료되면 Launcher에서는 받아온 설정 파일을 기반으로 서버 JVM을 기동한다. 서버를 기동할 때는 설정 파일에서 시작시킬 서버에 설정되어져 있는 JVM 옵션이나 클래스 패스를 읽어서 서버 JVM을 생성할 때 옵션으로 설정한다.

만약 Launcher 프로세스에서 설정을 받아오는 작업을 실패한 경우 머신에 캐시되어 있는 도메인 설정 파일이 존재할 경우 이 파일을 기반으로 서버 JVM을 기동시킬 것이다. Launcher에서 설정을 받아오는 작업도 실패하고, 머신에도 캐시해놓은 설정 파일이 존재하지 않는다면 서버는 부팅될 수 없다.

Launcher 프로세스는 위의 2가지 역할 외에도 서버 부팅 로그의 logging 역할을 한다.

서버가 부팅하면서 발생한 로그는 Launcher 로그에도 logging이 된다. Launcher 프로세스는 서버 JVM을 기동시키고 서버의 부팅 작업이 모두 완료될 때까지 대기하면서 서버를 부팅할 때 발생한 로그를 logging한다. 만약 서버가 로거를 초기화하기 전에 부팅에 실패했다면 Launcher 로그에서 부팅 실패 원인을 확인할 수 있다.

일반적으로 Launcher 프로세스는 서버의 JVM을 기동하고 해당 서버의 부팅이 완료됨을 확인하면 종료된다. Launcher를 통해 기동된 서버 프로세스는 백그라운드로 수행된다는 것에 유의해야 한다. 또한 서버 프로세스는 Launcher 프로세스의 자식 프로세스로 기동되기 때문에 백그라운드 프로세스로 생성되기 때문에 서버 프로세스는 자신의 콘솔 화면을 갖지 못한다.

따라서 서버의 로그를 콘솔 화면으로 출력하고 싶다면 서버를 실행할 때 -verbose 옵션을 추가해야 한다. -verbose 옵션이 존재하면 Launcher 프로세스는 서버가 종료될 때까지 종료되지 않고 서버의 로그를 화면에 출력하는 역할을 하게 된다. Launcher 로그에 대한 자세한 내용은 “8.2.2. Launcher 로거”를 참고한다.

INDEPENDENT 모드는 MS가 DAS의 관리 없이 부팅되어 운영되고 있는 모드를 의미한다. 즉, 부팅할 때 DAS의 URL 정보가 없거나 DAS가 장애상황인 경우에 발생한다.

MS를 시작시킬 때는 항상 DAS의 URL 정보를 옵션으로 주어야 한다. Launcher는 서버를 실행할 때 설정한 URL 정보로 DAS의 URL을 알 수 있기 때문에 이 정보가 없는 경우에는 DAS로부터 설정을 받아올 수가 없다. DAS URL을 주지 않은 경우 부팅하려고 하는 서버의 머신에 캐시되어 있는 설정 파일들이 있다면 서버는 해당 설정 파일을 기반으로 하여 INDEPENDENT 상태로 기동될 것이다. 하지만 서버의 머신에 설정 파일이 존재하지 않는다면 서버는 부팅될 수 없다.

서버의 머신에 설정 파일이 존재한다고 하더라도 이전에 사용하던 파일이기 때문에 DAS와 동기화가 맞지 않을 가능성이 높다. 따라서 항상 서버를 부팅할 때는 DAS의 URL을 주어야 한다.

DAS URL을 주지 않아도 되는 경우는 DAS와 MS가 같은 머신에 존재하여 도메인 설정 파일을 전송받지 않아도 되는 경우 외에는 없다. DAS가 장애상황이 아닌데 URL을 주지 않은 경우에는 서버는 INDEPENDENT 상태라고 인식하겠지만, MS에 그룹 관리 서비스가 시작되고 난 후에는 DAS와 통신이 되어 다시 DEPENDENT 모드로 복구될 것이다.

INDEPENDENT 상태는 URL을 주지 않은 상황보다 DAS가 장애상황인 경우에 많이 발생할 것이다. MS를 기동할 때 DAS가 장애상황이었다면 MS의 Launcher는 설정을 받아오는 작업도 실패할 것이다. DAS가 failback되어 INDEPENDENT 상태로 부팅된 MS가 DEPENDENT 모드로 복구되면 DAS로부터 설정 동기화를 하고 Deploy에 실패한 애플리케이션을 다시 deploy한다.

다음은 MS가 INDEPENDENT 상태로 부팅했을 때의 로그이다.

JEUS_HOME/bin$ ./startManagedServer -domain domain1 -server server1 
-u administrator -p adminadmin -dasurl 61.77.153.160:9736
***************************************************************
  - JEUS Home         : /home/test/jeus                           
  - JEUS Base Port    :
  - Added Java Option :
  - Java Vendor       : Sun
***************************************************************
================ JEUS LICENSE INFORMATION ================
=== VERSION : JEUS 7 Fix#5 (7.0.0.5-b334)
=== EDITION: Enterprise (Trial License)
=== NOTICE: This license restricts the number of allowed clients.
=== Max. Number of Clients: 5
==========================================================
[2017.05.13 23:05:06][0] [launcher-1] [Launcher-0052] Receiving the configuration failed.
 Attempting to start as INDEPENDENT.
<<__Exception__>>
java.io.IOException: Connection failed. host:61.77.153.160, port:9736, virtual id:FileTransfer
 at jeus.net.SocketProxy.getConnection(SocketProxy.java:107)
 at jeus.net.SocketProxy.getConnection(SocketProxy.java:42)
 at jeus.server.filetransfer.ConfigurationSynchronizer.connect( ConfigurationSynchronizer.java:106)
 at jeus.server.filetransfer.ConfigurationSynchronizer.checkConnection( ConfigurationSynchronizer.java:131)
 at jeus.server.filetransfer.ConfigurationSynchronizer.downloadConfigFileFromDAS( ConfigurationSynchronizer.java:170)
 at jeus.launcher.ManagedServerLauncher.receiveConfigurationFromDas( ManagedServerLauncher.java:179)
 at jeus.launcher.ManagedServerLauncher.updateXmls(ManagedServerLauncher.java:59)
 at jeus.launcher.ManagedServerLauncher.readDescriptor(ManagedServerLauncher.java:39)
 at jeus.launcher.Launcher.start(Launcher.java:145)
 at jeus.launcher.ManagedServerLauncher.main(ManagedServerLauncher.java:35)
<<__!Exception__>>
[2017.05.13 23:05:08][0] [launcher-1] [Launcher-0054] Starting the server using the local configuration.
...
[2017.05.13 23:05:26][0] [server1-1] [SERVER-0249] Successfully started the server INDEPENDENTLY
[2017.05.13 23:05:26][2] [server1-1] [SERVER-0248] The JEUS server is RUNNING
[2017.05.13 23:05:26][2] [server1-1] [SERVER-0401] The elapsed time to start: 17672ms
[2017.05.13 23:05:26][2] [launcher-10] [Launcher-0034] The server[server1] initialization completed successfully[pid : 3388].
[2017.05.13 23:05:26][0] [launcher-1] [Launcher-0040] Successfully started the server. 
The server state is now RUNNING.
JEUS_HOME/bin$ 

그 후에 DAS가 정상상황이 되었다면 MS는 다시 설정을 동기화하고, deploy에 실패한 애플리케이션이 있었다면 다시 deploy를 수행할 것이다.

[2017.05.13 23:08:28][2] [server1-66] [Domain-0101] Domain Administration Serverrecovered. server1 is running in DEPENDENT mode now.
[2017.05.13 23:08:28][2] [server1-66] [SERVER-0201] Successfully connected to Domain Administration Server(61.77.153.160:9736)
[2017.05.13 23:08:28][2] [server1-66] [SERVER-0308] Resynchronized the configuration with Domain Administration Server.

JEUS에서는 외부 라이브러리들을 JEUS로 읽어와서 연결된 애플리케이션에서 사용 가능하게 할 수 있다. 그러기 위해서는 적당한 위치에 클래스 파일을 위치시키거나 설정을 해줘야 한다. 이런 설정들은 스코프나 목적에 따라서 여러 방법으로 제공되며, 그에 따라 클래스 로딩 순서가 달라지고 클래스 우선순위도 바뀌게 된다.

애플리케이션에서 원하는 라이브러리를 잘 읽을 수 있게 하기 위해서는 설정을 하는데에 신중해야 한다. 별개의 라이브러리를 사용한다면 보통 문제는 없겠지만 같은 라이브러리의 다른 버전을 여러 곳에 놓고 쓰는 경우에는 큰 문제가 발생할 수 있다. 이런 상황에서는 원하는 라이브러리의 특정 버전을 애플리케이션에서 읽을 수 있도록 적절한 클래스 로더에 라이브러리를 올려야 하는데 이는 설정 방법에 따라서 달라지기 때문이다.

본 절에서는 클래스 로딩을 하기 위한 설정방법과 각각의 우선순위와 스코프에 대해서 간략하게 설명하도록 한다.

다음은 JEUS가 jar 파일이나 라이브러리들을 읽어들이는 우선순위 순서에 대한 설명이다.