웹 엔진에서 요청을 처리하기 위해서는 스레드 풀이 필수적이다.

스레드 풀은 Web-Connection, VirtualHost, Context 단에서 설정할 수 있으며, 우선순위가 존재하여 요청에 따라 각각 다른 스레드 풀에서 처리될 수 있다.

우선 3개의 스레드 풀을 다 활용하기 위해서는 Selector 기반으로 돌아가야 하며, 서버 리스너 설정이 있는 Ajp, Http, Tcp 리스너와 use-nio가 true인 WebtoB 커넥터가 이에 해당한다. use-nio가 false인 WebtoB 커넥터와 Tmax 커넥터는 오직 웹 커넥션 레벨의 스레드 풀에서만 처리된다.

Context와 VirtualHost 레벨에서의 스레드 풀은 선택사항이고, Web-Connection 레벨의 스레드 풀은 필수적으로 설정해야 한다. Context 스레드 풀은 jeus-web-dd.xml에서 설정이 가능하고, VirtualHost와 Web-Connection 스레드 풀은 domain.xml에서 각각 <virtual-host>와 <web-connections> 하위에서 설정이 가능하다.

[참고] JEUS21 이전에는 Web Connection 별로 스레드 풀이 존재했었고, JEUS 21 FIX 0에서는 서버 리스너가 있는 Ajp, Http, Tcp 웹 커넥션은 WebContainer, VirtualHost, Context 레벨의 스레드 풀에서 처리될 수 있었고, WebtoB와 Tmax 커넥터는 자신에게 종속하는 스레드 풀에서 처리되었다.

본 절에서는 WebContainer, VirtualHost, Context의 레벨의 스레드 풀 생성, 소멸 시점과 역할을 설명한다.

Web-Connection 레벨의 스레드 풀은 웹 엔진이 기동될 때 설정된 Web-Connection을 생성하거나 동적으로 Web-Connection을 추가할 때 생성되며, 조건에 맞는 Context와 VirtualHost의 스레드 풀이 없을 때 디폴트로 요청을 처리하는 스레드 풀이다. Web-Connection이 제거될 때 같이 스레드 풀도 소멸된다.

VirtualHost 레벨의 스레드 풀은 웹 엔진이 기동될 때 설정된 VirtualHost를 생성하거나 동적으로 VirtualHost를 추가할 때, 스레드 풀에 대한 설정이 존재하면 각 VirtualHost마다 스레드 풀을 생성한다. 참고로, System application을 위한 System Host와, 디폴트로 설정되는 Default Host는 스레드 풀을 생성하지 않는다. VirtualHost를 제거할 때 해당하는 스레드 풀이 소멸된다.

Context 레벨의 스레드 풀은 application이 deploy될 때 스레드 풀에 대한 설정이 존재하면 스레드 풀을 생성한다. Context 레벨의 스레드 풀은 다른 레벨의 스레드 풀과 달리 하나 이상의 스레드 풀을 설정할 수 있다. Context 레벨의 스레드 풀은 하나의 base 스레드 풀과 하나 이상의 Service Group 스레드 풀을 설정할 수 있다. Service Group 스레드 풀은 특정 uri로 온 요청들을 처리하기 위해 하나 이상의 uri를 ','로 구분하여 uri들을 설정할 수 있으며, 요청이 많이 들어올 리소스를 효율적으로 처리할 수 있도록 도와준다. uri에 매칭되는 Service Group 스레드 풀이 없을 경우에 base 스레드 풀이 설정되어 있다면, Service Group에 설정된 uri를 제외한 모든 요청들은 base 스레드 풀로 처리된다. 만약 base 스레드 풀도 설정되어 있지 않다면, VirtualHost 또는 디폴트인 Web-Connection 레벨의 스레드 풀로 요청을 처리한다. application이 undeploy될 때 생성된 모든 스레드 풀이 소멸된다.

본 절에서는 각 레벨의 스레드 풀 설정 방법을 설명한다.

Web-Connection 레벨의 스레드 풀은 domain.xml에 정의되어야 한다. 만약 설정하지 않는다면, JEUS 기동에 실패하게 된다.

<web-connections>
    <http-listener>
        <thread-pool>
            <min>10</min>
            <max>40</max>
            <max-idle-time>300000</max-idle-time>
            <max-queue>30</max-queue>
        </thread-pool>
    </http-listener>
