Last modified by Thomas Mortagne on 2023/10/13

From version 16.1
edited by Marius Dumitru Florea
on 2013/01/14
Change comment: There is no comment for this version
To version 17.1
edited by Denis Gervalle
on 2013/01/14
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.mflorea
1 +XWiki.dgervalle
Content
... ... @@ -2,6 +2,10 @@
2 2  {{toc/}}
3 3  {{/box}}
4 4  
5 +{{warning}}
6 +If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue [[XWIKI-8129>>http://jira.xwiki.org/browse/XWIKI-8129]]. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki.
7 +{{/warning}}
8 +
5 5  This is the release notes for XWiki Platform, XWiki Enterprise and XWiki Enterprise Manager. They share the same release notes as they are released together and have the same version.
6 6  
7 7  <insert description of release here>
... ... @@ -112,6 +112,11 @@
112 112  
113 113  == General Notes ==
114 114  
119 +{{warning}}
120 +PLEASE, BACKUP YOUR DATABASE BEFORE STARTING YOUR WIKI.
121 +AUTOMATED MIGRATION PROCEDURE TAKE PLACE AT STARTUP AND YOU MAY NEED TO START OVER IF YOU ENCOUNTER AN UNEXPECTED ISSUE.
122 +{{/warning}}
123 +
115 115  You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
116 116  
117 117  {{warning}}
... ... @@ -118,6 +118,14 @@
118 118  Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were added. Note that you should add ##xwiki.store.migration=1## so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.
119 119  {{/warning}}
120 120  
130 +{{warning}}
131 +If you are migrating from an earlier version than 4.0, and your database contains statistics collected using a version earlier than 2.2, you will probably encounter an issue during our automated database migration. To avoid that issue, you will need to clean up your statistics by executing some SQL commands described in issue [[XWIKI-8129>>http://jira.xwiki.org/browse/XWIKI-8129]]. Be sure to apply these before attempting the migration. If your are in doubt, apply it, these could not hurt. If you don't, you will face duplicate IDs errors during the migration process, and it will fail, preventing you to run your wiki.
132 +{{/warning}}
133 +
134 +{{warning}}
135 +If you have encountered an issue with the migration, you may need to start over from a backup. Be careful that during the migration, two new tables have been created (in each xwiki database for a farm) and should be dropped when you restore a backup of a database coming from a version earlier than 4.x. These two tables are DATABASECHANGELOG and DATABASECHANGELOGLOCK. These should only be removed if you restore a pre-4.x database schema. Mixing an old database with these two tables will surely cause issue during schema updates (liquibase checksum failure).
136 +{{/warning}}
137 +
121 121  == Issues specific to XWiki 4.5M1 ==
122 122  
123 123  <issues specific to the project>

Get Connected