제2장 도메인 생성

내용 목차

2.1. 도메인 생성
2.1.1. 기본 도메인 생성
2.1.2. Virtual Multicast를 사용하는 도메인 생성
2.2. 도메인 구성
2.2.1. WebAdmin 사용
2.2.2. 콘솔 툴 사용
2.3. 디렉터리 구성
2.3.1. JEUS_HOME 디렉터리
2.3.2. 도메인 디렉터리

본 장에서는 도메인을 생성할 때 필요한 조건과 JEUS가 제공하는 툴(WebAdmin, jeusadmin)을 사용하여 도메인 생성 방법, 도메인 생성 후 디렉터리 구조에 대해 설명한다.

도메인을 생성하면 도메인 디렉터리가 생성되고 그 안에 도메인에 속한 서버들을 시작하고 종료할 수 있는 스크립트와 기본적인 설정 파일들이 생성된다. 각 도메인의 최상위 디렉터리는 DOMAIN_HOME이라고 하고, 다음의 경로에 위치한다.

JEUS_HOME/domains/<domain_name>

도메인을 처음 생성하면 DAS만 포함된 도메인이 생성되고 WebAdmin이나 jeusadmin을 사용해 MS를 추가하여 원하는 도메인을 구성한다. 추가한 MS를 원하는 머신에서 시작하면 해당 머신에 필요한 도메인 정보가 DAS를 통해 전달된다. 즉, DAS는 도메인 생성을 통해 도메인 디렉터리를 생성하고, MS는 처음 시작할 때 DAS를 통해 도메인 디렉터리를 생성한다.

Ant Task나 jeusadmin을 통해 도메인을 생성할 수 있다. 이때 다음의 2가지 조건이 필요하다.

본 절에서는 기본 도메인을 생성하는 방법에 대해 설명한다. 기본 도메인을 생성할 때에는 Virtual Multicast가 동작하지 않음에 유의한다.

Ant Task와 jeusadmin 명령에 사용할 속성들은 공통적으로 다음과 같은 기본값을 갖는다.

속성기본값
DAS 이름adminServer
Listen IP 주소0.0.0.0 / 0:0:0:0:0:0:0:0
Listen Port 번호9736
사용자 이름administrator
Multicast IP 주소230.30.1.1 / FF01:0:0:0:0:0:0:1
Multicast Port 번호3030

  • Ant Task를 사용한 도메인 생성

    Ant Task에서 설정의 기본값은 JEUS_HOME/setup/domain-config-template.properties에 정의되어 있다. 기본값은 사용자가 별도로 설정하지 않아도 자동으로 값이 설정되지만 아래의 생성 예제에서는 설정 방법 확인을 위해 표시한다.

    JEUS_HOME/setup$ ant create-domain -Ddomain=jeus_domain
    -Dservername=adminServer 
    -Djeus.address=0.0.0.0 
    -Djeus.port=9736 
    -Dtransport.address=224.0.0.1
    -Dtransport.port=12488
  • jeusadmin을 사용한 도메인 생성

    jeusadmin에서 설정 기본값은 JEUS_HOME/setup/domain-config-template.properties에 정의되어 있다. domain-config-template.properties에 jeus.password 설정이 있다면 설정을 따르고 없다면 아래 예제와 같이 password를 입력 받는다.

    offline>create-domain -domain jeus_domain -das adminServer -taddress 224.0.0.1 -tport 12488
    Enter the password for [administrator]: **********
    Confirm the password: **********
    Do you want to encrypt the password? (y/n): y
    ================================================================================
    The domain [jeus_domain] was created successfully.
    +-------------------------------+----------------------------------------------+
    |         Property              |                        Value                 |
    +-------------------------------+----------------------------------------------+
    | Domain name                   | jeus_domain                                  |
    | Das Name                      | adminServer                                  |
    | Das Base Listen Port          | 9736                                         |
    | Das Base Listen Address       | 0.0.0.0                                      |
    | HTTP Port                     | 8088                                         |
    | User Name                     | jeus                                         |
    | Node Name                     | node1                                        |
    | Password                      | {base}amV1cw==                               |
    | JVM Option                    | -Xmx256m -XX:MaxMetaspaceSize=128m           |
    | Production Mode               | true                                         |
    | Transport Type                | HYBRID                                       |
    +-------------------------------+----------------------------------------------+
    ================================================================================  

