제26장 JEUS Configuration plan 설정

내용 목차

26.1. 소개
26.2. XML Schema/XML 트리
26.3. Element Reference
26.4. JEUS Configuration plan 파일 예제

여기에서 JEUS Configuration plan의 태그에 대한 설명을 찾을 수 있다.

레퍼런스는 다음 형식으로 구성되어 있다.

  1. XML Schema/XML 트리: XML 설정 파일의 모든 태그 리스트를 정리했다. 각 노드의 형식은 다음과 같다.

    1. 태그 레퍼런스로 빨리 찾아보기 위해서 각 태그마다 인덱스 번호( 예: (11) )를 붙여 놓았다. 태그 레퍼런스에서는 이 번호 순서로 설명한다.

    2. XML Schema에서 정의한 XML 태그명을 <tag name> 형식으로 표시한다.

    3. XML Schema에서 정의한 Cardinality를 표시한다. “?” = 0개나 1개의 element, “+” = 1개 이상의 element, “*” = 0개 이상의 element, (기호가 없음) = 정확히 1개의 element

    4. 몇몇 태그에는 “P” 문자를 붙여 놓았는데, 해당 태그는 성능에 관계되는 태그라는 것을 뜻한다. 이 태그는 설정을 튜닝할 때 사용된다.

  2. Element Reference: 트리에 있는 각 XML 태그를 설명한다.

    1. Dynamic: 동적 설정 반영 가능

    2. Non-Dynamic: 동적 설정 반영 불가능, Dynamic이 설정되지 않은 항목들이 보통 이에 해당 하나 특별히 설명이 있는 경우 이 항목이 표시된다.

    3. Description: 태그에 대한 간단한 설명.

    4. Value Description: 입력하는 값과 타입.

    5. Value Type: 값의 데이터 타입. (예: String)

    6. Value Type Description: 값의 데이터 타입에 대한 설명

    7. Default Value: 해당 XML을 사용하지 않았을 때 기본적으로 사용되는 값.

    8. Defined Value: 이미 정해져 있는 값.

    9. Example: 해당 XML 태그에 대한 예.

    10. Performance Recommendation: 성능 향상을 위해서 추천하는 값.

    11. Child Elements: 자신의 태그 안에 사용하는 태그.

(1) <jeus-configuration-plan>
Description JEUS configuration plan 설정을 정의한다.
Value Type jeus-configuration-planType
Child Elements

(3) configurations

(2) < jeus-configuration-plan > <configurations>
Description 복수의 configuration 설정을 정의한다.
Value Type configurationsType
Child Elements

(4) configuration

(3) < jeus-configuration-plan >< configurations > <configuration>
Description JEUS plan을 통하여 적용할 하나의 설정 단위를 정의한다.
Value Type configurationType
Child Elements

(5) action

(6) xpath

(7) value

(4) < jeus-configuration-plan >< configurations >< configuration > <action>
Description 적용할 설정의 action type을 지정한다.
Value Type actionType
Defined Value

DELETE

REPLACE

APPEND_CHILD

INSERT_BEFORE

(5) < jeus-configuration-plan >< configurations >< configuration > <xpath>
Description 설정을 적용할 XML 문서 상의 target element의 xpath를 명시한다.
Value Type token

(6) < jeus-configuration-plan >< configurations >< configuration > <value>
Description REPLACE, APPEND_CHILD, INSERT_BEFORE action 수행시 필요한 입력값을 정의한다. CDATA section으로 입력할 XML fragment를 적는다.
Value Type token

[예 26.1] JEUS Configuration plan 파일 예제

<?xml version="1.0" encoding="UTF-8"?>
<jeus-configuration-plan xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <configurations>
        <!-- Replace <name> tag of domain admin server -->
        <configuration>
            <action>REPLACE</action>
            <xpath>/domain/servers/server/name[.='adminServer']</xpath>
            <value>
                <![CDATA[<name>das</name>]]>
            </value>
        </configuration>
        <!-- For all servers, remove <listener> tag of which name is "http-listener" -->
        <configuration>
            <action>DELETE</action>
            <xpath>/domain/servers/server/listeners/listener/name[.='http-listener']/..</xpath>
        </configuration>
        <!-- Append <jvm-option> tag to server of which name is "das" -->
        <configuration>
            <action>APPEND_CHILD</action>
            <xpath>/domain/servers/server/name[.='das']/../jvm-config</xpath>
            <value>
                <![CDATA[<jvm-option>-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005</jvm-option>]]>
            </value>
        </configuration>
        <!-- Insert <database> tag before another <database> tag of which data source ID is "ds1" -->
        <configuration>
            <action>INSERT_BEFORE</action>
            <xpath>/domain/resources/data-source/database/data-source-id[.='ds1']/..</xpath>
            <value>
                <![CDATA[
                <database>
                    <data-source-id>ds0</data-source-id>
                    <data-source-class-name>org.apache.derby.jdbc.ClientConnectionPoolDataSource</data-source-class-name>
                    <data-source-type>ConnectionPoolDataSource</data-source-type>
                    <server-name>localhost</server-name>
                    <port-number>1527</port-number>
                    <database-name>DB1</database-name>
                    <user>app</user>
                    <password>app</password>
                    <property>
                        <name>ConnectionAttributes</name>
                        <type>java.lang.String</type>
                        <value>;create=true</value>
                    </property>
                </database>
                ]]>
            </value>
        </configuration>
    </configurations>
</jeus-configuration-plan>