제18장 nodes.xml 관리할 원격 노드의 설정

여기에서 관리할 원격 노드의 주소, JEUS 설치 디렉터리, SSH 설정을 정의하는 데 사용하는 설정 파일인 nodes.xml의 설명을 찾을 수 있다. 여기서의 노드는 하나의 JEUS 설치본을 의미한다.

18.1. 소개

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

  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: 자신의 태그 안에 사용하는 태그.

18.2. XML Schema/XML 트리

18.3. Element Reference

(1) <nodes>
Description 노드들을 정의한다.
Value Type nodesType
Child Elements

(3) node

(2) < nodes > <node>
Description 노드를 정의한다.
Value Type nodeType
Child Elements

(4) name

(5) host

(6) ssh

(11) java

(3) < nodes >< node > <name>
Description 해당 노드에 대한 유일한 노드 이름을 정의한다.
Value Type token

(4) < nodes >< node > <host>
Description 해당 노드의 호스트 이름을 정의한다.
Value Type token

(5) < nodes >< node > <ssh>
Description 해당 노드의 SSH 설정을 정의한다.
Value Type sshType
Child Elements

(7) install-dir

(8) port

(9) user

(10) private-key-file

(6) < nodes >< node >< ssh > <install-dir>
Description 해당 노드의 JEUS 설치 디렉터리를 정의한다.
Value Type token

(7) < nodes >< node >< ssh > <port>
Description 해당 SSH 노드의 포트 번호를 설정한다. 기본값으로 22번 포트를 사용한다.
Value Type nonNegativeIntType

(8) < nodes >< node >< ssh > <user>
Description 해당 SSH 노드의 인증에 사용될 User의 이름을 설정한다. 기본값으로 System User 이름을 사용한다.
Value Type token

(9) < nodes >< node >< ssh > <private-key-file>
Description 해당 SSH 노드의 인증에 사용될 개인 키 파일을 설정한다. 기본값으로 System User Home 하위의 "/.ssh/id_rsa"를 사용한다.
Value Type token

(10) < nodes >< node > <java>
Description 해당 노드의 Java 타입의 노드매니저 설정을 정의한다.
Value Type javaType
Child Elements

(12) port

(13) use-ssl

(14) truststore-path

(15) truststore-password

(11) < nodes >< node >< java > <port>
Description 노드매니저에서 사용할 port를 설정한다. default는 7730을 사용한다.
Value Type nonNegativeIntType
Default Value 7730

(12) < nodes >< node >< java > <use-ssl>
Description 노드매니저에서 ssl를 사용할 지 여부를 설정한다.
Value Type boolean
Default Value false

(13) < nodes >< node >< java > <truststore-path>
Description 노드매니저에서 ssl를 사용할 때 인증에 사용될 truststore 파일경로를 설정한다.
Value Type token

(14) < nodes >< node >< java > <truststore-password>
Description 노드매니저에서 ssl를 사용할 때 인증에 사용될 truststore 파일의 password를 설정한다.
Value Type token

18.4. nodes.xml 파일 예제

[예 18.1] nodes.xml 파일 예제

<?xml version="1.0"?>
<nodes xmlns="http://www.tmaxsoft.com/xml/ns/jeus"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.tmaxsoft.com/xml/ns/jeus http://www.tmaxsoft.com/xml/ns/jeus/jeus-nodes.xsd"
        version="7.0">
    <node>
        <name>my-node</name>
        <host>111.111.111.111</host>
        <install-dir>/home/remote/jeus</install-dir>
        <ssh>
            <port>22</port>
            <user>remote</user>
            <private-key-file>/home/local/.ssh/id_rsa</private-key-file>
        </ssh>
    </node>
</nodes>