다음은 WebAdmin을 사용해서 서버를 추가하는 과정에 대한 설명이다.

콘솔 툴에서는 add-server 명령을 통해 서버를 추가할 수 있다. 하지만 이 명령으로는 몇 가지 설정에 대해서만 추가할 수 있기 때문에 서버를 추가하고 난 뒤에 별도의 명령들을 통해 설정을 변경해야 한다. 만약 엔진 설정을 변경하는 경우 웹 엔진, EJB 엔진, JMS 엔진 명령어를 사용한다.

다음은 콘솔 툴에서 서버를 추가하는 예제이다.

[DAS]domain1.adminServer>serverinfo
Information about Domain (domain1)
================================================================================
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| Server|  Status |Node | PID | Clu |   Latest   |  Need  |   Listen  |Running |
|       |         |Name |     |ster | Start Time |   to   |   Ports   |Engines |
|       |         |     |     |     | / Shutdown |Restart |           |        |
|       |         |     |     |     |    Time    |        |           |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| admin | RUNNING | nod | 116 | N/A | 2016-08-24 | false  | base-0.0. | jms,   |
|Server |(00:03:1 |e1   |35   |     | (수) 오전   |        |0.0:9736   |ejb, web|
|(*)    |2)       |     |     |     |11:09:58 KST|        | http-serv |        |
|       |         |     |     |     |            |        |er-0.0.0.0 |        |
|       |         |     |     |     |            |        |:8088      |        |
|       |         |     |     |     |            |        | jms-0.0.0 |        |
|       |         |     |     |     |            |        |.0:9741    |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| serve | RUNNING | nod | 118 | N/A | 2016-08-24 | false  | base-0.0. | jms,   |
|r1     |(00:01:4 |e1   |08   |     | (수) 오전   |        |0.0:9836   |ejb, web|
|       |8)       |     |     |     |11:11:22 KST|        |           |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
================================================================================

[DAS]domain1.adminServer>>add-server server2 -addr 192.168.15.59 -baseport 9936 -node node1 -jvm "-Xmx512m -XX:MaxPermSize=128m"
Successfully performed the ADD operation for server (server2).
Check the results using "list-servers or add-server".

[DAS]domain1.adminServer>>modify-system-thread-pool server2 -max 200
Successfully performed the MODIFY operation for the system thread pool of the server (server2), but all changes were non-dynamic. They will be applied after restarting.
Check the results using "modify-system-thread-pool server2 or show-system-thread-pool server2".

[DAS]domain1.adminServer>>serverinfo
Information about Domain (domain1)
================================================================================
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| Server|  Status |Node | PID | Clu |   Latest   |  Need  |   Listen  |Running |
|       |         |Name |     |ster | Start Time |   to   |   Ports   |Engines |
|       |         |     |     |     | / Shutdown |Restart |           |        |
|       |         |     |     |     |    Time    |        |           |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| admin | RUNNING | nod | 116 | N/A | 2016-08-24 | false  | base-0.0. | jms,   |
|Server |(01:35:1 |e1   |35   |     | (수) 오전   |        |0.0:9736   |ejb, web|
|(*)    |2)       |     |     |     |11:09:58 KST|        | http-serv |        |
|       |         |     |     |     |            |        |er-0.0.0.0 |        |
|       |         |     |     |     |            |        |:8088      |        |
|       |         |     |     |     |            |        | jms-0.0.0 |        |
|       |         |     |     |     |            |        |.0:9741    |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| serve | RUNNING | nod | 118 | N/A | 2016-08-24 | false  | base-0.0. | jms,   |
|r1     |(01:33:4 |e1   |08   |     | (수) 오전   |        |0.0:9836   |ejb, web|
|       |8)       |     |     |     |11:11:22 KST|        |           |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| serve | SHUTDOWN| nod | N/A | N/A | N/A        | N/A    | N/A       | N/A    |
|r2     |         |e1   |     |     |            |        |           |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
================================================================================

[DAS]domain1.adminServer>>start-server server2
The server(server2) was successfully started. The server is [RUNNING]

