Wiki source code of Backup
Version 3.1 by Ludovic Dubost on 2009/10/09
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
1.2 | 1 | #startfloatingbox() |
2 | *Contents* | ||
![]() |
2.1 | 3 | |
![]() |
1.2 | 4 | #endfloatingbox() |
5 | |||
![]() |
1.1 | 6 | 1 Backup/Restore |
7 | |||
8 | 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. | ||
9 | |||
10 | 1.1 Backup configuration files | ||
11 | |||
12 | There are 2 configuration files you'll need to backup: | ||
![]() |
2.1 | 13 | * WEB-INF/xwiki.cfg: general XWiki configuration file |
14 | * WEB-INF/hibernate.cfg.xml: Hibernate configuration file | ||
![]() |
1.1 | 15 | |
16 | In addition you may want to also backup any extra files you'll have installed in your XWiki installation such as JDBC drivers, extra plugins, etc. | ||
17 | |||
18 | To restore them simply copy them at the same location where you backupped them from. | ||
19 | |||
20 | 1.1 Backup your database | ||
21 | |||
22 | XWiki stores all its data in a database so all you need to do to save you wiki's data is backup that database. | ||
23 | |||
![]() |
2.1 | 24 | 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. |
![]() |
1.1 | 25 | |
26 | 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. | ||
27 | |||
![]() |
3.1 | 28 | * *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. |
29 | * *Oracle*: use "exp" to export data and "imp" to restore it. | ||
![]() |
1.3 | 30 | |
![]() |
1.1 | 31 | 1.1 Use the XWiki Import/Export tool |
32 | |||
![]() |
1.5 | 33 | 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>ImportExport]. 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. As a consequence the recommended backup strategy is to backup the databases. It's much etter to use a specialized backup tool that'll bbackup the database, perform incremental backups, verify backup integrity, etc. |
![]() |
1.1 | 34 | |
![]() |
1.5 | 35 | The Import/Export should be reserved for the following use cases: |
36 | * move data across XWiki instances, including sharing of applications between separate instances | ||
37 | * move data to another wiki | ||
38 |