source: trunk/gsdl3/comms/jakarta/server.xml.in@ 9874

Last change on this file since 9874 was 9874, checked in by kjdon, 17 years ago

merged from branch ant-install-branch: merge 1

  • Property svn:keywords set to Author Date Id Revision
File size: 19.1 KB
Line 
1<!-- Example Server Configuration File -->
2<!-- Note that component elements are nested corresponding to their
3 parent-child relationships with each other -->
4
5<!-- A "Server" is a singleton element that represents the entire JVM,
6 which may contain one or more "Service" instances. The Server
7 listens for a shutdown command on the indicated port.
8
9 Note: A "Server" is not itself a "Container", so you may not
10 define subcomponents such as "Valves" or "Loggers" at this level.
11 -->
12
13<Server port="8005" shutdown="SHUTDOWN">
14
15 <!-- Comment these entries out to disable JMX MBeans support used for the
16 administration web application -->
17 <Listener className="org.apache.catalina.mbeans.ServerLifecycleListener" />
18 <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
19 <Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>
20
21 <!-- Global JNDI resources -->
22 <GlobalNamingResources>
23
24 <!-- Test entry for demonstration purposes -->
25 <Environment name="simpleValue" type="java.lang.Integer" value="30"/>
26
27 <!-- Editable user database that can also be used by
28 UserDatabaseRealm to authenticate users -->
29 <Resource name="UserDatabase" auth="Container"
30 type="org.apache.catalina.UserDatabase"
31 description="User database that can be updated and saved"
32 factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
33 pathname="conf/tomcat-users.xml" />
34
35 </GlobalNamingResources>
36
37 <!-- A "Service" is a collection of one or more "Connectors" that share
38 a single "Container" (and therefore the web applications visible
39 within that Container). Normally, that Container is an "Engine",
40 but this is not required.
41
42 Note: A "Service" is not itself a "Container", so you may not
43 define subcomponents such as "Valves" or "Loggers" at this level.
44 -->
45
46 <!-- Define the Tomcat Stand-Alone Service -->
47 <Service name="Catalina">
48
49 <!-- A "Connector" represents an endpoint by which requests are received
50 and responses are returned. Each Connector passes requests on to the
51 associated "Container" (normally an Engine) for processing.
52
53 By default, a non-SSL HTTP/1.1 Connector is established on port 8080.
54 You can also enable an SSL HTTP/1.1 Connector on port 8443 by
55 following the instructions below and uncommenting the second Connector
56 entry. SSL support requires the following steps (see the SSL Config
57 HOWTO in the Tomcat 5 documentation bundle for more detailed
58 instructions):
59 * If your JDK version 1.3 or prior, download and install JSSE 1.0.2 or
60 later, and put the JAR files into "$JAVA_HOME/jre/lib/ext".
61 * Execute:
62 %JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA (Windows)
63 $JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA (Unix)
64 with a password value of "changeit" for both the certificate and
65 the keystore itself.
66
67 By default, DNS lookups are enabled when a web application calls
68 request.getRemoteHost(). This can have an adverse impact on
69 performance, so you can disable it by setting the
70 "enableLookups" attribute to "false". When DNS lookups are disabled,
71 request.getRemoteHost() will return the String version of the
72 IP address of the remote client.
73 -->
74
75 <!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
76 <Connector port="@port@"
77 maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
78 enableLookups="false" redirectPort="8443" acceptCount="100"
79 connectionTimeout="20000" disableUploadTimeout="true" />
80 <!-- Note : To disable connection timeouts, set connectionTimeout value
81 to 0 -->
82
83 <!-- Note : To use gzip compression you could set the following properties :
84
85 compression="on"
86 compressionMinSize="2048"
87 noCompressionUserAgents="gozilla, traviata"
88 compressableMimeType="text/html,text/xml"
89 -->
90
91 <!-- Define a SSL HTTP/1.1 Connector on port 8443 -->
92 <!--
93 <Connector port="8443"
94 maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
95 enableLookups="false" disableUploadTimeout="true"
96 acceptCount="100" scheme="https" secure="true"
97 clientAuth="false" sslProtocol="TLS" />
98 -->
99
100 <!-- Define an AJP 1.3 Connector on port 8009 -->
101 <Connector port="8009"
102 enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />
103
104 <!-- Define a Proxied HTTP/1.1 Connector on port 8082 -->
105 <!-- See proxy documentation for more information about using this. -->
106 <!--
107 <Connector port="8082"
108 maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
109 enableLookups="false" acceptCount="100" connectionTimeout="20000"
110 proxyPort="80" disableUploadTimeout="true" />
111 -->
112
113 <!-- An Engine represents the entry point (within Catalina) that processes
114 every request. The Engine implementation for Tomcat stand alone
115 analyzes the HTTP headers included with the request, and passes them
116 on to the appropriate Host (virtual host). -->
117
118 <!-- You should set jvmRoute to support load-balancing via AJP ie :
119 <Engine name="Standalone" defaultHost="localhost" jvmRoute="jvm1">
120 -->
121
122 <!-- Define the top level container in our container hierarchy -->
123 <Engine name="Catalina" defaultHost="localhost">
124
125 <!-- The request dumper valve dumps useful debugging information about
126 the request headers and cookies that were received, and the response
127 headers and cookies that were sent, for all requests received by
128 this instance of Tomcat. If you care only about requests to a
129 particular virtual host, or a particular application, nest this
130 element inside the corresponding <Host> or <Context> entry instead.
131
132 For a similar mechanism that is portable to all Servlet 2.4
133 containers, check out the "RequestDumperFilter" Filter in the
134 example application (the source for this filter may be found in
135 "$CATALINA_HOME/webapps/examples/WEB-INF/classes/filters").
136
137 Request dumping is disabled by default. Uncomment the following
138 element to enable it. -->
139 <!--
140 <Valve className="org.apache.catalina.valves.RequestDumperValve"/>
141 -->
142
143 <!-- Because this Realm is here, an instance will be shared globally -->
144
145 <!-- This Realm uses the UserDatabase configured in the global JNDI
146 resources under the key "UserDatabase". Any edits
147 that are performed against this UserDatabase are immediately
148 available for use by the Realm. -->
149 <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
150 resourceName="UserDatabase"/>
151
152 <!-- Comment out the old realm but leave here for now in case we
153 need to go back quickly -->
154 <!--
155 <Realm className="org.apache.catalina.realm.MemoryRealm" />
156 -->
157
158 <!-- Replace the above Realm with one of the following to get a Realm
159 stored in a database and accessed via JDBC -->
160
161 <!--
162 <Realm className="org.apache.catalina.realm.JDBCRealm"
163 driverName="org.gjt.mm.mysql.Driver"
164 connectionURL="jdbc:mysql://localhost/authority"
165 connectionName="test" connectionPassword="test"
166 userTable="users" userNameCol="user_name" userCredCol="user_pass"
167 userRoleTable="user_roles" roleNameCol="role_name" />
168 -->
169
170 <!--
171 <Realm className="org.apache.catalina.realm.JDBCRealm"
172 driverName="oracle.jdbc.driver.OracleDriver"
173 connectionURL="jdbc:oracle:thin:@ntserver:1521:ORCL"
174 connectionName="scott" connectionPassword="tiger"
175 userTable="users" userNameCol="user_name" userCredCol="user_pass"
176 userRoleTable="user_roles" roleNameCol="role_name" />
177 -->
178
179 <!--
180 <Realm className="org.apache.catalina.realm.JDBCRealm"
181 driverName="sun.jdbc.odbc.JdbcOdbcDriver"
182 connectionURL="jdbc:odbc:CATALINA"
183 userTable="users" userNameCol="user_name" userCredCol="user_pass"
184 userRoleTable="user_roles" roleNameCol="role_name" />
185 -->
186
187 <!-- Define the default virtual host
188 Note: XML Schema validation will not work with Xerces 2.2.
189 -->
190 <Host name="localhost" appBase="webapps"
191 unpackWARs="true" autoDeploy="true"
192 xmlValidation="false" xmlNamespaceAware="false">
193
194 <!-- GSDL3 Service -->
195 <Context path="/gsdl3" docBase="@gsdl3home@/web" debug="1" reloadable="true"><Resources allowLinking='true'/></Context>
196
197 <!-- Defines a cluster for this node,
198 By defining this element, means that every manager will be changed.
199 So when running a cluster, only make sure that you have webapps in there
200 that need to be clustered and remove the other ones.
201 A cluster has the following parameters:
202
203 className = the fully qualified name of the cluster class
204
205 name = a descriptive name for your cluster, can be anything
206
207 mcastAddr = the multicast address, has to be the same for all the nodes
208
209 mcastPort = the multicast port, has to be the same for all the nodes
210
211 mcastBindAddr = bind the multicast socket to a specific address
212
213 mcastTTL = the multicast TTL if you want to limit your broadcast
214
215 mcastSoTimeout = the multicast readtimeout
216
217 mcastFrequency = the number of milliseconds in between sending a "I'm alive" heartbeat
218
219 mcastDropTime = the number a milliseconds before a node is considered "dead" if no heartbeat is received
220
221 tcpThreadCount = the number of threads to handle incoming replication requests, optimal would be the same amount of threads as nodes
222
223 tcpListenAddress = the listen address (bind address) for TCP cluster request on this host,
224 in case of multiple ethernet cards.
225 auto means that address becomes
226 InetAddress.getLocalHost().getHostAddress()
227
228 tcpListenPort = the tcp listen port
229
230 tcpSelectorTimeout = the timeout (ms) for the Selector.select() method in case the OS
231 has a wakup bug in java.nio. Set to 0 for no timeout
232
233 printToScreen = true means that managers will also print to std.out
234
235 expireSessionsOnShutdown = true means that
236
237 useDirtyFlag = true means that we only replicate a session after setAttribute,removeAttribute has been called.
238 false means to replicate the session after each request.
239 false means that replication would work for the following piece of code: (only for SimpleTcpReplicationManager)
240 <%
241 HashMap map = (HashMap)session.getAttribute("map");
242 map.put("key","value");
243 %>
244 replicationMode = can be either 'pooled', 'synchronous' or 'asynchronous'.
245 * Pooled means that the replication happens using several sockets in a synchronous way. Ie, the data gets replicated, then the request return. This is the same as the 'synchronous' setting except it uses a pool of sockets, hence it is multithreaded. This is the fastest and safest configuration. To use this, also increase the nr of tcp threads that you have dealing with replication.
246 * Synchronous means that the thread that executes the request, is also the
247 thread the replicates the data to the other nodes, and will not return until all
248 nodes have received the information.
249 * Asynchronous means that there is a specific 'sender' thread for each cluster node,
250 so the request thread will queue the replication request into a "smart" queue,
251 and then return to the client.
252 The "smart" queue is a queue where when a session is added to the queue, and the same session
253 already exists in the queue from a previous request, that session will be replaced
254 in the queue instead of replicating two requests. This almost never happens, unless there is a
255 large network delay.
256 -->
257 <!--
258 When configuring for clustering, you also add in a valve to catch all the requests
259 coming in, at the end of the request, the session may or may not be replicated.
260 A session is replicated if and only if all the conditions are met:
261 1. useDirtyFlag is true or setAttribute or removeAttribute has been called AND
262 2. a session exists (has been created)
263 3. the request is not trapped by the "filter" attribute
264
265 The filter attribute is to filter out requests that could not modify the session,
266 hence we don't replicate the session after the end of this request.
267 The filter is negative, ie, anything you put in the filter, you mean to filter out,
268 ie, no replication will be done on requests that match one of the filters.
269 The filter attribute is delimited by ;, so you can't escape out ; even if you wanted to.
270
271 filter=".*\.gif;.*\.js;" means that we will not replicate the session after requests with the URI
272 ending with .gif and .js are intercepted.
273
274 The deployer element can be used to deploy apps cluster wide.
275 Currently the deployment only deploys/undeploys to working members in the cluster
276 so no WARs are copied upons startup of a broken node.
277 The deployer watches a directory (watchDir) for WAR files when watchEnabled="true"
278 When a new war file is added the war gets deployed to the local instance,
279 and then deployed to the other instances in the cluster.
280 When a war file is deleted from the watchDir the war is undeployed locally
281 and cluster wide
282 -->
283
284 <!--
285 <Cluster className="org.apache.catalina.cluster.tcp.SimpleTcpCluster"
286 managerClassName="org.apache.catalina.cluster.session.DeltaManager"
287 expireSessionsOnShutdown="false"
288 useDirtyFlag="true"
289 notifyListenersOnReplication="true">
290
291 <Membership
292 className="org.apache.catalina.cluster.mcast.McastService"
293 mcastAddr="228.0.0.4"
294 mcastPort="45564"
295 mcastFrequency="500"
296 mcastDropTime="3000"/>
297
298 <Receiver
299 className="org.apache.catalina.cluster.tcp.ReplicationListener"
300 tcpListenAddress="auto"
301 tcpListenPort="4001"
302 tcpSelectorTimeout="100"
303 tcpThreadCount="6"/>
304
305 <Sender
306 className="org.apache.catalina.cluster.tcp.ReplicationTransmitter"
307 replicationMode="pooled"
308 ackTimeout="15000"/>
309
310 <Valve className="org.apache.catalina.cluster.tcp.ReplicationValve"
311 filter=".*\.gif;.*\.js;.*\.jpg;.*\.png;.*\.htm;.*\.html;.*\.css;.*\.txt;"/>
312
313 <Deployer className="org.apache.catalina.cluster.deploy.FarmWarDeployer"
314 tempDir="/tmp/war-temp/"
315 deployDir="/tmp/war-deploy/"
316 watchDir="/tmp/war-listen/"
317 watchEnabled="false"/>
318 </Cluster>
319 -->
320
321
322
323 <!-- Normally, users must authenticate themselves to each web app
324 individually. Uncomment the following entry if you would like
325 a user to be authenticated the first time they encounter a
326 resource protected by a security constraint, and then have that
327 user identity maintained across *all* web applications contained
328 in this virtual host. -->
329 <!--
330 <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
331 -->
332
333 <!-- Access log processes all requests for this virtual host. By
334 default, log files are created in the "logs" directory relative to
335 $CATALINA_HOME. If you wish, you can specify a different
336 directory with the "directory" attribute. Specify either a relative
337 (to $CATALINA_HOME) or absolute path to the desired directory.
338 -->
339 <!--
340 <Valve className="org.apache.catalina.valves.AccessLogValve"
341 directory="logs" prefix="localhost_access_log." suffix=".txt"
342 pattern="common" resolveHosts="false"/>
343 -->
344
345 <!-- Access log processes all requests for this virtual host. By
346 default, log files are created in the "logs" directory relative to
347 $CATALINA_HOME. If you wish, you can specify a different
348 directory with the "directory" attribute. Specify either a relative
349 (to $CATALINA_HOME) or absolute path to the desired directory.
350 This access log implementation is optimized for maximum performance,
351 but is hardcoded to support only the "common" and "combined" patterns.
352 -->
353 <!--
354 <Valve className="org.apache.catalina.valves.FastCommonAccessLogValve"
355 directory="logs" prefix="localhost_access_log." suffix=".txt"
356 pattern="common" resolveHosts="false"/>
357 -->
358 <!-- Access log processes all requests for this virtual host. By
359 default, log files are created in the "logs" directory relative to
360 $CATALINA_HOME. If you wish, you can specify a different
361 directory with the "directory" attribute. Specify either a relative
362 (to $CATALINA_HOME) or absolute path to the desired directory.
363 This access log implementation is optimized for maximum performance,
364 but is hardcoded to support only the "common" and "combined" patterns.
365
366 This valve use NIO direct Byte Buffer to asynchornously store the
367 log.
368 -->
369 <!--
370 <Valve className="org.apache.catalina.valves.ByteBufferAccessLogValve"
371 directory="logs" prefix="localhost_access_log." suffix=".txt"
372 pattern="common" resolveHosts="false"/>
373 -->
374
375 </Host>
376
377 </Engine>
378
379 </Service>
380
381</Server>
Note: See TracBrowser for help on using the repository browser.