[DAS]domain1.adminServer>>serverinfo
Information about Domain (domain1)
================================================================================
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| Server|  Status |Node | PID | Clu |   Latest   |  Need  |   Listen  |Running |
|       |         |Name |     |ster | Start Time |   to   |   Ports   |Engines |
|       |         |     |     |     | / Shutdown |Restart |           |        |
|       |         |     |     |     |    Time    |        |           |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| admin | RUNNING | nod | 116 | N/A | 2016-08-24 | false  | base-0.0. | jms,   |
|Server |(01:35:3 |e1   |35   |     | (수) 오전   |        |0.0:9736   |ejb, web|
|(*)    |8)       |     |     |     |11:09:58 KST|        | http-serv |        |
|       |         |     |     |     |            |        |er-0.0.0.0 |        |
|       |         |     |     |     |            |        |:8088      |        |
|       |         |     |     |     |            |        | jms-0.0.0 |        |
|       |         |     |     |     |            |        |.0:9741    |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| serve | RUNNING | nod | 118 | N/A | 2016-08-24 | false  | base-0.0. | jms,   |
|r1     |(01:34:1 |e1   |08   |     | (수) 오전   |        |0.0:9836   |ejb, web|
|       |3)       |     |     |     |11:11:22 KST|        |           |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
| serve | RUNNING | nod | 136 | N/A | 2016-08-24 | false  | base-192. | jms,   |
|r2     |(00:00:0 |e1   |60   |     | (수) 오후   |        |168.15.59: |ejb, web|
|       |9)       |     |     |     |12:45:27 KST|        |9936       |        |
+-------+---------+-----+-----+-----+------------+--------+-----------+--------+
================================================================================  

본 절에서는 기본적인 설정에 대해서 설명한다. 설명하지 않은 설정들에 대해서는 관련 서비스에 대한 안내서를 참고한다.

[DAS]domain1.adminServer>>modify-server server2
Shows the current configuration.
server (server2)
================================================================================
+-----------------------------------+------------------------------------------+
| Node                              | node1                                    |
| JVM Configs                       | -Xmx512m -XX:MaxPermSize=128m            |
| Action On Resource Leak           | WARNING                                  |
| Stdout to Raw Format              | true                                     |
| MEJB                              | false                                    |
| Class FTP                         | false                                    |
| Server Log Home Directory         | none                                     |
+-----------------------------------+------------------------------------------+
================================================================================

[DAS]domain1.adminServer>>modify-server server2 -logStdoutToRawFormat false -mejb true -classFtp true
Successfully performed the MODIFY operation for server (server2), but all changes were non-dynamic. They will be applied after restarting.
Check the results using "list-servers server2 or modify-server server2".

[DAS]domain1.adminServer>>modify-server server2
Shows the current configuration.
server (server2)
================================================================================
+-----------------------------------+------------------------------------------+
| Node                              | node1                                    |
| JVM Configs                       | -Xmx512m -XX:MaxPermSize=128m            |
| Action On Resource Leak           | WARNING                                  |
| Stdout to Raw Format              | false                                    |
| MEJB                              | true                                     |
| Class FTP                         | true                                     |
| Server Log Home Directory         | none                                     |
+-----------------------------------+------------------------------------------+
================================================================================ 

본 절에서는 서버에서 사용하는 네트워크 Listener 설정에 대해서 설명한다.

네트워크 Listener는 서버에서 수행되는 시스템 서비스들이나 각종 엔진에서 참조하여 그 설정을 사용하기 위한 것이다. 이 Listener는 포트 통합 서비스가 적용되어 있기 때문에 각자 다른 서비스나 엔진에서 하나의 Listener를 공유해서 사용하도록 설정할 수도 있다. 극단적인 예로는 기본 Listener 하나만을 열어두고 모든 서비스를 해당 Listener를 통해서 서비스하는 것도 가능하다.

WebAdmin 사용

