Source:OpenNebula Restore: Difference between revisions

From SEPsesam
(Minor update.)
(Added Jaglion-related note (single file restore in restore assistant).)
(17 intermediate revisions by the same user not shown)
Line 5: Line 5:


<!--T:2-->
<!--T:2-->
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Tigon''/4.4.3 ''Beefalo V2'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]]}}</div></translate>
{{Draft}}
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Tigon''/4.4.3 ''Beefalo V2'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]]}}
 
<!--T:174-->
{{Outdated_Version/en|[[SEP_sesam_Release_Versions|4.4.3 ''Tigon (V1 and V2)'']]}}</div></translate>
<br />
<br />
<translate>==Overview == <!--T:3--></translate>
<translate>==Overview == <!--T:3--></translate>
Line 21: Line 25:


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:6-->
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:171--> [[File:SEP_Video.png|45px|link=Special:MyLanguage/Video_Tutorials_&_Screencasts|videos & screencasts]]</translate>
[[File:SEP_Video.png|45px|link=Special:MyLanguage/Video Tutorials & Screencasts]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |<span style="color:black"><sup>'''<translate><!--T:172--> NEW</translate>'''</sup></span> <translate><!--T:173--> Watch SEP sesam video [https://www.youtube.com/watch?v=QxXWesrJyEs&list=PLoTFTskMneqNf9mFaRFVunX_UwbaGmwTb&index=2 Backup and restore of OpenNebula with SEP sesam].</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
<translate><!--T:7-->
Watch SEP sesam [[Special:MyLanguage/Video_Tutorials_&_Screencasts|videos & screencasts]].</translate>
|}
|}