</web-connections>

위의 예제에 나온 것 같이 Web-Connection 레벨의 스레드 풀은 <Web-Connections> 하위에 설정된 각 리스너 혹은 커넥터마다 하나의 스레드 풀을 설정할 수 있다. 선택된 Context와 VirtualHost 레벨의 스레드 풀이 없을 경우에 요청을 처리한다.

또한, webadmin 혹은 jeusadmin에서 동적으로 추가할 때도 스레드 풀을 필수적으로 설정해야 하며, 자세한 것은 [ajp-listener 추가]를 참고한다.

VirtualHost 레벨의 스레드 풀은 domain.xml에 정의되어야 한다. 선택적으로 설정할 수 있으며, 설정하지 않을 경우에는 Web-Connection 레벨의 스레드 풀에서 처리된다.

<web-engine>
    <virtual-host>
        <virtual-host-name>testHost</virtual-host-name>
        <host-name>192.1.1.1</host-name>
        <thread-pool>
            <min>10</min>
            <max>20</max>
            <max-idle-time>300000</max-idle-time>
            <max-queue>30</max-queue>
        </thread-pool>
    </virtual-host>
</web-engin>

위의 예제에 나온 것 같이 VirtualHost 레벨의 스레드 풀은 <virtual-host> 하위에 하나의 스레드 풀을 설정할 수 있다. 선택된 Context 레벨의 스레드 풀이 없을 경우에 요청을 처리하고, VirtualHost 레벨의 스레드 풀을 설정하지 않으면 Web-Connection 레벨의 스레드 풀로 넘긴다.

또한, webadmin 혹은 jeusadmin에서 동적으로 추가할 때도 스레드 풀을 설정할 수 있으며, 자세한 것은 [virtual-host 추가]를 참고한다.

Context 레벨의 스레드 풀은 jeus-web-dd.xml에 정의되어야 한다. 선택적으로 설정할 수 있으며, 설정하지 않을 경우에는 VirtualHost 레벨의 스레드 풀에서 처리된다.

<jeus-web-dd>
    <thread-pool>
        <base>
            <name>baseThreadPool</name>
            <min>30</min>
            <max>50</max>
            <max-idle-time>300000</max-idle-time>
            <max-queue>30</max-queue>
        </base>
        <service-group>
            <name>service1</name>
            <uri>/index.html,/index.jsp</uri>
            <min>10</min>
            <max>20</max>
            <max-idle-time>300000</max-idle-time>
            <max-queue>30</max-queue>
        </service-group>
        <service-group>
            <name>service2</name>
            <uri>/mostRequestedResource</uri>
            <min>10</min>
            <max>20</max>
            <max-idle-time>300000</max-idle-time>
            <max-queue>30</max-queue>
        </service-group>
    </thread-pool>
</jeus-web-dd>

위의 예제에 나온 것 같이 Context 레벨의 스레드 풀은 <jeus-web-dd> 하위에 하나의 base 스레드 풀과 하나 이상의 service-group 스레드 풀을 설정할 수 있다. 다수의 Context 스레드 풀을 구분하기 위해서 unique한 name을 지정해주어야 한다. 요청된 uri가 service-group에 설정된 uri와 매칭된다면 해당 service-group의 스레드 풀로 요청을 처리하고, 없을 경우에는 base 스레드 풀로 처리한다. base 스레드 풀이 설정되지 않았다면, VirtualHost 레벨의 스레드 풀로 넘긴다.

또한, jeusadmin에서 deploy할 때에도 단 하나의 Context 스레드 풀을 추가적으로 넣어줄 수가 있다. 자세한 것은 “JEUS Reference 안내서”의 “4.2.6.4. deploy-application”를 참고한다.

Thread 상태 통보는 이메일 통지나 서버 재시작 권고를 위해 필요한 최소의 Worker Thread 수와 관련된 오류 조건을 정의한다.

다음은 WebAdmin에서 Thread 상태 통보를 설정하는 과정에 대한 설명이다. 설정이 완료되면 Thread Pool의 Thread 상태 변경에 대한 통보 설정을 통해 원하는 통보를 받을 수 있다.

스레드 풀을 구성할 때 적용되는 규칙은 다음과 같다.