다음은 WebAdmin에서 기본 Listener를 설정하는 방법이다. 기본 Listener는 설정된 Listener 중의 하나를 선택하게 되며, JEUS의 가장 기본적인 시스템 서비스 및 Webadmin 등이 이 Listener를 사용하게 된다.

[그림 2.19] 기본 Listener 설정

새로운 Listener는 [LOCK & EDIT] 버튼을 누르고 Add 버튼을 눌러서 추가할 수 있다. 개별 Listener의 기본적인 설정은 다른 시스템 서비스나 엔진에서 참조할 이름을 반드시 설정하며, 다른 Listener와 중복되지 않도록 포트 번호를 설정한다.

[그림 2.20] 개별 Listener 설정

다음은 Listener에 적용할 수 있는 SSL(Secure Socket Layer) 설정이다. 해당 Listener를 사용하는 서비스나 엔진이 SSL로 서비스를 한다. (예: https)

[그림 2.21] 개별 Listener SSL 설정

본 절에서는 서버에서 사용하는 공용 Thread Pool에 대한 설정을 설명한다.

서버에서 사용되는 서비스들이 전용 Thread Pool을 별도로 설정해서 사용하지 않는다면 모두 이 공용 Thread Pool을 사용한다. 공용 Thread Pool을 사용하는 서비스는 트랜잭션 서비스와 JNDI 서비스, 스케줄러 서비스가 있다. 이 서비스들은 설정에 따라 공용 Thread Pool을 사용할 수도 있고, 전용 Thread Pool을 사용할 수도 있다. 공용 Thread Pool을 사용한다면 서비스에서 사용할 최소 Thread 개수를 미리 할당해 놓을 수 있다.

WebAdmin 사용

다음은 WebAdmin에서 Thread Pool을 설정하는 방법에 대한 설명이다.

콘솔 툴 사용

다음은 콘솔 툴로 공용 Thread Pool을 조회하고 변경하는 예제이다.

다음은 Thread Pool의 max를 100에서 200으로 변경하고 keep alive time을 5분에서 10분으로 변경하는 예제이다.

[DAS]domain1.adminServer>show-system-thread-pool server1
Shows the current configuration.
the system thread pool of the server (server1)
================================================================================
+---------------------------------------------------------+--------------------+
| Min                                                     | 0                  |
| Max                                                     | 100                |
| Keep-Alive Time                                         | 300000             |
| Queue Size                                              | 4096               |
| Max Stuck Thread Time                                   | 3600000            |
| Action On Stuck Thread                                  | IGNORE_AND_REPLACE |
| Stuck Thread Check Period                               | 300000             |
| Reserved Threads for the Service transaction            | 0                  |
| Reserved Threads for the Service namingserver           | 0                  |
+---------------------------------------------------------+--------------------+
================================================================================

[DAS]domain1.adminServer>modify-system-thread-pool server1 -max 200 -keep 600000
Successfully performed the MODIFY operation for the system thread pool of the server (server1).
Check the results using "modify-system-thread-pool server1 or show-system-thread-pool server1".

[DAS]domain1.adminServer>show-system-thread-pool server1
Shows the current configuration.
the system thread pool of the server (server1)
================================================================================
+---------------------------------------------------------+--------------------+
| Min                                                     | 0                  |
| Max                                                     | 200                |
| Keep-Alive Time                                         | 600000             |
| Queue Size                                              | 4096               |
| Max Stuck Thread Time                                   | 3600000            |
| Action On Stuck Thread                                  | IGNORE_AND_REPLACE |
| Stuck Thread Check Period                               | 300000             |
| Reserved Threads for the Service transaction            | 0                  |
| Reserved Threads for the Service namingserver           | 0                  |
+---------------------------------------------------------+--------------------+
================================================================================

다음은 JNDI 서비스에서 공용 Thread Pool에서 Thread를 미리 할당하도록 설정하는 예제이다.

