11 Mar
2011
11 Mar
'11
8:56 p.m.
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#HUpgradinganXWi…
--
Sergiu Dumitriu
http://purl.org/net/sergiu/