Changes for page Upgrading

Last modified by Vincent Massol on 2023/11/14

<
From version < 8.1 >
edited by Vincent Massol
on 2013/08/26
To version < 9.1 >
edited by Vincent Massol
on 2013/12/02
>
Change comment: Added explanations about "invalid extensions" you get when upgrading

Summary

Details

Page properties
Content
... ... @@ -2,7 +2,7 @@
2 2  
3 3  {{toc/}}
4 4  
5 -= Upgrading webapp =
5 += Upgrading the webapp =
6 6  
7 7  The general strategy is to [[download the WAR distribution>>xwiki:Main.Download]] and to replace your current installed WAR. Make sure you don't copy on top since this could leave some old files around which would make XWiki fail (like if old JARs are lying around in ##WEB-INF/lib##).
8 8  
... ... @@ -33,6 +33,19 @@
33 33  Ensure that these tables are dropped before restarting a failed migration.
34 34  {{/warning}}
35 35  
36 +== Invalid Extensions ==
37 +
38 +Also note that when you upgrade, some extensions that were previously valid may become invalid (for example they may have been renamed, removed or have versions that do not match the version of the WAR you've installed as is the case with the example below). In this case you'll see in the console messages such as:
39 +
40 +{{code language="noformat"}}
41 +2013-12-02 11:43:01,688 [localhost-startStop-1] WARN ltInstalledExtensionRepository - Invalid extension [org.xwiki.enterprise:xwiki-enterprise-ui-common-5.2.1] on namespace [wiki:xwiki]
42 +2013-12-02 11:43:01,688 [localhost-startStop-1] WARN ltInstalledExtensionRepository - Invalid extension [org.xwiki.platform:xwiki-platform-workspace-ui-5.2.1] on namespace [wiki:xwiki]
43 +2013-12-02 11:43:01,688 [localhost-startStop-1] WARN ltInstalledExtensionRepository - Invalid extension [org.xwiki.enterprise:xwiki-enterprise-ui-mainwiki-5.2.1] on namespace [wiki:xwiki]
44 +2013-12-02 11:43:01,689 [localhost-startStop-1] WARN ltInstalledExtensionRepository - Invalid extension [org.xwiki.enterprise:xwiki-enterprise-ui-wiki-all-5.2.1] on namespace [wiki:workspacetemplate]
45 +{{/code}}
46 +
47 +These are just warnings and don't affect that stability of your instance. Actually the Distribution Wizard you get (see the next section on "Upgrading wiki documents") will ask you to upgrade those invalid extensions and will remove the old versions that became invalid.
48 +
36 36  = Upgrading wiki documents =
37 37  
38 38  Starting with XWiki 4.3+ the recommended way to upgrade an XWiki installation is to use the [[Distribution Wizard>>Features.DistributionWizard]] which is automatically triggered after you upgrade the XWiki WAR. It allows you to automatically upgrade extensions installed in your wiki, supporting automatic merges and conflict resolution.

Get Connected