Backup/Restore

Backup/Restore

It's crucial that you define a backup strategy for your wiki so that you don't loose any data in case of a problem with your wiki installation. There are 2 strategies defined below.

Backup configuration files

There are 2 configuration files you'll need to backup:

• WEB-INF/xwiki.cfg: general XWiki configuration file
• WEB-INF/hibernate.cfg.xml: Hibernate configuration file

To restore them simply copy them at the same location where you backupped them from.

Backup your database

XWiki stores all its data in a database so all you need to do to save you wiki's data is backup that database.

If you've installed the default standalone version of XWiki then the data are saved in a Hypersonic SQL database bundled by default. It's located in a database/ directory inside the directory when you installed XWiki. Simply backup this directory and that'll backup all the Hypersonic SQL database.

If you've installed XWiki using your own database then you'll need a backup tool for that database to back it up and to restore it.

• MySQL: you can use mysqldump xwiki > xwiki.mysqldump to backup the xwiki schema (do the same for other schemas if you're in multiwiki mode) and mysql xwiki --user=root -p < xwiki.mysqldump to restore it.
• Oracle: use exp to export data and imp to restore it.

Use the XWiki Import/Export tool

Since all XWiki data are saved in XWiki pages one solution to backup a XWiki instance is simply to export all its pages. This can easily be done using the Import/Export tool. However note that this is quite a resource hungry operation and depending on the size of your wiki you may need a lot of memory.