Line 45: Line 46:
</div>
</div>
<translate><!--T:12-->
<translate><!--T:12-->
The [[Special:MyLanguage/SEP_sesam_Glossary#restore|restore]] of virtual machines (VMs) is quite similar to a regular file system restore. There are two ways to restore your OpenNebula virtual machines (VMs) in SEP sesam: by using '''GUI restore wizard''' (described below) or through the web interface '''Restore Assistant''' (in v. ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo'']]). Even though most of the options are the same in both restore interfaces, the web Restore Assistant interface is designed to be more intuitive and offers additional advanced options. However, it cannot be used for scheduling restore, as scheduling is only supported in the GUI mode. For details, see [[Special:MyLanguage/Restore_Assistant|Restore Assistant]].
The [[Special:MyLanguage/SEP_sesam_Glossary#restore|restore]] of virtual machines (VMs) is quite similar to a regular file system restore. There are two ways to restore your OpenNebula virtual machines (VMs) in SEP sesam: by using '''GUI restore wizard''' (described below) or through the web interface '''Restore Assistant''' (in v. ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo'']]). Even though most of the options are the same in both restore interfaces, the web Restore Assistant interface is designed to be more intuitive and offers additional advanced options. However, it cannot be used for scheduling restore or single file restore as these are only supported in the GUI mode. For details, see [[Special:MyLanguage/Restore_Assistant|Restore Assistant]].  
<!--
As of v. [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], you can also restore single files of Hyper-V virtual machines (VMs) by using the web interface ''Restore Assistant''. For details, see [[Special:MyLanguage/5_0_0:Web_Single_File_Restore_for_Virtual_Machines|Web Single File Restore for Virtual Machines]].-->


<!--T:55-->
<!--T:55-->
Line 54: Line 57:


==={{anchor|options}}Restore options=== <!--T:14--></translate>  
==={{anchor|options}}Restore options=== <!--T:14--></translate>  
*<translate><!--T:15-->
<ul><li><translate><!--T:15-->
By default, the OpenNebula restore is always performed to the same [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] that was used for backup.</translate>
By default, the OpenNebula restore is always performed to the same [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] that was used for backup.</translate></li>
*<translate><!--T:16-->
<li><translate><!--T:169--> You can perform a complete OpenNebula VM restore or single file restore (in SEP sesam ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']]). In the latter case, the UI mode has to be set to ''Expert''. See [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].</translate>
You can select an alternative location to restore your data by specifying:</translate>
<li><translate><!--T:16-->
You can select an alternative location to restore your data by specifying:</translate></li>
   -a drbd_prefix=/path/to/dbrd
   -a drbd_prefix=/path/to/dbrd
</ul>


<translate>=== {{anchor|prerequisites}}Prerequisites === <!--T:17-->
<translate>=== {{anchor|prerequisites}}Prerequisites === <!--T:17-->
Line 87: Line 92:
Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</translate></li>
Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</translate></li>
<translate><!--T:47-->
<translate><!--T:47-->
[[File:OpenNebula_restore_filter.jpg|850px|link=]]</translate>
[[File:OpenNebula_restore_filter.jpg|830px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:28-->
<li><translate><!--T:28-->
The search results are displayed. From the list of save sets matching your query, select the task you want to restore and other relevant restore options (''complete'', ''generation restore''). Click '''Next'''.</translate></li>
The search results are displayed. From the list of savesets matching your query, select the task you want to restore and other relevant restore options (''complete'', ''generation restore''). Click '''Next'''.</translate></li>
<translate><!--T:29-->
<translate><!--T:29-->
[[File:OpenNebula_restore_select_task.jpg|850px|link=]]</translate>
[[File:OpenNebula_restore_select_task.jpg|830px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:30-->
<li><translate><!--T:30-->
Line 101: Line 106:
Under the '''Target data''', select one of the following options:
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 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''''': It should be used when restoring a VM to the original or a different location with a different VM name. If you are restoring a VM to a different location with a different VM name, you also have to select new target path.
**'''''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 new target server from the ''Target node'' drop-down list. </translate>
**'''''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 new target server from the ''Target node'' drop-down list. </translate>
* <translate><!--T:37-->
* <translate><!--T:37-->
Line 120: Line 125:
<li><translate><!--T:41-->
<li><translate><!--T:41-->
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 [[Special:MyLanguage/4_4_3_Beefalo:Restore#wizard|Restore wizard]].</translate></li>
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 [[Special:MyLanguage/4_4_3_Beefalo:Restore#wizard|Restore wizard]].</translate></li>
{{<translate><!--T:52--> note</translate>|<translate><!--T:53--> As of v. [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3. ''Beefalo'']], the ''Expert Options'' button for specifying more advanced restore options is only available in the [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''Advanced'' and ''Expert'' UI mode]]. It is not available for users that run the GUI in ''Basic'' mode. In the latter case, if you want to access the the ''Expert Options'' you first have to change the ''Basic'' UI mode to ''Advanced'' or ''Expert'', as described in [[Special:MyLanguage/4_4_3_Beefalo:Configuration#Beefalo|UI Mode]].</translate>}}
{{<translate><!--T:52--> note</translate>|<translate><!--T:53--> As of v. [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3. ''Beefalo'']], the ''Expert Options'' button for specifying advanced restore options is only available in the [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''Expert'' UI mode]]. It is not available for users that run the GUI in ''Basic'' or ''Advanced'' mode. In the latter case, if you want to access the ''Expert Options'' you first have to change the ''Basic/Advanced'' UI mode to ''Expert'', as described in [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].</translate>}}
<translate><!--T:31-->
<translate><!--T:31-->
[[File:OpenNebula_restore_target_settings.jpg|850px|link=]]</translate>
[[File:OpenNebula_restore_target_settings.jpg|830px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:42-->
<li><translate><!--T:42-->
Line 129: Line 134:
note</translate>|<translate><!--T:44-->
note</translate>|<translate><!--T:44-->
A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see [[Special:MyLanguage/Scheduling_Restore|Scheduling Restore]].</translate>}}
A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see [[Special:MyLanguage/Scheduling_Restore|Scheduling Restore]].</translate>}}
<translate><!--T:45-->
You can view the status of your restore jobs by selecting '''Job state''' -> '''Restores''' from the ''Main Selection''. 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.


<!--T:54-->
<translate>=={{anchor|single_file}}Restoring single files <span style="font-size:74%; font-weight:550; font-family:Arial">([[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Expert mode]] only)</span>== <!--T:151-->
As of [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can also monitor the restores online by using new Web UI. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_Web_UI|SEP sesam Web UI]].  
 
<!--T:152-->
With [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], SEP sesam introduces single file restore – item-level restore of files, folders, and volumes from the ''FULL'' or ''COPY'' backup of OpenNebula virtual machine by mounting a virtual disk on the device server and browsing the content of a virtual disk file.
Before starting a restore, check the supported file systems and [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]].
 
==={{anchor|mount}}Mounting OpenNebula virtual disk=== <!--T:153-->
 
<!--T:154-->
Create a new restore task for individual item(s) you want to restore.</translate>
<ol><li><translate><!--T:155--> From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</translate></li>
<li><translate><!--T:156--> Select what you want to restore. You can search savesets by ''task name'' or by ''filename or path''.</translate>
* <translate><!--T:157--> 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.</translate>
* <translate><!--T:158--> 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.</translate></li>
<li><translate><!--T:159--> Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</translate></li>
<li><translate><!--T:160--> 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 virtual disk(s)'''. You can mount any saveset stored to ''default data store Path'', ''Si3 deduplication store'' or ''HPE StoreOnce''. Mounting is not possible if the savesets are stored to tapes or if the data is compressed or encrypted. Note that some other [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] apply.</translate></li>
<translate><!--T:161--> [[image:OpenNebula_SFR_select_task_Beefalo_V2.jpg|830px|link=]]</translate>
<br clear=all>
<li><translate><!--T:162--> [[Special:MyLanguage/SEP_sesam_Glossary#mount|Mount]] is triggered and your virtual disk is mounted to the device server. This may take a few seconds. Click '''OK'''.</translate></li>
<translate><!--T:163--> [[image:OpenNebula_SFR_mount_Beefalo_V2.jpg|830px|link=]]</translate>
<br clear=all>
<li><translate><!--T:164--> In the ''Select Files'' window, select the folders or files you want to restore and click '''Next'''.</translate></li>
<translate><!--T:145--> [[image:OpenNebula_SFR_select_files_Beefalo_V2.jpg|830px|link=]]</translate>
<br clear=all>
<li><translate><!--T:146--> In the fourth step of the restore wizard (''Target Settings''), select a restore target (''Target node'' and ''New restore target'') where you want to restore your files.</translate></li>
<li><translate><!--T:147--> In the final step of the restore wizard, you can review all the settings of your restore task. You can start your single file restore immediately by clicking '''Start'''. If you want to save the restore task, click '''Save'''.</translate></li>
<li><translate><!--T:148--> Click '''OK''' to unmount the saveset and close your restore session.</translate></li>
</ol>
 
{{<translate><!--T:165--> note</translate>|<translate><!--T:166--> A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see [[Special:MyLanguage/Scheduling_Restore|Scheduling Restore]].</translate>}}
 
<translate>=={{anchor|monitor}}Monitoring restore== <!--T:150-->
 
<!--T:167-->
You can view the status of your restore jobs by selecting '''Job State''' -> '''Restores''' from the ''Main Selection''. 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.
 
<!--T:170-->
As of [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can also monitor the restore progress using the Web UI. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_Web_UI|SEP sesam Web UI]].


<div class="noprint">
<div class="noprint">
==See also== <!--T:46-->
==See also== <!--T:46-->
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/4 4 3_Tigon:OpenNebula_Backup|OpenNebula Backup]]</div></translate>
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/4 4 3_Tigon:OpenNebula_Backup|OpenNebula Backup]]</div></translate>

Revision as of 14:04, 21 April 2021

Other languages:

Template:Copyright SEP AG en

Draft.png WORK IN PROGRESS
This article is in the initial stage and may be updated, replaced or deleted at any time. It is inappropriate to use this document as reference material as it is a work in progress and should be treated as such.
Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Tigon/4.4.3 Beefalo V2. For previous documentation version(s), check documentation archive.


Information sign.png SEP AG has discontinued support for SEP sesam version 4.4.3 Tigon (V1 and V2). Instructions are still available for these SEP sesam products, however, SEP AG accepts no responsibility or liability for any errors or inaccuracies in the instructions or for the incorrect operation of obsolete SEP sesam software. It is strongly recommended that you update your SEP sesam software to the latest version.


Overview

The restore of virtual machines (VMs) is quite similar to a regular file system restore. There are two ways to restore your OpenNebula virtual machines (VMs) in SEP sesam: by using GUI restore wizard (described below) or through the web interface Restore Assistant (in v. ≥ 4.4.3 Beefalo). Even though most of the options are the same in both restore interfaces, the web Restore Assistant interface is designed to be more intuitive and offers additional advanced options. However, it cannot be used for scheduling restore or single file restore as these are only supported in the GUI mode. For details, see Restore Assistant.

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 step-by-step procedure, see Standard Restore Procedure.

To successfully restore an OpenNebula backup, all preparation steps must be performed properly. For details, see OpenNebula Backup.

Restore options

  • By default, the OpenNebula restore is always performed to the same data store that was used for backup.
  • You can perform a complete OpenNebula VM restore or single file restore (in SEP sesam ≥ 4.4.3 Beefalo V2). In the latter case, the UI mode has to be set to Expert. See Selecting UI mode.
  • You can select an alternative location to restore your data by specifying:
  • -a drbd_prefix=/path/to/dbrd

Prerequisites

Before you perform OpenNebula restore, check the following prerequisites:

  • Depending on what you want to restore, make sure that you have the proper restore permissions and access rights.
  • 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.
  • During restore, it is recommended that you stop all activities on the target.

Restoring an OpenNebula virtual machine

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

  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. OpenNebula restore filter.jpg
  4. The search results are displayed. From the list of savesets matching your query, select the task you want to restore and other relevant restore options (complete, generation restore). Click Next.
  5. OpenNebula restore select task.jpg
  6. 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 insert 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 new target server 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.
  7. 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.
  8. Information sign.png Note
    As of v. 4.4.3. Beefalo, the Expert Options button for specifying advanced restore options is only available in the Expert UI mode. It is not available for users that run the GUI in Basic or Advanced mode. In the latter case, if you want to access the Expert Options you first have to change the Basic/Advanced UI mode to Expert, as described in Selecting UI mode.

    OpenNebula restore target settings.jpg

  9. 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.
Information sign.png 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.

Restoring single files (Expert mode only)

With 4.4.3 Beefalo V2, SEP sesam introduces single file restore – item-level restore of files, folders, and volumes from the FULL or COPY backup of OpenNebula virtual machine by mounting a virtual disk on the device server and browsing the content of a virtual disk file. Before starting a restore, check the supported file systems and restrictions.

Mounting OpenNebula virtual disk

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 virtual disk(s). You can mount any saveset stored to default data store Path, Si3 deduplication store or HPE StoreOnce. Mounting is not possible if the savesets are stored to tapes or if the data is compressed or encrypted. Note that some other restrictions apply.
  5. OpenNebula SFR select task Beefalo V2.jpg
  6. Mount is triggered and your virtual disk is mounted to the device server. This may take a few seconds. Click OK.
  7. OpenNebula SFR mount Beefalo V2.jpg
  8. In the Select Files window, select the folders or files you want to restore and click Next.
  9. OpenNebula SFR select files Beefalo V2.jpg
  10. In the fourth step of the restore wizard (Target Settings), select a restore target (Target node and New restore target) where you want to restore your files.
  11. In the final step of the restore wizard, you can review all the settings of your restore task. You can start your single file restore immediately by clicking Start. If you want to save the restore task, click Save.
  12. Click OK to unmount the saveset and close your restore session.
Information sign.png 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 view the status of your restore jobs by selecting Job State -> Restores from the Main Selection. 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.

As of 4.4.3 Beefalo V2, you can also monitor the restore progress using the Web UI. For details, see SEP sesam Web UI.