Backup-tool

From Zarafa wiki

Jump to: navigation, search

Contents

How make a brick-level backup

The Zarafa commercial editions also include a brick level backup. Using this backup tool, you can create a backup for individual mailboxes. With this backup you can restore a single item, folder or mailbox.

The Zarafa Brick level backup contains two tools:

zarafa-backup
zarafa-restore


Creating a brick level backup

zarafa-backup -u username

With the -a option you can create a backup for all users and the public folder. See the man page for more options of the zarafa-backup tool.

The zarafa-backup tool will create two files in the current directory:

username.index.zbk 
username.data.zbk

The data file contains all items of the mailbox of the user (including all attachments). The index file is a text file which contains all information about the items, like the subject, received date and other information.

If you run the backup tool a second time, the backup tool will do an incremental backup of only the latest/changed items. The incremental file will get the name username.data.zbk.1.

The index file will be extended with the latest changes.

Hint: to be able to restore all items of a mailbox from a specific date the index file from this day is needed.


Restoring an item of folder

To restore a single item or folder you need to have the restore key of the item. In the directory /usr/share/zarafa-backup there is a script called readable-index.pl.

This script will show the index file in a user-friendly view, so you can select the restore key on an item.

readable-index.pl username.index.zbk | less

The first column of this view is the restorekey. This restorekey is used to restore and item or folder.

To restore an items to the original location, run:

zarafa-restore -u <username> <restorekey>


If you want to restore a complete folder, you need to select the restore key of a folder and restore it with the following command:

zarafa-restore -r -u username restorekey


Full mailbox restore

To restore a complete mailbox, there is a full-restore script available in the directory /usr/share/zarafa-backup.

To restore the full mailbox, execute:

 full-restore.sh <user> <newuser>

When the second parameter is left empty the backup will be restored to the same name.

Personal tools