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: 자신의 태그 안에 사용하는 태그.
(43) <listeners>?
(44) <base>?
(45) <listener>*
(46) <name>
(47) <listen-address>?
(48) <listen-port>? P
(49) <selectors>? P
(50) <use-dual-selector>? P
(51) <backlog>? P
(52) <ssl>?
(53) <client-auth>? P
(54) <ssl-protocol>?
(55) <use-alt-jsse-provider>?
(56) <cipher-suite>*
(57) <keystore-file>?
(58) <keystore-pass>?
(59) <keystore-keypassword>?
(60) <keystore-type>? P
(62) <key-alias>?
(63) <truststore-file>?
(64) <truststore-pass>?
(65) <truststore-type>? P
(67) <crl-file>?
(68) <keep-alive-timeout>?
(69) <read-timeout>? P
(70) <reserved-thread-num>? P
(235) <web-connections>?
(236) <http-listener>*
(237) <name>
(238) <output-buffer-size>?
(239) <postdata-read-timeout>? P
(240) <max-post-size>? P
(241) <max-parameter-count>? P
(242) <max-header-count>? P
(243) <max-header-size>? P
(244) <max-querystring-size>? P
(245) <server-access-control>? P
(246) <allowed-server>*
(247) <server-listener-ref>
(248) <thread-pool>
(249) <min>
(250) <max>
(251) <step>?
(252) <use-auto-tuning>? P
(253) <limit>? P
(254) <max-idle-time>? P
(255) <max-wait-queue>?
(256) <max-queue>? P
(257) <thread-state-notify>?
(258) <max-thread-active-time>? P
(259) <interrupt-thread>? P
(260) <active-timeout-notification>? P
(261) <notify-threshold-ratio>? P
(262) <notify-subject>?
(263) <restart-threshold-ratio>? P
(264) <restart-subject>?
(265) <http2>?
(266) <settings-enable-push>? P
(267) <settings-max-concurrent-streams>? P
(268) <settings-max-frame-size>? P
(269) <settings-ack-timeout>? P
(270) <connection-type>?
(271) <name>
(272) <output-buffer-size>?
(273) <postdata-read-timeout>? P
(274) <max-post-size>? P
(275) <max-parameter-count>? P
(276) <max-header-count>? P
(277) <max-header-size>? P
(278) <max-querystring-size>? P
(279) <server-access-control>? P
(280) <allowed-server>*
(281) <webtob-connector>*
(282) <name>
(283) <output-buffer-size>?
(284) <postdata-read-timeout>? P
(285) <max-post-size>? P
(286) <max-parameter-count>? P
(287) <max-header-count>? P
(288) <max-header-size>? P
(289) <max-querystring-size>? P
(290) <thread-pool>
(291) <number>
(292) <threshold>? P
(293) <thread-state-notify>?
(294) <max-thread-active-time>? P
(295) <interrupt-thread>? P
(296) <active-timeout-notification>? P
(297) <notify-threshold-ratio>? P
(298) <notify-subject>?
(299) <restart-threshold-ratio>? P
(300) <restart-subject>?
(301) <wjp-version>? P
(302) <registration-id>
(303) <hth-count>? P
(304) <network-address>
(305) <port>
(306) <ip-address>? P
(307) <domain-socket-address>
(308) <webtob-home>?
(309) <webtob-ipcbaseport>? P
(310) <read-timeout>? P
(311) <reconnect-interval>? P
(312) <reconnect-count-for-backup>? P
(313) <send-buffer-size>?
(314) <receive-buffer-size>?
(315) <request-prefetch>? P
(316) <connection-type>?
(317) <secure>?
(318) <trust-store-file-path>
(320) <trust-store-file-type>? P
(321) <key-store-file-path>?
(322) <key-store-file-password>?
(323) <private-key-password>?
(324) <key-store-file-type>? P
(325) <secure-protocol-name>? P
(328) <webtob-backup>?
(329) <network-address>
(330) <port>
(331) <ip-address>? P
(332) <domain-socket-address>
(333) <webtob-home>?
(334) <webtob-ipcbaseport>? P
(335) <name>
(336) <output-buffer-size>?
(337) <postdata-read-timeout>? P
(338) <max-post-size>? P
(339) <max-parameter-count>? P
(340) <max-header-count>? P
(341) <max-header-size>? P
(342) <max-querystring-size>? P
(343) <ajp13-listener>*
(344) <name>
(345) <output-buffer-size>?
(346) <postdata-read-timeout>? P
(347) <max-post-size>? P
(348) <max-parameter-count>? P
(349) <max-header-count>? P
(350) <max-header-size>? P
(351) <max-querystring-size>? P
(352) <server-access-control>? P
(353) <allowed-server>*
(354) <server-listener-ref>
(355) <thread-pool>
(356) <min>
(357) <max>
(358) <step>?
(359) <use-auto-tuning>? P
(360) <limit>? P
(361) <max-idle-time>? P
(362) <max-wait-queue>?
(363) <max-queue>? P
(364) <thread-state-notify>?
(365) <max-thread-active-time>? P
(366) <interrupt-thread>? P
(367) <active-timeout-notification>? P
(368) <notify-threshold-ratio>? P
(369) <notify-subject>?
(370) <restart-threshold-ratio>? P
(371) <restart-subject>?
(372) <read-timeout>? P
(373) <name>
(374) <output-buffer-size>?
(375) <postdata-read-timeout>? P
(376) <max-post-size>? P
(377) <max-parameter-count>? P
(378) <max-header-count>? P
(379) <max-header-size>? P
(380) <max-querystring-size>? P
(381) <server-access-control>? P
(382) <allowed-server>*
(383) <tcp-listener>*
(384) <name>
(385) <output-buffer-size>?
(386) <postdata-read-timeout>? P
(387) <max-post-size>? P
(388) <max-parameter-count>? P
(389) <max-header-count>? P
(390) <max-header-size>? P
(391) <max-querystring-size>? P
(392) <server-access-control>? P
(393) <allowed-server>*
(394) <server-listener-ref>
(395) <thread-pool>
(396) <min>
(397) <max>
(398) <step>?
(399) <use-auto-tuning>? P
(400) <limit>? P
(401) <max-idle-time>? P
(402) <max-wait-queue>?
(403) <max-queue>? P
(404) <thread-state-notify>?
(405) <max-thread-active-time>? P
(406) <interrupt-thread>? P
(407) <active-timeout-notification>? P
(408) <notify-threshold-ratio>? P
(409) <notify-subject>?
(410) <restart-threshold-ratio>? P
(411) <restart-subject>?
(412) <connection-type>?
(413) <dispatcher-config-class>
(414) <name>
(415) <output-buffer-size>?
(416) <postdata-read-timeout>? P
(417) <max-post-size>? P
(418) <max-parameter-count>? P
(419) <max-header-count>? P
(420) <max-header-size>? P
(421) <max-querystring-size>? P
(422) <server-access-control>? P
(423) <allowed-server>*
(424) <tmax-connector>*
(425) <name>
(426) <output-buffer-size>?
(427) <postdata-read-timeout>? P
(428) <max-post-size>? P
(429) <max-parameter-count>? P
(430) <max-header-count>? P
(431) <max-header-size>? P
(432) <max-querystring-size>? P
(433) <thread-pool>
(434) <min>
(435) <max>
(436) <step>?
(437) <use-auto-tuning>? P
(438) <limit>? P
(439) <max-idle-time>? P
(440) <max-wait-queue>?
(441) <max-queue>? P
(442) <thread-state-notify>?
(443) <max-thread-active-time>? P
(444) <interrupt-thread>? P
(445) <active-timeout-notification>? P
(446) <notify-threshold-ratio>? P
(447) <notify-subject>?
(448) <restart-threshold-ratio>? P
(449) <restart-subject>?
(450) <connection-type>?
(451) <port>
(452) <server-group-name>
(453) <server-name>
(455) <read-timeout>? P
(456) <reconnect-interval>? P
(457) <reconnect-count-for-backup>? P
(458) <tmax-address>? P
(459) <tmax-version>?
(460) <server-type>?
(461) <xaresource-class>?
(462) <tmax-backup-address>?
(463) <tmax-backup-port>?
(464) <name>
(465) <output-buffer-size>?
(466) <postdata-read-timeout>? P
(467) <max-post-size>? P
(468) <max-parameter-count>? P
(469) <max-header-count>? P
(470) <max-header-size>? P
(471) <max-querystring-size>? P
(472) <composite-listener>*
(473) <name>
(474) <output-buffer-size>?
(475) <postdata-read-timeout>? P
(476) <max-post-size>? P
(477) <max-parameter-count>? P
(478) <max-header-count>? P
(479) <max-header-size>? P
(480) <max-querystring-size>? P
(481) <server-access-control>? P
(482) <allowed-server>*
(483) <server-listener-ref>
(484) <http-listener>?
(485) <http2>?
(486) <settings-enable-push>? P
(487) <settings-max-concurrent-streams>? P
(488) <settings-max-frame-size>? P
(489) <settings-ack-timeout>? P
(490) <connection-type>?
(491) <webtob-connector>?
(492) <connection-pool>
(493) <size>
(494) <wjp-version>? P
(495) <registration-id>
(496) <hth-count>? P
(497) <network-address>
(498) <port>
(499) <ip-address>? P
(500) <domain-socket-address>
(501) <webtob-home>?
(502) <webtob-ipcbaseport>? P
(503) <read-timeout>? P
(504) <reconnect-interval>? P
(505) <reconnect-count-for-backup>? P
(506) <send-buffer-size>?
(507) <receive-buffer-size>?
(508) <request-prefetch>? P
(509) <connection-type>?
(510) <secure>?
(511) <trust-store-file-path>
(513) <trust-store-file-type>? P
(514) <key-store-file-path>?
(515) <key-store-file-password>?
(516) <private-key-password>?
(517) <key-store-file-type>? P
(518) <secure-protocol-name>? P
(521) <webtob-backup>?
(522) <network-address>
(523) <port>
(524) <ip-address>? P
(525) <domain-socket-address>
(526) <webtob-home>?
(527) <webtob-ipcbaseport>? P
(528) <name>
(529) <output-buffer-size>?
(530) <postdata-read-timeout>? P
(531) <max-post-size>? P
(532) <max-parameter-count>? P
(533) <max-header-count>? P
(534) <max-header-size>? P
(535) <max-querystring-size>? P
(536) <server-access-control>? P
(537) <allowed-server>*
(43)
<domain> <servers> <server> <listeners>
| |
Description | 서버의 JEUS 시스템이 사용하는 Socket Listener 및 Socket Connection Request 처리에 필요한 각종 속성을 지정한다. |
Value Type |
listenersType
|
Child Elements |
(44)
(45)
|
(44)
<domain> <servers> <server> <listeners> <base>
| |
Description | JNDI, Security, JMX, 클래스 FTP 서비스 등이 기본적으로 이용하는 Base Listener를 지정한다. Listener 설정의 Name과 동일한 값을 설정해야 한다. 설정하지 않으면 9736 포트와 기본 설정들로 Listener 생성을 시도한다. |
Value Type |
valuableToken
|
(45)
<domain> <servers> <server> <listeners> <listener>
| |
Description | 서버의 JEUS 시스템이 사용하는 Socket Listener 및 Socket Connection Request 처리에 필요한 각종 속성을 지정한다. |
Value Type |
listenerType
|
Child Elements |
(46)
(47)
(48)
(49)
(50)
(51)
(52)
(68)
(69)
(70)
|
(46)
<domain> <servers> <server> <listeners> <listener> <name>
| |
Description | 통합 포트 Listener를 나타내는 고유한 ID를 설정한다. 다른 설정에서 이 Listener에 대해 언급할 때 사용한다. |
Value Type |
valuableToken
|
(47)
<domain> <servers> <server> <listeners> <listener> <listen-address>
| |
Description | IP가 여러 개 할당되어 있을 때 이 통합 포트 Listener가 바인드될 서비스 IP 주소를 설정한다. IP가 하나일 경우에는 호스트 이름으로 대체할 수 있다. 지정하지 않은 경우는 Anyaddress로 바인드된다. 여러 IP를 입력하는 경우 콤마(,)로 구분한다. Virtual Multicast를 사용하는 경우에는 Base Listener의 IP 주소 혹은 호스트 이름을 반드시 지정해야 한다. |
Value Type |
valuableToken
|
(48)
<domain> <servers> <server> <listeners> <listener> <listen-port>
| |
Description | 통합 포트 Listener의 포트를 설정한다. 아무런 설정이 없는 경우에는 항상 9736을 사용하기 때문에 여러 서버를 같은 머신에 운영하는 경우에는 반드시 지정해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
9736
|
(49)
<domain> <servers> <server> <listeners> <listener> <selectors>
| |
Description | @Deprecated. 통합 포트 Listener의 I/O처리에 사용할 Selector의 개수를 설정한다. CPU Core의 개수로 설정하는 것이 일반적이며, 기본값은 1이다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
1
|
(50)
<domain> <servers> <server> <listeners> <listener> <use-dual-selector>
| |
Description | @Deprecated. 통합 포트 Listener의 Read와 Write에 사용하는 Selector를 분리할지 여부를 설정한다. 대용량의 Read/Write가 동시에 필요할 경우에 설정하는 것이 바람직하다. |
Value Type |
boolean
|
Default Value |
false
|
(51)
<domain> <servers> <server> <listeners> <listener> <backlog>
| |
Description | 통합 포트 Listener에 대한 Backlog 값을 지정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
128
|
(52)
<domain> <servers> <server> <listeners> <listener> <ssl>
| |
Description | SSL 속성을 지정하고, 해당 Listener를 사용하는 모든 서비스에 SSL이 적용됨을 선언한다. |
Value Type |
server-sslType
|
Child Elements |
(53)
(54)
(55)
(56)
(57)
(58)
(59)
(60)
(61)
(62)
(63)
(64)
(65)
(66)
(67)
|
(53)
<domain> <servers> <server> <listeners> <listener> <ssl> <client-auth>
| |
Description | 클라이언트의 인증 여부를 설정한다. |
Value Description | Need, Want 또는 Unnecessary를 설정할 수 있다. 기본값은 Unnecessary이다. Need이면 서버가 클라이언트에게 인증서를 요청하여 클라이언트에 대한 인증을 수행하고, Unnecessary이면 클라이언트에 대한 인증과정을 수행하지 않는다. Want일 경우 클라이언트가 자신의 인증서를 제공할 때만 인증을 수행한다. 일반적으로 B2B를 제외한 보통의 경우에는 클라이언트 인증을 수행하지 않는다. |
Value Type |
client-authType
|
Default Value |
Unnecessary
|
Defined Value |
|
(54)
<domain> <servers> <server> <listeners> <listener> <ssl> <ssl-protocol>
| |
Description | 암호화 및 복호화하는 데 사용되는 SSL 프로토콜을 지정한다. |
Value Description | 현재 버전에서 유효한 값은 SSLv3, TLSv1, TLSv1.1, TLSv1.2 등이 있으며 쉼표로 구분해서 다수를 지정할 수 있다. |
Value Type |
token
|
(55)
<domain> <servers> <server> <listeners> <listener> <ssl> <use-alt-jsse-provider>
| |
Description | JDK의 JSSE (Java Secure Socket Extension) Provider를 대체하는 JSSE를 사용하도록 설정한다. BouncyCastle JSSE를 사용하게 되며, 다른 필요한 설정들도 그에 맞게 자동으로 기본값이 선택된다. |
Value Type |
boolean
|
(56)
<domain> <servers> <server> <listeners> <listener> <ssl> <cipher-suite>
| |
Description | SSL Handshaking 후에 실제 데이터를 보낼 때 사용하는 암호 Suite들을 지정한다. |
Value Description | 일반적으로 JDK에서 제공하는 Cipher Suite를 사용하며, 기본으로 제공되지 않는 Cipher suite를 사용할 때 사용한다. |
Value Type |
token
|
(57)
<domain> <servers> <server> <listeners> <listener> <ssl> <keystore-file>
| |
Description | 서버 비밀키와 그에 매칭되는 인증서를 저장한 파일을 지정한다. 웹 서버들과는 달리 PEM 형식의 비밀키 파일은 지원하지 않는다. Java Key Store 형식의 파일을 사용하길 권장한다. |
Value Description | 절대 경로와 상대 경로 모두 허용된다. 상대 경로를 사용할 때의 기준점은 ${JEUS_HOME}/domains/domain_name/config 이다. |
Value Type |
token
|
(58)
<domain> <servers> <server> <listeners> <listener> <ssl> <keystore-pass>
| |
Description | keystore-file 을 열기 위한 암호값이다. 이 값을 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw== |
Value Type |
token
|
(59)
<domain> <servers> <server> <listeners> <listener> <ssl> <keystore-keypassword>
| |
Description | keystore-file 에 저장된 서버 비밀키에 대한 암호값이다. 이 값을 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw== |
Value Type |
token
|
(60)
<domain> <servers> <server> <listeners> <listener> <ssl> <keystore-type>
| |
Description | keystore-file 의 타입을 지정한다. |
Value Description | Sun의 Keytool에 의해서 Keystore를 생성한다면 "JKS"(Java's Keystore)를, OpenSSL이나 Microsoft KeyManager로 Keystore를 생성한다면 "PKCS12"를 사용해야 한다. |
Value Type |
token
|
Default Value |
JKS
|
(61)
<domain> <servers> <server> <listeners> <listener> <ssl> <key-management-algorithm>
| |
Description | Keystore에 저장할 Key에 대한 관리 알고리듬을 설정한다. |
Value Description | 일반적으로 Sun JVM을 사용할 경우 "SunX509"를, IBM JVM을 사용할 경우에는 "IbmX509"를 사용해야 하며 기본값은 Sun JVM에서는 "SunX509"이 IBM JVM에서는 "IbmX509"이 자동으로 선택된다. |
Value Type |
token
|
(62)
<domain> <servers> <server> <listeners> <listener> <ssl> <key-alias>
| |
Description | SSL을 사용할 때 이용되는 서버 인증서의 Key Alias 이름을 설정한다. |
Value Type |
token
|
(63)
<domain> <servers> <server> <listeners> <listener> <ssl> <truststore-file>
| |
Description | 서버 인증서를 저장하고 있는 파일을 지정한다. SSL 서버 인증 기능, 클라이언트 인증 기능 등에 필요한 인증서들을 저장한다. 웹 서버들과는 달리 PEM 형식의 인증서 파일은 지원하지 않는다. Java Key Store 형식의 파일을 사용하길 권장한다. |
Value Description | 절대 경로와 상대 경로 모두 허용된다. 상대 경로를 사용할 때의 기준점은 ${JEUS_HOME}/domains/domain_name/config 이다. |
Value Type |
token
|
(64)
<domain> <servers> <server> <listeners> <listener> <ssl> <truststore-pass>
| |
Description | truststore-file 파일을 열기 위한 암호값이다. 이 값을 암호화해서 저장할 때에는 {algorithm}ciphertext와 같은 형식으로 입력한다. ex) {DES}FQrLbQ/D8O1lDVS71L28rw== |
Value Type |
token
|
(65)
<domain> <servers> <server> <listeners> <listener> <ssl> <truststore-type>
| |
Description | Truststore의 타입을 지정한다. |
Value Description | Sun의 Keytool에 의해서 Keystore를 생성한다면 "JKS"(Java's Key Store)를, OpenSSL이나 Microsoft KeyManager로 Keystore를 생성한다면 "PKCS12"를 사용해야 한다. |
Value Type |
token
|
Default Value |
JKS
|
(66)
<domain> <servers> <server> <listeners> <listener> <ssl> <trust-management-algorithm>
| |
Description | Truststore에 저장할 Trust에 대한 관리 알고리듬을 설정한다. |
Value Description | 일반적으로 Sun JVM을 사용할 경우 "SunX509"를, IBM JVM을 사용할 경우에는 "IbmX509"를 사용해야 하며 기본값은 Sun JVM에서는 "SunX509"이 IBM JVM에서는 "IbmX509"이 자동으로 선택된다. |
Value Type |
token
|
(67)
<domain> <servers> <server> <listeners> <listener> <ssl> <crl-file>
| |
Description | Certificate Revocation Lists를 저장하고 있는 파일을 지정한다. |
Value Description | 절대 경로와 상대 경로 모두 허용된다. 상대 경로를 사용할 때의 기준점은 ${JEUS_HOME}/domains/domain_name/config 이다. |
Value Type |
token
|
(68)
<domain> <servers> <server> <listeners> <listener> <keep-alive-timeout>
| |
Description | KeepAlive 형태의 클라이언트가 설정된 시간 동안 아무런 요청이 없는 경우 끊어준다. Base Listener에는 설정하는 것을 권장하지 않는다. |
Value Description | 밀리세컨드이다. 0 일 경우 끊지 않는다. |
Value Type |
nonNegativeLongType
|
Value Type Description | 0 이상의 Long 값이다. |
(69)
<domain> <servers> <server> <listeners> <listener> <read-timeout>
| |
Description | 새로 받아들인 소켓에 대해서 읽기 함수가 Blocking되는 시간을 설정한다. 이 소켓이 목적으로 하는 서비스로 분배하기 위해 판별할 때 부터 시작하여 서비스로 전달된 후에도 계속 적용된다. |
Value Description | Integer 타입으로 단위는 밀리세컨드이다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
30000
|
(70)
<domain> <servers> <server> <listeners> <listener> <reserved-thread-num>
| |
Description | 포트 통합 서비스 처리를 위한 Thread Pool에 대한 부가적인 설정이다. 기본적으로 시스템 Thread Pool(threadpool.System)을 사용하지만 특별히 이 서비스를 위한 스레드를 미리 할당하고 싶을 경우에만 설정한다. 설정한 값은 다른 서비스들과 합산했을 때 시스템 Thread Pool의 최댓값을 넘지 않도록 해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
0
|
(235)
<domain> <servers> <server> <web-engine> <web-connections>
| |
Description | 웹 서버와의 커넥션 설정을 구성하거나 JEUS 단독으로 제공하는 Web Listener를 설정한다. |
Value Type |
web-connectionsType
|
Child Elements |
(236)
(281)
(343)
(383)
(424)
(472)
|
(236)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener>
| |
Description | HTTP Listener는 웹 엔진에서 제공하는 웹 서버이다. 이것은 소규모 운영 환경 내지는 내부 관리 용도로만 사용해야 한다. 대규모 운영 환경에서는 WebtoB 또는 Apache 웹 서버 사용을 권장한다. |
Value Type |
http-listenerType
|
Child Elements |
(237)
(238)
(239)
(240)
(241)
(242)
(243)
(244)
(245)
(246)
(247)
(248)
(265)
(270)
|
(237)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(238)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(239)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(240)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(241)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(242)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(243)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(244)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(245)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(246)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
(247)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <server-listener-ref>
| |
Description | 해당 Listener가 참조하는 서버의 Listener를 선택한다. 이름을 "ADMIN-HTTP"로 할 경우 내부 관리용 HTTP Listener에 대해 설정할 수 있다. 내부 관리용 HTTP Listener는 항상 "BASE" 서버 Listener를 참조한다. 이 Listener를 통해서 도메인 관리 서버의 WebAdmin을 사용할 수 있으며, 일반 서버에서는 Graceful Redistribute한 웹 애플리케이션을 테스트할 수 있다. 내부 관리용 HTTP Listener로는 일반 웹 애플리케이션에 접근할 수 없다. 내부 관리용 HTTP Listener는 Server Access Control 및 Allowed Server 설정을 권장한다. |
Value Type |
valuableToken
|
(248)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool>
| |
Description | Web Listener에서 요청을 받아 처리할 Thread Pool을 설정한다. |
Value Type |
thread-poolType
|
Child Elements |
(249)
(250)
(251)
(252)
(253)
(254)
(255)
(256)
(257)
|
(249)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <min>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최소 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(250)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <max>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최대 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(251)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <step>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(252)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <use-auto-tuning>
| |
Description | auto-tuning의 적용 여부. 이 옵션을 켜면 min, max는 설정을 해도 적용되지 않는다. http connection에 대해서만 적용된다. |
Value Type |
boolean
|
Default Value |
false
|
(253)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <limit>
| |
Description | auto-tuning 적용시 Thread 수의 한계점. |
Value Description | 스레드 수 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
0
|
(254)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <max-idle-time>
| |
Description | Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간을 설정한다. <min>을 초과해서 생성된 스레드에 적용하는 값이다. |
Value Description | 밀리세컨드 |
Value Type |
long
|
Default Value |
300000
|
(255)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <max-wait-queue>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
int
|
(256)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <max-queue>
| |
Description | Queue에 대기할 수 있는 최대 요청값을 설정한다. 이 설정은 Tmax/WebtoB connector에서는 사용되지 않는다. WebtoB connector의 Queue 사이즈는 WebtoB 설정 파일에 MaxQCount 값으로 구성된다. |
Value Type |
int
|
Default Value |
-1
|
(257)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify>
| |
Description | Block되는 Worker Thread를 정의하고, Block될 때 통지될 스레드의 수를 설정한다. |
Value Type |
thread-state-notifyType
|
Child Elements |
(258)
(259)
(260)
(261)
(262)
(263)
(264)
|
(258)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify> <max-thread-active-time>
| |
Description | 스레드를 Block 상태로 간주하는 시간 간격을 설정한다. 단, 체크 주기는 <monitoring><check-thread-pool>을 사용한다. 기본적으로 Block 상태에 있는 스레드는 버리고 새로운 스레드를 생성해서 스레드 풀을 채운다. 하지만 webtob-connector 및 tmax-connector 에 속한 쓰레드 풀의 경우에는 아무런 액션을 취하지 않고 Block 상태로 표시만 해준다. |
Value Description | 밀리세컨드 단위로 설정한다. 이 값이 0과 같거나 작으면 무시된다. |
Value Type |
long
|
Default Value |
0
|
(259)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify> <interrupt-thread>
| |
Description | 스레드가 Block 상태가 되었을 때 인터럽트 여부를 설정한다. 단, 인터럽트는 스레드에게 진행중인 동작을 취소하라고 힌트를 주는 것일 뿐이다. 만약 스레드 내부적으로 인터럽트 상태를 체크하지 않으면 아무런 영향을 주지 않는다. |
Value Type |
boolean
|
Default Value |
false
|
(260)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify> <active-timeout-notification>
| |
Description | Blocked 상태의 스레드가 발생한 사실에 대해 e-mail 통지 여부를 설정한다. |
Value Type |
boolean
|
Default Value |
false
|
(261)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify> <notify-threshold-ratio>
| |
Description | 스레드 풀 max 값을 기준으로 Blocked 상태인 스레드의 비율을 입력한다. 여기에 지정한 비율 이상으로 Blocked 상태의 스레드가 늘어날 경우 e-mail 통지를 해준다. |
Value Description | 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(262)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify> <notify-subject>
| |
Description | notify-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(263)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify> <restart-threshold-ratio>
| |
Description | 웹 엔진의 재시작 권고를 위한 Blocked Thread의 비율을 설정한다. 1보다 작은 소수점의 값을 입력한다. 설정한 비율을 초과하여 Blocked Thread가 존재한다면 서버재시작을 권고하는 메세지가 출력된다. |
Value Description | 총 Worker Thread 중에서 Blocked Thread 비율을 입력한다. 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(264)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <thread-pool> <thread-state-notify> <restart-subject>
| |
Description | restart-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(265)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <http2>
| |
Description | HTTP/2 프로토콜 지원 여부를 결정한다. JEUS 8에서의 HTTP/2 리스너는 h2c(clear text), h2(over TLS)를 모두 지원한다. 하지만, Java7에서 지원하는 Cipher Suites 중 HTTP/2의 Spec.을 만족하는 하는 것이 없어서 h2로 사용하기 위해선 Java8 이상의 Java 버젼을 사용하여야 한다. |
Value Type |
http2Type
|
Child Elements |
(266)
(267)
(268)
(269)
|
(266)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <http2> <settings-enable-push>
| |
Description | HTTP/2 Server Push를 지원할지 설정한다. |
Value Type |
boolean
|
Default Value |
true
|
(267)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <http2> <settings-max-concurrent-streams>
| |
Description | HTTP/2 RFC에 정의된 SETTINGS_MAX_CONCURRENT_STREAMS 기본값을 치환한다. 이 설정은 특정 클라이언트가 TCP 커넥션에 한꺼번에 보내는 요청 수를 제한하는 의미를 갖는다. 이값이 너무 크면 특정 클라이언트가 리스너에 속한 다수의 쓰레드들을 일시적으로 점유하게 될 수 있다. 리스너 쓰레드 풀의 max 값을 감안해서 적정한 값이 설정되어야 한다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
32
|
(268)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <http2> <settings-max-frame-size>
| |
Description | HTTP/2 RFC에 정의된 SETTINGS_MAX_FRAME_SIZE 기본값을 치환한다. RFC 정의에 따라 이값은 16384부터 2^24-1 (16,777,215) 이다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
16384
|
(269)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <http2> <settings-ack-timeout>
| |
Description | SETTINGS frame에 대한 ACK을 기다리는 timeout을 설정한다. timeout이 지나도 ACK이 오지 않을 경우에는 SETTINGS_TIMEOUT 에러 코드와 함께 connection error로 처리한다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
5000
|
(270)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type>
| |
Description | Response의 커넥션 타입을 강제로 설정한다. |
Value Type |
http-listenerType
|
Defined Value |
|
Child Elements |
(271)
(272)
(273)
(274)
(275)
(276)
(277)
(278)
(279)
(280)
|
(271)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(272)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(273)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(274)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(275)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(276)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(277)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(278)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(279)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(280)
<domain> <servers> <server> <web-engine> <web-connections> <http-listener> <connection-type> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
(281)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector>
| |
Description | WebtoB와의 연동을 위한 Connector이다. 연결을 생성할 때 JEUS가 클라이언트이다. |
Value Type |
webtob-connectorType
|
Child Elements |
(282)
(283)
(284)
(285)
(286)
(287)
(288)
(289)
(290)
(301)
(302)
(303)
(304)
(307)
(310)
(311)
(312)
(313)
(314)
(315)
(316)
(317)
(328)
|
(282)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(283)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(284)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(285)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(286)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(287)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(288)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(289)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(290)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool>
| |
Description | WebtoB Connector에서 요청을 받아 처리할 Thread Pool을 설정한다. |
Value Type |
webtob-thread-poolType
|
Child Elements |
(291)
(292)
(293)
|
(291)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <number>
| |
Dynamic | 동적 변경이 가능하다. |
Description | WJP 커넥션 갯수를 의미하며, 이 설정에서 지정된 수 만큼 쓰레드를 생성한다. 이 설정에 지정된 수 만큼 WebtoB와의 연결을 생성하므로 반드시 WebtoB 설정의 MinProc, MaxProc를 바탕으로 해야 한다. 동적 변경을 시도할 때 기존 값보다 작은 값을 넣는 경우 서비스 중인 thread가 종료될 수 있으므로 요청이 있는 경우에는 값을 줄이지 않기를 권장한다. |
Value Description | WJP 연결 갯수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(292)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <threshold>
| |
Description | webtob에 전달할 로드밸런싱 임계치를 지정한다. 한 웹투비 호스트에 여러 JEUS가 연결되어 있는 경우에 적용된다. 해당 값에 도달하면, 웹투비는 다른 제우스에 우선적으로 요청을 할당한다. sticky session routing이 적용된 경우에는 임계치 설정은 적용되지 않는다. WJP v1에만 적용된다. |
Value Description | 연결의 임계치 |
Value Type |
int
|
Default Value |
-1
|
(293)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify>
| |
Description | Block되는 Worker Thread를 정의하고, Block될 때 통지될 스레드의 수를 설정한다. |
Value Type |
thread-state-notifyType
|
Child Elements |
(294)
(295)
(296)
(297)
(298)
(299)
(300)
|
(294)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify> <max-thread-active-time>
| |
Description | 스레드를 Block 상태로 간주하는 시간 간격을 설정한다. 단, 체크 주기는 <monitoring><check-thread-pool>을 사용한다. 기본적으로 Block 상태에 있는 스레드는 버리고 새로운 스레드를 생성해서 스레드 풀을 채운다. 하지만 webtob-connector 및 tmax-connector 에 속한 쓰레드 풀의 경우에는 아무런 액션을 취하지 않고 Block 상태로 표시만 해준다. |
Value Description | 밀리세컨드 단위로 설정한다. 이 값이 0과 같거나 작으면 무시된다. |
Value Type |
long
|
Default Value |
0
|
(295)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify> <interrupt-thread>
| |
Description | 스레드가 Block 상태가 되었을 때 인터럽트 여부를 설정한다. 단, 인터럽트는 스레드에게 진행중인 동작을 취소하라고 힌트를 주는 것일 뿐이다. 만약 스레드 내부적으로 인터럽트 상태를 체크하지 않으면 아무런 영향을 주지 않는다. |
Value Type |
boolean
|
Default Value |
false
|
(296)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify> <active-timeout-notification>
| |
Description | Blocked 상태의 스레드가 발생한 사실에 대해 e-mail 통지 여부를 설정한다. |
Value Type |
boolean
|
Default Value |
false
|
(297)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify> <notify-threshold-ratio>
| |
Description | 스레드 풀 max 값을 기준으로 Blocked 상태인 스레드의 비율을 입력한다. 여기에 지정한 비율 이상으로 Blocked 상태의 스레드가 늘어날 경우 e-mail 통지를 해준다. |
Value Description | 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(298)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify> <notify-subject>
| |
Description | notify-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(299)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify> <restart-threshold-ratio>
| |
Description | 웹 엔진의 재시작 권고를 위한 Blocked Thread의 비율을 설정한다. 1보다 작은 소수점의 값을 입력한다. 설정한 비율을 초과하여 Blocked Thread가 존재한다면 서버재시작을 권고하는 메세지가 출력된다. |
Value Description | 총 Worker Thread 중에서 Blocked Thread 비율을 입력한다. 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(300)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <thread-pool> <thread-state-notify> <restart-subject>
| |
Description | restart-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(301)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <wjp-version>
| |
Description | WebtoB와 연결할 때 사용하는 WJP 프로토콜 버전을 결정한다. 1, 2만 설정 가능하다. WebtoB 4.1.6 이하인 경우 버전 2를 지원하지 않으므로 1로 설정해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
2
|
(302)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <registration-id>
| |
Description | WebtoB 서버와 연결할 때 사용할 Registration ID 이름을 설정한다. WebtoB와의 약속된 프로토콜로 인하여 최대 15자 제 |
Value Description | Registration ID 이름은 WebtoB 설정 파일의 *SERVER 절 하위의 값과 동일해야 한다. 15자 이내로 설정해야 한다. |
Value Type |
token
|
(303)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <hth-count>
| |
Description | WebtoB 서버에 지정되어 있는 HTH 프로세스 개수를 설정한다. WebtoB 서버의 HTH 프로세스 개수와 동일하게 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
1
|
(304)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <network-address>
| |
Description | WebtoB TCP/IP 주소 정보를 설정한다. |
Value Type |
webtob-ip-addressType
|
Child Elements |
(305)
(306)
|
(305)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <network-address> <port>
| |
Description | WebtoB에 접속할 포트이다. 이 포트 번호는 WebtoB 설정 파일의 JSVPORT 값과 일치해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(306)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <network-address> <ip-address>
| |
Description | WebtoB의 IP 주소를 설정한다. |
Value Type |
token
|
Default Value |
localhost
|
(307)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <domain-socket-address>
| |
Description | UNIX 도메인 소켓 정보 또는 Windows에서 HTH 프로세스와의 IPC 통신을 하기 위한 정보를 설정한다. WebtoB가 웹 엔진과 같은 머신에 있을 경우, UNIX 도메인 소켓(파이프)을 통해서 서로 통신한다. 단, Windows에서는 일반 소켓 통신을 한다. |
Value Type |
webtob-domain-socket-addressType
|
Child Elements |
(308)
(309)
|
(308)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <domain-socket-address> <webtob-home>
| |
Description | WebtoB의 홈 디렉터리를 설정한다. 이 설정값은 WebtoB 홈 디렉터리를 나타내는 OS 환경변수(JEUS_WSDIR 또는 WEBTOBDIR)를 Override한다. |
Value Description | 마지막에 경로 분리자가 붙는 절대 디렉터리 경로로 설정한다(Windows의 경우 "\", UNIX의 경우 "/"). |
Value Type |
token
|
(309)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <domain-socket-address> <webtob-ipcbaseport>
| |
Description | Windows에서 WebtoB HTH 프로세스와의 IPC 통신을 하기 위한 포트를 설정한다. OS 환경변수로 설정된 WEBTOB_IPCBASEPORT를 치환한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
6666
|
(310)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <read-timeout>
| |
Description | 여기에 설정된 시간 동안 WebtoB로부터 아무런 메시지가 오지 않는다면 커넥션에 문제가 있다고 간주하고 새로 맺는다. WebtoB와 JEUS 사이에 방화벽이 있을 경우, WebtoB가 보내는 Ping 메시지 도착 여부를 이 설정으로 체크할 수 있다. 기본적으로 WebtoB의 svrchktime값보다 크게 설정되어야 한다. 0보다 크고 1초보다 작은 값으로 설정되어 있으면 무조건 1초로 가정한다. -1일 경우에는 OS의 설정을 따른다. |
Value Description | 밀리세컨드 |
Value Type |
int
|
Default Value |
120000
|
(311)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <reconnect-interval>
| |
Description | WebtoB와 JEUS 사이의 커넥션이 끊어진 경우에 성공할 때까지 재연결을 시도하며, 시도할 때마다 여기에 설정된 간격만큼 기다린 후에 시도한다. 1초보다 작은 값으로 설정되어 있으면 무조건 1초로 가정한다. |
Value Type |
nonNegativeLongType
|
Value Type Description | 0 이상의 Long 값이다. |
Default Value |
5000
|
(312)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <reconnect-count-for-backup>
| |
Description | 이 설정은 webtob-backup 이 설정되어 있을 경우에만 사용한다. WebtoB와 JEUS 사이의 커넥션이 끊어진 경우에 재연결을 시도하는데, 이때 재연결을 시도하는 최대 횟수를 설정한다. 해당 횟수만큼 시도해도 연결되지 않으면 백업으로 설정된 WebtoB 로 Failover를 시도한다. 이값은 항상 0보다 커야 한다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
12
|
(313)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <send-buffer-size>
| |
Description | WebtoB로 연결할 TCP 소켓이나 UNIX 도메인 소켓 연결 시 설정할 sndbuf의 바이트 수이다. 이값을 너무 크게 잡으면 커널 메모리가 부족해서 소켓 생성이 되지 않을 수 있으므로 주의한다. |
Value Description | 바이트 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(314)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <receive-buffer-size>
| |
Description | WebtoB로 연결할 TCP 소켓이나 UNIX 도메인 소켓 연결 시 설정할 rcvbuf의 바이트 수이다. 이값을 너무 크게 잡으면 커널 메모리가 부족해서 소켓 생성이 되지 않을 수 있으므로 주의한다. |
Value Description | 바이트 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(315)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <request-prefetch>
| |
Description | WebtoB Request prefetch 기능이다. 이 기능이 true이면 현재 처리하는 WebtoB Request 외에 1개의 다음 WebtoB Request를 미리 받아 Request Queue에 저장하여 처리 속도를 향상시킬 수 있다. 단, 웹 엔진이 abnormal하게 다운되는 경우 Prefetch된 WebtoB Request가 유실될 수 있다. |
Value Type |
boolean
|
Default Value |
false
|
(316)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <connection-type>
| |
Description | Response의 커넥션 타입을 강제로 설정한다. |
Value Type |
webConnectionType
|
Defined Value |
|
(317)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure>
| |
Description | WebtoB로 연결할 때 TLS와 같은 보안 프로토콜을 사용하는 설정이다. |
Value Type |
webtob-secure-type
|
Child Elements |
(318)
(319)
(320)
(321)
(322)
(323)
(324)
(325)
|
(318)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <trust-store-file-path>
| |
Description | WebtoB 인증서가 저장된 파일을 지정한다. 절대 경로, 상대 경로 모두 허용된다. 상대 경로의 경우, ${JEUS_HOME}/domains/${DOMAIN_NAME}/config/servlet을 기준으로 파일을 찾는다. |
Value Type |
token
|
(319)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <trust-store-file-password>
| |
Description | <trust-store-file-path>에 지정된 파일을 열기 위한 암호다. {DES}FQrLbQ/D8O1lDVS71L28rw==와 같은 형식으로 적기를 권장한다. |
Value Type |
token
|
(320)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <trust-store-file-type>
| |
Description | <truststore-file-path>에 지정된 파일의 형식이다. 일반적으로 JKS(Java KeyStore 형식) 또는 PKCS12 형식을 쓴다. 기본값은 JKS이다. |
Value Type |
token
|
Default Value |
JKS
|
(321)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <key-store-file-path>
| |
Description | 비밀키, 그에 매칭되는 인증서가 저장된 파일을 지정한다. WebtoB 쪽에서 JEUS를 인증하기 위해서 Client Authentication 기능을 사용하는 경우, 이 파일이 필요하다. 절대 경로, 상대 경로 모두 허용된다. 상대 경로의 경우, ${JEUS_HOME}/domains/${DOMAIN_NAME}/config/servlet을 기준으로 파일을 찾는다. |
Value Type |
token
|
(322)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <key-store-file-password>
| |
Description | <key-store-file-path>에 지정된 파일을 열기 위한 암호다. <key-store-file-path>가 설정될 경우 반드시 필요하다. {DES}FQrLbQ/D8O1lDVS71L28rw==와 같은 형식으로 적기를 권장한다. |
Value Type |
token
|
(323)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <private-key-password>
| |
Description | <key-store-file-path>로 지정된 파일에 저장된 비밀키의 암호다. 이 값을 설정하지 않을 경우에는 <key-store-file-password> 값을 사용한다. 이 암호는 javax.net.ssl.KeyManagerFactory 구현체 내부에서 해당 비밀키를 접근할 때 사용할 것이다. {DES}FQrLbQ/D8O1lDVS71L28rw==와 같은 형식으로 적기를 권장한다. |
Value Type |
token
|
(324)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <key-store-file-type>
| |
Description | <key-store-file-path>에 지정된 파일의 형식이다. 일반적으로 JKS(Java key-store 형식) 또는 PKCS12 형식을 쓴다. 기본값은 JKS이다. |
Value Type |
token
|
Default Value |
JKS
|
(325)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <secure-protocol-name>
| |
Description | 서버와 통신할 때 사용할 통신 보안 프로토콜을 선택한다. javax.net.ssl.SSLContext#getInstance(String protocol)을 통해서 javax.net.ssl.SSLContext를 생성할 때 사용한다. 기본값으로 TLS이다. |
Value Type |
token
|
Default Value |
TLS
|
(326)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <trust-manager-factory-algorithm-name>
| |
Description | 인증서를 다루는 javax.net.ssl.TrustManagerFactory를 생성할 때 사용하는 알고리듬을 선택한다. 참고로 JEUS는 별도의 JSSE Provider를 제공하지 않는다. 아무 것도 설정하지 않으면 JVM 벤더에 따른 기본값으로 사용한다. |
Value Type |
token
|
(327)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <secure> <key-manager-factory-algorithm-name>
| |
Description | 비밀키를 다루는 javax.net.ssl.KeyManagerFactory를 생성할 때 사용하는 알고리듬을 선택한다. 참고로 JEUS는 별도의 JSSE Provider를 제공하지 않는다. 아무 것도 설정하지 않으면 JVM 벤더에 따른 기본값으로 사용한다. WebtoB 쪽에서 JEUS를 인증하기 위해서 Client Authentication 기능을 사용하는 경우에 사용한다. |
Value Type |
token
|
(328)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup>
| |
Description | JEUS와 연결되는 WebtoB가 어떤 이유로든 정상 서비스가 불가능할 경우, 이를 대신하여 서비스를 해줄 WebtoB를 설정한다. |
Value Type |
webtob-backupType
|
Child Elements |
(329)
(332)
|
(329)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <network-address>
| |
Description | WebtoB TCP/IP 주소 정보를 설정한다. |
Value Type |
webtob-ip-addressType
|
Child Elements |
(330)
(331)
|
(330)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <network-address> <port>
| |
Description | WebtoB에 접속할 포트이다. 이 포트 번호는 WebtoB 설정 파일의 JSVPORT 값과 일치해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(331)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <network-address> <ip-address>
| |
Description | WebtoB의 IP 주소를 설정한다. |
Value Type |
token
|
Default Value |
localhost
|
(332)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address>
| |
Description | UNIX 도메인 소켓 정보 또는 Windows에서 HTH 프로세스와의 소켓 통신을 하기 위한 정보를 설정한다. |
Value Type |
webtob-domain-socket-addressType
|
Child Elements |
(333)
(334)
|
(333)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-home>
| |
Description | WebtoB의 홈 디렉터리를 설정한다. 이 설정값은 WebtoB 홈 디렉터리를 나타내는 OS 환경변수(JEUS_WSDIR 또는 WEBTOBDIR)를 Override한다. |
Value Description | 마지막에 경로 분리자가 붙는 절대 디렉터리 경로로 설정한다(Windows의 경우 "\", UNIX의 경우 "/"). |
Value Type |
token
|
(334)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport>
| |
Description | Windows에서 WebtoB HTH 프로세스와의 IPC 통신을 하기 위한 포트를 설정한다. OS 환경변수로 설정된 WEBTOB_IPCBASEPORT를 치환한다. |
Value Type |
webtob-connectorType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
6666
|
Child Elements |
(335)
(336)
(337)
(338)
(339)
(340)
(341)
(342)
|
(335)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(336)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(337)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(338)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(339)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(340)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(341)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(342)
<domain> <servers> <server> <web-engine> <web-connections> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(343)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener>
| |
Description | Apache mod_jk 모듈을 사용하는 AJP 1.3 프로토콜을 지원한다. |
Value Type |
ajp13-listenerType
|
Child Elements |
(344)
(345)
(346)
(347)
(348)
(349)
(350)
(351)
(352)
(353)
(354)
(355)
(372)
|
(344)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(345)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(346)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(347)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(348)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(349)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(350)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(351)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(352)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(353)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
(354)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <server-listener-ref>
| |
Description | AJP13 Listener가 참조하는 서버 리스너를 설정한다. "BASE" Listener를 선택할 수 없다. |
Value Type |
valuableToken
|
(355)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool>
| |
Description | AJP13 Listener에서 요청을 받아 처리할 Thread Pool을 설정한다. |
Value Type |
thread-poolType
|
Child Elements |
(356)
(357)
(358)
(359)
(360)
(361)
(362)
(363)
(364)
|
(356)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <min>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최소 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(357)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <max>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최대 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(358)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <step>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(359)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <use-auto-tuning>
| |
Description | auto-tuning의 적용 여부. 이 옵션을 켜면 min, max는 설정을 해도 적용되지 않는다. http connection에 대해서만 적용된다. |
Value Type |
boolean
|
Default Value |
false
|
(360)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <limit>
| |
Description | auto-tuning 적용시 Thread 수의 한계점. |
Value Description | 스레드 수 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
0
|
(361)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <max-idle-time>
| |
Description | Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간을 설정한다. <min>을 초과해서 생성된 스레드에 적용하는 값이다. |
Value Description | 밀리세컨드 |
Value Type |
long
|
Default Value |
300000
|
(362)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <max-wait-queue>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
int
|
(363)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <max-queue>
| |
Description | Queue에 대기할 수 있는 최대 요청값을 설정한다. 이 설정은 Tmax/WebtoB connector에서는 사용되지 않는다. WebtoB connector의 Queue 사이즈는 WebtoB 설정 파일에 MaxQCount 값으로 구성된다. |
Value Type |
int
|
Default Value |
-1
|
(364)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify>
| |
Description | Block되는 Worker Thread를 정의하고, Block될 때 통지될 스레드의 수를 설정한다. |
Value Type |
thread-state-notifyType
|
Child Elements |
(365)
(366)
(367)
(368)
(369)
(370)
(371)
|
(365)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify> <max-thread-active-time>
| |
Description | 스레드를 Block 상태로 간주하는 시간 간격을 설정한다. 단, 체크 주기는 <monitoring><check-thread-pool>을 사용한다. 기본적으로 Block 상태에 있는 스레드는 버리고 새로운 스레드를 생성해서 스레드 풀을 채운다. 하지만 webtob-connector 및 tmax-connector 에 속한 쓰레드 풀의 경우에는 아무런 액션을 취하지 않고 Block 상태로 표시만 해준다. |
Value Description | 밀리세컨드 단위로 설정한다. 이 값이 0과 같거나 작으면 무시된다. |
Value Type |
long
|
Default Value |
0
|
(366)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify> <interrupt-thread>
| |
Description | 스레드가 Block 상태가 되었을 때 인터럽트 여부를 설정한다. 단, 인터럽트는 스레드에게 진행중인 동작을 취소하라고 힌트를 주는 것일 뿐이다. 만약 스레드 내부적으로 인터럽트 상태를 체크하지 않으면 아무런 영향을 주지 않는다. |
Value Type |
boolean
|
Default Value |
false
|
(367)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify> <active-timeout-notification>
| |
Description | Blocked 상태의 스레드가 발생한 사실에 대해 e-mail 통지 여부를 설정한다. |
Value Type |
boolean
|
Default Value |
false
|
(368)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify> <notify-threshold-ratio>
| |
Description | 스레드 풀 max 값을 기준으로 Blocked 상태인 스레드의 비율을 입력한다. 여기에 지정한 비율 이상으로 Blocked 상태의 스레드가 늘어날 경우 e-mail 통지를 해준다. |
Value Description | 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(369)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify> <notify-subject>
| |
Description | notify-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(370)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify> <restart-threshold-ratio>
| |
Description | 웹 엔진의 재시작 권고를 위한 Blocked Thread의 비율을 설정한다. 1보다 작은 소수점의 값을 입력한다. 설정한 비율을 초과하여 Blocked Thread가 존재한다면 서버재시작을 권고하는 메세지가 출력된다. |
Value Description | 총 Worker Thread 중에서 Blocked Thread 비율을 입력한다. 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(371)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <thread-pool> <thread-state-notify> <restart-subject>
| |
Description | restart-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(372)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout>
| |
Description | 이 설정값은 더이상 사용하지 않는다. |
Value Type |
ajp13-listenerType
|
Value Type Description | 0 이상의 Long 값이다. |
Default Value |
0
|
Child Elements |
(373)
(374)
(375)
(376)
(377)
(378)
(379)
(380)
(381)
(382)
|
(373)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(374)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(375)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(376)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(377)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(378)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(379)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(380)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(381)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(382)
<domain> <servers> <server> <web-engine> <web-connections> <ajp13-listener> <read-timeout> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
(383)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener>
| |
Description | TCP Listener는 HTTP가 아닌 TCP 기반의 Custom 프로토콜을 지원한다. 서비스 개발자가 직접 프로토콜을 정의해야 한다. |
Value Type |
tcp-listenerType
|
Child Elements |
(384)
(385)
(386)
(387)
(388)
(389)
(390)
(391)
(392)
(393)
(394)
(395)
(412)
(413)
|
(384)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(385)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(386)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(387)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(388)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(389)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(390)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(391)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(392)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(393)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
(394)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <server-listener-ref>
| |
Description | 해당 Listener가 참조하는 서버의 Listener를 선택한다. "BASE" Listener를 선택할 수 없다. 또한 다른 Web Listener들과 서버 Listener를 공유할 수 없다. |
Value Type |
valuableToken
|
(395)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool>
| |
Description | TCP Listener에서 요청을 받아 처리할 Thread Pool을 설정한다. |
Value Type |
thread-poolType
|
Child Elements |
(396)
(397)
(398)
(399)
(400)
(401)
(402)
(403)
(404)
|
(396)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <min>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최소 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(397)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <max>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최대 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(398)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <step>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(399)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <use-auto-tuning>
| |
Description | auto-tuning의 적용 여부. 이 옵션을 켜면 min, max는 설정을 해도 적용되지 않는다. http connection에 대해서만 적용된다. |
Value Type |
boolean
|
Default Value |
false
|
(400)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <limit>
| |
Description | auto-tuning 적용시 Thread 수의 한계점. |
Value Description | 스레드 수 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
0
|
(401)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <max-idle-time>
| |
Description | Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간을 설정한다. <min>을 초과해서 생성된 스레드에 적용하는 값이다. |
Value Description | 밀리세컨드 |
Value Type |
long
|
Default Value |
300000
|
(402)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <max-wait-queue>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
int
|
(403)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <max-queue>
| |
Description | Queue에 대기할 수 있는 최대 요청값을 설정한다. 이 설정은 Tmax/WebtoB connector에서는 사용되지 않는다. WebtoB connector의 Queue 사이즈는 WebtoB 설정 파일에 MaxQCount 값으로 구성된다. |
Value Type |
int
|
Default Value |
-1
|
(404)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify>
| |
Description | Block되는 Worker Thread를 정의하고, Block될 때 통지될 스레드의 수를 설정한다. |
Value Type |
thread-state-notifyType
|
Child Elements |
(405)
(406)
(407)
(408)
(409)
(410)
(411)
|
(405)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify> <max-thread-active-time>
| |
Description | 스레드를 Block 상태로 간주하는 시간 간격을 설정한다. 단, 체크 주기는 <monitoring><check-thread-pool>을 사용한다. 기본적으로 Block 상태에 있는 스레드는 버리고 새로운 스레드를 생성해서 스레드 풀을 채운다. 하지만 webtob-connector 및 tmax-connector 에 속한 쓰레드 풀의 경우에는 아무런 액션을 취하지 않고 Block 상태로 표시만 해준다. |
Value Description | 밀리세컨드 단위로 설정한다. 이 값이 0과 같거나 작으면 무시된다. |
Value Type |
long
|
Default Value |
0
|
(406)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify> <interrupt-thread>
| |
Description | 스레드가 Block 상태가 되었을 때 인터럽트 여부를 설정한다. 단, 인터럽트는 스레드에게 진행중인 동작을 취소하라고 힌트를 주는 것일 뿐이다. 만약 스레드 내부적으로 인터럽트 상태를 체크하지 않으면 아무런 영향을 주지 않는다. |
Value Type |
boolean
|
Default Value |
false
|
(407)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify> <active-timeout-notification>
| |
Description | Blocked 상태의 스레드가 발생한 사실에 대해 e-mail 통지 여부를 설정한다. |
Value Type |
boolean
|
Default Value |
false
|
(408)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify> <notify-threshold-ratio>
| |
Description | 스레드 풀 max 값을 기준으로 Blocked 상태인 스레드의 비율을 입력한다. 여기에 지정한 비율 이상으로 Blocked 상태의 스레드가 늘어날 경우 e-mail 통지를 해준다. |
Value Description | 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(409)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify> <notify-subject>
| |
Description | notify-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(410)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify> <restart-threshold-ratio>
| |
Description | 웹 엔진의 재시작 권고를 위한 Blocked Thread의 비율을 설정한다. 1보다 작은 소수점의 값을 입력한다. 설정한 비율을 초과하여 Blocked Thread가 존재한다면 서버재시작을 권고하는 메세지가 출력된다. |
Value Description | 총 Worker Thread 중에서 Blocked Thread 비율을 입력한다. 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(411)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <thread-pool> <thread-state-notify> <restart-subject>
| |
Description | restart-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(412)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <connection-type>
| |
Description | Response의 커넥션 타입을 강제로 설정한다. |
Value Type |
webConnectionType
|
Defined Value |
|
(413)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class>
| |
Description | dispatcher 설정 클래스를 지정한다. 이때 클래스는 반드시 classpath로 설정된 곳에 위치해야 하며, 클래스의 이름은 Fully Qualified Class Name이어야 한다. |
Value Type |
tcp-listenerType
|
Child Elements |
(414)
(415)
(416)
(417)
(418)
(419)
(420)
(421)
(422)
(423)
|
(414)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(415)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(416)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(417)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(418)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(419)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(420)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(421)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(422)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(423)
<domain> <servers> <server> <web-engine> <web-connections> <tcp-listener> <dispatcher-config-class> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
(424)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector>
| |
Description | Tmax와의 연동을 위한 Connector이다. 연결을 생성할 때 JEUS가 클라이언트이다. |
Value Type |
tmax-connectorType
|
Child Elements |
(425)
(426)
(427)
(428)
(429)
(430)
(431)
(432)
(433)
(450)
(451)
(452)
(453)
(454)
(455)
(456)
(457)
(458)
(459)
(460)
(461)
(462)
(463)
|
(425)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(426)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(427)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(428)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(429)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(430)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(431)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(432)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(433)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool>
| |
Description | Tmax Connector에서 요청을 받아 처리할 Thread Pool을 설정한다. |
Value Type |
thread-poolType
|
Child Elements |
(434)
(435)
(436)
(437)
(438)
(439)
(440)
(441)
(442)
|
(434)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <min>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최소 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(435)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <max>
| |
Dynamic | 동적 변경이 가능하다. |
Description | Pool에서 Worker Thread를 유지해야 하는 최대 개수를 설정한다. |
Value Description | 스레드 수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(436)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <step>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(437)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <use-auto-tuning>
| |
Description | auto-tuning의 적용 여부. 이 옵션을 켜면 min, max는 설정을 해도 적용되지 않는다. http connection에 대해서만 적용된다. |
Value Type |
boolean
|
Default Value |
false
|
(438)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <limit>
| |
Description | auto-tuning 적용시 Thread 수의 한계점. |
Value Description | 스레드 수 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
0
|
(439)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <max-idle-time>
| |
Description | Pool에서 제거되기 전에 Idle 상태로 머물러 있는 Worker Thread의 최대 시간을 설정한다. <min>을 초과해서 생성된 스레드에 적용하는 값이다. |
Value Description | 밀리세컨드 |
Value Type |
long
|
Default Value |
300000
|
(440)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <max-wait-queue>
| |
Description | 더이상 사용하지 않는다. |
Value Type |
int
|
(441)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <max-queue>
| |
Description | Queue에 대기할 수 있는 최대 요청값을 설정한다. 이 설정은 Tmax/WebtoB connector에서는 사용되지 않는다. WebtoB connector의 Queue 사이즈는 WebtoB 설정 파일에 MaxQCount 값으로 구성된다. |
Value Type |
int
|
Default Value |
-1
|
(442)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify>
| |
Description | Block되는 Worker Thread를 정의하고, Block될 때 통지될 스레드의 수를 설정한다. |
Value Type |
thread-state-notifyType
|
Child Elements |
(443)
(444)
(445)
(446)
(447)
(448)
(449)
|
(443)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify> <max-thread-active-time>
| |
Description | 스레드를 Block 상태로 간주하는 시간 간격을 설정한다. 단, 체크 주기는 <monitoring><check-thread-pool>을 사용한다. 기본적으로 Block 상태에 있는 스레드는 버리고 새로운 스레드를 생성해서 스레드 풀을 채운다. 하지만 webtob-connector 및 tmax-connector 에 속한 쓰레드 풀의 경우에는 아무런 액션을 취하지 않고 Block 상태로 표시만 해준다. |
Value Description | 밀리세컨드 단위로 설정한다. 이 값이 0과 같거나 작으면 무시된다. |
Value Type |
long
|
Default Value |
0
|
(444)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify> <interrupt-thread>
| |
Description | 스레드가 Block 상태가 되었을 때 인터럽트 여부를 설정한다. 단, 인터럽트는 스레드에게 진행중인 동작을 취소하라고 힌트를 주는 것일 뿐이다. 만약 스레드 내부적으로 인터럽트 상태를 체크하지 않으면 아무런 영향을 주지 않는다. |
Value Type |
boolean
|
Default Value |
false
|
(445)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify> <active-timeout-notification>
| |
Description | Blocked 상태의 스레드가 발생한 사실에 대해 e-mail 통지 여부를 설정한다. |
Value Type |
boolean
|
Default Value |
false
|
(446)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify> <notify-threshold-ratio>
| |
Description | 스레드 풀 max 값을 기준으로 Blocked 상태인 스레드의 비율을 입력한다. 여기에 지정한 비율 이상으로 Blocked 상태의 스레드가 늘어날 경우 e-mail 통지를 해준다. |
Value Description | 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(447)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify> <notify-subject>
| |
Description | notify-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(448)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify> <restart-threshold-ratio>
| |
Description | 웹 엔진의 재시작 권고를 위한 Blocked Thread의 비율을 설정한다. 1보다 작은 소수점의 값을 입력한다. 설정한 비율을 초과하여 Blocked Thread가 존재한다면 서버재시작을 권고하는 메세지가 출력된다. |
Value Description | 총 Worker Thread 중에서 Blocked Thread 비율을 입력한다. 이 값이 0과 같거나 작으면 이 설정은 무시된다. |
Value Type |
double
|
Default Value |
0.0E1
|
(449)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <thread-pool> <thread-state-notify> <restart-subject>
| |
Description | restart-threshold-ratio 에 의해 통지되는 e-mail 제목을 설정한다. |
Value Description | 수신자(관리자)가 해당 e-mail에 대해 어떤 내용인지 바로 알아볼 수 있는 메시지를 입력한다. |
Value Type |
token
|
(450)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <connection-type>
| |
Description | Response의 커넥션 타입을 강제로 설정한다. |
Value Type |
webConnectionType
|
Defined Value |
|
(451)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <port>
| |
Description | Tmax 서버에 접속할 포트 번호를 설정한다. |
Value Description | 포트 번호는 0보다 큰 값이어야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(452)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <server-group-name>
| |
Description | 연결하려는 Tmax 서버가 포함된 그룹을 의미한다. |
Value Description | Tmax 서버 그룹의 이름 |
Value Type |
token
|
(453)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <server-name>
| |
Description | 연결하려는 Tmax 서버의 이름이다. |
Value Description | Tmax 서버의 이름 |
Value Type |
token
|
(454)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <dispatcher-config-class>
| |
Description | dispatcher 설정 클래스를 지정한다. 이때 클래스는 반드시 classpath로 설정된 곳에 위치해야 하며, 클래스의 이름은 Fully Qualified Class Name이어야 한다. |
Value Type |
token
|
(455)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <read-timeout>
| |
Description | Tmax로부터 요청을 읽어 올때 기다리는 최대의 시간을 설정한다. |
Value Type |
int
|
Default Value |
0
|
(456)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <reconnect-interval>
| |
Description | Tmax와 JEUS 사이의 커넥션이 끊어진 경우에 재연결을 시도하게 되는데, 재연결을 시도하는 시간 간격을 설정한다. 각 횟수마다 여기에 설정된 간격만큼 기다린 후에 시도한다. 이때 1초보다 작은 값으로 설정되어 있으면 무조건 1초로 가정한다. 연결이 성공할 때까지 무한히 시도한다. 단, Backup 설정이 있을 경우에는 Reconnect Count For Backup 값만큼 시도한 뒤 FailOver를 시도한다. |
Value Type |
nonNegativeLongType
|
Value Type Description | 0 이상의 Long 값이다. |
Default Value |
5000
|
(457)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <reconnect-count-for-backup>
| |
Description | 이 설정은 Tmax Backup Address 와 Tmax Backup Port 가 설정되어 있을 경우에만 사용한다. Tmax 와 JEUS 사이의 커넥션이 끊어진 경우에 재연결을 시도하게 되는데, 재연결을 시도하는 최대 횟수를 설정한다. 해당 횟수만큼 시도해도 연결되지 않으면 백업으로 FailOver 를 시도한다. 이값은 항상 0보다 커야 한다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
12
|
(458)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-address>
| |
Description | Tmax 서버의 IP 주소를 설정한다. |
Value Description | Tmax 서버의 IP 주소 |
Value Type |
token
|
Default Value |
localhost
|
(459)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-version>
| |
Description | 연결하려는 Tmax 서버의 버전이다. 4.0, 3.x의 두 버전을 지원한다. 4.0은 40, 3.x는 3X라고 입력한다. |
Value Description | Tmax 서버의 버전 |
Value Type |
token
|
(460)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <server-type>
| |
Description | 연결하려는 Tmax 서버의 종류이다. TMS, HTTPGW 등 특수한 서버일 경우에 설정한다. |
Value Description | Tmax 서버의 종류 |
Value Type |
token
|
(461)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <xaresource-class>
| |
Description | XAResource 클래스의 이름 Transaction Recovery 기능을 사용하고자 할 때 설정한다. |
Value Description | XAResource 클래스 이름 |
Value Type |
token
|
(462)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-address>
| |
Description | 백업으로 사용할 Tmax 서버의 IP 주소를 설정한다. |
Value Description | Tmax 서버의 IP 주소 |
Value Type |
token
|
(463)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port>
| |
Description | 백업으로 사용할 Tmax 서버의 포트 번호를 설정한다. |
Value Description | 포트 번호는 0보다 큰 값이어야 한다. |
Value Type |
tmax-connectorType
|
Value Type Description | 0 이상의 Int 값이다. |
Child Elements |
(464)
(465)
(466)
(467)
(468)
(469)
(470)
(471)
|
(464)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(465)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(466)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(467)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(468)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(469)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(470)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(471)
<domain> <servers> <server> <web-engine> <web-connections> <tmax-connector> <tmax-backup-port> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(472)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener>
| |
Description | WebtoB Connector와 Http Listener를 함께 사용할 수 있는 Listener이다. |
Value Type |
composite-listenerType
|
Child Elements |
(473)
(474)
(475)
(476)
(477)
(478)
(479)
(480)
(481)
(482)
(483)
(484)
(491)
|
(473)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(474)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(475)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(476)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(477)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(478)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(479)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(480)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(481)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(482)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
(483)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <server-listener-ref>
| |
Description | composite-listener의 하위 listener가 참조할 서버의 Listener를 선택한다. "BASE" Listener를 선택할 수 없다. |
Value Type |
valuableToken
|
(484)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <http-listener>
| |
Description | composit listener로 통신할 때의 http리스너를 설정한다. |
Value Type |
http-listener-specificType
|
Child Elements |
(485)
(490)
|
(485)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <http-listener> <http2>
| |
Description | HTTP/2 프로토콜 지원 여부를 결정한다. JEUS 8에서의 HTTP/2 리스너는 h2c(clear text), h2(over TLS)를 모두 지원한다. 하지만, Java7에서 지원하는 Cipher Suites 중 HTTP/2의 Spec.을 만족하는 하는 것이 없어서 h2로 사용하기 위해선 Java8 이상의 Java 버젼을 사용하여야 한다. |
Value Type |
http2Type
|
Child Elements |
(486)
(487)
(488)
(489)
|
(486)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <http-listener> <http2> <settings-enable-push>
| |
Description | HTTP/2 Server Push를 지원할지 설정한다. |
Value Type |
boolean
|
Default Value |
true
|
(487)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <http-listener> <http2> <settings-max-concurrent-streams>
| |
Description | HTTP/2 RFC에 정의된 SETTINGS_MAX_CONCURRENT_STREAMS 기본값을 치환한다. 이 설정은 특정 클라이언트가 TCP 커넥션에 한꺼번에 보내는 요청 수를 제한하는 의미를 갖는다. 이값이 너무 크면 특정 클라이언트가 리스너에 속한 다수의 쓰레드들을 일시적으로 점유하게 될 수 있다. 리스너 쓰레드 풀의 max 값을 감안해서 적정한 값이 설정되어야 한다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
32
|
(488)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <http-listener> <http2> <settings-max-frame-size>
| |
Description | HTTP/2 RFC에 정의된 SETTINGS_MAX_FRAME_SIZE 기본값을 치환한다. RFC 정의에 따라 이값은 16384부터 2^24-1 (16,777,215) 이다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
16384
|
(489)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <http-listener> <http2> <settings-ack-timeout>
| |
Description | SETTINGS frame에 대한 ACK을 기다리는 timeout을 설정한다. timeout이 지나도 ACK이 오지 않을 경우에는 SETTINGS_TIMEOUT 에러 코드와 함께 connection error로 처리한다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
5000
|
(490)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <http-listener> <connection-type>
| |
Description | Response의 커넥션 타입을 강제로 설정한다. |
Value Type |
webConnectionType
|
Defined Value |
|
(491)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector>
| |
Description | composit listener로 통신할 때의 webtob 를 설정한다. |
Value Type |
webtob-connector-specificType
|
Child Elements |
(492)
(494)
(495)
(496)
(497)
(500)
(503)
(504)
(505)
(506)
(507)
(508)
(509)
(510)
(521)
|
(492)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <connection-pool>
| |
Description | WebtoB Connector에서 요청을 받을 연결에 대한 설정을 한다. |
Value Type |
webtob-connection-poolType
|
Child Elements |
(493)
|
(493)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <connection-pool> <size>
| |
Description | WJP 커넥션 갯수를 의미한다. 이 설정에 지정된 수 만큼 WebtoB와의 연결을 생성하므로 반드시 WebtoB 설정의 MinProc, MaxProc를 바탕으로 해야 한다. |
Value Description | WJP 연결 갯수 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
(494)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <wjp-version>
| |
Description | WebtoB와 연결할 때 사용하는 WJP 프로토콜 버전을 결정한다. 1, 2만 설정 가능하다. WebtoB 4.1.6 이하인 경우 버전 2를 지원하지 않으므로 1로 설정해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
2
|
(495)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <registration-id>
| |
Description | WebtoB 서버와 연결할 때 사용할 Registration ID 이름을 설정한다. WebtoB와의 약속된 프로토콜로 인하여 최대 15자 제 |
Value Description | Registration ID 이름은 WebtoB 설정 파일의 *SERVER 절 하위의 값과 동일해야 한다. 15자 이내로 설정해야 한다. |
Value Type |
token
|
(496)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <hth-count>
| |
Description | WebtoB 서버에 지정되어 있는 HTH 프로세스 개수를 설정한다. WebtoB 서버의 HTH 프로세스 개수와 동일하게 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
1
|
(497)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <network-address>
| |
Description | WebtoB TCP/IP 주소 정보를 설정한다. |
Value Type |
webtob-ip-addressType
|
Child Elements |
(498)
(499)
|
(498)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <network-address> <port>
| |
Description | WebtoB에 접속할 포트이다. 이 포트 번호는 WebtoB 설정 파일의 JSVPORT 값과 일치해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(499)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <network-address> <ip-address>
| |
Description | WebtoB의 IP 주소를 설정한다. |
Value Type |
token
|
Default Value |
localhost
|
(500)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <domain-socket-address>
| |
Description | UNIX 도메인 소켓 정보 또는 Windows에서 HTH 프로세스와의 IPC 통신을 하기 위한 정보를 설정한다. WebtoB가 웹 엔진과 같은 머신에 있을 경우, UNIX 도메인 소켓(파이프)을 통해서 서로 통신한다. 단, Windows에서는 일반 소켓 통신을 한다. |
Value Type |
webtob-domain-socket-addressType
|
Child Elements |
(501)
(502)
|
(501)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <domain-socket-address> <webtob-home>
| |
Description | WebtoB의 홈 디렉터리를 설정한다. 이 설정값은 WebtoB 홈 디렉터리를 나타내는 OS 환경변수(JEUS_WSDIR 또는 WEBTOBDIR)를 Override한다. |
Value Description | 마지막에 경로 분리자가 붙는 절대 디렉터리 경로로 설정한다(Windows의 경우 "\", UNIX의 경우 "/"). |
Value Type |
token
|
(502)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <domain-socket-address> <webtob-ipcbaseport>
| |
Description | Windows에서 WebtoB HTH 프로세스와의 IPC 통신을 하기 위한 포트를 설정한다. OS 환경변수로 설정된 WEBTOB_IPCBASEPORT를 치환한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
6666
|
(503)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <read-timeout>
| |
Description | 여기에 설정된 시간 동안 WebtoB로부터 아무런 메시지가 오지 않는다면 커넥션에 문제가 있다고 간주하고 새로 맺는다. WebtoB와 JEUS 사이에 방화벽이 있을 경우, WebtoB가 보내는 Ping 메시지 도착 여부를 이 설정으로 체크할 수 있다. 기본적으로 WebtoB의 svrchktime값보다 크게 설정되어야 한다. 0보다 크고 1초보다 작은 값으로 설정되어 있으면 무조건 1초로 가정한다. -1일 경우에는 OS의 설정을 따른다. |
Value Description | 밀리세컨드 |
Value Type |
int
|
Default Value |
120000
|
(504)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <reconnect-interval>
| |
Description | WebtoB와 JEUS 사이의 커넥션이 끊어진 경우에 성공할 때까지 재연결을 시도하며, 시도할 때마다 여기에 설정된 간격만큼 기다린 후에 시도한다. 1초보다 작은 값으로 설정되어 있으면 무조건 1초로 가정한다. |
Value Type |
nonNegativeLongType
|
Value Type Description | 0 이상의 Long 값이다. |
Default Value |
5000
|
(505)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <reconnect-count-for-backup>
| |
Description | 이 설정은 webtob-backup 이 설정되어 있을 경우에만 사용한다. WebtoB와 JEUS 사이의 커넥션이 끊어진 경우에 재연결을 시도하는데, 이때 재연결을 시도하는 최대 횟수를 설정한다. 해당 횟수만큼 시도해도 연결되지 않으면 백업으로 설정된 WebtoB 로 Failover를 시도한다. 이값은 항상 0보다 커야 한다. |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
12
|
(506)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <send-buffer-size>
| |
Description | WebtoB로 연결할 TCP 소켓이나 UNIX 도메인 소켓 연결 시 설정할 sndbuf의 바이트 수이다. 이값을 너무 크게 잡으면 커널 메모리가 부족해서 소켓 생성이 되지 않을 수 있으므로 주의한다. |
Value Description | 바이트 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(507)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <receive-buffer-size>
| |
Description | WebtoB로 연결할 TCP 소켓이나 UNIX 도메인 소켓 연결 시 설정할 rcvbuf의 바이트 수이다. 이값을 너무 크게 잡으면 커널 메모리가 부족해서 소켓 생성이 되지 않을 수 있으므로 주의한다. |
Value Description | 바이트 |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(508)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <request-prefetch>
| |
Description | WebtoB Request prefetch 기능이다. 이 기능이 true이면 현재 처리하는 WebtoB Request 외에 1개의 다음 WebtoB Request를 미리 받아 Request Queue에 저장하여 처리 속도를 향상시킬 수 있다. 단, 웹 엔진이 abnormal하게 다운되는 경우 Prefetch된 WebtoB Request가 유실될 수 있다. |
Value Type |
boolean
|
Default Value |
false
|
(509)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <connection-type>
| |
Description | Response의 커넥션 타입을 강제로 설정한다. |
Value Type |
webConnectionType
|
Defined Value |
|
(510)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure>
| |
Description | WebtoB로 연결할 때 TLS와 같은 보안 프로토콜을 사용하는 설정이다. |
Value Type |
webtob-secure-type
|
Child Elements |
(511)
(512)
(513)
(514)
(515)
(516)
(517)
(518)
|
(511)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <trust-store-file-path>
| |
Description | WebtoB 인증서가 저장된 파일을 지정한다. 절대 경로, 상대 경로 모두 허용된다. 상대 경로의 경우, ${JEUS_HOME}/domains/${DOMAIN_NAME}/config/servlet을 기준으로 파일을 찾는다. |
Value Type |
token
|
(512)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <trust-store-file-password>
| |
Description | <trust-store-file-path>에 지정된 파일을 열기 위한 암호다. {DES}FQrLbQ/D8O1lDVS71L28rw==와 같은 형식으로 적기를 권장한다. |
Value Type |
token
|
(513)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <trust-store-file-type>
| |
Description | <truststore-file-path>에 지정된 파일의 형식이다. 일반적으로 JKS(Java KeyStore 형식) 또는 PKCS12 형식을 쓴다. 기본값은 JKS이다. |
Value Type |
token
|
Default Value |
JKS
|
(514)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <key-store-file-path>
| |
Description | 비밀키, 그에 매칭되는 인증서가 저장된 파일을 지정한다. WebtoB 쪽에서 JEUS를 인증하기 위해서 Client Authentication 기능을 사용하는 경우, 이 파일이 필요하다. 절대 경로, 상대 경로 모두 허용된다. 상대 경로의 경우, ${JEUS_HOME}/domains/${DOMAIN_NAME}/config/servlet을 기준으로 파일을 찾는다. |
Value Type |
token
|
(515)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <key-store-file-password>
| |
Description | <key-store-file-path>에 지정된 파일을 열기 위한 암호다. <key-store-file-path>가 설정될 경우 반드시 필요하다. {DES}FQrLbQ/D8O1lDVS71L28rw==와 같은 형식으로 적기를 권장한다. |
Value Type |
token
|
(516)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <private-key-password>
| |
Description | <key-store-file-path>로 지정된 파일에 저장된 비밀키의 암호다. 이 값을 설정하지 않을 경우에는 <key-store-file-password> 값을 사용한다. 이 암호는 javax.net.ssl.KeyManagerFactory 구현체 내부에서 해당 비밀키를 접근할 때 사용할 것이다. {DES}FQrLbQ/D8O1lDVS71L28rw==와 같은 형식으로 적기를 권장한다. |
Value Type |
token
|
(517)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <key-store-file-type>
| |
Description | <key-store-file-path>에 지정된 파일의 형식이다. 일반적으로 JKS(Java key-store 형식) 또는 PKCS12 형식을 쓴다. 기본값은 JKS이다. |
Value Type |
token
|
Default Value |
JKS
|
(518)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <secure-protocol-name>
| |
Description | 서버와 통신할 때 사용할 통신 보안 프로토콜을 선택한다. javax.net.ssl.SSLContext#getInstance(String protocol)을 통해서 javax.net.ssl.SSLContext를 생성할 때 사용한다. 기본값으로 TLS이다. |
Value Type |
token
|
Default Value |
TLS
|
(519)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <trust-manager-factory-algorithm-name>
| |
Description | 인증서를 다루는 javax.net.ssl.TrustManagerFactory를 생성할 때 사용하는 알고리듬을 선택한다. 참고로 JEUS는 별도의 JSSE Provider를 제공하지 않는다. 아무 것도 설정하지 않으면 JVM 벤더에 따른 기본값으로 사용한다. |
Value Type |
token
|
(520)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <secure> <key-manager-factory-algorithm-name>
| |
Description | 비밀키를 다루는 javax.net.ssl.KeyManagerFactory를 생성할 때 사용하는 알고리듬을 선택한다. 참고로 JEUS는 별도의 JSSE Provider를 제공하지 않는다. 아무 것도 설정하지 않으면 JVM 벤더에 따른 기본값으로 사용한다. WebtoB 쪽에서 JEUS를 인증하기 위해서 Client Authentication 기능을 사용하는 경우에 사용한다. |
Value Type |
token
|
(521)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup>
| |
Description | JEUS와 연결되는 WebtoB가 어떤 이유로든 정상 서비스가 불가능할 경우, 이를 대신하여 서비스를 해줄 WebtoB를 설정한다. |
Value Type |
webtob-backupType
|
Child Elements |
(522)
(525)
|
(522)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <network-address>
| |
Description | WebtoB TCP/IP 주소 정보를 설정한다. |
Value Type |
webtob-ip-addressType
|
Child Elements |
(523)
(524)
|
(523)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <network-address> <port>
| |
Description | WebtoB에 접속할 포트이다. 이 포트 번호는 WebtoB 설정 파일의 JSVPORT 값과 일치해야 한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(524)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <network-address> <ip-address>
| |
Description | WebtoB의 IP 주소를 설정한다. |
Value Type |
token
|
Default Value |
localhost
|
(525)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address>
| |
Description | UNIX 도메인 소켓 정보 또는 Windows에서 HTH 프로세스와의 소켓 통신을 하기 위한 정보를 설정한다. |
Value Type |
webtob-domain-socket-addressType
|
Child Elements |
(526)
(527)
|
(526)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-home>
| |
Description | WebtoB의 홈 디렉터리를 설정한다. 이 설정값은 WebtoB 홈 디렉터리를 나타내는 OS 환경변수(JEUS_WSDIR 또는 WEBTOBDIR)를 Override한다. |
Value Description | 마지막에 경로 분리자가 붙는 절대 디렉터리 경로로 설정한다(Windows의 경우 "\", UNIX의 경우 "/"). |
Value Type |
token
|
(527)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport>
| |
Description | Windows에서 WebtoB HTH 프로세스와의 IPC 통신을 하기 위한 포트를 설정한다. OS 환경변수로 설정된 WEBTOB_IPCBASEPORT를 치환한다. |
Value Type |
composite-listenerType
|
Value Type Description | 0 이상의 Int 값이다. |
Default Value |
6666
|
Child Elements |
(528)
(529)
(530)
(531)
(532)
(533)
(534)
(535)
(536)
(537)
|
(528)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <name>
| |
Description | 해당 Listener 또는 Connector를 식별할 수 있는 유일한 이름을 설정한다. |
Value Type |
valuableToken
|
(529)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <output-buffer-size>
| |
Description | out.write()메소드들로부터 출력되는 JSP/Servlet 출력물을 임시 저장하는 출력 Buffer의 크기를 설정한다. 이 Buffer가 가득 차면 자동으로 클라이언트에게 데이터를 보낸다. 기본값은 AJP13의 경우 8192이다. 다른 프로토콜의 경우 listener socket의 send buffer 크기를 따르되, 최소 8192, 최대 16384을 기본값으로 한다. |
Value Description | Byte 단위의 Buffer 크기를 설정한다. |
Value Type |
nonNegativeIntType
|
Value Type Description | 0 이상의 Int 값이다. |
(530)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <postdata-read-timeout>
| |
Description | 웹 서버/웹 클라이언트로부터 Post 데이터를 읽어올 때 기다리는 최대시간을 설정한다. |
Value Description | 밀리세컨드 |
Value Type |
positiveIntType
|
Value Type Description | 1 이상의 Integer 값이다. |
Default Value |
30000
|
(531)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-post-size>
| |
Description | POST 요청의 데이터 크기 제한을 설정한다. 설정값 보다 큰 데이터를 처리하지 않음으로 다른 요청이 특정 요청(공격)들로부터 보호될 수 있는 기능을 제공한다. |
Value Description | Byte 단위로 설정한다. |
Value Type |
long
|
Default Value |
-1
|
(532)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-parameter-count>
| |
Description | 웹 엔진에서 자동적으로 Parsing될 파라미터와 값의 쌍(GET과 POST 모두 포함)의 최대 숫자이다. 이 제한을 넘어가는 파라미터와 값의 쌍을 가진 요청은 더 이상 처리되지 않는다. 0보다 작은 값으로 설정되면 제한이 없음을 의미한다. 설정하지 않으면 기본값인 -1로 설정되고 제한이 없게 된다. |
Value Description | 허용하는 최대 파라미터와 값의 쌍의 개수 |
Value Type |
int
|
Default Value |
-1
|
(533)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-header-count>
| |
Description | 한 요청이 포함할 수 있는 최대 header의 개수를 설정한다. 설정된 값을 넘어가면 해당 요청은 처리하지 않는다. 0보다 작은 값을 설정할 경우, 제한이 없음을 나타낸다. |
Value Description | 허용하는 최대 header의 개수 |
Value Type |
int
|
Default Value |
-1
|
(534)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-header-size>
| |
Description | 요청의 HTTP header 최대 크기를 설정한다. 해당 설정값을 넘어가는 요청의 경우는 처리하지 않는다. 이 설정은 서버가 필요로 하는 메모리보다 많은 양을 할당하도록 하는 DOS 공격을 방지하여 다른 요청들에게 빠른 응답을 보장해 줄 수 있는 기능을 제공한다. 기본값은 8096(8 KByte)이고, 0보다 작게 설정할 경우는 제한이 없다. |
Value Description | Byte 단위의 한 Request header에 대한 최대 크기 |
Value Type |
int
|
Default Value |
-1
|
(535)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <max-querystring-size>
| |
Description | 요청에 포함된 Query String의 최대 크기를 설정한다. 설정된 크기 이상의 Query String이 들어온다면 해당 요청은 처리하지 않는다. 기본값은 8192 Byte이고, 이 설정값을 포함한 Request Line의 총 사이즈가 64 kbyte를 넘을 수 없다. |
Value Description | Byte 단위의 한 요청에 포함된 Query string의 최대 크기 |
Value Type |
int
|
Default Value |
8192
|
(536)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <server-access-control>
| |
Description | 서버에 대한 접근 제어 여부를 설정한다. true로 설정하면 허용된 서버(Allowed Server에서 지정된)만 해당 Listener에 접속할 수 있다. |
Value Description | Boolean 타입으로, 설정을 활성화 또는 비활성화한다. |
Value Type |
boolean
|
Default Value |
false
|
(537)
<domain> <servers> <server> <web-engine> <web-connections> <composite-listener> <webtob-connector> <webtob-backup> <domain-socket-address> <webtob-ipcbaseport> <allowed-server>
| |
Description | Listener에 접속하려는 하나의 서버 IP 주소를 설정한다. Server Access Control의 설정값이 true일 경우에만 사용되고, 설정되지 않은 서버로부터 온 모든 요청들은 거절된다. |
Value Description | 해당 Listener에 연결이 허용되는 서버의 IP 주소 |
Value Type |
token
|
[예 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>