JEUS의 설정 파일인 domain.xml 내의 웹 엔진의 웹 연결(웹 리스너, 웹 서버 연결)와 관련된 태그에 대한 설명을 찾을 수 있다.
XML Schema 파일:
JEUS_HOME/lib/schemas/jeus/web-engine.xsd
레퍼런스는 다음 형식으로 구성되어 있다.
XML Schema/XML 트리: XML 설정 파일의 모든 태그 리스트를 정리했다. 각 노드의 형식은 다음과 같다.
태그 레퍼런스로 빨리 찾아보기 위해서 각 태그마다 인덱스 번호( 예: (11) )를 붙여 놓았다. 태그 레퍼런스에서는 이 번호 순서로 설명한다.
XML Schema에서 정의한 XML 태그명을 <tag name> 형식으로 표시한다.
XML Schema에서 정의한 Cardinality를 표시한다. “?” = 0개나 1개의 element, “+” = 1개 이상의 element, “*” = 0개 이상의 element, (기호가 없음) = 정확히 1개의 element
몇몇 태그에는 “P” 문자를 붙여 놓았는데, 해당 태그는 성능에 관계되는 태그라는 것을 뜻한다. 이 태그는 설정을 튜닝할 때 사용된다.
Element Reference: 트리에 있는 각 XML 태그를 설명한다.
Dynamic: 동적 설정 반영 가능
Non-Dynamic: 동적 설정 반영 불가능, Dynamic이 설정되지 않은 항목들이 보통 이에 해당 하나 특별히 설명이 있는 경우 이 항목이 표시된다.
Description: 태그에 대한 간단한 설명.
Value Description: 입력하는 값과 타입.
Value Type: 값의 데이터 타입. (예: String)
Value Type Description: 값의 데이터 타입에 대한 설명
Default Value: 해당 XML을 사용하지 않았을 때 기본적으로 사용되는 값.
Defined Value: 이미 정해져 있는 값.
Example: 해당 XML 태그에 대한 예.
Performance Recommendation: 성능 향상을 위해서 추천하는 값.
Child Elements: 자신의 태그 안에 사용하는 태그.
(44) <listeners> ?
(45) <base> ?
(46) <listener> *
(47) <name>
(48) <listen-address> ?
(49) <listen-port> ?
(50) <selectors> ?
(51) <use-dual-selector> ?
(52) <backlog> ?
(53) <ssl> ?
(54) <client-auth> ?
(55) <ssl-protocol> ?
(56) <use-alt-jsse-provider> ?
(57) <cipher-suite> *
(58) <keystore-file> ?
(59) <keystore-pass> ?
(60) <keystore-keypassword> ?
(61) <keystore-type> ?
(62) <key-management-algorithm> ?
(63) <key-alias> ?
(64) <truststore-file> ?
(65) <truststore-pass> ?
(66) <truststore-type> ?
(67) <trust-management-algorithm> ?
(68) <crl-file> ?
(69) <keep-alive-timeout> ?
(70) <read-timeout> ?
(71) <reserved-thread-num> ?
(225) <web-connections> ?
(226) <http-listener> *
(227) <name>
(228) <thread-pool>
(229) <min>
(230) <max>
(231) <max-idle-time> ?
(232) <max-queue> ?
(233) <thread-state-notify> ?
(234) <max-thread-active-time> ?
(235) <interrupt-thread> ?
(236) <active-timeout-notification> ?
(237) <notify-threshold-ratio> ?
(238) <notify-subject> ?
(239) <restart-threshold-ratio> ?
(240) <restart-subject> ?
(241) <output-buffer-size> ?
(242) <postdata-read-timeout> ?
(243) <max-post-size> ?
(244) <max-parameter-count> ?
(245) <max-header-count> ?
(246) <max-header-size> ?
(247) <max-querystring-size> ?
(248) <server-access-control> ?
(249) <allowed-server> *
(250) <server-listener-ref>
(251) <http2> ?
(252) <settings-enable-push> ?
(254) <settings-max-frame-size> ?
(255) <settings-ack-timeout> ?
(256) <connection-type> ?
(257) <webtob-connector> *
(258) <name>
(259) <thread-pool>
(260) <min>
(261) <max>
(262) <max-idle-time> ?
(263) <max-queue> ?
(264) <thread-state-notify> ?
(265) <max-thread-active-time> ?
(266) <interrupt-thread> ?
(267) <active-timeout-notification> ?
(268) <notify-threshold-ratio> ?
(269) <notify-subject> ?
(270) <restart-threshold-ratio> ?
(271) <restart-subject> ?
(272) <output-buffer-size> ?
(273) <postdata-read-timeout> ?
(274) <max-post-size> ?
(275) <max-parameter-count> ?
(276) <max-header-count> ?
(277) <max-header-size> ?
(278) <max-querystring-size> ?
(279) <wjp-version> ?
(280) <registration-id>
(281) <hth-count> ?
(282) <connection-count>
(283) <threshold> ?
(284) <use-nio> ?
(285) <network-address>
(286) <port>
(287) <ip-address> ?
(288) <domain-socket-address>
(289) <webtob-home> ?
(290) <webtob-ipcbaseport> ?
(291) <read-timeout> ?
(292) <reconnect-interval> ?
(293) <reconnect-count-for-backup> ?
(294) <send-buffer-size> ?
(295) <receive-buffer-size> ?
(296) <request-prefetch> ?
(297) <connection-type> ?
(298) <secure> ?
(299) <trust-store-file-path>
(301) <trust-store-file-type> ?
(302) <key-store-file-path> ?
(303) <key-store-file-password> ?
(304) <private-key-password> ?
(305) <key-store-file-type> ?
(306) <secure-protocol-name> ?
(309) <webtob-backup> ?
(310) <network-address>
(311) <port>
(312) <ip-address> ?
(313) <domain-socket-address>
(314) <webtob-home> ?
(315) <webtob-ipcbaseport> ?
(316) <ajp13-listener> *
(317) <name>
(318) <thread-pool>
(319) <min>
(320) <max>
(321) <max-idle-time> ?
(322) <max-queue> ?
(323) <thread-state-notify> ?
(324) <max-thread-active-time> ?
(325) <interrupt-thread> ?
(326) <active-timeout-notification> ?
(327) <notify-threshold-ratio> ?
(328) <notify-subject> ?
(329) <restart-threshold-ratio> ?
(330) <restart-subject> ?
(331) <output-buffer-size> ?
(332) <postdata-read-timeout> ?
(333) <max-post-size> ?
(334) <max-parameter-count> ?
(335) <max-header-count> ?
(336) <max-header-size> ?
(337) <max-querystring-size> ?
(338) <server-access-control> ?
(339) <allowed-server> *
(340) <server-listener-ref>
(341) <read-timeout> ?
(342) <tcp-listener> *
(343) <name>
(344) <thread-pool>
(345) <min>
(346) <max>
(347) <max-idle-time> ?
(348) <max-queue> ?
(349) <thread-state-notify> ?
(350) <max-thread-active-time> ?
(351) <interrupt-thread> ?
(352) <active-timeout-notification> ?
(353) <notify-threshold-ratio> ?
(354) <notify-subject> ?
(355) <restart-threshold-ratio> ?
(356) <restart-subject> ?
(357) <output-buffer-size> ?
(358) <postdata-read-timeout> ?
(359) <max-post-size> ?
(360) <max-parameter-count> ?
(361) <max-header-count> ?
(362) <max-header-size> ?
(363) <max-querystring-size> ?
(364) <server-access-control> ?
(365) <allowed-server> *
(366) <server-listener-ref>
(367) <connection-type> ?
(369) <tmax-connector> *
(370) <name>
(371) <thread-pool>
(372) <min>
(373) <max>
(374) <max-idle-time> ?
(375) <max-queue> ?
(376) <thread-state-notify> ?
(377) <max-thread-active-time> ?
(378) <interrupt-thread> ?
(379) <active-timeout-notification> ?
(380) <notify-threshold-ratio> ?
(381) <notify-subject> ?
(382) <restart-threshold-ratio> ?
(383) <restart-subject> ?
(384) <output-buffer-size> ?
(385) <postdata-read-timeout> ?
(386) <max-post-size> ?
(387) <max-parameter-count> ?
(388) <max-header-count> ?
(389) <max-header-size> ?
(390) <max-querystring-size> ?
(391) <connection-type> ?
(392) <port>
(393) <server-group-name>
(394) <server-name>
(396) <read-timeout> ?
(397) <reconnect-interval> ?
(398) <reconnect-count-for-backup> ?
(399) <tmax-address> ?
(400) <tmax-version> ?
(401) <server-type> ?
(402) <xaresource-class> ?
(403) <tmax-backup-address> ?
(404) <tmax-backup-port> ?
(44)
<
domain
><
servers
><
server
>
<listeners>
| |
| Description | 서버의 JEUS 시스템이 사용하는 Socket Listener 및 Socket Connection Request 처리에 필요한 각종 속성을 지정한다. |
| Value Type | listenersType |
| Child Elements |
(46)
(47)
|
(225)
<
domain
><
servers
><
server
><
web-engine
>
<web-connections>
| |
| Description | 웹 서버와의 커넥션 설정을 구성하거나 JEUS 단독으로 제공하는 Web Listener를 설정한다. |
| Value Type | web-connectionsType |
| Child Elements |
(227)
(258)
(317)
(343)
(370)
|
[예 8.1] 웹 엔진의 웹 커넥션 설정 예제
<?xml version="1.0"?>
<domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
<servers>
<server>
<listeners>
<listener>
<name>http-and-ajp</name>
<listen-port>8088</listen-port>
</listener>
<listener>
<name>secure-http</name>
<listen-port>8089</listen-port>
<ssl/>
</listener>
<listener>
<name>tcp1</name>
<listen-port>8090</listen-port>
</listener>
</listeners>
<web-engine>
<web-connections>
<!-- WebtoB -->
<webtob-connector>
<name>WebListener1</name>
<network-address>
<port>9900</port>
<ip-address>111.111.111.111</ip-address>
</network-address>
<!-- unique id for registration -->
<registration-id>RegId1</registration-id>
<output-buffer-size>8192</output-buffer-size>
<!-- simple thread pool setting-->
<thread-pool>
<number>30</number>
</thread-pool>
<!-- web attack prevention setting -->
<max-post-size>20000000</max-post-size>
<max-parameter-count>10000</max-parameter-count>
<max-header-count>50</max-header-count>
<max-header-size>50000</max-header-size>
<max-querystring-size>10000</max-querystring-size>
<read-timeout>120000</read-timeout>
<postdata-read-timeout>40000</postdata-read-timeout>
<hth-count>1</hth-count>
<reconnect-interval>5000</reconnect-interval>
</webtob-connector>
<!-- http listener without web server -->
<http-listener>
<name>WebListener2</name>
<server-listener-ref>http-and-ajp</server-listener-ref>
<output-buffer-size>8192</output-buffer-size>
<!-- simple thread pool setting-->
<thread-pool>
<min>10</min>
<max>10</max>
<max-idle-time>60000</max-idle-time>
</thread-pool>
<!-- web attack prevention setting -->
<max-post-size>20000000</max-post-size>
<max-parameter-count>10000</max-parameter-count>
<max-header-count>50</max-header-count>
<max-header-size>50000</max-header-size>
<max-querystring-size>10000</max-querystring-size>
<postdata-read-timeout>40000</postdata-read-timeout>
<!-- do you need http keep-alive? -->
<keep-alive>true</keep-alive>
</http-listener>
<!-- http listener without web server, SSL secure communication -->
<http-listener>
<name>WebListener3</name>
<server-listener-ref>secure-http</server-listener-ref>
<output-buffer-size>16384</output-buffer-size>
<!-- simple thread pool setting-->
<thread-pool>
<min>10</min>
<max>10</max>
</thread-pool>
<!-- web attack prevention setting -->
<max-post-size>20000000</max-post-size>
<max-parameter-count>10000</max-parameter-count>
<max-header-count>50</max-header-count>
<max-header-size>50000</max-header-size>
<max-querystring-size>10000</max-querystring-size>
<postdata-read-timeout>40000</postdata-read-timeout>
<keep-alive>true</keep-alive>
</http-listener>
<!-- tcp listener -->
<tcp-listener>
<name>WebListener4</name>
<server-listener-ref>tcp1</server-listener-ref>
<output-buffer-size>16384</output-buffer-size>
<thread-pool>
<min>10</min>
<max>20</max>
</thread-pool>
<postdata-read-timeout>40000</postdata-read-timeout>
<!-- custom dispatcher class -->
<dispatcher-config-class>
tcp.TcpDispatcher
</dispatcher-config-class>
</tcp-listener>
<!-- other web servers(Apache, IIS, Iplanet, etc...) with ajp13 protocol(mod_jk) -->
<ajp13-listener>
<name>WebListener6</name>
<server-listener-ref>http-and-ajp</server-listener-ref>
<output-buffer-size>8192</output-buffer-size>
<!-- simple thread pool setting-->
<thread-pool>
<min>10</min>
<max>30</max>
</thread-pool>
<!-- web attack prevention setting -->
<max-post-size>20000000</max-post-size>
<max-parameter-count>10000</max-parameter-count>
<max-header-count>50</max-header-count>
<max-header-size>50000</max-header-size>
<max-querystring-size>10000</max-querystring-size>
<postdata-read-timeout>40000</postdata-read-timeout>
</ajp13-listener>
<!-- tmax connector -->
<tmax-connector>
<name>WebListener7</name>
<!-- listen port for tmax-->
<output-buffer-size>16384</output-buffer-size>
<!-- simple thread pool setting-->
<thread-pool>
<min>30</min>
<max>30</max>
</thread-pool>
<postdata-read-timeout>40000</postdata-read-timeout>
<reconnect-interval>5000</reconnect-interval>
<!-- tmax specific infomations -->
<port>8092</port>
<tmax-address>111.111.111.111</tmax-address>
<tmax-version>40</tmax-version>
<server-type>tms</server-type>
<xaresource-class>mypackage.XAResourceImpl</xaresource-class>
<server-group-name>tmaxGroup</server-group-name>
<server-name>tmaxServer</server-name>
<!-- custom dispatcher class -->
<dispatcher-config-class>
mypackage.mydispatcher
</dispatcher-config-class>
</tmax-connector>
</web-connections>
</web-engine>
</server>
</servers>
</domain>