Installation and Setup

Backup/Restore

When upgrading from earlier versions of AtomicWiki and/or eXist, make sure you always create a backup of your data first. This is done via the standard backup/restore tools that ship with eXist. When launching the eXist admin client, replace the server URL with

xmldb:exist://localhost:8000/xmlrpc

or the corresponding port and context of your AtomicWiki installation (you always need to add the /xmlrpc).

If you need to restore from a backup into an existing AtomicWiki install, make sure to remove the old data first by deleting the contents of the webapp/WEB-INF/data directory.

Automatic Restore

We prepared an Ant task to make restoring/upgrading easier. The task will restore a specified backup archive, then run an automatic migration process to upgrade old data. This is important as the database layout may have changed between AtomicWiki versions. There have been a few modifications recently. It is thus possible that your restored data does no longer match the expectations of the protocol implementation or AtomicWiki's internal organization. The restore task handles this. To run it, call

build.sh -Dbackup.zip restore

where backup.zip points to the backup archive you want to restore.

If you ever want to manually launch the migration process, just launch

build.sh migrate

The task will not cause any damage if your database is already up to date.