본 절에서는 IP Multicast를 사용할 수 있는 환경인지 테스트하는 방법, 그리고 IP Multicast를 사용할 수 없는 환경이나 도메인이 서브넷을 넘어서는 범위에 걸쳐서 구성되어있을 경우에 Virtual Multicast를 사용하는 도메인의 생성 방법에 대해 설명한다.

IP Multicast를 사용할 수 있는 환경인지 테스트하기 위해서는 mcastSender와 mcastReceiver라는 두 개의 테스트 스크립트를 실행하면 된다. 두 개의 스크립트는 JEUS_HOME/bin에 위치하고 있으며 다음과 같이 각각 다른 머신에서 실행하면 된다.

JEUS_HOME/bin$ mcastReceiver -addr 224.0.0.1 -port 3030
Socket == 0.0.0.0/0.0.0.0 : 3030, bound to /fe80:0:0:0:2a37:37ff:fe1e:fc4%5
Socket == 0.0.0.0/0.0.0.0 : 3030, bound to /192.168.0.26
Socket == 0.0.0.0/0.0.0.0 : 3030, bound to /fe80:0:0:0:3e07:54ff:fe6f:95e%4
Socket == 0.0.0.0/0.0.0.0 : 3030, bound to /61.77.153.207
Socket == 0.0.0.0/0.0.0.0 : 3030, bound to /fe80:0:0:0:0:0:0:1%1
Socket == 0.0.0.0/0.0.0.0 : 3030, bound to /0:0:0:0:0:0:0:1
Socket == 0.0.0.0/0.0.0.0 : 3030, bound to /127.0.0.1          
JEUS_HOME/bin$ mcastSender -addr 224.0.0.1 -port 3030
1 == 0.0.0.0/0.0.0.0 : 3030, bound to /fe80:0:0:0:2a37:37ff:fe1e:fc4%5
2 == 0.0.0.0/0.0.0.0 : 3030, bound to /192.168.0.26
3 == 0.0.0.0/0.0.0.0 : 3030, bound to /fe80:0:0:0:3e07:54ff:fe6f:95e%4
4 == 0.0.0.0/0.0.0.0 : 3030, bound to /61.77.153.207
5 == 0.0.0.0/0.0.0.0 : 3030, bound to /fe80:0:0:0:0:0:0:1%1
6 == 0.0.0.0/0.0.0.0 : 3030, bound to /0:0:0:0:0:0:0:1
7 == 0.0.0.0/0.0.0.0 : 3030, bound to /127.0.0.1 

이 테스트는 머신의 모든 네트워크 인터페이스를 통해서 IP Multicast 패킷을 송수신하려고 시도한다. 최초에 나오는 주소들은 모든 네트워크 인터페이스를 나타내는 것이다.

이어서 Sender쪽에 나타난 프롬프트에 임의의 메시지를 입력하면 Receiver쪽에 수신된다. 만일 수신이 되지 않는다면 IP Multicast가 제대로 동작하지 않는 환경이기 때문에 아래에 나오는 Virtual Multicast를 설정해야 한다. 위의 mcastSender에서 메시지 테스트의 실행 예는 다음과 같다.

