Wiki source code of Upgrade Troubleshooting

Last modified by Eleni Cojocariu on 2026/08/13 15:14

Hide last authors
Eleni Cojocariu 2.1 1 An upgrade that leaves XWiki unable to start usually fails on the environment around it rather than on the wiki content, and the failure is often reported by the [[servlet container>>documentation.xs.admin.installation.methods.install-xwiki-war.configure-servlet-container.WebHome]] rather than by XWiki. Read both logs first, to find which component stopped.
Eleni Cojocariu 1.1 2
Eleni Cojocariu 2.1 3 The two failures documented here are:
Eleni Cojocariu 1.1 4
Eleni Cojocariu 2.1 5 * [[XWiki Startup Stuck during Solr Initialization>>documentation.xs.admin.upgrade.troubleshooting.xwiki-startup-stuck-solr-initialization.WebHome]], when existing Solr cores are not configured for delayed loading.
6 * [[XWiki Startup Failure after a Required Java Upgrade>>documentation.xs.admin.upgrade.troubleshooting.xwiki-startup-failure-java-upgrade.WebHome]], when the servlet container still runs the Java version the new XWiki version no longer supports.

Get Connected