Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGreg Wilkins2012-10-11 01:15:57 -0400
committerGreg Wilkins2012-10-11 01:15:57 -0400
commit8c3fa91b261d0a7caf151959d0bbcee2b17e6f40 (patch)
tree6f20e151f6ffa95a59ea686762643a2321159aea /jetty-server/src/main/config/etc/jetty.xml
parent20317fffeb9fd78e5543d55ca382165e7867cd88 (diff)
downloadorg.eclipse.jetty.project-8c3fa91b261d0a7caf151959d0bbcee2b17e6f40.tar.gz
org.eclipse.jetty.project-8c3fa91b261d0a7caf151959d0bbcee2b17e6f40.tar.xz
org.eclipse.jetty.project-8c3fa91b261d0a7caf151959d0bbcee2b17e6f40.zip
jetty-9 reverted to more start.ini rather than start.d usage as we will not be using plugins. More configuration documentation added
Diffstat (limited to 'jetty-server/src/main/config/etc/jetty.xml')
-rw-r--r--jetty-server/src/main/config/etc/jetty.xml91
1 files changed, 58 insertions, 33 deletions
diff --git a/jetty-server/src/main/config/etc/jetty.xml b/jetty-server/src/main/config/etc/jetty.xml
index b93c736b3a..7202e21049 100644
--- a/jetty-server/src/main/config/etc/jetty.xml
+++ b/jetty-server/src/main/config/etc/jetty.xml
@@ -1,24 +1,46 @@
<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">
-
<!-- =============================================================== -->
-<!-- Configure the Jetty Server -->
-<!-- -->
<!-- Documentation of this file format can be found at: -->
<!-- http://wiki.eclipse.org/Jetty/Reference/jetty.xml_syntax -->
<!-- -->
<!-- Additional configuration files are available in $JETTY_HOME/etc -->
-<!-- and can be mixed in. For example: -->
-<!-- java -jar start.jar etc/jetty-ssl.xml -->
+<!-- and can be mixed in. See start.ini file for the default -->
+<!-- configuration files. -->
<!-- -->
-<!-- See start.ini file for the default configuraton files -->
+<!-- For a description of the configuration mechanism, see the -->
+<!-- output of: -->
+<!-- java -jar start.jar -? -->
<!-- =============================================================== -->
-
+<!-- =============================================================== -->
+<!-- Configure a Jetty Server instance with an ID "Server" -->
+<!-- Other configuration files may also configure the "Server" -->
+<!-- ID, in which case they are adding configuration to the same -->
+<!-- instance. If other configuration have a different ID, they -->
+<!-- will create and configure another instance of Jetty. -->
+<!-- Consult the javadoc of o.e.j.server.Server for all -->
+<!-- configuration that may be set here. -->
+<!-- =============================================================== -->
<Configure id="Server" class="org.eclipse.jetty.server.Server">
+
<!-- =========================================================== -->
- <!-- Server Thread Pool -->
+ <!-- Configure the Server Thread Pool. -->
+ <!-- The server holds a common thread pool which is used by -->
+ <!-- default as the executor used by all connectors and servlet -->
+ <!-- dispatches. -->
+ <!-- -->
+ <!-- Configuring a fixed thread pool is vital to controlling the -->
+ <!-- maximal memory footprint of the server and is a key tuning -->
+ <!-- parameter for tuning. In an application that rarely blocks -->
+ <!-- then maximal threads may be close to the number of 5*CPUs. -->
+ <!-- In an application that frequently blocks, then maximal -->
+ <!-- threads should be set as high as possible given the memory -->
+ <!-- available. -->
+ <!-- -->
+ <!-- Consult the javadoc of o.e.j.util.thread.QueuedThreadPool -->
+ <!-- for all configuration that may be set here. -->
<!-- =========================================================== -->
<Arg name="threadpool">
<New id="threadpool" class="org.eclipse.jetty.util.thread.QueuedThreadPool">
@@ -29,42 +51,45 @@
</Arg>
<!-- =========================================================== -->
- <!-- HttpChannel Configuration -->
+ <!-- HttpChannel Configuration. -->
+ <!-- This is a common configuration instance used by all -->
+ <!-- connectors that can carry HTTP semantics (HTTP, HTTPS, SPDY)-->
+ <!-- It configures the non wire protocol aspects of the HTTP -->
+ <!-- semantic. -->
+ <!-- -->
+ <!-- This configuration is only defined here and is used by -->
+ <!-- reference from the jetty-http.xml, jetty-https.xml and -->
+ <!-- jetty-spdy.xml configuration files which instantiate the -->
+ <!-- connectors. -->
+ <!-- -->
+ <!-- Consult the javadoc of o.e.j.server.HttpChannelConfig -->
+ <!-- for all configuration that may be set here. -->
<!-- =========================================================== -->
<New id="httpConfig" class="org.eclipse.jetty.server.HttpChannelConfig">
<Set name="secureScheme">https</Set>
- <Set name="securePort">8443</Set>
+ <Set name="securePort"><Property name="jetty.tls.port" default="8443" /></Set>
<Set name="outputBufferSize">32768</Set>
<Set name="requestHeaderSize">8192</Set>
<Set name="responseHeaderSize">8192</Set>
+
+ <!-- Uncomment to enable handling of X-Forwarded- style headers
<Call name="addCustomizer">
<Arg><New class="org.eclipse.jetty.server.ForwardedRequestCustomizer"/></Arg>
</Call>
+ -->
</New>
- <!-- =========================================================== -->
- <!-- Set connectors -->
- <!-- =========================================================== -->
- <Call name="addConnector">
- <Arg>
- <New class="org.eclipse.jetty.server.ServerConnector">
- <Arg name="server"><Ref id="Server" /></Arg>
- <Arg name="factories">
- <Array type="org.eclipse.jetty.server.ConnectionFactory">
- <Item><New class="org.eclipse.jetty.server.HttpConnectionFactory">
- <Arg name="config"><Ref id="httpConfig"/></Arg>
- </New></Item>
- </Array>
- </Arg>
- <Set name="host"><Property name="jetty.host" /></Set>
- <Set name="port"><Property name="jetty.port" default="8080"/></Set>
- <Set name="idleTimeout">30000</Set>
- </New>
- </Arg>
- </Call>
<!-- =========================================================== -->
- <!-- Set handler Collection Structure -->
+ <!-- Set the default handler structure for the Server -->
+ <!-- A handler collection is used to pass received requests to -->
+ <!-- both the ContextHandlerCollection, which selects the next -->
+ <!-- handler by context path and virtual host, and the -->
+ <!-- DefaultHandler, which handles any requests not handled by -->
+ <!-- the context handlers. -->
+ <!-- Other handlers may be added to the "Handlers" collection, -->
+ <!-- for example the jetty-requestlog.xml file adds the -->
+ <!-- RequestLogHandler after the default handler -->
<!-- =========================================================== -->
<Set name="handler">
<New id="Handlers" class="org.eclipse.jetty.server.handler.HandlerCollection">
@@ -82,13 +107,13 @@
</Set>
<!-- =========================================================== -->
- <!-- extra options -->
+ <!-- extra server options -->
<!-- =========================================================== -->
<Set name="stopAtShutdown">true</Set>
<Set name="sendServerVersion">true</Set>
<Set name="sendDateHeader">true</Set>
<Set name="stopTimeout">1000</Set>
- <Set name="dumpAfterStart">true</Set>
+ <Set name="dumpAfterStart">false</Set>
<Set name="dumpBeforeStop">false</Set>
</Configure>

Back to the top