> test
> 
test [sender = 192.168.0.26 : 5555], [bind_addr=/127.0.0.1]
test [sender = 192.168.0.26 : 5555], [bind_addr=/61.77.153.207]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:3e07:54ff:fe6f:95e%4]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:3e07:54ff:fe6f:95e%4]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:2a37:37ff:fe1e:fc4%5]
test [sender = 192.168.0.26 : 5555], [bind_addr=/61.77.153.207]
test [sender = 192.168.0.26 : 5555], [bind_addr=/192.168.0.26]
test [sender = 192.168.0.26 : 5555], [bind_addr=/192.168.0.26]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:3e07:54ff:fe6f:95e%4]
test [sender = 192.168.0.26 : 5555], [bind_addr=/61.77.153.207]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:2a37:37ff:fe1e:fc4%5]
test [sender = 192.168.0.26 : 5555], [bind_addr=/61.77.153.207]
test [sender = 192.168.0.26 : 5555], [bind_addr=/61.77.153.207]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:2a37:37ff:fe1e:fc4%5]
test [sender = 192.168.0.26 : 5555], [bind_addr=/61.77.153.207]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:3e07:54ff:fe6f:95e%4]
test [sender = 192.168.0.26 : 5555], [bind_addr=/192.168.0.26]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:3e07:54ff:fe6f:95e%4]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:3e07:54ff:fe6f:95e%4]
test [sender = 192.168.0.26 : 5555], [bind_addr=/192.168.0.26]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:3e07:54ff:fe6f:95e%4]
test [sender = 192.168.0.26 : 5555], [bind_addr=/192.168.0.26]
test [sender = 192.168.0.26 : 5555], [bind_addr=/61.77.153.207]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:2a37:37ff:fe1e:fc4%5]
test [sender = 192.168.0.26 : 5555], [bind_addr=/192.168.0.26]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:2a37:37ff:fe1e:fc4%5]
test [sender = 192.168.0.26 : 5555], [bind_addr=/192.168.0.26]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:2a37:37ff:fe1e:fc4%5]
test [sender = 192.168.0.26 : 5555], [bind_addr=/fe80:0:0:0:2a37:37ff:fe1e:fc4%5]

하나의 메시지가 다수의 네트워크 인터페이스를 통해서 송신되고, 또한 다수의 네트워크 인터페이스를 통해서 수신되기 때문에 하나 이상의 메시지가 수신될 수 있다. Sender쪽의 프롬프트에 quit 또는 exit를 입력하면 종료되며, Receiver는 <Ctrl> + C를 이용하여 종료해야 한다.

각각의 도움말을 보려면 인자로 -help를 입력하거나 인자를 주지않으면 된다.

다음은 Virtual Multicast를 설정하는 방법이다. 속성의 기본값은 “2.1.1. 기본 도메인 생성”과 동일하다.

  • Ant Task를 사용한 도메인 생성

    JEUS_HOME/setup$ ant create-domain
    -Ddomain=jeus_domain
    -Djeus.address=192.168.34.1 
    -Dusevirtualmulticast=true
  • jeusadmin을 사용한 도메인 생성

    offline>create-domain  -domain jeus_domain -baseaddress 192.168.34.1 -uvm 
    Enter the password for [administrator]: **********
    Confirm the password: **********
    Do you want to encrypt the password? (y/n): y
    ================================================================================
    The domain [jeus_domain] was created successfully.
    +-------------------------+----------------------------------------------------+
    |         Property        |                        Value                       |
    +-------------------------+----------------------------------------------------+
    | Domain name             | jeus_domain                                        |
    | Das Name                | adminServer                                        |
    | Das Base Listen Port    | 9736                                               |
    | Das Base Listen Address | 192.168.34.1                                       |
    | JMS Internal Port       | 9741                                               |
    | HTTP Port               | 8088                                               |
    | User Name               | administrator                                      |
    | Node Name               | node1                                              |
    | Password                | {AES:256}r2qfvDR/5DvZHmuPBEjbXCvKyR+F2dJ8tFaA/+k=  |
    | JVM Option              | -Xmx256m -XX:MaxPermSize=128m                      |
    | Production Mode         | true                                               |
    | Use virtual multicast   | true                                               |
    +-------------------------+----------------------------------------------------+
    ================================================================================

본 절에서는 “2.1. 도메인 생성”에서 생성한 도메인에 서버와 클러스터를 추가하여 도메인을 구성하는 방법에 대해 설명한다.

서버와 클러스터를 추가하는 것 또한 설정을 변경하는 것이기 때문에 추가하기 전에 다음과 같이 DAS를 구동한다. 설정 변경에 대한 자세한 내용은 “제3장 도메인 설정변경”을 참고한다.

DOMAIN_HOME/bin$ startDomainAdminServer -u administrator -p 1111111

WebAdmin을 사용하여 서버와 클러스터를 추가할 때 다음과 같은 순서로 추가 및 설정한다.

노드 추가

