웹 컨테이너의 하위 모듈들과 기능들은 다음과 같다.

위에서 열거된 목록은 JEUS 웹 컨테이너의 최상위 뷰를 표현하고 있다. 이들은 웹 컨테이너의 주요 하위 모듈인 Context Group과 Context가 사용할 수 있는 모듈들과 서비스들을 의미한다.

다음은 JEUS 웹 컨테이너를 다룰 때 가장 많이 사용되는 디렉터리들이다.

[그림 2.2] JEUS 웹 컨테이너 관련 디렉터리

로그는 웹 컨테이너를 통해 직접적으로 생성되지 않고 Context Group 레벨에서 설정하고 생성된다. 자세한 내용은 “제3장 Context Group”을 참고한다.

웹 컨테이너 설정하기 위해서는 기본 설정 파일인 JEUSMain.xml과 WEBMain.xml이 필요하다.

WEBMain.xml은 JEUSMain.xml에 추가된 JEUS 웹 컨테이너를 설정하는 파일로 웹 컨테이너의 설정 디렉터리에 해당 파일이 존재해야한다. WEBMain.xml의 수정은 XML 파일을 직접 편집하거나 WebAdmin을 사용하여 설정을 할 수 있다.

WEBMain.xml 파일에는 웹 컨테이너 설정의 여러 부분을 대표하는 태그들이 존재한다. 각 태그들을 다음 하위 절에서 설명한다. Context Group과 Session 설정의 일부는 본 절에서 간략히 설명하고 좀 더 자세한 내용은 별도의 장의 내용을 참고한다.

다음은 웹 컨테이너의 기본 설정 파일인 JEUSMain.xml의 예이다.

<?xml version="1.0"?>
<jeus-system xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    . . .
    <node>
        . . .
        <engine-container>
            . . .
            <engine-command>
                <type>servlet</type>
                <name>engine1</name>
            </engine-command>
            . . .
        </engine-container>
        . . .
    </node>
    . . .
</jeus-system>

<engine-command> 태그가 JEUS 기동(Booting) 과정에 사용되기 위해서는 다음 디렉터리가 존재해야 한다. 해당 디렉터리 아래에는 반드시 WEBMain.xml이라는 파일이 존재해야 한다.

JEUS_HOME\config\<node-name>\<node-name>_servlet_<engine-name>

다음은 디렉터리명을 설정하는 항목에 대한 설명이다.

웹 컨테이너 자체 감시의 가장 중요한 부분은 자동 모니터링을 이용하는 것이다. 자동 모니터링은 웹 컨테이너의 자동 관찰 시스템이다. 이 기능은 컨테이너 내의 모든 자원과 Pool들의 상태를 감시하고 문제가 발생하였을 때 대응할 수 있는 기능을 한다.

자동 모니터링에는 다음이 3가지가 존재한다.

관리자는 모니터링을 하기 위해서 상태를 파악하기 위한 시간 간격을 설정해야 한다. 모니터링 Thread가 사용하는 시간 주기를 WEBMain.xml의 <monitoring> 태그와 그 하위 태그에 설정한다. 자세한 내용은 JEUS_HOME\docs\reference\schema\index.html에서 WEBMain.xml XML Reference를 참조한다.

다음은 자동 모니터링을 설정한 XML 예제이다.

<?xml version="1.0"?>
<web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <monitoring>
        <check-thread-pool>60000</check-thread-pool>
        <check-class-reload>60000</check-class-reload>
        <check-session>60000</check-session>
    </monitoring>
    . . .
</web-container>

문제가 발생한 경우 각 모니터링 Thread의 하위 컴포넌트에 해당하는 XML 설정 부분에서 따로 설정한다.

웹 컨테이너는 자체적으로 WEBMain.xml에는 2개의 태그들이 stdout과 stderr Redirection을 위해 설정되고 다음 디렉터리에 로그를 남기는 기능을 제공하고 있다. 그러나 이 기능은 JEUS 시스템 로거에 의해 같은 기능이 포함되어 있으므로 앞으로 이 기능은 설정하지 않도록 한다. 자세한 사항은 “JEUS Server 안내서”의 “11.3.3. 표준 출력과 표준 에러를 로그 형식으로 출력 설정”을 참고한다.

