Wiki source code of Installation Troubleshooting
Last modified by superadmin on 2026/10/14 18:26
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | When [[installing>>doc:documentation.xs.admin.installation.WebHome]] or starting XWiki, most of what goes wrong is not in XWiki itself but in the environment it runs in: the servlet container, the network, or the Java runtime. This topic covers the symptoms that appear whatever installation method was used: | ||
| 2 | |||
| 3 | * a JMX domain conflict that stops the cache from starting, when [[several instances share one servlet container>>doc:documentation.xs.admin.installation.troubleshooting.multiple-instances-container.WebHome]]. | ||
| 4 | * ##connection refused## exceptions in the log files, when [[XWiki sits behind a proxy server>>doc:documentation.xs.admin.installation.troubleshooting.xwiki-proxy-server.WebHome]] and cannot reach the extension repositories. | ||
| 5 | * a PKIX handshake failure when XWiki calls an HTTPS service, described in [[SSL Certificate Error>>doc:documentation.xs.admin.installation.troubleshooting.ssl-certificate-error.WebHome]]. | ||
| 6 | * a [["File path too long" error on Windows>>doc:documentation.xs.admin.installation.troubleshooting.file-path-long-windows-unzipping.WebHome]] while unzipping the distribution. | ||
| 7 | |||
| 8 | The [[Admin Tools application>>extensions:Extension.Admin Tools Application]] checks the basic settings of a Tomcat and MySQL installation. Some of its tools only work on Linux. |
