제19장 노드매니저의 jeusnm.xml

여기에서 JEUS 서버의 상태를 관리해주는 노드매니저 jeusnm.xml에서 사용되는 설정을 찾을 수 있다.

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

19.2. XML Schema/XML 트리

19.3. Element Reference

(1) <nodeManager>
Value Type nodeManagerType
Child Elements

(3) useNodeManager

(4) host

(5) port

(6) serverMonitoringPeriod

(7) serverAutoRestart

(8) serverRestartTryCount

(9) serverRestartDurationTime

(10) serverRetryRestart

(11) useSSLListener

(12) keystoreFile

(13) keystorePass

(14) truststoreFile

(15) truststorePass

(16) logFileName

(17) standbyPort

(18) processList

(2) < nodeManager > <useNodeManager>
Description 노드매니저의 사용여부를 설정한다.
Value Type boolean
Default Value true

(3) < nodeManager > <host>
Description 노드매니저가 동작하고 있는 host를 설정한다.
Value Type string
Default Value localhost

(4) < nodeManager > <port>
Description 노드매니저가 동작하고 있는 port를 설정한다.
Value Type positiveInteger
Default Value 7730

(5) < nodeManager > <serverMonitoringPeriod>
Description 서버의 상태를 체크할 때의 주기를 설정한다.
Value Type unsignedLong
Default Value 500

(6) < nodeManager > <serverAutoRestart>
Description 서버가 이상종료되었을 시에, 서버를 재시작할지 여부를 설정한다.
Value Type boolean
Default Value true

(7) < nodeManager > <serverRestartTryCount>
Description 서버의 재시작 시도 횟수를 설정한다.
Value Type positiveInteger
Default Value 5

(8) < nodeManager > <serverRestartDurationTime>
Description 서버의 재시작시에 대기할 시간을 설정한다. 이 시간을 기다린 후에 노드매니저가 서버로의 통신을 시도한다.
Value Type unsignedLong
Default Value 120000

(9) < nodeManager > <serverRetryRestart>
Description 서버의 재시작에 실패했을 경우에, 다시 재시작 시도할지를 설정한다.
Value Type boolean
Default Value false

(10) < nodeManager > <useSSLListener>
Description SSL 소켓 통신을 사용할지를 설정한다.
Value Type boolean
Default Value false

(11) < nodeManager > <keystoreFile>
Description SSL 통신을 사용할 시에, keystore 파일의 위치를 설정한다.
Value Type string

(12) < nodeManager > <keystorePass>
Description SSL 통신을 사용할 시에, keystore의 password를 설정한다.
Value Type string

(13) < nodeManager > <truststoreFile>
Description SSL 통신을 사용할 시에, truststore 파일의 위치를 설정한다.
Value Type string

(14) < nodeManager > <truststorePass>
Description SSL 통신을 사용할 시에, truststore의 password를 설정한다.
Value Type string

(15) < nodeManager > <logFileName>
Description 노드 매니져의 로그 파일 이름(경로 포함 가능)을 설정한다. 기본 값으로는 노드 매니저 홈의 logs/JeusNodeManager.log가 된다.
Value Type string

(16) < nodeManager > <standbyPort>
Description 노드 매니져의 standby 프로세스의 연결 포트를 설정한다. standby 프로세스는 노드 매니져의 에러 발생시에 노드 매니져를 대체하여 구동하도록 대기하고 있는 프로세스이다. 포트를 설정하지 않으면 사용하지 않는것으로 간주한다.
Value Type positiveInteger

(17) < nodeManager > <processList>
Description 노드 매니져가 관리할 프로세스들을 설정한다.
Value Type processType
Child Elements

(19) rqs

(18) < nodeManager >< processList > <rqs>
Description 노드 매니져가 관리할 RQS 프로세스에 대한 정보를 설정한다.
Value Type rqsType
Child Elements

(20) domainName

(21) processName

(22) path

(23) port

(24) option

(25) rqsdir

(26) retryCount

(27) monitoringPeriod

(19) < nodeManager >< processList >< rqs > <domainName>
Description ᅟRQS의 도메인 이름을 설정한다.
Value Type string

(20) < nodeManager >< processList >< rqs > <processName>
Description RQS의 이름을 설정한다.
Value Type string

(21) < nodeManager >< processList >< rqs > <path>
Description RQS의 실행 파일을 지정한다.
Value Type string

(22) < nodeManager >< processList >< rqs > <port>
Description RQS의 상태를 체크할 때에 사용할 포트를 설정한다.
Value Type positiveInteger

(23) < nodeManager >< processList >< rqs > <option>
Description RQS 실행시에 필요한 argument를 설정할 수 있다.
Value Type string
Default Value  

(24) < nodeManager >< processList >< rqs > <rqsdir>
Description RQS의 시작에 필요한 RQSDIR을 설정해줄 수 있다.
Value Type string
Default Value  

(25) < nodeManager >< processList >< rqs > <retryCount>
Description RQS의 상태 체크에 실패하였을 경우, 재상태 체크 횟수를 설정한다.
Value Type positiveInteger
Default Value 5

(26) < nodeManager >< processList >< rqs > <monitoringPeriod>
Description RQS의 상태를 체크할 때에 몇 millisecond 단위로 체크할 지를 설정한다.
Value Type unsignedLong
Default Value 500

19.4. jeusnm.xml 파일 예제

[예 19.1] jeusnm.xml 파일 예제

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<nodeManager xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <useNodeManager>true</useNodeManager>
    <host>localhost</host>
    <port>7730</port>
    <serverMonitoringPeriod>500</serverMonitoringPeriod>
    <serverAutoRestart>true</serverAutoRestart>
    <serverRestartTryCount>5</serverRestartTryCount>
    <serverRestartDurationTime>120000</serverRestartDurationTime>
    <serverRetryRestart>false</serverRetryRestart>
    <useSSLListener>false</useSSLListener>
    <processList>
    </processList>
</nodeManager>