노드는 특정 머신에 설치된 JEUS를 의미한다. 노드에서 DAS를 통해 서버를 시작하려면 해당 노드의 정보를 구성하는 작업이 필요하다. 사용하는 OS가 UNIX 계열인 경우 SSH를 사용하는 SSH 노드가 지원된다. 해당 머신의 호스트 주소, JEUS 설치 디렉터리, SSH 접속을 위한 사용자 이름, SSH 접속을 위한 개인 Key 파일 경로, SSH 접속 포트 번호 등을 지정할 수 있다. JEUS를 설치할 때 기본적으로 하나의 노드가 생성되며 설정을 변경해서 사용할 수 있다. 노드 관리에 대한 자세한 설명은 "JEUS Node Manager 안내서"를 참고한다.

다음은 새로운 노드를 추가하는 과정에 대한 설명이다.

설정변경 모드로 전환

노드의 추가와는 달리 서버, 클러스터를 추가 및 변경하려면 WebAdmin 화면의 왼쪽에서 [LOCK & EDIT] 버튼을 클릭해서 설정변경 모드를 전환해야 한다.


참고

WebAdmin의 설정변경 모드에 대한 자세한 설명은 JEUS WebAdmin 안내서”의 “2.3.2. 메뉴 영역”을 참고한다(노드의 설정 변경은 도메인 간에도 영향을 주지만 서버, 클러스터의 변경은 도메인 내에서만 영향을 주기 때문에 다른 Lock 메커니즘을 사용한다).

Managed Server(MS) 추가

MS를 추가할 때에는 동적으로 변경하지 못하는 설정들을 신중히 고려하여 입력해야 한다.

“2.1. 도메인 생성”에서 설명한 도메인을 생성할 때 DAS의 기본 설정과 마찬가지로 MS를 추가할 때의 기본 설정은 동적 반영이 안 되는 설정이다. 같은 머신에 있는 다른 서버들과 충돌되지 않는 Port 번호를 선정해야 하고, 외부에서 이 서버로 접속할 IP 주소와 서버의 JVM에게 전달할 옵션을 설정해야 한다. 서브넷을 벗어난 도메인의 경우라면 기본값 '0:0:0:0'을 사용하지 않고 하나의 IP 주소를 지정한다. 도메인 내에서 서버 이름은 유일한 값이어야 하므로 등록된 서버 이름을 확인한 후 충돌이 발생하지 않게 설정해야 한다. 본 예제에서 생성할 서버는 같은 클러스터를 구성할 서버들이므로 클러스터 내에서 동일해야 하는 설정들은 각 서버에서 별도로 설정하지 않아도 된다.

다음은 WebAdmin에서 MS를 추가하는 방법에 대한 설명이다.

  1. WebAdmin의 왼쪽 메뉴에서 [Servers]를 선택하면 서버 목록 조회 화면으로 이동한다.

  2. [LOCK & EDIT] 버튼을 클릭해서 설정변경 모드로 전환한다.

  3. Servers 화면([그림 2.2])에서 [ADD] 버튼을 클릭한 후 [Basic] > [Basic Info] 메뉴로 이동한다. Server 화면에서 추가할 서버의 정보를 입력한 후 [확인] 버튼을 클릭한다.

    다음은 Server 설정 화면의 고급선택사항이다.


    'Data Sources'에 "Cluster에 포함될 서버라면 해당 항목은 Cluster에 설정해야 합니다. Cluster 설정이 우선됩니다."라는 문구가 표시된다. 이 항목들은 클러스터 내에서 동일하게 설정되어야 한다. 따라서 클러스터에 포함하기 위해 서버를 생성하는 경우 서버의 항목을 설정하지 않고 서버가 포함될 클러스터의 동일한 항목을 설정한다.

    이미 클러스터에 포함된 서버의 설정 정보를 수정하는 경우에는 클러스터 내에서 동일하게 설정되어야 하는 항목은 "Cluster[cluster1]에 속해 있습니다. 해당 설정은 Cluster의 설정이 적용됩니다."라는 문구가 표시된다.

  4. 리스너를 추가하려면 [Resource] > [Listener] 메뉴로 이동한다. Listeners 화면Listener 영역에 있는 [ADD] 버튼을 클릭한다.

  5. Listener 화면에서 추가할 기본 리스너의 각 정보를 원하는 대로 입력하고 [확인] 버튼을 클릭한다.

  6. MS가 추가되면 서버의 기본 리스너를 선택하는 'Base' 항목을 5번에서 추가한 리스너의 name으로 지정하고 [확인] 버튼을 클릭한다.

  7. 변경 내용의 반영을 위해 [Activate Changes] 버튼을 클릭한다.

  8. 서버 생성이 완료되면 서버 목록에서 확인할 수 있다.

