5 1 0:Kopano Restore

From SEPsesam


Welcome to the latest SEP sesam documentation version 5.1.0 Apollon. For previous documentation version(s), check documentation archive.


Overview


The SEP sesam online module for Kopano (formerly Zarafa) provides hot backup and restore of Kopano groupware servers. This includes backup and restore of single user mails, mailboxes and public folders.

Restore interfaces

There are two ways to restore your Kopano mail(s) in SEP sesam: using the GUI restore wizard or via the web interface Restore Assistant. Although most options are the same in both restore interfaces, the web Restore Assistant is more intuitive and offers additional advanced options. Scheduling restore is only supported in GUI mode. For details, see Scheduling Restore.

In the GUI, the restore is triggered from the Menu bar -> Activities -> Restore. The restore wizard guides you through the process of restoring your data. For general step-by-step procedure, see Standard Restore Procedure.

Prerequisites

Before you perform Kopano restore, check the following prerequisites:

  • Depending on what you want to restore, make sure that you have the proper restore permissions and access rights. For details, see User Roles and Permissions.
  • Make sure that there is sufficient free space on the target system to which you are restoring your data.

Configuring Kopano restore

SEP sesam supports the restore of single items (such as e-mails and contacts from the backup) as well as the full mailbox restore.

Depending on the interface you are using, follow the appropriate procedure to restore Kopano mail(s):

When restoring individual mails, the only option you can select in the last step of the restore wizard is Auto recover after restore. If selected, SEP sesam will import the mail(s) into the original mailbox. Otherwise, the exported mail data and index files will be restored into the file system to <SESAMVAR>/work/kopano and can be imported manually with the regular Kopano command (kopano-backup).

For details on how to configure a restore task and a description of different restore options, see Standard Restore Procedure and Restore Assistant. Only Kopano-specific steps and options are described in this section.

If you prefer to watch a video, you can learn all the steps in Backup and restore of Kopano with SEP sesam.

Kopano restore via GUI

Before you begin, make sure that the prerequisites are met. This example shows the procedure for restoring a single mail into the original folder. The procedure differs slightly depending on whether you are restoring a single mail or a regular mailbox. In the latter case, the complete mailbox is selected instead of an individual mail (refer to steps 4 and 5).

  1. From the SEP sesam GUI menu bar, select Activities -> Restore. The New Restore Task window opens.
  2. Select what you want to restore. You can search savesets by task name or by filename or path.
  3. Under the Saved in period drop-down lists, specify the time frame for which you want to conduct the search. Click Next.
  4. The search results are displayed. From the list of savesets matching your query, click the version you want to restore. Click Next.
  5. Note
    If you want to perform a complete mailbox restore, select Complete restore of selected task and set additional restore options in the final step of the wizard. For details, see Standard Restore Procedure.
  6. In the Select Files window, select a single mail you want to restore. Click Next.
  7. In the Target Settings window you can set additional restore options. To restore to the original location, under the Execution options drop-down list, select Auto recover after restore. Note that all other fields must stay unchanged.
  8. In the final step of the restore wizard (Summary window), you can review all the settings of your restore task. You can start the restore immediately or save the restore task as a template for future use.
Note
A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see Scheduling Restore.

Kopano restore via Restore Assistant

You can access the Restore Assistant in one of the following ways:

  • via the GUI: by clicking the Restore Assistant icon in the toolbar or from Activities -> Restore Assistant
  • from SEP sesam Web UI: left menu -> Restore Assistant
  • or by entering the following address in the browser bar: http://[sesamserver]:11401/sep/ui/restore/.
Note
  • If you cannot access the web Restore Assistant, check if you have received the appropriate permissions for online restore.
  • The operations and options available after logging in may differ depending on the user type. Other Web UI display restrictions may depend on the custom roles with specific permissions and the UI mode.
    For details, see About Authentication and Authorization and User Roles and Permissions.
Steps

The following steps are performed in basic UI mode. They cover the most common restore cases and are the recommended method for performing a restore. For more experienced users, some additional restore options are available in advanced restore mode. For details, see Restoring Kopano in advanced UI mode.

  1. Open the Restore Assistant in the browser.
  2. In the start window, select Kopano Groupware and click Next.

  3. In the Groupware Server window, under Client selection for restore, select your target client to which the data will be restored.
  4. In the Task window, under Task selection, select your source backup task.
    Under Backup selection, select the exact backup version you want to restore. Note that Generation restore is selected by default. You can use the calendar function in the upper right corner to set a date range for the displayed backups.
    Click Next.
  5. In the Files window, select the mailboxes to restore or drill down to select a single mail you want to restore. Click Next.
  6. In the Target window you can set additional restore options. To restore to the original location, under the Execution options, select Auto recover after restore. Note that all other fields must stay unchanged. Click Next.
  7. Optionally, in advanced UI mode, you can select additional restore options in the Options window.
  8. In the last step, check the summary of your restore task (restore type (based on task type, selected backup, its date and details, restore options, etc.) and click Start restore.

Restoring single items via mount

Note that this section provides information about a Kopano restore via the GUI. For details on restoring via a web interface, see Restore Assistant.

Note
The Mount saveset option is available only in advanced UI mode. To use the mount option, make sure your UI mode is set to advanced, as described in Selecting UI mode.
  • Before starting a restore, check the restrictions that apply to mounting.
  • Make sure that the UI mode is set to advanced.
    The currently active mode is displayed at the top of the SEP sesam application window.

Create a new restore task for individual item(s) you want to restore.

  1. From the SEP sesam GUI menu bar, select Activities -> Restore. The New Restore Task window opens.
  2. Select what you want to restore. You can search savesets by task name or by filename or path.
    • When searching by task name, use the drop-down list of available tasks and select the one you want to restore from. This option is selected by default.
    • If you are searching by filename/path, select the option Filename or path in a saveset and enter your search expression in the search pattern field.
  3. Under the Saved in period drop-down lists, specify the time frame for which you want to conduct the search. Click Next.
  4. The search results are displayed. From the list of savesets matching your query, select the version from which you want to restore an individual file. Then select the check box Mount saveset under Single file restore via Mount. You can mount any saveset stored to default data store Path, to Si3 deduplication store or to HPE StoreOnce. Mounting is not possible if the savesets are stored to tapes or if the data is compressed or encrypted.

  5. The selected saveset is mounted to the SEP sesam home directory var\tmp\mnt. Click OK.
  6. In the Select Files window, select the single mails you want to restore and click Next.
  7. In the next step of the restore wizard (Target Settings), select a restore target where you want to restore your files.
  8. In the final step of the restore wizard, you can review all the settings of your restore task. You can start your single item restore immediately by clicking Start. If you want to save the restore task, click Save.
  9. Click OK to unmount the saveset and close your restore session.
Note
A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see Scheduling Restore.

Monitoring restore

You can monitor the restore progress using the Web UI (Monitoring -> Restores) or view the status in the GUI (Main Selection -> Job State -> Restores). Restore overview provides detailed information on the last run of restore jobs, including the task name, status (successful, error, in queue...), start and stop time of the last backup, data size, throughput, client and message.


See also

Restore AssistantKopano BackupStandard Restore Procedure

Copyright © SEP AG 1999-2024. All rights reserved.
Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.