source: installer/resources/eepsite/jetty.xml @ 1773fc0

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

Add more clues to file locations in default config files

  • Property mode set to 100644
File size: 16.5 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  <!-- Add a HTTPS SSL listener on port 8443                               -->
173  <!--                                                                     -->
174  <!-- In the unlikely event you would want SSL support for your eepsite.  -->
175  <!-- You would need to generate a selfsigned certificate in a keystore   -->
176  <!-- in ~/.i2p/eepsite/keystore.ks, for example with the command line:   -->
177  <!--
178       keytool -genkey -storetype JKS -keystore ~/.i2p/eepsite/etc/keystore.ks -storepass changeit -alias console -dname CN=xyz123.eepsite.i2p.net,OU=Eepsite,O=I2P Anonymous Network,L=XX,ST=XX,C=XX -validity 3650 -keyalg DSA -keysize 1024 -keypass myKeyPassword
179   -->
180  <!-- Change the CN and key password in the example, of course.           -->
181  <!-- You wouldn't want to open this up to the regular internet,          -->
182  <!-- would you?? Untested and not recommended.                           -->
183  <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
184
185    <!-- =========================================================== -->
186    <!-- Set up global session ID manager                            -->
187    <!-- =========================================================== -->
188    <!--
189    <Set name="sessionIdManager">
190      <New class="org.eclipse.jetty.server.session.HashSessionIdManager">
191        <Set name="workerName">node1</Set>
192      </New>
193    </Set>
194    -->
195
196    <!-- =========================================================== -->
197    <!-- Set handler Collection Structure                            --> 
198    <!-- =========================================================== -->
199    <Set name="handler">
200      <New id="Handlers" class="org.eclipse.jetty.server.handler.HandlerCollection">
201        <Set name="handlers">
202         <Array type="org.eclipse.jetty.server.Handler">
203           <Item>
204             <New id="Contexts" class="org.eclipse.jetty.server.handler.ContextHandlerCollection"/>
205           </Item>
206           <Item>
207             <New id="DefaultHandler" class="org.eclipse.jetty.server.handler.DefaultHandler"/>
208           </Item>
209           <Item>
210             <New id="RequestLog" class="org.eclipse.jetty.server.handler.RequestLogHandler"/>
211           </Item>
212         </Array>
213        </Set>
214      </New>
215    </Set>
216
217    <!-- =============================================================== -->
218    <!-- Create the deployment manager                                   -->
219    <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
220    <!-- The deplyment manager handles the lifecycle of deploying web    -->
221    <!-- applications. Apps are provided by instances of the             -->
222    <!-- AppProvider interface.  Typically these are provided by         -->
223    <!-- one or more of:                                                 -->
224    <!--   jetty-webapps.xml       - monitors webapps for wars and dirs  -->
225    <!--   jetty-contexts.xml      - monitors contexts for context xml   -->
226    <!--   jetty-templates.xml     - monitors contexts and templates     -->
227    <!-- =============================================================== -->
228    <Call name="addBean">
229      <Arg>
230        <New id="DeploymentManager" class="org.eclipse.jetty.deploy.DeploymentManager">
231          <Set name="contexts">
232            <Ref id="Contexts" />
233          </Set>
234          <Call name="setContextAttribute">
235            <Arg>org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern</Arg>
236            <Arg>.*/.*jsp-api-[^/]*\.jar$|.*/.*jsp-[^/]*\.jar$|.*/.*taglibs[^/]*\.jar$</Arg>
237          </Call>
238        </New>
239      </Arg>
240    </Call>
241
242    <!-- =========================================================== -->
243    <!-- Configure the context deployer                              -->
244    <!-- A context deployer will deploy contexts described in        -->
245    <!-- configuration files discovered in a directory.              -->
246    <!-- The configuration directory can be scanned for hot          -->
247    <!-- deployments at the configured scanInterval.                 -->
248    <!--                                                             -->
249    <!-- This deployer is configured to deploy contexts configured   -->
250    <!-- in the $JETTY_HOME/contexts directory                       -->
251    <!--                                                             -->
252    <!-- =========================================================== -->
253    <Ref id="DeploymentManager">
254      <Call name="addAppProvider">
255        <Arg>
256          <New class="org.eclipse.jetty.deploy.providers.ContextProvider">
257            <Set name="monitoredDirName">./eepsite/contexts</Set>
258            <Set name="scanInterval">120</Set>
259          </New>
260        </Arg>
261      </Call>
262    </Ref>
263
264    <!-- =========================================================== -->
265    <!-- Configure the webapp deployer.                              -->
266    <!-- A webapp  deployer will deploy standard webapps discovered  -->
267    <!-- in a directory at startup, without the need for additional  -->
268    <!-- configuration files.    It does not support hot deploy or   -->
269    <!-- non standard contexts (see ContextDeployer above).          -->
270    <!--                                                             -->
271    <!-- This deployer is configured to deploy webapps from the      -->
272    <!-- $JETTY_HOME/webapps directory                               -->
273    <!--                                                             -->
274    <!-- Normally only one type of deployer need be used.            -->
275    <!--                                                             -->
276    <!-- =========================================================== -->
277    <Ref id="DeploymentManager">
278      <Call id="webappprovider" name="addAppProvider">
279        <Arg>
280          <New class="org.eclipse.jetty.deploy.providers.WebAppProvider">
281            <Set name="monitoredDirName">./eepsite/webapps</Set>
282            <Set name="parentLoaderPriority">false</Set>
283            <Set name="extractWars">false</Set>
284            <Set name="defaultsDescriptor">./eepsite/etc/webdefault.xml</Set>
285          </New>
286        </Arg>
287      </Call>
288    </Ref>
289
290    <!-- =========================================================== -->
291    <!-- Configure Authentication Realms                             -->
292    <!-- Realms may be configured for the entire server here, or     -->
293    <!-- they can be configured for a specific web app in a context  -->
294    <!-- configuration (see $(jetty.home)/contexts/test.xml for an   -->
295    <!-- example).                                                   -->
296    <!-- =========================================================== -->
297  <!-- UNCOMMENT TO ACTIVATE
298    <Set name="UserRealms">
299      <Array type="org.eclipse.jetty.security.LoginService">
300        <Item>
301          <New class="org.eclipse.jetty.security.HashLoginService">
302            <Set name="name">Test Realm</Set>
303            <Set name="config">./eepsite/etc/realm.properties</Set>
304            <Set name="refreshInterval">0</Set>
305          </New>
306        </Item>
307      </Array>
308    </Set>
309  -->
310
311    <!-- =========================================================== -->
312    <!-- Configure Request Log                                       -->
313    <!-- Request logs  may be configured for the entire server here, -->
314    <!-- or they can be configured for a specific web app in a       -->
315    <!-- contexts configuration (see $(jetty.home)/contexts/test.xml -->
316    <!-- for an example).                                            -->
317    <!-- =========================================================== -->
318    <Ref id="RequestLog">
319      <Set name="requestLog">
320        <New id="RequestLogImpl" class="net.i2p.jetty.I2PRequestLog">
321          <Set name="filename">./eepsite/logs/yyyy_mm_dd.request.log</Set>
322          <Set name="filenameDateFormat">yyyy_MM_dd</Set>
323          <Set name="retainDays">90</Set>
324          <Set name="append">true</Set>
325          <Set name="extended">false</Set>
326          <Set name="logCookies">false</Set>
327          <Set name="LogTimeZone">GMT</Set>
328        </New>
329      </Set>
330    </Ref>
331
332    <!-- =========================================================== -->
333    <!-- extra options                                               -->
334    <!-- =========================================================== -->
335    <Set name="stopAtShutdown">true</Set>
336    <Set name="sendServerVersion">false</Set>
337    <Set name="sendDateHeader">true</Set>
338    <Set name="gracefulShutdown">1000</Set>
339
340</Configure>
Note: See TracBrowser for help on using the repository browser.