클러스터 추가

클러스터를 추가할 때에는 클러스터 내의 모든 서버가 같은 서비스를 하기 위한 설정과 클러스터의 기능인 부하 분산(Load Balance)과 장애 극복(Failover)을 위한 설정을 해야한다. 클러스터 설정에 대한 자세한 설명은 “5.5. 클러스터 설정”을 참고한다.

다음은 WebAdmin에서 클러스터를 추가하는 과정에 대한 설명이다.

  1. WebAdmin의 왼쪽 메뉴에서 [Clusters]를 선택하면 클러스터 목록 조회 화면으로 이동한다.

  2. [LOCK & EDIT] 버튼을 클릭해서 설정변경 모드로 전환한다.

  3. Clusters 화면에서 [ADD] 버튼을 클릭한 후 [Basic] 탭을 선택해서 클러스터의 세부 설정을 한다. 클러스터 설정에 대한 자세한 설명은 “5.5. 클러스터 설정”을 참고한다.

    클러스터에 추가할 수 있는 서버는 일반 서버와 다이나믹 서버가 있다. 클러스터당 한 가지 방법만 사용 가능하다.

    • 새 클러스터에 직접 서버에 포함될 서버들을 지정하여 생성하는 방법

      이미 생성된 서버들을 클러스터에 포함시키게 되며, 서버별 설정이 가능하고 클러스터에 서버를 자유로이 추가 제거할 수 있다. Cluster 화면에서 'Servers' 항목에 있는 여러 서버들 중에서 클러스터로 묶기를 원하는 서버들을 선택한 후 [확인] 버튼을 클릭한다.

    • 클러스터에 포함될 서버들을 미리 저장해 둔 서버 템플릿을 통하여 생성하는 방법

      지정된 갯수의 서버들을 서버 템플릿에 저장된 설정을 이용하여 일괄적으로 생성하도록 한다. 개별 서버의 설정 변경은 불가능하고, 템플릿이나 클러스터 설정을 변경하는 것으로 전체적인 설정만이 가능하다. Cluster 화면에서 'Dynamic Servers' 항목을 클릭하면 동적으로 생성할 서버들의 설정을 할 수 있다. 'Server Count'를 설정하여 몇 개의 서버를 생성할지 지정할 수 있고, 이 서버들의 설정 정보는 'Server Template Name' 항목에서 지정할 수 있다. 이후 각 서버들이 위치할 노드들을 아래의 'Node Names' 에서 설정하고 [확인] 버튼을 클릭한다. 어떤 노드도 설정하지 않은경우에는 모든 노드들을 대상으로 한다.

  4. 클러스터의 추가가 완료되면 추가되었다는 메시지가 출력된다.

  5. 변경 내용의 반영을 위해 [Activate Changes] 버튼을 클릭하면 변경 내용이 반영되었다는 결과 메시지가 화면에 표시된다.

  6. WebAdmin 왼쪽 메뉴에서 [Clusters]를 선택하면 클러스터 조회 목록 화면으로 이동한다. 추가한 서버들을 시작하려면 조회된 클러스터 목록에서 원하는 클러스터의 [start] 버튼을 클릭한다.

JEUS의 콘솔 툴(jeusadmin)을 사용하여 도메인을 구성하는 방법은 WebAdmin을 사용할 경우와 동일하지만 "설정변경 모드로 전환" 과정이 필요없다.

