Wiki source code of Tomcat Installation

Last modified by Thomas Mortagne on 2023/12/01

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 = Installation Steps =
6
7 * Download and install [[Tomcat 8+>>http://tomcat.apache.org/]]. There are plenty of ways to install Tomcat, refer to the Tomcat site for more information. Let's call ##TOMCAT_HOME## the directory where it's installed.(((
8 {{warning}}
9 * Using Tomcat 10 is not possible right now since it moved to the incompatible Jakarta EE 9 API. See [[Apache Tomcat migration tool for Jakarta EE>>https://github.com/apache/tomcat-jakartaee-migration]] for mode details.
10 * Tomcat 9.0.70 has some bugs that make it fail with XWiki. See:
11 ** -- https://jira.xwiki.org/browse/XWIKI-20470 -- (A Tomcat regression now fixed in Tomcat 9.0.71+)
12 {{/warning}}
13 )))
14 * Make sure you [[give enough memory to Java>>Documentation.AdminGuide.InstallationTomcat#HOutOfMemoryError]] since by default Tomcat is not configured with enough memory for XWiki.
15 * Extract the [[XWiki WAR>>xwiki:Main.Download]] into a directory named ##xwiki## in ##TOMCAT_HOME/webapps/##
16 * Open ##TOMCAT_HOME/webapps/xwiki/WEB-INF/xwiki.properties## files and [[configure a permanent directory>>Documentation.AdminGuide.Configuration#HConfiguringDirectories]]
17 * Start Tomcat
18 * When Tomcat has opened go to your wiki by accessing [[http:~~/~~/localhost:8080/xwiki/bin/view/Main/>>http://localhost:8080/xwiki/bin/view/Main/]]
19 * NOTE - if you have issues with maximum cache size - In your ##$CATALINA_BASE/conf/context.xml## add the following content before ##</Context>##:(((
20 {{code language="none"}}
21 <Resources cachingAllowed="true" cacheMaxSize="100000" ></Resources>
22 {{/code}}
23 )))
24
25 == Activate headless mode ==
26
27 If you're operating XWiki on a Linux server with no X11 libraries installed you have to enable headless mode for your Tomcat installation. Sometimes this is also needed on Windows platforms. Typical exceptions are:
28
29 * ##Exception: Could not initialize class sun.awt.X11.XToolkit##
30 * ##java.lang.InternalError: Can't connect to X11 window server using 'localhost:10.0' as the value of the DISPLAY variable##
31 * ##Error number 0 in 11: Uncaught exception##
32 * ##java.lang.NoClassDefFoundError: Could not initialize class java.awt.GraphicsEnvironment$LocalGE##
33
34 * On Linux create a file ##///TOMCAT_HOME///bin/setenv.sh## and insert the following code:(((
35 {{code language="none"}}
36 #!/bin/sh
37 export JAVA_OPTS="${JAVA_OPTS} -Djava.awt.headless=true"
38 {{/code}}
39 )))
40 * On Windows create a file ##///TOMCAT_HOME///bin/setenv.bat## and insert the following code:(((
41 {{code language="none"}}
42 set JAVA_OPTS=%JAVA_OPTS% -Djava.awt.headless=true
43 {{/code}}
44 )))
45 * When running as a Windows service the ##setenv.bat## is not working. See registry ##HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Procrun 2.0\//FOOBAR//\Parameters\Java## for similar settings.
46
47 == Optional configuration ==
48
49 * To enable gzip compression the connector property in the ##server.xml## file needs to be modified. The location of the ##server.xml## file is found at:
50 - On Linux: ##/etc/tomcat[version]/server.xml##
51 - On Windows: ##//TOMCAT_HOME///conf/server.xml##(((
52 {{code language="none"}}
53 <Connector port="8080"
54 ...
55 compression="on"
56 compressionMinSize="2048"
57 compressibleMimeType="text/html,text/xml,text/css,text/javascript,application/x-javascript">
58 </Connector>
59 {{/code}}
60 )))
61 * To modify the port on which Tomcat will run, search in ##server.xml## for all instances of {{code}}8080{{/code}} (in Linux this can also be {{code}}8180{{/code}}) and replace this with the port value you wish to use.
62 * It is possible to setup a Tomcat Java Server as a UNIX Daemon - JSVC. Just follow [[these instructions>>http://www.malisphoto.com/tips/tomcatonosx.html?#Anchor-JSVC||rel="noopener noreferrer" target="new"]].
63 The only reason to make Tomcat a daemon is to make it runnable on port 80, which can be replaced by using a proxy server (such as NginX or Apache) on port 80 and then forwarding to Tomcat on port 8080.
64
65 == Policy configuration ==
66
67 For those who activate the security manager for Tomcat, add this portion of code to the end of your ##conf/catalina.policy## file from your Tomcat installation. You can adapt the code for the available installations of OpenOffice/LibreOffice on your server and for different databases :
68
69 {{code language="none"}}
70 grant codeBase "file:${catalina.base}/webapps/xwiki/WEB-INF/lib/-" {
71 // for mySQL connection
72 permission java.net.SocketPermission "127.0.0.1:3306", "connect,resolve";
73
74 // XWiki must have access to all properties in read/write
75 permission java.util.PropertyPermission "*", "read, write";
76
77 // Generic detected permissions
78 permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
79 permission java.lang.RuntimePermission "createClassLoader";
80 permission java.lang.RuntimePermission "setContextClassLoader";
81 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.loader";
82 permission java.lang.RuntimePermission "accessDeclaredMembers";
83 permission java.lang.RuntimePermission "getenv.ProgramFiles";
84 permission java.lang.RuntimePermission "getenv.APPDATA";
85 permission java.lang.RuntimePermission "accessClassInPackage.sun.reflect";
86 permission java.lang.RuntimePermission "getClassLoader";
87 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.catalina.connector";
88 permission java.lang.RuntimePermission "accessClassInPackage.org.apache.tomcat.util.threads";
89 permission java.lang.RuntimePermission "reflectionFactoryAccess";
90 permission java.lang.RuntimePermission "accessClassInPackage.com.sun.jmx.interceptor";
91 permission java.lang.RuntimePermission "accessClassInPackage.com.sun.jmx.mbeanserver";
92 permission java.lang.RuntimePermission "modifyThread";
93 permission java.lang.RuntimePermission "getProtectionDomain";
94
95 // JAXB permissions
96 permission javax.xml.bind.JAXBPermission "setDatatypeConverter";
97
98 // Serialization related permissions
99 permission java.io.SerializablePermission "allowSerializationReflection";
100 permission java.io.SerializablePermission "creator";
101 permission java.io.SerializablePermission "enableSubclassImplementation";
102
103 // Internal resources access permissions
104 permission java.io.FilePermission "synonyms.txt", "read";
105 permission java.io.FilePermission "lang/synonyms_en.txt", "read";
106 permission java.io.FilePermission "quartz.properties", "read";
107 permission java.io.FilePermission "/templates/-", "read";
108 permission java.io.FilePermission "/skins/-", "read";
109 permission java.io.FilePermission "/resources/-", "read";
110
111 // MBean related permissions
112 permission javax.management.MBeanServerPermission "createMBeanServer";
113 permission javax.management.MBeanPermission "*", "registerMBean";
114 permission javax.management.MBeanPermission "*", "unregisterMBean";
115 permission javax.management.MBeanTrustPermission "register";
116 permission javax.management.MBeanPermission "-#-[-]", "queryNames";
117 permission javax.management.MBeanServerPermission "findMBeanServer";
118
119 // LibreOffice/OpenOffice related permissions
120 permission java.io.FilePermission "/opt/openoffice.org3/program/soffice.bin", "read";
121 permission java.io.FilePermission "/opt/libreoffice/program/soffice.bin", "read";
122 permission java.io.FilePermission "/usr/lib/openoffice/program/soffice.bin", "read";
123 permission java.io.FilePermission "/usr/lib/libreoffice/program/soffice.bin", "read";
124
125 // Allow file storage directory reading - for directory and everything underneath
126 // This is dependent on the setting of environment.permanentDirectory in xwiki.properties
127 permission java.io.FilePermission "${catalina.base}${file.separator}xwikidata${file.separator}", "read,write,delete";
128 permission java.io.FilePermission "${catalina.base}${file.separator}xwikidata${file.separator}-", "read,write,delete";
129
130 // Allow file storage directory reading - temporary directory and everything underneath
131 // This is dependent on the setting of environment.temporaryDirectory in xwiki.properties.
132 permission java.io.FilePermission "${catalina.base}${file.separator}temp${file.separator}", "read,write,delete";
133 permission java.io.FilePermission "${catalina.base}${file.separator}temp${file.separator}-", "read,write,delete";
134 };
135 {{/code}}
136
137 Please note that this policy configuration file has been tested on CentOS 5.9 with Sun JDK 1.7.0u21 on Tomcat 7.0.40 with XWiki 5.0.1 installed.
138
139 == HTTP reverse proxy ==
140
141 For a [[variety of reasons>>https://en.wikipedia.org/wiki/Reverse_proxy||rel="__blank"]], it is not ideal to allow users to connect directly to tomcat. So it's generally recommended to put an HTTP reverse proxy such as Apache HTTP Server or Nginx in front of it.
142
143 === Using Apache HTTP Server ===
144
145 See [[Documentation.AdminGuide.Installation.ApacheHTTPD]] for a producting setup example with Apache HTTP Server.
146
147 === Using Nginx ===
148
149 Another popular choice for a reverse-proxy web server is [[Nginx>>http://wiki.nginx.org/Main||rel="__blank"]]. These instructions will walk through a very basic deployment of nginx acting as a reverse-proxy for the tomcat XWiki application.
150
151 After a typical XWiki installation XWiki will be running on ##http:~/~/localhost:8080/xwiki##. Ultimately we will want to access XWiki via ##http:~/~/mydomain.com## on a standard http (80) or https (443) port. To accomplish this for unsecure http traffic, the following basic config file gets us started.
152
153 ==== Http (unsecure) ====
154
155 * create this file ##/etc/nginx/conf.d/tomcat.conf##
156 * put the following code inside:(((
157 {{code language="none"}}
158 server {
159 listen 80;
160 server_name mydomain.com;
161
162 # Normally root should not be accessed, however, root should not serve files that might compromise the security of your server.
163 root /var/www/html;
164
165 # Configuration to avoid Request Entity too large error 413
166 client_max_body_size 0;
167
168 location / {
169 # All "root" requests will have /xwiki appended AND redirected to mydomain.com
170 rewrite ^ $scheme://$server_name/xwiki$request_uri? permanent;
171 }
172
173 location ^~ /xwiki {
174 # If path starts with /xwiki - then redirect to backend: XWiki application in Tomcat
175 # Read more about proxy_pass: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass
176 proxy_pass http://localhost:8080;
177 proxy_set_header X-Real-IP $remote_addr;
178 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
179 proxy_set_header Host $http_host;
180 proxy_set_header X-Forwarded-Proto $scheme;
181 }
182 }
183 {{/code}}
184 )))
185 * restart nginx
186
187 Now all ##http:~/~/mydomain.com/*## requests will lead to the XWiki application. Please note that these settings are basic. For more flexible solutions please refer to [[the Nginx documentation>>http://wiki.nginx.org/Main||rel="__blank"]].
188
189 ==== Https (secure) ====
190
191 There are many guides on how to create a secure configuration of nginx. To get started:
192
193 * [[Strong SSL Security on nginx>>https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html||rel="__blank"]]
194 * [[How To Secure Nginx With LetsEncrypt on Ubuntu 16.04>>https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-16-04||rel="__blank"]]
195
196 The following config assumes you are using LetsEncrypt and that your XWiki is hosted on ##http:~/~/localhost:8080/##. This config will redirect all unsecure requests to https:~/~/ and set the correct proxy headers for a secure nginx+tomcat setup.
197
198 First, you will need to add the following config to tomcat's ##server.xml##. The first line should already be in the file, I include it to give you something to search for (that line is located on line 108 in the Ubuntu 16.04 tomcat8 package). This will help tomcat find your proxy headers.
199
200 (((
201 {{code language="none"}}
202 <Engine name="Catalina" defaultHost="localhost">
203 <Valve className="org.apache.catalina.valves.RemoteIpValve"
204 internalProxies="127\.0\.[0-1]\.1"
205 remoteIpHeader="x-forwarded-for"
206 requestAttributesEnabled="true"
207 protocolHeader="x-forwarded-proto"
208 protocolHeaderHttpsValue="https"></Valve>
209 {{/code}}
210 )))
211
212 Next, add the following nginx config file to your nginx config folder, replacing ##wiki.yourdomain.com## with your actual domain info:
213
214 (((
215 {{code language="none"}}
216 server {
217 listen 80;
218 server_name wiki.yourdomain.com;
219
220 location ~ /.well-known {
221 allow all;
222 }
223
224 rewrite ^ https://$server_name$request_uri? permanent;
225
226 access_log /var/log/nginx-xwiki/access.log;
227 error_log /var/log/nginx-xwiki/error.log;
228
229 }
230
231 server {
232 listen 443;
233 server_name wiki.yourdomain.com;
234
235 root /var/www/html;
236
237 # Configuration to avoid Request Entity too large error 413
238 client_max_body_size 0;
239
240 ssl on;
241 ssl_certificate /etc/letsencrypt/live/wiki.yourdomain.com/fullchain.pem;
242 ssl_certificate_key /etc/letsencrypt/live/wiki.yourdomain.com/privkey.pem;
243
244 access_log /var/log/nginx-xwiki/access_ssl.log;
245 error_log /var/log/nginx-xwiki/error_ssl.log;
246
247 location / {
248 proxy_set_header Host $http_host;
249 proxy_set_header X-Real-IP $remote_addr;
250 proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;
251 proxy_set_header X-Forwarded-Proto $scheme;
252 proxy_set_header X-Scheme $scheme;
253 proxy_redirect off;
254 if (!-f $request_filename) {
255 proxy_pass http://127.0.0.1:8080;
256 break;
257 }
258 }
259
260 location ~ /.well-known {
261 allow all;
262 }
263 }
264 {{/code}}
265 )))
266
267 For more background on this config, see the discussion on this ticket: [[XWIKI-13963>>http://jira.xwiki.org/browse/XWIKI-13963||rel="__blank"]].
268
269 ==== Proxying and tunnels ====
270
271 This proxy methods brings remote connections to local connection. This is complementary to SSH-tunneling which is easily done on port 8080 and can be used to test development servers.
272
273 For example, if you are running an XWiki on port 80 on your laptop while running the NGinx (or Apache) on a server where it is accessible as ##https://wiki.yourdomain.com##, you can make your XWiki acessible with this URL:##
274
275 * First make sure that the port 8080 is not in use: You can proof this with ##{{{ssh server wget -O - https://127.0.0.1:8080/}}}## which should display the error message //Connection refused//. If not, something is running there and it should be stopped.
276 * You can then create the tunnel with the following ##ssh -R8080:127.0.0.1:8080 server##. This tells the server that incoming ("R"emote) connections on port 8080 on the server are to be tunnelled to the local (laptop) port 8080. This method has the advantage that the laptop (typically using a dynamic address) invokes the SSH where as a proxy configured on the server to proxy to the laptop would need to know the address of the laptop.
277
278 = Recommendations =
279
280 == Default encoding ==
281
282 XWiki strives to not be impacted by the default encoding, but it's still possible to have bugs or simply mistakes in extensions or tools used by XWiki (database connectors, etc.) so it's highly recommended to make sure Tomcat is started with utf8 as default encoding. If you use a Linux package of Tomcat this is generally set by default, but it might not always be the case. For that, make sure you have ##-Dfile.encoding=utf8## in the Java command line which starts Tomcat.
283
284 = Troubleshooting =
285
286 == Out Of Memory Error ==
287
288 === General Memory Settings ===
289
290 When you run XWiki in Tomcat with the default settings, you'll probably get an ##Out Of Memory## error (##java.lang.OutOfMemoryError: Java heap space## or ##java.lang.OutOfMemoryError: PermGen space##) since the default Tomcat memory settings are not enough for [[XWiki Memory Requirements>>Documentation.AdminGuide.Performances#HMemory]]. You'll need to allocate more memory to the JVM.
291
292 One easy solution to configure Tomcat's memory is to create a ##setenv.sh## file (or ##setenv.bat## on Windows) in ##[TOMCAT_HOME]/bin/## (where ##[TOMCAT_HOME]## is where you've installed Tomcat) and inside this file add the following (adjust the memory values according to the [[XWiki Memory Requirements>>Documentation.AdminGuide.Performances#HMemory]]). For example:
293
294 {{code language="none"}}
295 CATALINA_OPTS="-Xmx1024m -XX:MaxPermSize=192m"
296 {{/code}}
297
298 On most Linux distributions, this can also be achieved in ##/etc/default/tomcat//X//##, ##/etc/tomcat//X///tomcat//X//.conf## or ##/etc/conf.d/tomcat//X//.conf## (where //X// is the version of Tomcat installed).
299
300 On Windows, if you are running Tomcat as a service then defining ##CATALINA_OPTS## will not help. There is an utility provided in the ##bin## folder of your Tomcat installation (for example for Tomcat 5.x on Windows it's called tomcat5w.exe). It's a GUI tool which can be used to set various options including the heap size.
301
302 === NullPointerExceptions in catalina.log during startup on Ubuntu 23.x ===
303
304 Tomcat 9.0.70 has [[a very serious regression>>https://bz.apache.org/bugzilla/show_bug.cgi?id=66388]]. Unfortunately this is the version Ubuntu chose to put in its repository so you will be impacted with Ubuntu 23.04 and 23.10 at time of writing.
305
306 A possible workaround is to use the tomcat9 package coming for Ubuntu jammy (22.04) repository (9.0.58).
307
308 === Max number of threads ===
309
310 On some Debian 10 installations there can be a limitation of the max number of threads for services started with ##systemd## (and ##tomcat9## is such a service), what can force problems with OOM Errors: ##Out Of Memory## error (##java.lang.OutOfMemoryError: unable to create native thread##)
311
312 If you have such messages in the ##catalina.out## check your default limitations of the ##systemd## with the command
313
314 {{code language="none"}}
315 > systemctl show --property DefaultTasksMax
316 {{/code}}
317
318 For XWiki a value of about 100 is too low. Depending on the number of parallel users and sub wikis, this value should be larger. A value of about 512 should be sufficient.
319
320 Changing the parameter ##DefaultTasksMax## in ##/etc/systemd/system.conf## to a larger value, restarting the ##system-daemon## and ##tomcat9##, should solve the problem.
321
322 {{code language="none"}}
323 > systemctl daemon-reload
324 > systemctl restart tomcat9
325 {{/code}}
326
327 If the problem is not fixed with these changes, check the number of currently used threads by tomcat9 with the command
328
329 {{code language="none"}}
330 > ps -elfT | grep tomcat9| wc -l
331 {{/code}}
332
333 If the value is very near to the configured ##DefaultTasksMax##, you can try to increase it to an appropriate value.
334
335 == Java Security Manager ==
336
337 By default Tomcat is configured to have the Java Security Manager turned on. See the [[sample policy file>>Documentation.AdminGuide.InstallationWAR#HInstallandconfigureaServletContainer]] for more details.
338
339 If you want to turn off the Java Security Manager for Tomcat, edit the Tomcat startup script. You might also want to check your ##/etc/init.d/tomcat## file or ##/etc/default/tomcat5.5##. You should see the following code:
340
341 {{code language="none"}}
342 # Use the Java security manager? (yes/no)
343 TOMCAT5_SECURITY=
344 {{/code}}
345
346 Set it to ##no## to turn off the Security Manager.
347
348 == Allowing "/" and "\" in page names ==
349
350 Tomcat completely freaks out when there's a ##%2F## or ##%5C## in URLs and it's not something that can be changed in XWiki. See [[this note>>http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10]] for more information.
351
352 You can configure Tomcat to allow "/", by setting the ##org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH## system property to ##true##, as in:
353
354 {{code language="none"}}
355 -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true
356 {{/code}}
357
358 And by setting the ##org.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH## system property to ##true## to allow "\", as in:
359
360 {{code language="none"}}
361 -Dorg.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true
362 {{/code}}
363
364 To have both properties permanently enabled on your Tomcat instance, add the lines below to your ##CATALINA_OPTS## environment variable. How to achieve this depends on your operating system, Tomcat distribution and single/multi-instance setup.
365
366 {{code language="none"}}
367 -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true
368 -Dorg.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true
369 {{/code}}
370
371 === Apache front-end server ===
372
373 Note that if you're using the Apache web server as a front-end, you also need to [[configure Apache to allow encoded / and \>>https://httpd.apache.org/docs/current/mod/core.html#allowencodedslashes]] (##AllowEncodedSlashes NoDecode##) and also make sure to use ##nocanon## on the [[ProxyPass line used>>https://httpd.apache.org/docs/2.4/mod/mod_proxy.html]].
374
375 == NotSerializableException ==
376
377 If you get the following:
378
379 {{code language="none"}}
380 SEVERE: IOException while loading persisted sessions: java.io.WriteAbortedException: writing aborted; java.io.NotSerializableException: org.xwiki.model.internal.reference.LocalStringEntityReferenceSerializer
381 java.io.WriteAbortedException: writing aborted; java.io.NotSerializableException: org.xwiki.model.internal.reference.LocalStringEntityReferenceSerializer
382 at java.io.ObjectInputStream.readObject0(Unknown Source)
383 at java.io.ObjectInputStream.defaultReadFields(Unknown Source)
384 {{/code}}
385
386 This means that on startup Tomcat tries to load saved Sessions and fails to do so. In this case it fails because some non-serializable object was put in the Servlet Session. To work around the issue [[you can tell Tomcat to not save sessions>>http://dev-answers.blogspot.fr/2007/03/how-to-turn-off-tomcat-session.html]].
387
388 == SEVERE: Error listenerStart ==
389
390 If you get this error in your Tomcat logs then you'll need to enable finer-grained logging configuration to see what's the problem. This involves copying the following content in a ##WEB-INF/classes/logging.properties## file:
391
392 {{code language="none"}}
393 org.apache.catalina.core.ContainerBase.[Catalina].level = INFO
394 org.apache.catalina.core.ContainerBase.[Catalina].handlers = java.util.logging.ConsoleHandler
395 {{/code}}
396
397 == Parameter count exceeded allowed maximum ==
398
399 If you get an error such as the following it means you reached the limit of parameters you can send in a form.
400
401 {{code language="none"}}
402 java.lang.IllegalStateException: Parameter count exceeded allowed maximum: 512
403 {{/code}}
404
405 You can set the value you want by setting the following in your Tomcat ##server.xml## file:
406
407 {{code language="none"}}
408 <Connector port=... maxParameterCount="10000" ></Connector>
409 {{/code}}
410
411 == ThreadLocal Errors ==
412
413 When you stop XWiki you may see the following type of errors in the Tomcat logs. This is a [[known limitation of XWiki in cleaning up some ThreadLocal variables>>https://jira.xwiki.org/browse/XWIKI-9055]]. To be safe, we recommend that you stop XWiki by stopping Tomcat (i.e. stopping the Tomcat JVM). This ensures that there won't be any memory leak related to these ThreadLocal variables. If you use the Tomcat Manager to stop the XWiki webapp (by undeploying it), then we recommend to not do that and instead to stop Tomcat and restart it.
414
415 {{code language="none"}}
416 SEVERE [Thread-794] org.apache.catalina.loader.WebappClassLoaderBase.checkThreadLocalMapForLeaks The web application [...] created a ThreadLocal with key of type [java.lang.ThreadLocal] (value [java.lang.ThreadLocal@1125fc78]) and a value of type [...] (value [...]) but failed to remove it when the web application was stopped. Threads are going to be renewed over time to try and avoid a probable memory leak.
417 {{/code}}
418
419 = Old Instructions =
420
421 Note that [[Tomat 7 is no longer supported>>dev:Community.SupportStrategy.ServletContainerSupportStrategy.WebHome]].
422
423 {{error}}
424 The Tomcat project has brought a change in the [[way they handle ##RequestDispatcher##>>https://bz.apache.org/bugzilla/show_bug.cgi?id=59317]] which has caused [[regressions in XWiki>>https://jira.xwiki.org/browse/XWIKI-13556]] for some versions of Tomcat. Thus you should **not** use the following Tomcat versions:
425
426 * >= 9.0.0.M5 and < 9.0.0.M10 for the 9.0.x branch (fixed in 9.0.0.M10)
427 * >= 8.5.1 and < 8.5.5 for the 8.5.x branch (fixed in 8.5.5)
428 * >= 8.0.34 and < 8.0.37 for the 8.0.x branch (fixed in 8.0.37)
429 * >= 7.0.70 and < 7.0.71 for the 7.0.x branch (fixed in 7.0.71)
430
431 There is an important Classloader related bug in 8.0.32 which makes impossible to use the code macro or write Python scripts so you should avoid this version if possible. See https://bz.apache.org/bugzilla/show_bug.cgi?id=58999.
432 {{/error}}
433
434 * XWiki 12.0+ requires a Tomcat version >= 8 since it requires Servlet 3.1+
435 * Older versions of XWiki require a Tomcat version >= 7 since it requires Servlet 3.0+
436 * Tomcat 7 is not using URF-8 by default. Edit the ##conf/server.xml## file to set the UTF-8 encoding:(((
437 {{code language="none"}}
438 <Connector port="8080"
439 ...
440 URIEncoding="UTF-8">
441 </Connector>
442 {{/code}}
443 )))

Get Connected