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>