Wiki source code of Restore an XWiki Instance
Last modified by Eleni Cojocariu-testing account on 2026/08/21 15:47
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | To bring an XWiki instance back from a [[backup>>doc:documentation.xs.admin.backup.WebHome]], on the server it came from or on a new one: |
| 2 | |||
| 3 | 1. Install the XWiki version the backup was taken from, and [[upgrade>>doc:documentation.xs.admin.upgrade.WebHome]] afterwards rather than restoring into a newer version. | ||
| 4 | 1. Stop the servlet container. | ||
| 5 | 1. Restore into the web application the files you copied out of it: ##WEB-INF/hibernate.cfg.xml##, ##WEB-INF/xwiki.cfg##, ##WEB-INF/xwiki.properties##, ##WEB-INF/classes/logback.xml##, ##WEB-INF/observation##, the JDBC driver in ##WEB-INF/lib## and any skin under ##skins##. | ||
| 6 | 1. Restore the [[permanent directory>>doc:documentation.xs.admin.configuration.directories.permanent-directory.WebHome]] to the location the restored ##xwiki.properties## names. | ||
| 7 | 1. Restore the database with [[the command of your database>>doc:documentation.xs.admin.backup.database-commands.WebHome]]. | ||
| 8 | 1. Recreate the database user that the restored ##hibernate.cfg.xml## authenticates with, if the database server is a new one, [[with the password that file holds>>doc:documentation.xs.admin.backup.database-commands.WebHome]]. | ||
| 9 | 1. Update the [[reverse proxy>>doc:documentation.xs.admin.installation.http-reverse-proxy.WebHome]] configuration if the instance now answers on a different host name or address, and reload the proxy. | ||
| 10 | 1. Start the servlet container. | ||
| 11 | 1. Open the wiki in a browser. It serves the content the backup holds, and the "Administration" reports the version installed in the first step. |
