5 1 0:OpenNebula Restore

From SEPsesam

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

Virtualization Are you looking for an alternative for your VMware environment?

SEP supports a range of hypervisors, offering snapshot-based online backup of VMs.

Click HERE to get an overview of the available SEP modules and explore supported features like CBT, Single File Restore, and more.


SEP sesam provides efficient data protection for virtual machines (VMs) running in OpenNebula environments. By using the SEP Sesam OpenNebula module, you can benefit from online backup and restore of your virtual machines including configuration.

Key features

  • The restore of OpenNebula VMs is simple, guided and similar to regular file system restore. Note that you can only restore one VM at a time.
  • There are two ways to restore your virtual machines (VMs) 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.
Restore options
  • By default, the OpenNebula restore is always performed to the same data store that was used for backup.
  • You can select an alternative location to restore your data by specifying:
  •  -a drbd_prefix=/path/to/dbrd


Before you perform OpenNebula restore, check the following prerequisites:

  • To successfully restore an OpenNebula backup, all preparation steps must be performed properly. For details, see OpenNebula Backup.
  • 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; by default, the target data store for restore is the same data store that was used for the backup.
  • SFR of backups from virtualization platforms requires the guestfs-tools package to be installed on Linux in order to access and mount VM disk image on Linux. If the package is not installed on your SEP sesam Server or Linux RDS, it is not possible to mount VMDK and perform SFR. For details, see OpenNebula Single File Restore and Installing guestfs-tools on Linux.
  • During restore, it is recommended that you stop all activities on the target.
Watch a short demo on how to configure, backup and restore OpenNebula: Convenient Backup and Restore of OpenNebula.

Restoring an OpenNebula virtual machine

Depending on the interface you are using, follow the appropriate procedure to restore an OpenNebula VM:

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

VM 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.
    • 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 searching by filename/path, select the option Filename or path in saveset and enter your search expression in the search pattern field.
    Under the Saved in period drop-down lists, specify the time frame for which you want to conduct the search. Click Next.
  3. The search results are displayed. From the list of savesets matching your query, select the task you want to restore. The restore types Complete restore of selected task and Generation restore are selected by default and cannot be deselected. Click Next.
  4. Review your configured restore task and set additional options, if necessary.
    • Details of the selected saveset are displayed at the top and at the bottom (Optional data source selection) of the window. The name of the restore task is automatically generated in the Restore task name field. You can edit the name and add a comment below.
    • Under the Target data, select one of the following options:
      • Restore to original VM (set by default): If selected, the data will be restored to the same location from which it was backed up. Note that this only applies if the target node is the same server from which the data was backed up, i.e., when the source and target server are the same.
      • Restore with new VM name: If selected, the target VM name will be automatically created.
      • Change VM target selection: If selected, the data will be restored to another location. If you are restoring a VM to a different location, you have to select a new target from the Target node drop-down list.
    • Under the VM restore options drop-down list, select one of the following options:
      • Do not overwrite existing items (set by default): the VM will not be restored if it already exists on the target server
      • Overwrite existing items: if data exists on the target server, it will be replaced by the restored version
      • Create new version: if data exists on the target server, the restored data will be restored under a different name
      • (Do not) start virtual machine after restore: You can also define if you want to start a virtual machine after restore or not.
    • Preferred media pool: If the data was migrated or replicated and different media pools were used for the process, the source media pool to restore from can be selected from the drop-down list of available media pools.
    • Used media | barcode: If the data was migrated, the migrated copy is stored to another media; the source media to restore from can be selected from the drop-down list of available media.
    • Optionally, you can select the Drive with backed up data from the drop-down list.
    • The Interface field shows the server (RDS server or SEP sesam Server) with the attached data storage containing the selected saveset. You can select another interface from the drop-down list.
  5. Click the Expert Options button if you want to specify additional restore settings, e.g., modify the log level, define the pre/post script for restore, etc. For details, see the Restore wizard.
  6. 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.
  7. In the final step of the restore wizard, you can review all the settings of your restore task. You can also edit the settings by using Change Selection button. If you want to start your 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.

VM restore via the 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/.
  • 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.

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 VMs in advanced UI mode.

  1. Open the Restore Assistant in the browser.
  2. In the start window, select OpenNebula and click Next.
  3. In the Virtual Machine window, under Selection of the server, select your target server to which the data will be restored.
    Under Selection of the virtual machine select the VM you want to restore and click Next.
  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 Target window, under the Target selection select your target OpenNebula server. Note that the target VM will be created under a new name. The name will be known after the restore.
    Click Next.
  6. Modify or set additional restore options under the Virtualization restore options:
    • Recovery options: Specify whether or not to start the VM after restore.
    • Under Target options of the virtual machine select the data store from the drop-down list (by default, the restore is done to the same data store where the data was backed up).
    • Under Advanced restore options, you can further refine the restore:
      • Use the Log, Special Options tab to change the log level for your specific restore, see Setting Log Level. You can specify additional commands that may be useful for specific options of the sbc command. For details about the commands, see SBC CLI.
      • Use the Retention, Generation, Pre/Post tab if you want to specify the retention period parameter for the restore (how long (in days) the restore task is kept), enable/disable a generation restore, and specify whether to apply a pre- or post-script to the restore task, see Pre/Post options.
    Click Next.
  7. 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.

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

OpenNebula Single File RestoreStandard Restore ProcedureRestore AssistantOpenNebula Backup

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.