각 웹 컨테이너는 하나 이상의 Context Group을 포함할 수 있다.

Context Group은 개별적인 작은 웹 컨테이너로 Group은 여러 개의 리스너, 가상 호스트, Context를 관리한다. Context는 컨테이너에서 수행되는 실제 웹 애플리케이션과 같은 개념이다. Context Group은 그 안에 포함된 모든 Context와 가상 호스트에 공통적으로 적용되는 설정과 서비스들을 가지고 있다.

Context Group의 또 한 가지 중요한 기능은 웹 서버 연결과 클러스터 환경에서의 Session Handling과 Active Management이다.

Context Group은 여러 개의 웹 애플리케이션 또는 가상 호스트를 관리하는 컨테이너이다. 각 웹 컨테이너에는 하나 이상의 Context Group이 존재할 수 있고, WEBMain.xml의 최상위 태그인 <context-group>을 이용하여 설정된다.

<?xml version="1.0"?>
<web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <monitoring>
        . . .
    </monitoring>
    . . .
    <context-group>
        . . .    <!-- See chapter “제3장 Context Group” -->
    </context-group>
    <context-group>
        . . .
    </context-group>
        . . .
</web-container>

웹 컨테이너 레벨에서 정의된 설정들은 모든 Context Group과 웹 컨테이너의 하위 Context에 글로벌하게 적용된다.

JEUS v5.0 Fix13 이전까지 웹 컨테이너는 독립적인 DB Connection Pool을 사용했다. 그러나 JEUS v5.0 Fix#13 이후 버전에서는 javax.sql.DataSource를 사용하도록 변경되었다. 그래서 JEUSMain.xml에 DB Connection Pool을 등록하고 JNDI lookup을 이용해서 Datasource를 얻은 다음 DB Connection을 얻어야 한다.

웹 컨테이너의 Session을 관리하기 위한 여러 가지를 설정한다.

Session 클러스터링의 참여 여부, Session 객체의 공유 여부, Session Cookie 설정, Timeout 등 웹 컨테이너의 Session과 관련된 모든 설정을 할 수 있다. 추가적으로 클러스터링된 환경에서의 Session에 대한 사항은 “제5장 Session Tracking”에서 설명한다.

웹 컨테이너의 Session과 관련된 여러 가지 설정을 할 수 있다. Session 설정은 웹 컨테이너 외에도 다음의 여러 레벨에서 설정이 가능하다.

Web Container 레벨에서 Session 설정이 되어 있다면 하위 Context Group 또는 jeus-web-dd에 Session 설정하지 않았을 경우 공통적으로 웹 컨테이너의 Session 설정 부분이 적용된다.

다음은 Web Container 레벨의 Session 설정의 예이다. Session 설정은 <web-contianer> 하위 <session-config>에 설정한다.

<?xml version="1.0"?>
<web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    . . .
    <session-config>
        <distributable>false</distributable>
        <shared>false</shared>
        <timeout>30</timeout>
        <reload-persistent>false</reload-persistent>
        <url-rewriting>false</url-rewriting>
        <session-cookie>
            <jsessionid-name>JSESSIONID</jsessionid-name>
            <version>0</version>
            <path>/</path>
            <max-age>-1</max-age>
            <secure>false</secure>
            <http-only>true</http-only>
        </session-cookie>
    </session-config>
    . . .
</web-container>

다음은 설정 태그에 대한 설명이다.

웹 컨테이너에서 생성되는 로그 메시지는 System log, User log, Access log 3가지이다.