[DAS]domain1.adminServer>show-system-thread-pool server1
Shows the current configuration.
the system thread pool of the server (server1)
================================================================================
+---------------------------------------------------------+--------------------+
| Min                                                     | 0                  |
| Max                                                     | 200                |
| Keep-Alive Time                                         | 600000             |
| Queue Size                                              | 4096               |
| Max Stuck Thread Time                                   | 3600000            |
| Action On Stuck Thread                                  | IGNORE_AND_REPLACE |
| Stuck Thread Check Period                               | 300000             |
| Reserved Threads for the Service transaction            | 0                  |
| Reserved Threads for the Service namingserver           | 0                  |
+---------------------------------------------------------+--------------------+
================================================================================

[DAS]domain1.adminServer>modify-system-thread-pool server1 -service namingserver -r 10
Successfully performed the MODIFY operation for The namingserver thread pool of the server (server1)., but all changes were non-dynamic. They will be applied after restarting.
Check the results using "show-system-thread-pool server1 -service namingserver or modify-system-thread-pool server1 -service namingserver".

[DAS]domain1.adminServer>show-system-thread-pool server1 -service namingserver
Shows the current configuration.
the system thread pool of the server (server1)
================================================================================
+---------------------------------------------------------+--------------------+
| Min                                                     | 0                  |
| Max                                                     | 200                |
| Keep-Alive Time                                         | 600000             |
| Queue Size                                              | 4096               |
| Max Stuck Thread Time                                   | 3600000            |
| Action On Stuck Thread                                  | IGNORE_AND_REPLACE |
| Stuck Thread Check Period                               | 300000             |
| Reserved Threads for the Service transaction            | 0                  |
| Reserved Threads for the Service namingserver           | 10                 |
+---------------------------------------------------------+--------------------+
================================================================================

[DAS]domain1.adminServer>modify-system-thread-pool server1 -service namingserver
Shows the current configuration.
The namingserver thread pool of the server (server1).
================================================================================
+----------------------------------------------------------------------+-------+
| Reserved Threads for the Service namingserver                        | 10    |
+----------------------------------------------------------------------+-------+
================================================================================

JEUS에서는 서버의 Lifecycle에 맞게 사용자가 원하는 작업을 할 수 있도록 Lifecycle Invocation 기능을 제공하고 있다. 서버는 부팅, 다운 과정에서 각 단계에 사용자가 설정한 이벤트를 호출해준다. Lifecycle Invocation은 WebAdmin을 통해서만 설정 가능하다.

다음은 Lifecycle Invocation에 등록하는 클래스는 일반 Java 클래스 예제이다. 이 클래스를 서버의 Lifecycle에 맞게 호출하고 싶은 대상 서버의 SERVER_HOME/lib/application에 위치시킨다.

package lifecycle;

public class LifeCycleTester {
    public void boot() {
        System.out.println("Boot");
        // do somethig
    }

    public void beforeDeploy() {
        System.out.println("Before Deploy");
        // do somethig
    }

    public void afterDeploy() {
        System.out.println("After Deploy");
        // do somethig
    }

    public void ready() {
        System.out.println("Ready");
        // do somethig
        try {
            System.out.println("Sleeping for 15 seconds ....");
            Thread.sleep(15000L);
        } catch (Exception e) {
            //ignored
        }
    }

    public void beforeUndeploy() {
        System.out.println("Before Undeploy");
        // do somethig
    }

    public void afterUndeploy() {
        System.out.println("After Undeploy");
        // do somethig
    }
}

WebAdmin 사용

다음은 위의 예제를 이용해서 WebAdmin을 통해 서버의 Lifecycle Invocation 클래스로 설정하는 과정에 대한 설명이다.

서버의 애플리케이션에서 공통으로 사용할 리소스에 대한 매핑 정보를 설정한다.

애플리케이션에서 사용하는 리소스는 해당 애플리케이션이 서비스되는 서버의 JNDI 저장소에 이름이 등록된다. 리소스 매핑을 설정하면 등록되는 이름에 상관없이 애플리케이션에서는 항상 같은 이름의 리소스를 Lookup해서 사용할 수 있다.

WebAdmin 사용

다음은 WebAdmin에서 Resource Reference를 설정하는 과정에 대한 설명이다.