This chapter explains the tags related to web engine connection (web listener, web server) in domain.xml.
XML schema file:
JEUS_HOME/lib/schemas/jeus/web-engine.xsd
XML references are configured in the following format.
XML Schema/XML Tree: Summarizes all the tags of XML configuration file. Each node is defined in the following format.
Tag reference enables quick search for tags. Each tag is attached with index numbers ( ex: (11) ). Tags are explained with this number in tag reference.
The XML tag name defined in the XML schema is expressed in the format of <tag name>.
Tags are set with cardinality defined in XML schema.
“?” is for 0 or 1 element, “+” is for 1 or more elements, “*” is for 0 or more elements, (no symbol) is for exactly one element
Several tags have "P" character, meaning that they are the tags related to performance. These tags are used to tune the setting.
Element Reference: Explains XML tags in the tree.
Dynamic: Allowed to change the configuration dynamically.
Non-Dynamic: Not allowed to change the configuration dynamically. This is expressed only for the special case to comment out.
Description: A short description for tags.
Value Description: The value and type.
Value Type: Data type of the value. (ex: String)
Value Type Description: Description for the data type of the value.
Default Value: The value to be used by default when the XML is not used.
Defined Value: The default value.
Example: The XML tag example.
Performance Recommendation: The value recommended to improve performance.
Child Elements:The tags contained in its own tag element.
(44) <listeners> ?
(45) <base> ?
(46) <listener> *
(47) <name>
(48) <listen-address> ?
(49) <listen-port> ?
(50) <selectors> ?
(51) <use-dual-selector> ?
(52) <backlog> ?
(53) <ssl> ?
(54) <client-auth> ?
(55) <ssl-protocol> ?
(56) <use-alt-jsse-provider> ?
(57) <cipher-suite> *
(58) <keystore-file> ?
(59) <keystore-pass> ?
(60) <keystore-keypassword> ?
(61) <keystore-type> ?
(62) <key-management-algorithm> ?
(63) <key-alias> ?
(64) <truststore-file> ?
(65) <truststore-pass> ?
(66) <truststore-type> ?
(67) <trust-management-algorithm> ?
(68) <crl-file> ?
(69) <keep-alive-timeout> ?
(70) <read-timeout> ?
(71) <reserved-thread-num> ?
(225) <web-connections> ?
(226) <http-listener> *
(227) <name>
(228) <thread-pool>
(229) <min>
(230) <max>
(231) <max-idle-time> ?
(232) <max-queue> ?
(233) <thread-state-notify> ?
(234) <max-thread-active-time> ?
(235) <interrupt-thread> ?
(236) <active-timeout-notification> ?
(237) <notify-threshold-ratio> ?
(238) <notify-subject> ?
(239) <restart-threshold-ratio> ?
(240) <restart-subject> ?
(241) <output-buffer-size> ?
(242) <postdata-read-timeout> ?
(243) <max-post-size> ?
(244) <max-parameter-count> ?
(245) <max-header-count> ?
(246) <max-header-size> ?
(247) <max-querystring-size> ?
(248) <server-access-control> ?
(249) <allowed-server> *
(250) <server-listener-ref>
(251) <http2> ?
(252) <settings-enable-push> ?
(254) <settings-max-frame-size> ?
(255) <settings-ack-timeout> ?
(256) <connection-type> ?
(257) <webtob-connector> *
(258) <name>
(259) <thread-pool>
(260) <min>
(261) <max>
(262) <max-idle-time> ?
(263) <max-queue> ?
(264) <thread-state-notify> ?
(265) <max-thread-active-time> ?
(266) <interrupt-thread> ?
(267) <active-timeout-notification> ?
(268) <notify-threshold-ratio> ?
(269) <notify-subject> ?
(270) <restart-threshold-ratio> ?
(271) <restart-subject> ?
(272) <output-buffer-size> ?
(273) <postdata-read-timeout> ?
(274) <max-post-size> ?
(275) <max-parameter-count> ?
(276) <max-header-count> ?
(277) <max-header-size> ?
(278) <max-querystring-size> ?
(279) <wjp-version> ?
(280) <registration-id>
(281) <hth-count> ?
(282) <connection-count>
(283) <threshold> ?
(284) <use-nio> ?
(285) <network-address>
(286) <port>
(287) <ip-address> ?
(288) <domain-socket-address>
(289) <webtob-home> ?
(290) <webtob-ipcbaseport> ?
(291) <read-timeout> ?
(292) <reconnect-interval> ?
(293) <reconnect-count-for-backup> ?
(294) <send-buffer-size> ?
(295) <receive-buffer-size> ?
(296) <request-prefetch> ?
(297) <connection-type> ?
(298) <secure> ?
(299) <trust-store-file-path>
(301) <trust-store-file-type> ?
(302) <key-store-file-path> ?
(303) <key-store-file-password> ?
(304) <private-key-password> ?
(305) <key-store-file-type> ?
(306) <secure-protocol-name> ?
(309) <webtob-backup> ?
(310) <network-address>
(311) <port>
(312) <ip-address> ?
(313) <domain-socket-address>
(314) <webtob-home> ?
(315) <webtob-ipcbaseport> ?
(316) <ajp13-listener> *
(317) <name>
(318) <thread-pool>
(319) <min>
(320) <max>
(321) <max-idle-time> ?
(322) <max-queue> ?
(323) <thread-state-notify> ?
(324) <max-thread-active-time> ?
(325) <interrupt-thread> ?
(326) <active-timeout-notification> ?
(327) <notify-threshold-ratio> ?
(328) <notify-subject> ?
(329) <restart-threshold-ratio> ?
(330) <restart-subject> ?
(331) <output-buffer-size> ?
(332) <postdata-read-timeout> ?
(333) <max-post-size> ?
(334) <max-parameter-count> ?
(335) <max-header-count> ?
(336) <max-header-size> ?
(337) <max-querystring-size> ?
(338) <server-access-control> ?
(339) <allowed-server> *
(340) <server-listener-ref>
(341) <read-timeout> ?
(342) <tcp-listener> *
(343) <name>
(344) <thread-pool>
(345) <min>
(346) <max>
(347) <max-idle-time> ?
(348) <max-queue> ?
(349) <thread-state-notify> ?
(350) <max-thread-active-time> ?
(351) <interrupt-thread> ?
(352) <active-timeout-notification> ?
(353) <notify-threshold-ratio> ?
(354) <notify-subject> ?
(355) <restart-threshold-ratio> ?
(356) <restart-subject> ?
(357) <output-buffer-size> ?
(358) <postdata-read-timeout> ?
(359) <max-post-size> ?
(360) <max-parameter-count> ?
(361) <max-header-count> ?
(362) <max-header-size> ?
(363) <max-querystring-size> ?
(364) <server-access-control> ?
(365) <allowed-server> *
(366) <server-listener-ref>
(367) <connection-type> ?
(369) <tmax-connector> *
(370) <name>
(371) <thread-pool>
(372) <min>
(373) <max>
(374) <max-idle-time> ?
(375) <max-queue> ?
(376) <thread-state-notify> ?
(377) <max-thread-active-time> ?
(378) <interrupt-thread> ?
(379) <active-timeout-notification> ?
(380) <notify-threshold-ratio> ?
(381) <notify-subject> ?
(382) <restart-threshold-ratio> ?
(383) <restart-subject> ?
(384) <output-buffer-size> ?
(385) <postdata-read-timeout> ?
(386) <max-post-size> ?
(387) <max-parameter-count> ?
(388) <max-header-count> ?
(389) <max-header-size> ?
(390) <max-querystring-size> ?
(391) <connection-type> ?
(392) <port>
(393) <server-group-name>
(394) <server-name>
(396) <read-timeout> ?
(397) <reconnect-interval> ?
(398) <reconnect-count-for-backup> ?
(399) <tmax-address> ?
(400) <tmax-version> ?
(401) <server-type> ?
(402) <xaresource-class> ?
(403) <tmax-backup-address> ?
(404) <tmax-backup-port> ?
(44)
<
domain
><
servers
><
server
>
<listeners>
| |
| Description | Properties required for handling socket connection requests and the socket listener used by the server's JEUS system. |
| Value Type | listenersType |
| Child Elements |
(46)
(47)
|
(225)
<
domain
><
servers
><
server
><
web-engine
>
<web-connections>
| |
| Description | Use this to configure the connection with a web server, or configures the web listener provided independently in JEUS. |
| Value Type | web-connectionsType |
| Child Elements |
(227)
(258)
(317)
(343)
(370)
|
[Example 8.1] Example File
<?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>