On 03/11/2011 08:03 PM, Ramon Gomes Brandão - SERINT wrote:
Hi XWiki Team,
Sorry if this is a recurring thread, but can't find more details on it. I'm using XE 2.4.30451 in production enviromnent on my company, and due to the numerous new functionalities of the new XWiki versions, I'm planning to migrate to 2.7.1, and after to 3.0.
My question is: can I upgrade it as easy as just replacing the entire old war file with the new one (of course, with the tunings I've made on it, such as WYSIWYG macros, footnotes etc, setting the schema migration flag on xwiki.cfg? Won't I lose any of my documents, pages, attachments, comments etc at all? Of course I'll test it first, outside the production, but I would like to gather as much information I can to plan the entire migration process. We have a very large set of pages already on the wiki, and I wouldn't like to face big problems :-)
Normally, yes. All the documents are in the database, so all that's important in the war is: - the xwiki.cfg and xwiki.properties configuration files - the database connector jar - any other jars you added, or files you manually changed Then you should import some of the documents from the new XAR, since many features come inside wiki pages. This is a bit more difficult, since you don't want to override changed configuration documents (like XWikiAdminGroup or XWikiPreferences), or documents you have changed (like Main.WebHome or Panels.QuickLinks). What can break things is changed APIs or behavior changes caused by bugfixing (which means that some code was exploiting a bug). For example, you might get deprecation warnings in the server logs. If you properly upgrade the entire war, and you import the new xar, there should be no headaches. More detailed instructions at: http://platform.xwiki.org/xwiki/bin/AdminGuide/Installation#HUpgradinganXWik... -- Sergiu Dumitriu http://purl.org/net/sergiu/