Steps

To bring an XWiki instance back from a backup, on the server it came from or on a new one:

1. Install the XWiki version the backup was taken from, and upgrade afterwards rather than restoring into a newer version.
2. Stop the servlet container.
3. 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.
4. Restore the permanent directory to the location the restored xwiki.properties names.
5. Restore the database with the command of your database.
6. 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.
7. Update the reverse proxy configuration if the instance now answers on a different host name or address, and reload the proxy.
8. Start the servlet container.
9. Open the wiki in a browser. It serves the content the backup holds, and the "Administration" reports the version installed in the first step.

FAQ

The instance answers on a new address. What else has to change?

The database brings back the settings that named the old environment, starting with the "Alias" of the wiki descriptor. Clone an XWiki Instance goes through them.

Can I restore over a running instance?

No. The servlet container has to be stopped first, otherwise XWiki keeps writing to the files and the database while they are being replaced.

Does the restore bring back the instance id?

Yes, the whole xwikiid table comes back with the database. That is what a repaired server wants and what a clone does not, which is why Clone an XWiki Instance leaves that table out.

Related

• Database Backup and Restore Commands
• Clone an XWiki Instance
• Move XWiki to a New Server and Upgrade it