Wiki source code of Upgrading
Last modified by Eleni Cojocariu on 2026/03/06 14:42
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | = Upgrading = | ||
| 6 | |||
| 7 | See [[Upgrade>>documentation.xs.admin.upgrade.WebHome]]. | ||
| 8 | |||
| 9 | ---- | ||
| 10 | |||
| 11 | == (% class="label label-primary" %)Part 1(%%) Upgrading the distribution == | ||
| 12 | |||
| 13 | {{velocity}} | ||
| 14 | #if ("$!request.get('method')" != '') | ||
| 15 | === (% class="label label-default" %)Method $request.get('method')(%%) Upgrading from the $request.get('method') package === | ||
| 16 | |||
| 17 | {{display reference="Documentation.AdminGuide.Upgrade.Upgrade${request.get('method')}.WebHome"/}} | ||
| 18 | #else | ||
| 19 | === (% class="label label-default" %)Method 1.A(%%) Upgrading from the Debian package (% class="badge fill-gray pull-right" id="HUpgradingfromtheDebianpackage" %).DEB(%%) === | ||
| 20 | |||
| 21 | {{display reference="Documentation.AdminGuide.Installation.InstallationViaAPT.WebHome" section="HUpgrading"/}} | ||
| 22 | |||
| 23 | === (% class="label label-default" %)Method 1.B(%%) Upgrading from Docker (% class="badge fill-gray pull-right" %).Docker(%%) === | ||
| 24 | |||
| 25 | {{display reference="Documentation.AdminGuide.Upgrade.UpgradeDocker.WebHome"/}} | ||
| 26 | |||
| 27 | === (% class="label label-default" %)Method 1.C(%%) Upgrading the WAR (% class="badge fill-gray pull-right" %).WAR(%%) === | ||
| 28 | |||
| 29 | {{display reference="Documentation.AdminGuide.Upgrade.UpgradeWAR.WebHome"/}} | ||
| 30 | |||
| 31 | === (% class="label label-default" %)Method 1.D(%%) Upgrading the demo package (% class="badge fill-gray pull-right" %).ZIP(%%) === | ||
| 32 | |||
| 33 | {{display reference="Documentation.AdminGuide.Upgrade.UpgradeDemo.WebHome"/}} | ||
| 34 | #end | ||
| 35 | {{/velocity}} | ||
| 36 | |||
| 37 | ---- | ||
| 38 | |||
| 39 | == (% class="label label-primary" id="HUpgradingwikidocuments" %)Part 2(%%) Upgrading the flavor == | ||
| 40 | |||
| 41 | === Using Distribution Wizard === | ||
| 42 | |||
| 43 | (% class="label label-success" %)Recommended | ||
| 44 | |||
| 45 | See [[Upgrade the Standard Flavor of the Wiki using the Distribution Wizard>>documentation.xs.admin.upgrade.flavor.upgrade-distribution-wizard.WebHome]]. | ||
| 46 | |||
| 47 | See [[Programming Rights Impact on Distribution Wizard>>documentation.xs.admin.upgrade.flavor.upgrade-distribution-wizard.programming-rights-impact-distribution-wizard.WebHome]]. | ||
| 48 | |||
| 49 | ---- | ||
| 50 | |||
| 51 | == (% class="label label-default" %)Alternative(%%) Start fresh, plus Export and Reimport your data == | ||
| 52 | |||
| 53 | See [[Upgrade the Flavor using the Export/Import Method>>documentation.xs.admin.upgrade.flavor.upgrade-export-import.WebHome]]. | ||
| 54 | |||
| 55 | {{warning}} | ||
| 56 | See [[Limitations>>documentation.xs.admin.upgrade.flavor.upgrade-export-import.limitations.WebHome]]. | ||
| 57 | |||
| 58 | See [[Move XWiki to a new server and upgrade it>>documentation.xs.admin.upgrade.move-xwiki-new-server-upgrade.WebHome]]. | ||
| 59 | {{/warning}} | ||
| 60 | |||
| 61 | ---- | ||
| 62 | |||
| 63 | = Downgrading = | ||
| 64 | |||
| 65 | See [[Downgrade your Wiki>>documentation.xs.admin.downgrade-your-wiki.WebHome]]. | ||
| 66 | |||
| 67 | = Troubleshooting = | ||
| 68 | |||
| 69 | == XWiki won't start without any error in the log and stay stuck on Solr initialization == | ||
| 70 | |||
| 71 | Solr has a tendency to lock itself when it has several cores to initialize. To workaround that, XWiki started creating new cores with an option to disable loading the core during Solr init (it's loaded during its first use), but you might still have some existing cores without this option set, in which case you will have to set it by hand: go to ##<permdir>/store/solr/## and edit each core ##core.properties## file to add {{code language="properties"}}loadOnStartup=false{{/code}} | ||
| 72 | |||
| 73 | == XWiki startup failed due to previous errors == | ||
| 74 | |||
| 75 | If XWiki fails to start after an upgrade that requires an upgrade of the java version (i.e. when upgrading to 16.x, which requires a switch to Java17), and the servlet container only shows a failue when starting the webapp, like: | ||
| 76 | |||
| 77 | {{code langugae="none"}} | ||
| 78 | Context [/xwiki] startup failed due to previous errors | ||
| 79 | {{/code}} | ||
| 80 | |||
| 81 | then it might be the servlet container still uses the previous java version. | ||
| 82 | For Tomcat the path to the java version in use is displayed soon after start in a line like: | ||
| 83 | |||
| 84 | {{code langugage="none"}} | ||
| 85 | [info] JVM Version: 11.0.21+9-post-Ubuntu-0ubuntu122.04 | ||
| 86 | {{/code}} | ||
| 87 | |||
| 88 | Here the first number (the "11" of the "11.0.21+9-...") indicated that tomcat is still running Java11 instead of e.g. Java17 | ||
| 89 | |||
| 90 | This problem can be caused by various sources, like a hard wired ##JAVA_HOME## in some configuration file (like. ##/etc/default/tomcat9##). | ||
| 91 | |||
| 92 | For Debian based distributions it seems one symbolic link in ##/usr/lib/jvm## is not changed an needs to be updated manually. If you get an output like: | ||
| 93 | |||
| 94 | {{code language="none"}} | ||
| 95 | # ls -l /usr/lib/jvm/ | ||
| 96 | lrwxrwxrwx 1 root root 25 Dec 30 2018 default-java -> java-1.11.0-openjdk-amd64 | ||
| 97 | lrwxrwxrwx 1 root root 21 Jan 17 2020 java-1.11.0-openjdk-amd64 -> java-11-openjdk-amd64 | ||
| 98 | drwxr-xr-x 7 root root 4096 Jan 24 15:49 java-11-openjdk-amd64 | ||
| 99 | lrwxrwxrwx 1 root root 21 Jan 31 00:08 java-1.17.0-openjdk-amd64 -> java-17-openjdk-amd64 | ||
| 100 | drwxr-xr-x 7 root root 4096 Feb 3 22:59 java-17-openjdk-amd64 | ||
| 101 | {{/code}} | ||
| 102 | |||
| 103 | then you neeed to update the ##default-java## link explicitely e.g. by: | ||
| 104 | |||
| 105 | {{code language="none"}} | ||
| 106 | # cd /usr/lib/jvm | ||
| 107 | # rm default-java; ln -s java-17-openjdk-amd64 default-java | ||
| 108 | {{/code}} |
