Wiki source code of XWiki Startup Stuck during Solr Initialization
Last modified by Eleni Cojocariu on 2026/08/13 15:14
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | When starting XWiki, the application may appear to hang during startup while initializing [[Solr>>extensions:Extension.Solr Search Application]]. No clear error may be displayed in the logs, but the [[servlet container>>documentation.xs.admin.installation.methods.install-xwiki-war.configure-servlet-container.WebHome]] remains stuck during the Solr initialization phase. | ||
| 2 | |||
| 3 | This can happen when Solr tries to initialize multiple cores at the same time, especially for cores created by older XWiki versions. | ||
| 4 | |||
| 5 | === Cause === | ||
| 6 | |||
| 7 | This issue occurs because Solr loads all configured cores during startup. When multiple cores need to be initialized simultaneously, Solr may lock itself and prevent the XWiki application from completing the startup process. | ||
| 8 | |||
| 9 | Newer XWiki versions create Solr cores with delayed loading enabled, meaning that the core is initialized only when it is first used. However, existing Solr cores created by older versions may not have this option configured. | ||
| 10 | |||
| 11 | === Solution === | ||
| 12 | |||
| 13 | To resolve the issue, configure the existing Solr cores to use delayed loading: | ||
| 14 | |||
| 15 | 1. Navigate to the XWiki Solr storage directory:((( | ||
| 16 | {{code language="none"}} | ||
| 17 | <permdir>/store/solr/ | ||
| 18 | {{/code}} | ||
| 19 | ))) | ||
| 20 | 1. For each Solr core, edit the ##core.properties## file:((( | ||
| 21 | {{code language="none"}} | ||
| 22 | <permdir>/store/solr/<core-name>/core.properties | ||
| 23 | {{/code}} | ||
| 24 | ))) | ||
| 25 | 1. Add the following property:((( | ||
| 26 | {{code language="properties"}} | ||
| 27 | loadOnStartup=false | ||
| 28 | {{/code}} | ||
| 29 | ))) | ||
| 30 | 1. Save the changes and restart the servlet container running XWiki. |