System log는 JEUSMain.xml에서 <system-logging>을 통해 설정한다. User log 및 Access log는 WEBMain.xml의 <logging>을 통해 설정한다. Logging 설정은 웹 컨테이너 전체 또는 하위 Context Group별로 따로 설정할 수 있다. Logging 설정에 대한 자세한 내용은 “2.4. Logging 설정”에서 설명한다.

Shutdown Timeout 기능은 관리자가 down 명령을 내렸을 때 웹 컨테이너가 실제로 종료되기까지 웹 컨테이너가 기다리는 시간을 지정한다. 이 설정은 관리자가 웹 컨테이너는 Worker Thread들이 작업을 모두 마치기까지 기다리도록 한다.

down 명령을 수행했을 때 어떤 Worker Thread도 실행되고 있지 않으면 컨테이너는 이 설정을 무시하고 바로 종료를 수행한다.

다음은 Shutdown Timeout 설정에 대한 예로 <web-container> 태그에 <shutdown-timeout> 하위에 구성한다.

<?xml version="1.0"?>
<web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    . . .
    <shutdown-timeout>10000</shutdown-timeout>
</web-container>

만약 HTTP 클라이언트가 다음과 같은 요청을 보냈다고 하자.

GET /examples/%2e%2e%2fdb.txt HTTP/1.1

이 경우 웹 컨테이너는 먼저 요청 URI를 URL decode해야 한다.

/examples/../db.txt

이렇게 되면 실제 HTTP 서비스와는 관련없는 파일들을 접근할 수 있게 된다. 주로 악의적인 목적을 가진 클라이언트가 이런 식으로 요청 URI을 보낸다.

웹 컨테이너에서 모든 악의적인 요청 패턴을 파악할 수 없으므로 사용자가 직접 악의적인 패턴을 막을 수 있도록 설정을 제공한다. HTTP 요청인 경우에만 동작하며, Query String을 제외한 URI에 대해 특정 문자열을 매칭해서 무조건 404 Not Found로 처리한다.

프로퍼티 파일에 다음의 형식으로 설정한다.

#URL-encoded patterns
encodedUrl1=%2f
encodedUrl2=%2e
encodedUrl3=%5c
encodedUrl4=test
 
#URL-decoded patterns
decodedUrl1=\
decodedUrl2=#
decodedUrl3=::$
decodedUrl4=test

URL-encoded 패턴은 HTTP 클라이언트가 보낸 URI에 대해 설정된 문자열을 포함하는지 체크하는 것이고, 해당 URI를 웹 컨테이너가 URL decode한 다음에 URL-decoded 패턴이 decode한 URI에 포함되어 있는지 매칭해 본다.

위 프로퍼티 파일의 절대 경로를 jeus.servlet.url-blocking-properties 옵션으로 지정한다.

-Djeus.servlet.url-blocking-properties=/jeus/blockedUrlPatterns.properties

본 절에서는 Access log과 User log 설정 항목 중 공통으로 적용되는 설정 정보에 대해서 설명한다.

설정 정보는 <context-group> 태그 아래 <logging>에 구성한다. <access-log>와 <user-log>는 <logging> 설정의 하위 요소이며 <context-group> 단위로 설정이 가능하다.

<logging> 설정은 다음의 예제와 같이 <web-container> 또는 <context-group>의 하위 요소로 존재한다. <web-container> 설정의 하위 요소로 <logging>을 설정하면 <web-container> 내의 모든 <context-group>에 공통으로 적용된다. <context-group>의 하위 요소로 설정된 <logging>은 해당 <context-group>에만 적용되며 <web-container>의 <logging> 설정보다 우선한다.

다음은 웹 컨테이너 Logging 설정에 대한 예이다.

