source: installer/resources/eepsite/jetty.xml @ 18b61e7

Last change on this file since 18b61e7 was 18b61e7, checked in by zzz <zzz@…>, 4 years ago

Config files, eepsite help: Add path information for OS X
and Windows as a service. (ticket #1495)

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