MBean 정보 조회 및 JMX Manager 환경설정
본 장에서는 JEUS에서 사용하고 있는 MBean의 정보를 조회하는 방법 및 JMX Manager의 환경을 설정하는 방법을 설명한다.
1. MBean 정보 조회
콘솔 툴(jeusadmin)을 사용하여 JEUS에서 사용하고 있는 MBean의 정보를 조회할 수 있다.
1.1. 콘솔 툴 사용
콘솔 툴(jeusadmin)을 사용해서 MBean 정보를 조회할 수 있다.
jeusadmin을 통해 JEUS 서버에 접속한 후 mbean-info 명령어를 이용하면 다음과 같이 등록된 MBean 정보를 조회할 수 있다.
[MASTER]domain1.adminServer>mbean-info -server adminServer
The object names of MBeans on the server [adminServer].
================================================================================
+------------------------------------------------------------------------------+
| JEUS:j2eeType=JeusService,jeusType=ThreadPool,JMXManager=adminServer,J2EEServ|
|er=adminServer,name=threadpool.System |
| JEUS:j2eeType=JeusService,jeusType=JMSDestinationResource,JMXManager=adminSer|
|ver,J2EEServer=adminServer,JMSResource=adminServer_jms,name=ExamplesQueue |
| JEUS:j2eeType=JeusService,jeusType=JEUSMPConnector,JMXManager=adminServer,J2E|
|EServer=adminServer,name=adminServer |
. . .
| JEUS:j2eeType=JeusService,jeusType=JNDIResourceService,JMXManager=adminServer|
|,J2EEServer=adminServer,name=adminServer |
| JEUS:j2eeType=JTAResource,JMXManager=adminServer,J2EEServer=adminServer,name=|
|adminServer |
| JEUS:j2eeType=JMSResource,JMXManager=adminServer,J2EEServer=adminServer,name=|
|adminServer_jms |
+------------------------------------------------------------------------------+
================================================================================
2. JMX Manager 환경설정
JMX Remote API 스펙 1.0을 따르는 클라이언트 애플리케이션에게 JEUS JMX는 JEUS의 구성과 실시간 정보를 제공한다. 본 절에서는 JMX Manager를 설정하는 방법에 대해서 설명한다.
JMX Manager 관련 설정은 설정 파일(domain.xml)의 서버 설정 하위에 존재한다. 설정을 위해서는 XML 파일을 직접 편집해야 한다.
다음은 설정 항목에 대한 설명이다.
-
기본 설정
<server> ... <jmx-manager> <use-rmi-connector>true</use-rmi-connector> <use-html-adaptor>true</use-html-adaptor> <html-adaptor-port>8098</html-adaptor-port> <snmp-adaptor> ... </snmp-adaptor> <mlet-url>file:///home/user/mlet/example.mlet</mlet-url> </jmx-manager> ... </server>RMI Connector를 사용할지 여부, HTML Adaptor 사용 여부, HTML Adaptor Port 및 MLet URL 정보를 설정한다.
항목 설명 Use Html Adaptor Port
HTML Adaptor는 HTML을 지원하는 JMX의 Protocol Adapter이다.
HTML Adaptor에 대한 추가적인 사항은 JMX 시작하기 문서의 설명을 참고한다.
Use Rmi Connector
RMI Connector를 사용할지 여부를 설정한다. 이 항목을 체크했을 경우 서버가 기동할 때 RMI Connector server 인스턴스를 생성한다. RMI Connector server에 접속하기 위한 URL은 "service:jmx:rmi://SERVER_ADDRESS:SERVER_BASE_PORT/jndi/SERVER_NAME"과 같은 형태를 갖는다.
Html Adaptor Port
HTML Adapter의 Listener Port로 웹 브라우저로 접속할 HTML Adapter의 Port를 지정한다. Port를 -1로 설정을 하면 JMX Manager가 HTML Protocol을 사용하지 않음을 의미한다. Port를 설정할 때 다른 서비스가 사용하는 Port를 사용하지 않도록 주의해서 설정한다.
HTML Adaptor 설정이 정상적으로 이루어졌는지 확인하려면, 웹 브라우저를 실행한 후 서버 IP와 설정한 Port 값을 사용해 서버에 접속한다(HTML Adaptor 접속 화면 참고).
MLet URL
서버의 MBean 서버에 등록할 MLet URL을 설정한다. 설정한 MLet URL을 적용하기 위해서는 서버를 재시작해야 한다. MLet에 대한 자세한 설명은 MLet API 문서의 설명을 참고한다.
-
Snmp Adaptor
SNMP Adaptor는 JMX가 제공하는 SNMP Protocol Adapter이다. SNMP Adaptor 설정은 JMX Manager 설정의 하위 항목으로 존재한다.
<server> ... <jmx-manager> ... <snmp-adaptor> <snmp-adaptor-port>8099</snmp-adaptor-port> <snmp-version>3</snmp-version> <snmp-max-packet-size>256</snmp-max-packet-size> <trap-demon> <ip-address>127.0.0.1</ip-address> <port>9099</port> </trap-demon> <pooling> <min>1</min> <max>5</max> <period>30000</period> </pooling> </snmp-adaptor> ... </jmx-manager> ... </server>항목 설명 Snmp Adaptor Port
SNMP 어댑터가 사용할 포트를 설정한다.
Snmp Version
사용할 SNMP 버전을 지정한다. 1,2 또는 3을 값으로 지정할 수 있다.
Snmp Max Packet Size
SNMP 패킷에 대한 최댓값을 설정한다. 최소 256 Byte부터 설정할 수 있다.
Snmp Security
보안 적용 여부를 설정한다. 보안은 SNMP 버전 3에서만 지정이 가능하다.
Trap Demon
장애 상황이 발생할 경우에 Trap 메시지를 보낼 서버를 설정한다. 여러 개를 설정할 수 있으며 설정한 모든 주소를 전송한다. 주소는 111.111.111.1:8888과 같은 형태로 지정한다.
Pooling
SNMP 서버에서 요청을 처리하는데 사용하는 스레드 풀에 대한 설정이다.
-
Min : 스레드 풀이 사용할 스레드의 최소 갯수를 지정한다.
-
Max : 스레드 풀이 사용할 스레드의 최댓값을 지정한다.
-
Period : 풀 크기를 조정하는 주기를 설정한다. SNMP와 SNMP Adaptor 설정에 대한 자세한 설명은 JEUS SNMP 안내서의 SNMP Agent 설정을 참고한다.
-
다음은 HTML 어댑터가 정상적으로 동작하고 있는 경우의 접속 화면이다.
