5 1 0:Micro Focus GroupWise Restore

From SEPsesam

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


The Novell corporate brand has been acquired by Micro Focus. The Novell GroupWise product name is now Micro Focus GroupWise; however, SEP sesam documentation update (such as names and screenshots) to reflect these changes is being done in a phased manner, therefore Micro Focus GroupWise may still appear under the name Novell GroupWise.

SEP sesam enables you to restore all or only selected parts of your GroupWise system – a domain, a mailbox or a single message. Before you begin, check that all the prerequisites are met.

Key features

  • Micro Focus GroupWise restore is simple, guided and similar to a regular file system restore.
  • There are two ways to restore your Micro Focus GroupWise in SEP sesam: via the GUI restore wizard or via the web Restore Assistant (as of v. ≥ SEP sesam 5.0.0 Jaglion). Although most options are the same in both restore interfaces, the web Restore Assistant interface is more intuitive and offers additional advanced options.

Restore options

The SEP sesam Micro Focus Client supports path relocation for restored data. The following options are available after restoring GroupWise to the restore area:

  • restore single objects from user mailbox (restore post office to the restore area, user via Groupwise Windows client)
  • restore the complete mailbox (restore post office to restore area, administrative recovery by admin via ConsoleOne/AdminConsole)
  • restore domains (restore the domain to a temporary folder and use of the required files)
  • restore libraries (restore the library directories or databases from post office (for libraries that have their storage in the post office), restore the external storage structure into a temporary directory and use the required files)


Before performing Micro Focus GroupWise restore, check the following prerequisites:

  • For a successful restore, all preparation steps must be performed properly. For details, see Micro Focus GroupWise Backup.
  • Depending on what you want to restore, make sure you have the required 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. By default, the target data store for the restore is the same data store that was used for the backup.

Restoring Micro Focus GroupWise data

Restore GroupWise data as a normal file restore into the restore area you have defined in your GroupWise system. Note that you can restore missing objects via the GroupWise Windows client or as an administrator via ConsoleOne. For details, refer to the relevant version of the relevant Micro Focus GroupWise documentation.

Depending on the interface you are using, follow the appropriate procedure to restore a Micro Focus GroupWise server data:

Restore via the GUI

  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. 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.
  4. Under the Saved in period drop-down lists, specify the time frame for which you want to conduct the search. Click Next.
  5. The search results are displayed. From the list of savesets matching your query, click the version you want to restore. Click Next.

  6. In the Select Files dialog, select the data you want to restore and click Next.

  7. Under the Target Settings, set the following options:
    • Under the Target path settings, select New restore target and make sure that the option Original tree structure is selected.

    • Then click the Expert Options button, switch to the Relocation tab and select With relocation. Select the source folder from the left drop-down list and target folder from the right.
    • Note
      The Expert Options button for specifying advanced restore options is available only in advanced UI mode (formerly expert GUI mode). To use Expert Options, make sure your UI mode is set to advanced. For details, see Selecting UI mode.

      Click OK and then Next.
  8. In the last step of the restore wizard, you can review all the settings of your restore task. You can also edit the settings using the Change Selection button. If you want to start your GroupWise restore immediately, click Start. If you want to save the restore task, click Save.
A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see Scheduling Restore.

Restore via the Restore Assistant

As of v. ≥ SEP sesam 5.0.0 Jaglion, you can use the web Restore Assistant to restore Micro Focus GroupWise data.

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/.
  • If you cannot access the web Restore Assistant, check that you have been given 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.


The following steps are performed in simple 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 path, mail, HCL Domino, and Micro Focus Groupwise backups in advanced UI mode.

  1. Open Restore Assistant in the browser.
  2. In the Start window, select Micro Focus GroupWise and click Next.
  3. In the Client window, select your client and click Next.

  4. In the Task window, select your backup task from the Task selection. A backup task defines the source data that was backed up by the client.
  5. Tip
    You can search for a file or directory by entering your search term in the Search for files or directories in all backups field.

    Under Backup selection, select the exact backup version you want to restore. You can use the calendar function in the upper right corner to set a date range for the displayed backups. Click Next.

  6. In the Files window, select your GroupWise post office or domain folder. Click Next.

  7. Select the options in the Target window:
    1. Select the target client for the restore. Note that only clients with OS OES-Linux can be selected as the target for GroupWise restore.
    2. You can enter or browse the path to the target GroupWise restore area. You must also configure Relocation. Click the Relocation button and set the following:
      Restore to target node <name>
      Files from this path: Select the backup source folder from the drop-down list on the left.
      will be restored directly to the following path: Select or browse for the destination folder of the restore area from the drop-down list on the right.
      Click Save selection.

    3. Under the Execution options, you can set additional restore options:
    4. Do not overwrite existing items (selected by default): Files are only restored if they do not already exist on the target system.
      Overwrite existing items: If the data exists on the target server, it is replaced with the restored version.
    5. Decide how you want to restore your data (keep the original tree structure or flat):
    6. Keep original tree structure: When restoring to the original location, the Keep original tree structure option is selected by default. The directory structure of the restored files is the same as the original directory structure of the backed up data.
      Restore all items flat in the selected target directory: The backup is simply restored to a file without recreating the directory structure.
      Click Next.
  8. In the Finish window, review the summary of your restore task (restore type (based on task type, client, backup level, restore options) and click Start 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). The restore overview provides detailed information on the last run of restore jobs, including task name, status (successful, error, in queue...), start and stop time of the last backup, data size, throughput, etc. For details, see SEP sesam Web UI or Restores by State in the GUI.

See also

Micro Focus GroupWise BackupMicro Focus GroupWise ConfigurationRestore AssistantStandard 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.