Upgrade Troubleshooting
Last modified by Eleni Cojocariu on 2026/08/13 15:14
Content
Explanation
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 rather than by XWiki. Read both logs first, to find which component stopped.
The two failures documented here are:
- XWiki Startup Stuck during Solr Initialization, when existing Solr cores are not configured for delayed loading.
- XWiki Startup Failure after a Required Java Upgrade, when the servlet container still runs the Java version the new XWiki version no longer supports.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.