제4장 domain.xml의 JMX Manager 설정

제4장 domain.xml의 JMX Manager 설정

여기에서 JEUS 도메인의 메인 설정 파일인 domain.xml에서 JMX Manager에 관련된 태그에 대한 설명을 찾을 수 있다.

XML Schema 파일: JEUS_HOME/lib/schemas/jeus/jeus-domain.xsd

4.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” 문자를 붙여 놓았는데, 해당 태그는 성능에 관계되는 태그라는 것을 뜻한다. 이 태그는 설정을 튜닝할 때 사용된다.
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: 자신의 태그 안에 사용하는 태그.

4.2. XML Schema/XML 트리

(930) <jmx-manager>?
- (931) <use-rmi-connector>?
- (932) <use-html-adaptor>?
- (933) <html-adaptor-port>?
- (934) <snmp-adaptor>?
  - (935) <snmp-adaptor-port>
  - (936) <snmp-version>? P
  - (937) <snmp-max-packet-size>? P
  - (938) <snmp-security>? P
  - (939) <trap-demon>*
    (940) <ip-address>
    (941) <port>
  - (942) <pooling>?
    (943) <min>? P
    (944) <max>? P
    (945) <period>? P
- (946) <mlet-url>*

4.3. Element Reference

(930) `<domain> <servers> <server> <jmx-manager>`
Description	JEUS Manager JVM에서 사용하는 JMX에 대한 설정이다.
Value Type	`jmx-managerType`
Child Elements	(931) `use-rmi-connector?` (932) `use-html-adaptor?` (933) `html-adaptor-port?` (934) `snmp-adaptor?` (946) `mlet-url*`

(931) `<domain> <servers> <server> <jmx-manager> <use-rmi-connector>`
Description	RMI Connector Server를 사용할지 여부를 지정한다.
Value Type	`boolean`

(932) `<domain> <servers> <server> <jmx-manager> <use-html-adaptor>`
Value Type	`boolean`

(933) `<domain> <servers> <server> <jmx-manager> <html-adaptor-port>`
Description	JMX의 어댑터 중 하나인 HTML 어댑터의 포트를 지정한다. 여기에 지정된 값으로 웹 브라우저에 접속한다.
Value Type	`off-intType`
Value Type Description	기본적으로 Non Negative Int 타입이지만 -1인 경우에는 미설정 상태이다. 즉, off된다.

(934) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor>`
Description	JMX의 어댑터 중 하나인 SNMP 어댑터를 설정한다.
Value Type	`snmp-adaptorType`
Child Elements	(935) `snmp-adaptor-port` (936) `snmp-version?` (937) `snmp-max-packet-size?` (938) `snmp-security?` (939) `trap-demon*` (942) `pooling?`

(935) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <snmp-adaptor-port>`
Description	SNMP 어댑터의 Listener 포트를 설정한다.
Value Type	`snmp-adaptor-portType`

(936) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <snmp-version>`
Description	SNMP 버전을 지정하며 1, 2 또는 3을 지정할 수 있다
Value Type	`snmp-versionType`
Default Value	`3`
Defined Value	`1` `2` `3`

(937) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <snmp-max-packet-size>`
Description	SNMP 패킷에 대한 최댓값을 설정하며, 최소 256 Byte부터 설정할 수 있다.
Value Type	`snmp-max-packet-sizeType`
Default Value	`4096`

(938) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <snmp-security>`
Description	보안의 적용 여부를 설정한다. 보안은 SNMP 버전 3에서만 지정이 가능하다.
Value Type	`boolean`
Default Value	`false`

(939) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <trap-demon>`
Description	장애 상황이 발생한 경우에 대해 TRAP 메시지를 보낼 서버를 설정한다. 여러 개 설정이 가능하며 설정된 모든 IP 주소로 메시지를 전송한다.
Value Type	`trap-demonType`
Child Elements	(940) `ip-address` (941) `port`

(940) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <trap-demon> <ip-address>`
Description	Demon의 IP 주소를 설정한다.
Value Description	a valid IP address
Value Type	`token`
Example	`111.111.111.1`

(941) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <trap-demon> <port>`
Description	Demon의 포트 번호를 설정한다.
Value Description	a port number
Value Type	`int`
Example	`8888`

(942) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <pooling>`
Description	SNMP 서버에서 요청을 처리하는 스레드로 구성되어 있다. 아래 항목은 이 스레드를 관리하는 Pool을 설정한다.
Value Type	`poolingType`
Child Elements	(943) `min?` (944) `max?` (945) `period?`

(943) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <pooling> <min>`
Description	Pooling되는 객체의 최솟값을 지정한다.
Value Type	`nonNegativeIntType`
Value Type Description	0 이상의 Int 값이다.
Default Value	`2`

(944) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <pooling> <max>`
Description	Pooling되는 객체의 최댓값을 지정한다.
Value Type	`nonNegativeIntType`
Value Type Description	0 이상의 Int 값이다.
Default Value	`30`

(945) `<domain> <servers> <server> <jmx-manager> <snmp-adaptor> <pooling> <period>`
Description	Pool에 있는 객체의 개수를 min 값에 지정된 개수만큼 줄인다.
Value Type	`long`
Default Value	`3600000`
Performance Recommendation	설정값이 클수록 정리하는 주기가 길어져 서버를 운영할 때 부하가 줄어들 수 있지만 그만큼 메모리 사용량이 늘어날 수 있다.

(946) `<domain> <servers> <server> <jmx-manager> <mlet-url>`
Description	서버의 MBean 서버에 등록할 MLet의 URL을 지정한다.
Value Type	`token`

4.4. domain.xml의 JMX Manager 예제

[예 4.1] domain.xml의 JMX Manager 예제

<?xml version="1.0" encoding="utf-8"?>
<domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <servers>
        <server>
            <!-- JMX Manager configuration for JEUS management/monitoring --> 
            <jmx-manager>
                <!-- RMI Connector -->
                <use-rmi-connector>false</use-rmi-connector>
                <!-- HTML Adaptor -->
                <use-html-adaptor>true</use-html-adaptor>
                <html-adaptor-port>9980</html-adaptor-port>
                <!-- SNMP Adaptor (SNMP Agent) -->
                <snmp-adaptor>
                    <snmp-adaptor-port>9999</snmp-adaptor-port>
                    <snmp-version>3</snmp-version>
                    <snmp-max-packet-size>4096</snmp-max-packet-size>
                    <snmp-security>true</snmp-security>
                    <pooling>
                        <min>5</min>
                        <max>20</max>
                        <period>5</period>
                    </pooling>
                </snmp-adaptor>
            </jmx-manager>
        </server>
    </servers>
</domain>