source: installer/resources/eepsite/jetty.xml @ 1ac8d99

Last change on this file since 1ac8d99 was 1ac8d99, checked in by zzz <zzz@…>, 6 years ago

i2ptunnel: Send HTTP server port 443 traffic to the server
transparently, to support HTTPS over the same tunnel,
when so configured.
Jetty: Add extensive help to jetty-ssl.xml for setting
up SSL on the same server.

  • Property mode set to 100644
File size: 15.4 KB
Line 
1<?xml version="1.0" encoding="UTF-8" ?> 
2<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
3
4<!-- ========================================================================= -->
5<!-- This file configures the Jetty server.                                    -->
6<!-- All changes require a restart of I2P.                                     -->
7<!--                                                                           -->
8<!-- Commonly changed settings:                                                -->
9<!--   * host: Change 127.0.0.1 to 0.0.0.0 in the addListener section          -->
10<!--           to access the server directly (bypassing i2p)                   -->
11<!--           from other computers.                                           -->
12<!--   * port: Default 7658 in the addConnector section                         -->
13<!--   * docroot: Change the ResourceBase in the contexts/base-context.xml file -->
14<!--           to serve files from a different location.                       -->
15<!--   * threads: Raise maximumPoolSize in the ThreadPool section              -->
16<!--           if you have a high-traffic site and get a lot of warnings.      -->
17<!--   * Uncomment the addWebApplications section to use to enable             -->
18<!--           war files placed in the webapps/ dir.                           -->
19<!--   * Uncomment the line to allow Jetty to follow symlinks                  -->
20<!--                                                                           -->
21<!-- I2P uses Jetty 7. If you need web server features not found               -->
22<!-- in Jetty 7, you may install and run Jetty 7 or 8 in a different JVM       -->
23<!-- or run any other web server such as Apache. If you do run another web     -->
24<!-- server instead, be sure and disable the Jetty 6 server for your           -->
25<!-- eepsite on http://127.0.0.1:7657/configclients.jsp .                      -->
26<!--                                                                           -->
27<!-- Jetty now uses the I2P logging system rather than wrapper.log.            -->
28<!-- Use the log override org.eclipse.jetty.server.Server to adjust the log level.  -->
29<!--                                                                           -->
30<!-- Note that the XML encoding for this file is UTF-8.                        -->
31<!--                                                                           -->
32<!-- If you have a 'split' directory installation, with configuration          -->
33<!-- files in ~/.i2p (Linux) or %APPDATA%\I2P (Windows), be sure to            -->
34<!-- edit the file in the configuration directory, NOT the install directory.  -->
35<!-- When running as a Linux daemon, the configuration directory is            -->
36<!-- /var/lib/i2p and the install directory is /usr/share/i2p .                -->
37<!--                                                                           -->
38<!-- ========================================================================= -->
39
40<!-- =============================================================== -->
41<!-- Configure the Jetty Server                                      -->
42<!--                                                                 -->
43<!-- Documentation of this file format can be found at:              -->
44<!-- http://docs.codehaus.org/display/JETTY/jetty.xml                -->
45<!--                                                                 -->
46<!-- =============================================================== -->
47
48
49<Configure id="Server" class="org.eclipse.jetty.server.Server">
50
51    <!-- =========================================================== -->
52    <!-- Server Thread Pool                                          -->
53    <!-- =========================================================== -->
54    <Set name="ThreadPool">
55
56      <!-- PICK ONE -->
57
58      <!--
59           Recommended.
60           Two threads are used for the Connector and Acceptor.
61           Concurrent requests above maxThreads + queue size - 2 will be rejected and logged.
62           Due to the way QTP works, queue size should be larger than maxThreads.
63           Increase all values for high-traffic eepsites.
64
65           ref:
66           https://wiki.eclipse.org/Jetty/Howto/High_Load
67           http://trac.i2p2.i2p/ticket/1395
68       -->
69      <New class="org.eclipse.jetty.util.thread.QueuedThreadPool">
70        <Arg>
71           <New class="java.util.concurrent.LinkedBlockingQueue">
72              <Arg type="int">40</Arg>
73           </New>
74        </Arg>
75        <Set name="minThreads">3</Set>
76        <Set name="maxThreads">20</Set>
77        <Set name="maxIdleTimeMs">60000</Set>
78        <Set name="daemon">true</Set>
79        <Set name="name">Eepsite Jetty</Set>
80      </New>
81
82      <!-- Optional Java 5 bounded threadpool with job queue
83           Requests above the max will be rejected and logged.
84           High-traffic sites should increase maximumPoolSize.
85
86           Args are:
87             corePoolSize (should be at least 3)
88             maximumPoolSize
89             keepAliveTime (milliseconds)
90             timeout (TimeUnit)
91             queue (BlockingQueue)
92
93           Not recommended.
94           ref:
95           http://trac.i2p2.i2p/ticket/1395
96           http://docs.oracle.com/javase/6/docs/api/java/util/concurrent/ThreadPoolExecutor.html
97       -->
98     <!--
99      <New class="org.eclipse.jetty.util.thread.ExecutorThreadPool">
100        <Arg type="int">3</Arg>
101        <Arg type="int">20</Arg>
102        <Arg type="long">60000</Arg>
103        <Arg>
104            <Call class="java.util.concurrent.TimeUnit" name="valueOf" >
105                <Arg>MILLISECONDS</Arg>
106            </Call>
107        </Arg>
108        <Arg>
109            <New class="java.util.concurrent.SynchronousQueue" />
110        </Arg>
111      </New>
112     -->
113    </Set>
114
115
116
117    <!-- =========================================================== -->
118    <!-- Set connectors                                              -->
119    <!-- =========================================================== -->
120    <!-- One of each type!                                           -->
121    <!-- =========================================================== -->
122
123    <!-- Use this connector for many frequently idle connections
124         and for threadless continuations.
125         Not recommended on Java 5 - comment this out, and uncomment the
126         SocketConnector below.
127         Do not use for gij or JamVM - comment this out, and uncomment the
128         SocketConnector below.
129    -->   
130    <Call name="addConnector">
131      <Arg>
132          <New class="org.eclipse.jetty.server.nio.SelectChannelConnector">
133            <Set name="host">127.0.0.1</Set>
134            <Set name="port">7658</Set>
135            <Set name="maxIdleTime">600000</Set>
136            <Set name="Acceptors">1</Set>
137            <Set name="statsOn">false</Set>
138            <Set name="confidentialPort">8443</Set>
139            <Set name="lowResourcesConnections">5000</Set>
140            <Set name="lowResourcesMaxIdleTime">5000</Set>
141            <Set name="useDirectBuffers">false</Set>
142          </New>
143      </Arg>
144    </Call>
145
146    <!-- Recommended to use this connector on Java 5, as
147         Jetty 6 and Java 5 NIO don't play well together.
148    -->
149    <!--
150    <Call name="addConnector">
151      <Arg>
152          <New class="org.eclipse.jetty.server.bio.SocketConnector">
153            <Set name="host">127.0.0.1</Set>
154            <Set name="port">7658</Set>
155            <Set name="maxIdleTime">600000</Set>
156            <Set name="Acceptors">1</Set>
157            <Set name="statsOn">false</Set>
158            <Set name="confidentialPort">8443</Set>
159          </New>
160      </Arg>
161    </Call>
162    -->
163
164    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
165    <!-- To add a HTTPS SSL listener                                     -->
166    <!-- see jetty-ssl.xml to add an ssl connector. use                  -->
167    <!-- To enable this change clients.config args to be:                -->
168    <!--                                                                 -->
169    <!--   clientApp3.args=etc/jetty.xml etc/jetty-ssl.xml               -->
170    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
171
172    <!-- =========================================================== -->
173    <!-- Set up global session ID manager                            -->
174    <!-- =========================================================== -->
175    <!--
176    <Set name="sessionIdManager">
177      <New class="org.eclipse.jetty.server.session.HashSessionIdManager">
178        <Set name="workerName">node1</Set>
179      </New>
180    </Set>
181    -->
182
183    <!-- =========================================================== -->
184    <!-- Set handler Collection Structure                            --> 
185    <!-- =========================================================== -->
186    <Set name="handler">
187      <New id="Handlers" class="org.eclipse.jetty.server.handler.HandlerCollection">
188        <Set name="handlers">
189         <Array type="org.eclipse.jetty.server.Handler">
190           <Item>
191             <New id="Contexts" class="org.eclipse.jetty.server.handler.ContextHandlerCollection"/>
192           </Item>
193           <Item>
194             <New id="DefaultHandler" class="org.eclipse.jetty.server.handler.DefaultHandler"/>
195           </Item>
196           <Item>
197             <New id="RequestLog" class="org.eclipse.jetty.server.handler.RequestLogHandler"/>
198           </Item>
199         </Array>
200        </Set>
201      </New>
202    </Set>
203
204    <!-- =============================================================== -->
205    <!-- Create the deployment manager                                   -->
206    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
207    <!-- The deplyment manager handles the lifecycle of deploying web    -->
208    <!-- applications. Apps are provided by instances of the             -->
209    <!-- AppProvider interface.  Typically these are provided by         -->
210    <!-- one or more of:                                                 -->
211    <!--   jetty-webapps.xml       - monitors webapps for wars and dirs  -->
212    <!--   jetty-contexts.xml      - monitors contexts for context xml   -->
213    <!--   jetty-templates.xml     - monitors contexts and templates     -->
214    <!-- =============================================================== -->
215    <Call name="addBean">
216      <Arg>
217        <New id="DeploymentManager" class="org.eclipse.jetty.deploy.DeploymentManager">
218          <Set name="contexts">
219            <Ref id="Contexts" />
220          </Set>
221          <Call name="setContextAttribute">
222            <Arg>org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern</Arg>
223            <Arg>.*/.*jsp-api-[^/]*\.jar$|.*/.*jsp-[^/]*\.jar$|.*/.*taglibs[^/]*\.jar$</Arg>
224          </Call>
225        </New>
226      </Arg>
227    </Call>
228
229    <!-- =========================================================== -->
230    <!-- Configure the context deployer                              -->
231    <!-- A context deployer will deploy contexts described in        -->
232    <!-- configuration files discovered in a directory.              -->
233    <!-- The configuration directory can be scanned for hot          -->
234    <!-- deployments at the configured scanInterval.                 -->
235    <!--                                                             -->
236    <!-- This deployer is configured to deploy contexts configured   -->
237    <!-- in the $JETTY_HOME/contexts directory                       -->
238    <!--                                                             -->
239    <!-- =========================================================== -->
240    <Ref id="DeploymentManager">
241      <Call name="addAppProvider">
242        <Arg>
243          <New class="org.eclipse.jetty.deploy.providers.ContextProvider">
244            <Set name="monitoredDirName">./eepsite/contexts</Set>
245            <Set name="scanInterval">120</Set>
246          </New>
247        </Arg>
248      </Call>
249    </Ref>
250
251    <!-- =========================================================== -->
252    <!-- Configure the webapp deployer.                              -->
253    <!-- A webapp  deployer will deploy standard webapps discovered  -->
254    <!-- in a directory at startup, without the need for additional  -->
255    <!-- configuration files.    It does not support hot deploy or   -->
256    <!-- non standard contexts (see ContextDeployer above).          -->
257    <!--                                                             -->
258    <!-- This deployer is configured to deploy webapps from the      -->
259    <!-- $JETTY_HOME/webapps directory                               -->
260    <!--                                                             -->
261    <!-- Normally only one type of deployer need be used.            -->
262    <!--                                                             -->
263    <!-- =========================================================== -->
264    <Ref id="DeploymentManager">
265      <Call id="webappprovider" name="addAppProvider">
266        <Arg>
267          <New class="org.eclipse.jetty.deploy.providers.WebAppProvider">
268            <Set name="monitoredDirName">./eepsite/webapps</Set>
269            <Set name="parentLoaderPriority">false</Set>
270            <Set name="extractWars">false</Set>
271            <Set name="defaultsDescriptor">./eepsite/etc/webdefault.xml</Set>
272          </New>
273        </Arg>
274      </Call>
275    </Ref>
276
277    <!-- =========================================================== -->
278    <!-- Configure Authentication Realms                             -->
279    <!-- Realms may be configured for the entire server here, or     -->
280    <!-- they can be configured for a specific web app in a context  -->
281    <!-- configuration (see $(jetty.home)/contexts/test.xml for an   -->
282    <!-- example).                                                   -->
283    <!-- =========================================================== -->
284  <!-- UNCOMMENT TO ACTIVATE
285    <Set name="UserRealms">
286      <Array type="org.eclipse.jetty.security.LoginService">
287        <Item>
288          <New class="org.eclipse.jetty.security.HashLoginService">
289            <Set name="name">Test Realm</Set>
290            <Set name="config">./eepsite/etc/realm.properties</Set>
291            <Set name="refreshInterval">0</Set>
292          </New>
293        </Item>
294      </Array>
295    </Set>
296  -->
297
298    <!-- =========================================================== -->
299    <!-- Configure Request Log                                       -->
300    <!-- Request logs  may be configured for the entire server here, -->
301    <!-- or they can be configured for a specific web app in a       -->
302    <!-- contexts configuration (see $(jetty.home)/contexts/test.xml -->
303    <!-- for an example).                                            -->
304    <!-- =========================================================== -->
305    <Ref id="RequestLog">
306      <Set name="requestLog">
307        <New id="RequestLogImpl" class="net.i2p.jetty.I2PRequestLog">
308          <Set name="filename">./eepsite/logs/yyyy_mm_dd.request.log</Set>
309          <Set name="filenameDateFormat">yyyy_MM_dd</Set>
310          <Set name="retainDays">90</Set>
311          <Set name="append">true</Set>
312          <Set name="extended">false</Set>
313          <Set name="logCookies">false</Set>
314          <Set name="LogTimeZone">GMT</Set>
315        </New>
316      </Set>
317    </Ref>
318
319    <!-- =========================================================== -->
320    <!-- extra options                                               -->
321    <!-- =========================================================== -->
322    <Set name="stopAtShutdown">true</Set>
323    <Set name="sendServerVersion">false</Set>
324    <Set name="sendDateHeader">true</Set>
325    <Set name="gracefulShutdown">1000</Set>
326
327</Configure>
Note: See TracBrowser for help on using the repository browser.