View source for 4 4 3 Tigon:KVM QEMU Restore/en

<div class="noprint"><languages />
{{Copyright SEP AG en}}

{{Navigation_previous|link=[[Special:MyLanguage/KVM QEMU Restore|KVM QEMU Restore]] for the new version}}

{{Outdated_Version/en|[[SEP_sesam_Release_Versions|4.4.3 ''Tigon (V1 and V2)'']]}}</div>
<br />
==Overview ==
<!--Delete any items from the nav-table that you cannot link to relevant link, e.g., video, if it doesn't exist.--><div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 25%; "><center><b>
Additional resources</b></center>

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=Special:MyLanguage/Standard_Restore_Procedure]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
See also:
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/4 4 3_Tigon:KVM_QEMU_Backup|KVM/QEMU Backup]] 
|}

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_Video.png|45px|link=Video Tutorials & Screencasts]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |<span style="color:black"><sup>'''NEW'''</sup></span> Watch SEP sesam video [https://www.youtube.com/watch?v=PYrS27yGnCo Backup and Restore of KVM with SEP sesam].
|}

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.
|}

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Problems? See the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].
|}

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:icon_archived_docs.png|45px|link=Special:MyLanguage/KVM_QEMU]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
If you are using an older SEP sesam version, search the [[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]].
|}</div>
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 KVM/QEMU virtual machines (VMs) in SEP sesam: by using '''GUI restore wizard''' (described below) or through the web interface '''Restore Assistant''' (as of ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']]). 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]].  

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 [[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]].

To successfully restore a KVM/QEMU backup, all preparation steps must be performed properly. For details, see [[Special:MyLanguage/4 4 3_Tigon:KVM_QEMU_Backup|KVM/QEMU Backup]].

==={{anchor|integration_advantages}}SEP sesam KVM/QEMU integration advantages===
* Restore of complete virtual machines and configuration.
* Restore of virtual machine configuration.
* Restore into new virtual machine instances.
* Single file restore in SEP sesam ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']].

==={{anchor|options}}Restore options===

The following options are available when restoring KVM/QEMU:
* Select an alternative location to restore your data:
**Restore a KVM/QEMU to the '''original''' or a '''different''' location with the '''same''' or a '''different''' name using relocation.
* Perform a [[Special:MyLanguage/SEP_sesam_Glossary#complete_restore|'''complete''']] restore, simple '''path restore''' or '''single file restore''' (in ≥ ''Beefalo V2'') of your selected KVM/QEMU data directly to a directory on any system.
* Schedule a restore task.

=== {{anchor|prerequisites}}Prerequisites === 

Before you perform KVM/QEMU 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.

== {{anchor|restore}}Restoring a KVM/QEMU virtual machine == 

For details on how to configure a restore task and a description of different restore options, see [[Special:MyLanguage/Standard Restore Procedure|Standard Restore Procedure]]. Only KVM/QEMU-specific steps and options are described in this section.
<ol><li>From the SEP sesam GUI menu bar, select '''Activities -> Restore'''. The ''New Restore Task'' window opens.
<li>Select the saveset you want to restore. You can search savesets by ''task name'' or by ''filename or path''.
<ul><li>
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.</li>
<li>
If searching by ''filename/path'', select the option '''Filename or path in saveset''' and enter your search expression in the search pattern field.</li></ul></li>
<li>
Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</li>
<li>The search results are displayed. From the list of savesets matching your query, select the desired version by clicking on it, then select other relevant restore options (e.g., ''As path restore''). 
Click '''Next'''.</li>
[[Image:KVM_restore_select_task_Beefalo_V2.jpg|780px|link=]]
<br clear=all>
<!--<li>
If you selected the '''Mount saveset''' option, a mount action is triggered. The selected saveset is mounted to the SEP sesam home directory <tt>var\tmp\mnt</tt>, e.g., <tt>C:\Program Files\SEPsesam\var\tmp\mnt\''saveset_ID''</tt>.
<br />
Click '''Next''' to display the ''Select Files'' dialog. Select the data you want to restore and click '''Next'''.-->
<li>Review your restore task configuration and set additional options, if required.</li>
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.
;Target data:
You can restore the KVM/QEMU VM to the '''original VM''' or under a ''new VM name''. If you want to restore VM under a different name, select the option '''Restore with new VM name''' and enter a new VM name or use the '''Browser''' button. If you want to restore the VM ''to a different location'', under the ''Change VM target selection'', select another '''Target node''' from the drop-down list.  
;VM restore options:
Select one of the following from the drop-down list:
<ul><li>
'''Do not overwrite existing items''' (default): VM will be restored only if it does not exist on the target  server.</li>
<li>
'''Overwrite existing items''': If the VM exists on the target server, it will be replaced by its restored version.</li>
<li>'''Create a new version''' Will restore VM under a new name.</li>
<li>You can also select whether you want your virtual machine to start automatically after restore by selecting '''Start virtual machine after restore'''/'''Do not start virtual machine after restore''' (selected by default).</li>
<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]].</li>
{{note|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]].}}
</ul>
[[image:KVM_restore_target_Beefalo_V2.jpg|780px|link=]]
<br clear=all>
<li>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'''.</li></ol>

{{note|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]].}}

=={{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>== 

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 KVM/QEMU virtual machine by mounting a virtual disk on the device server and browsing the content of a virtual disk file.

{{tip|If you prefer to watch a video rather than to read a step-by-step guide, you can learn all the steps of the restore procedure by watching ''Backup of KVM'' on {{SEP youtube}}.}}

Before starting a restore, check the supported file systems and [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]].

==={{anchor|mount}}Mounting KVM/QEMU virtual disk=== 

Create a new restore task for individual item(s) you want to restore.
<ol><li>From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</li>
<li>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.</li>
<li>Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</li>
<li>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'', 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. Note that some other [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] apply.</li>
[[image:KVM_SFR_select_task_Beefalo_V2.jpg|780px|link=]]
<br clear=all>
<li>[[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'''.<br />
[[image:KVM_SFR_mount_Beefalo_V2.jpg|780px|link=]]
<br clear=all>
<li>In the ''Select Files'' window, select the folders or files you want to restore, for example, the ''home'' directory, and click '''Next'''.</li>
[[image:KVM_SFR_select_files_Beefalo_V2.jpg|780px|link=]]
<br clear=all>
<li>In the fourth step of the restore wizard (''Target Settings''), select a restore target where you want to restore your files.</li>
<li>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'''.</li>
<li>Click '''OK''' to unmount the saveset and close your restore session.</li>
</ol>

{{note|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]].}}

=={{anchor|monitor}}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 [[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">
==See also==
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/4 4 3_Tigon:KVM_QEMU_Backup|KVM/QEMU Backup]]</div>
[[Category:4.4.3 Tigon]]