<?xml version="1.0"?>
<web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <context-group>
    . . .
        <logging>
            <user-log>
                <level>FINE</level>
                <use-parent-handlers>
                    true
                </use-parent-handlers>
                <handler>
                    <smtp-handler>
                        <name>smtpHandler</name>
                        <level>SEVERE</level>
                        <smtp-host-address>
                            mail.com
                        </smtp-host-address>
                        <from-address>
                            jeus@mail.com
                        </from-address>
                        <to-address>
                            admin@mail.com
                        </to-address>
                        <send-for-all-messages>
                            false
                        </send-for-all-messages>
                    </smtp-handler>
                </handler>
            </user-log>
            <access-log>
                <enable>true</enable>
                <format>
                    [%{yyyy.MM.dd HH:mm:ss}t] %a %m %U%q" %s %Dms 
                </format>
                <handler>
                    <file-handler>
                        <name>fileHandler</name>
                        <valid-hour>1</valid-hour>
                    </file-handler>
                </handler>
            </access-log>
        </logging>
    </context-group>
    . . .
</web-container>

다음은 <access-log>, <user-log>에 공통으로 설정하는 항목에 대한 설명이다.

다음은 Access log에만 사용되는 설정에 대한 설명이다.

<access-log>의 <format> 설정

<access-log>의 하위 요소인 <format>을 사용하여 사용자 정의 Access log format을 지정하는 것이 가능하다. <format>에 넣을 값은 임의의 String 값이 가능하다. 단, “%” 기호는 특수 기호로 인식된다. 즉, “%”를 접두사로 사용하는 다음에 열거하는 단어들은 runtime에 여러 가지 request/response property로 대체되어 Access log에 남게 된다.

Access log 필터 설정

사용자의 특별한 설정이 없을 경우 다음과 같은 기본 형식의 모든 Access log를 기록한다.

[2010.06.22 14:42:57] 127.0.0.1 "GET /examples/images/bluebtn.gif" 404 0ms

하지만 보통 Access log의 양은 상당히 많기 때문에 특정 형식 또는 조건을 만족하는 로그만 Access log로 기록하고 싶을 경우가 때때로 존재한다. 이를 위해 제공되는 기능이 Access log 필터 기능이다.

Access log 필터 기능 지원을 위해 JEUS에서는 jeus.util.AccessLoggerFilter 인터페이스 및 jeus.util.AbstractAccessLoggerFilter 추상 클래스를 제공하고 있다.

다음은 jeus.servlet.util.AccessLoggerFilter 인터페이스의 상세 내용이다.

package jeus.servlet.util;

import java.util.logging.Filter;
import java.util.logging.LogRecord;

/**
 * Access Logger의 내용을 필터링 하기위해 필요한 정보들을 제공하는 인터페이스.
 * {@link Filter}를 상속한 필터 인터페이스로서 부수적으로 제공되는 인터페이스를 통해
 * {@link Filter#isLoggable(java.util.logging.LogRecord)}안에서 다양하게 필터링 정책을 정하도록 가이드 한다.
 */
public interface AccessLoggerFilter extends Filter {
    /**
     * 서버에 접속한 remote client의 address 정보를 반환한다.
     *
     * @param record a LogRecord
     * @return remote client의 address. 만약 올바른 값을 얻지 못할 경우 null을 반환한다.
     */
    public String getRemoteAddr( LogRecord record );

    /**
     * 요청의 메소드를 반환한다. ex) GET, POST, PUT, etc...
     *
     * @param record a LogRecord
     * @return request method. 만약 올바른 값을 얻지 못할 경우 null을 반환한다.
     */
    public String getMethod( LogRecord record );

    /**
     * 요청의 uri를 반환한다.
     *
     * @param record a LogRecord
     * @return request uri. 만약 올바른 값을 얻지 못할 경우 null을 반환한다.
     */
    public String getRequestURI( LogRecord record );

    /**
     * 응답의 status값을 반환한다. ex) 200, 404
     *
     * @param record a LogRecord
     * @return status.
     */
    public int getStatus( LogRecord record );

    /**
     * 요청에 따른 처리시간을 ms단위로 반환한다.
     * @param record a LogRecord
     * @return processing time. 만약 올바른 값을 얻지 못할 경우 -1을 반환한다.
     */
    public long getProcessingTimeMillis( LogRecord record );
}          