jeusadmin을 사용한 도메인 구성 방법은 다음과 같다.

  1. add-ssh-node 명령어를 사용하여 'node1'이라는 이름의 서버가 위치할 노드를 추가한다. 동일한 방법으로 'node2'도 추가한다. add-ssh-node 명령어에 대한 자세한 사용법은 JEUS Reference Book”의 “4.2.15.2. add-ssh-node”를 참고한다.

    [DAS]domain1.adminServer>add-ssh-node node1 -host 192.168.34.1 -dir /home/sshUser/jeus -user sshUser
    The node [node1] was successfully added.

  2. add-server 명령어를 사용하여 'server1'이라는 이름의 MS를 추가한다. 동일한 방법으로 'server2'도 추가한다. add-server 명령어에 대한 자세한 사용법은 JEUS Reference Book”의 “4.2.4.7. add-server”를 참고한다.

    [DAS]domain1.adminServer>add-server server1 -node node1 -addr 192.168.34.1 -port 9836
    Successfully performed the ADD operation for server (server1).
    Check the results using "list-servers or add-server"

  3. add-cluster 명령어를 사용하여 'cluster1'이라는 이름의 'server1'과 'server2'로 구성된 클러스터를 추가한다. add-cluster 명령어에 대한 자세한 사용법은 JEUS Reference Book”의 “4.2.4.1. add-cluster”를 참고한다.

    [DAS]domain1.adminServer> add-cluster cluster1 -servers server1,server2
    Successfully performed the ADD operation for cluster (cluster1).
    Check the results using "list-clusters or add-cluster"

  4. 클러스터의 추가까지 완료되면 다음과 같이 serverinfo 명령어를 사용하여 도메인의 구성 결과를 확인할 수 있다.

    [DAS]domain1.adminServer>serverinfo
    
    Information about Domain (domain1)
     ===============================================================================================
     +--------+---------+-----+-------+-----+----------------+---------+-------------+-------------+
     | Server |  Status | Node|  PID  | Clus|  Latest Start  | Need to | Listen Ports| Running     |
     |        |         |Name |       | ter |Time / Shutdown | Restart |             | Engines     |
     |        |         |     |       |     |     Time       |         |             |             |
     +--------+---------+-----+-------+-----+----------------+---------+-------------+-------------+
     | adminSe| RUNNING | N/A | 5360  | N/A | 2016-08-23     | false   | base-192.168| jms,        |
     |rver(*) |(00:01:11|     |       |     |(화) 오후        |         |.34.3:9736   | ejb, web    |
     |        |)        |     |       |     |03:53:28 KST    |         | http-server-|             |
     |        |         |     |       |     |                |         |0.0.0.0:8088 |             |
     |        |         |     |       |     |                |         |jms-internal-|             |
     |        |         |     |       |     |                |         |0.0.0.0:9741 |             |
     +--------+---------+-----+-------+-----+----------------+---------+-------------+-------------+
     | server1| RUNNING |node1| 6424  | clus| 2016-08-23     | false   | base-192.168| jms,        |
     |        |(00:00:03|     |       |ter1 |(화) 오후        |         |.34.1:9836   | ejb, web    |
     |        |)        |     |       |     |03:54:37 KST    |         |             |             |
     +--------+---------+-----+-------+-----+----------------+---------+-------------+-------------+
     | server2| RUNNING |node2| 3012  | clus| 2016-08-23     | false   | base-192.168| jms,        |
     |        |(00:00:03|     |       |ter1 |(화) 오후        |         |.34.2:9936   | ejb, web    |
     |        |)        |     |       |     |03:54:36 KST    |         |             |             |
     +--------+---------+-----+-------+-----+----------------+---------+-------------+-------------+
     ===============================================================================================

기본적으로 JEUS를 설치하면 JEUS_HOME 디렉터리와 JEUS_HOME 디렉터리 하위에 jeus_domain이라는 도메인 디렉터리가 생성된다. 본 절에서는 user home의 path가 /home/user1이고 domain이 domain1이라고 설치했다고 가정했을 때의 구성에 대해 설명한다.

JEUS를 설치했을 때의 전체 디렉터리 구조는 다음과 같다. JEUS_HOME은 JEUS의 최상위 디렉터리로 실제 디렉터리 이름과 위치는 설치할 때 설정할 수 있다.

/home/jeus/JEUS_HOME

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


bin

서버의 시작, 종료 스크립트인 startDomainAdminServer, startManagedServer, stopServer와 JEUS 콘솔 툴(jeusadmin)과 같은 실행 파일들이 위치한다.

derby

샘플 애플리케이션이나 테스트에서 쉽게 사용할 수 있도록 Apache Derby를 포함시킨다.

docs

JEUS에서 제공하는 API에 대한 Javadoc이 존재한다.

domains