사용자가 Access log의 특정 패턴에 대해 필터링하는 경우 위의 AccessLoggerFilter 인터페이스 및 AbstractAccessLoggerFilter 추상 클래스를 이용하여 쉽게 필터를 구현해서 적용할 수 있다.

사용자의 필터 클래스는 jeus.servlet.util.AbstractAccessLoggerFilter를 상속하고, java.util.logging.Filter의 isLoggable() 메소드를 구현해야 한다. isLoggable() 메소드를 구현할 때 위의 jeus.servlet.util.AccessLoggerFilter의 API 중에서 사용자가 필요한 정보를 적절히 선택하여 이용 및 구현한다.

다음은 요청 확장자가 gif인 경우에만 해당 요청을 Access log로 기록하는 사용자 필터 클래스를 정의한 예이다.

package sample;

import jeus.servlet.util.AbstractAccessLoggerFilter;
import java.util.logging.*;

 public class SimpleAccessLoggerFilter extends AbstractAccessLoggerFilter {
     public boolean isLoggable( LogRecord record ) {
         // get the request uri
         String requestURI = getRequestURI(record );

         // allow only "gif" extension
         return requestURI != null && requestURI.endsWith( "gif" );
     }
 }          

다음은 WEBMain.xml의 <access-log> 설정에 해당 필터를 등록하는 예이다.

<?xml version="1.0"?>
<web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <context-group>
    . . .
        <logging>
            . . .
            <access-log>
                <enable>true</enable>
                . . .                
                <filter-class>
                    sample.SimpleAccessLoggerFilter
                </filter-class>                
                <handler>
                    <file-handler>
                        <name>fileHandler</name>
                        <valid-hour>1</valid-hour>
                    </file-handler>
                </handler>
            </access-log>
        </logging>
    </context-group>
    . . .
</web-container>

User log에만 해당하는 별도의 하위 요소는 없다. User log는 다음에 별도로 설명할 Context DD에서 설정하여 특정 Context 단독으로 사용하는 것이 가능하다. 그러한 경우에는 Context DD 내의 <user-log> 설정이 우선순위를 갖는다.

웹 컨테이너를 제어한다는 것은 웹 컨테이너의 시작과 종료를 제어한다는 의미와 같다. 이 2가지 작업은 WebAdmin과 콘솔 툴(jeusadmin)을 사용해서 제어한다.

본 절에서는 웹 컨테이너에 대한 정보만 포함하며 Context Group과 Context(Web application)에 대해서는 언급하지 않는다.

콘솔 툴(jeusadmin)을 이용한 웹 컨테이너 제어

다음은 jeusadmin을 이용해서 웹 컨테이너 제어하는 예이다. 'johan_servlet_engine1'라는 웹 컨테이너가 JEUSMain.xml과 WEBMain.xml에 설정되어 있다고 가정한다.

위의 예에서는 웹 컨테이너에 관련된 명령을 몇 가지 알아보았다. 자세한 내용은 "JEUS Server 안내서"를 참고한다.

WebAdmin을 이용한 웹 컨테이너 제어

WebAdmin을 이용한 웹 컨테이너 제어에 대한 자세한 설명은 "JEUS WebAdmin 안내서"의 Servlet Engine 제어 부분을 참고한다.

모니터링은 특정 웹 컨테이너의 수행하는 경우 데이터와 상황 정보를 수집하는 것을 의미한다.

콘솔 툴(jeusadmin)을 통한 웹 컨테이너 모니터링

jeusadmin에서는 웹 컨테이너에 대한 기초 정보를 얻을 수 있는 기능을 제공한다. 자세한 내용은 "JEUS Server 안내서"와 “JEUS Reference Book”의 “4.2.5. 서블릿 엔진 관련 명령어”를 참고한다.

WebAdmin을 통한 웹 컨테이너 모니터링

WebAdmin을 통하여 웹 컨테이너를 모니터링할 수 있다. WebAdmin의 엔진 컨테이너 통계 부분과 Session 서버 통계 부분을 이용한다.