하위에 도메인별로 DOMAIN_HOME이 존재하고, JEUS_HOME에서 사용하는 노드 정보가 있는 nodes.xml이 존재한다.

lib

JEUS를 기동하는 데 필요한 라이브러리가 존재한다. shared 디렉터리를 제외한 나머지 디렉터리들은 사용자가 접근할 필요가 없다.

하위 디렉터리설명
shared

shared 디렉터리에는 애플리케이션에서 사용하는 라이브러리가 존재한다.

shared 디렉터리에 있는 라이브러리를 사용하기 위해서는 libraries.xml에 라이브러리의 정보를 추가해야 한다. 그리고 해당 라이브러리를 사용할 애플리케이션의 JEUS Deployment Descriptor(DD)에서 해당 라이브러리에 대한 레퍼런스 정보를 지정해야 한다.

shared 라이브러리에 대한 자세한 설명은 JEUS Applications & Deployment 안내서”의 “3.3.2. 공유 라이브러리”를 참고한다.

license

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

nodemanager

Java 타입의 노드 매니저를 사용하기 위한 설정 파일이 위치한다. 노드 매니저에서 남기는 로그 파일도 이 디렉터리에 저장된다.

setup

JEUS 설치 후 JEUS를 사용할 수 있도록 환경을 구축하기 위해 필요한 파일들이 위치한다.

templates

각종 설정 정보나 환경 정보 등의 template 파일이 위치한다.

JEUS_HOME/domains/domain1이 domain1의 DOMAIN_HOME 디렉터리가 된다.

도메인 디렉터리의 구조는 다음과 같다.


.applications

해당 도메인에서 관리하는 애플리케이션 파일이 존재한다. JEUS가 사용하는 디렉터리로 사용자의 접근을 제한한다. install-application이나 uninstall-application 명령어를 통해서만 추가 및 삭제가 가능하다. 각 명령어에 대한 설명은 JEUS Reference Book”의 “4.2.6.8. install-application”, JEUS Reference Book”의 “4.2.6.20. uninstall-application”을 참고한다.

.deploymentplans

해당 도메인에서 관리하는 Deployment Plan이 존재한다. JEUS가 사용하는 디렉터리로 사용자의 접근을 제한한다. install-deployment-plan과 uninstall-deployment-plan 명령어를 통해 Deployment Plan의 추가와 삭제가 가능하다. 각 명령어에 대한 설명은 JEUS Reference Book”의 “4.2.6.9. install-deployment-plan”JEUS Reference Book”의 “4.2.6.21. uninstall-deployment-plan”을 참고한다.

.libraries

해당 도메인에 설치한 라이브러리 파일이 존재한다. JEUS가 사용하는 디렉터리로 사용자의 접근을 제한한다. install-library 와 uninstall-library 명령어를 통해 라이브러리의 추가와 삭제가 가능하다. 각 명령어에 대한 설명은 JEUS Reference Book”의 “4.2.6.10. install-library”JEUS Reference Book”의 “4.2.6.22. uninstall-library”를 참고한다.

bin

해당 도메인에 속한 DAS와 MS의 시작 및 종료 스크립트가 위치한다.

JEUS_HOME/bin의 startDomainAdminServer, startManagedServer, stopServer와 동일한 기능을 수행하나 도메인 이름을 설정할 필요가 없다.

config

도메인의 설정 파일인 domain.xml이 변경된 경우 이전 이력을 위해 존재하는 백업 파일들이 위치한다. 도메인 설정에 대한 자세한 설명은 “제3장 도메인 설정변경”을 참고한다.

lib/application

도메인 전체에 적용할 애플리케이션 라이브러리를 위치시키는 디렉터리다.

SERVER_HOME에 존재하는 애플리케이션 라이브러리와 충돌이 발생할 경우 SERVER_HOME/lib/application이 우선되고 경고 메시지가 남는다. lib/application 디렉터리에 대한 자세한 설명은 JEUS Applications & Deployment 안내서”의 “3.3.1. lib/application 디렉터리”를 참고한다.

servers

디렉터리 하위에 SERVER_HOME 디렉터리가 서버 이름으로 생성된다. SERVER_HOME 디렉터리 구조에 대한 자세한 설명은 JEUS Server 안내서”의 “1.4. 서버 디렉터리 구조”를 참고한다.