4 4 3 Tigon:KVM QEMU Restore: Difference between revisions

From SEPsesam
(Corrected.)
(Removed draft (reviewed by MA) and prepared for translation.)
Line 1: Line 1:
<div class="noprint">{{Copyright SEP AG en}}
<translate><div class="noprint"><languages />
{{draft}}
{{Copyright SEP AG en}}
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Tigon''/4.4.3 ''Grolar'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]]}}</div>
 
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Tigon''/4.4.3 ''Grolar'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]]}}</div></translate>
<br />
<br />
==Overview ==
<translate>==Overview ==</translate>
<!--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>
<!--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>
<translate>Additional resources</translate></b></center>


{|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;" | [[File:SEP_next.png|45px|link=]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate>[[File:SEP_next.png|45px|link=Special:MyLanguage/Standard_Restore_Procedure]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Also relevant:
<translate>See also:
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4 4 3_Tigon:KVM_QEMU_Backup|KVM QEMU Backup]]  
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4 4 3_Tigon:KVM_QEMU_Backup|KVM QEMU Backup]]</translate>
|}
|}


{|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;" | [[File:SEP_Video.png|45px|link=Video Tutorials & Screencasts|]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate>[[File:SEP_Video.png|45px|link=Video Tutorials & Screencasts]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Watch SEP sesam [[Video Tutorials & Screencasts|videos & screencasts]].
<translate>Watch SEP sesam [[Video Tutorials & Screencasts|videos & screencasts]].</translate>
|}
|}


{|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;" | [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate>[[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
| 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.
<translate>Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.</translate>
|}
|}


{|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;" | [[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate>[[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Problems? See the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].
<translate>Problems? See the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].</translate>
|}
|}


{|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;" | [[File:icon_archived_docs.png|45px|link=Special:MyLanguage/KVM_QEMU]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate>[[File:icon_archived_docs.png|45px|link=Special:MyLanguage/KVM_QEMU]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
| 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]].
<translate>If you are using an older SEP sesam version, search the [[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]].</translate>
|}</div>
|}</div>
The [[Special:MyLanguage/SEP_sesam_Glossary#restore|restore]] of virtual machines (VMs) is quite similar to a regular file system restore. Restore is triggered from the ''Menu bar'' -> '''Activities''' -> '''Restore'''. 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]].
<translate>The [[Special:MyLanguage/SEP_sesam_Glossary#restore|restore]] of virtual machines (VMs) is quite similar to a regular file system restore. Restore is triggered from the ''Menu bar'' -> '''Activities''' -> '''Restore'''. 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]].
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===
==={{anchor|integration_advantages}}SEP sesam KVM/QEMU integration advantages===</translate>
* Restore of complete virtual machines and configuration.
* <translate>Restore of complete virtual machines and configuration.</translate>
* Restore of virtual machine configuration.
* <translate>Restore of virtual machine configuration.</translate>
* Restore into new virtual machine instances.
* <translate>Restore into new virtual machine instances.</translate>


==={{anchor|options}}Restore options===  
<translate>==={{anchor|options}}Restore options===
<!--Provide the options relevant for your extension.-->
 
The following options are available when restoring KVM/QEMU:
The following options are available when restoring KVM/QEMU:</translate>
* Select an alternative location to restore your data:
* <translate>Select an alternative location to restore your data:</translate>
**restore a KVM/QEMU to the '''original''' or a '''different''' location with the '''same''' or a '''different''' name using relocation
**<translate>Restore a KVM/QEMU to the '''original''' or a '''different''' location with the '''same''' or a '''different''' name using relocation.</translate>
* Perform a [[Special:MyLanguage/SEP_sesam_Glossary#complete_restore|'''complete''']] restore or simple '''path restore''' of your selected KVM/QEMU data directly to a directory on any system.
* <translate>Perform a [[Special:MyLanguage/SEP_sesam_Glossary#complete_restore|'''complete''']] restore or simple '''path restore''' of your selected KVM/QEMU data directly to a directory on any system.</translate>
* Schedule a restore task.
* <translate>Schedule a restore task.


=== {{anchor|prerequisites}}Prerequisites ===  
=== {{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 ==  
Before you perform KVM/QEMU restore, check the following prerequisites:</translate>
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.
* <translate>Depending on what you want to restore, make sure that you have the proper '''restore permissions''' and '''access rights'''.</translate>
<ol><li>
* <translate>Make sure that there is '''sufficient free space''' on the target system to which you are restoring your data.</translate>
From the SEP sesam GUI menu bar, select '''Activities -> Restore'''. The ''New restore task'' window opens.
 
<li>
<translate>== {{anchor|restore}}Restoring a KVM/QEMU virtual machine ==  
Select the saveset you want to restore. You can search savesets by ''task name'' or by ''filename or path''.
 
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.</translate>
<ol><li><translate>From the SEP sesam GUI menu bar, select '''Activities -> Restore'''. The ''New restore task'' window opens.</translate>
<li><translate>Select the saveset you want to restore. You can search savesets by ''task name'' or by ''filename or path''.</translate>
<ul><li>
<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>
<translate>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></li>
<li>
<li>
If searching by ''filename/path'', select the option '''Filename or path in save set''' and enter your search expression in the search pattern field.</li></ul></li>
<translate>If searching by ''filename/path'', select the option '''Filename or path in save set''' and enter your search expression in the search pattern field.</translate></li></ul></li>
<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>
<translate>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>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''). <!--As of ''SEP sesam version 4.4.2'', you can also select the option '''Mount saveset''' under ''Single File Restore'' to  mount the target saveset to the disk and make it accessible as if it was a separate volume on the disk. You can mount any saveset stored to ''default data store Path'' or to ''Si3 data store''. Mounting is not possible if the savesets are stored to tapes or if the data is compressed or encrypted. For advantages on mounting a saveset, see [[Special:MyLanguage/SEP_sesam_Glossary#XPRFS|XPRFS]].-->Click '''Next'''.</li>
<li><translate>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'').</translate> <!--As of ''SEP sesam version 4.4.2'', you can also select the option '''Mount saveset''' under ''Single File Restore'' to  mount the target saveset to the disk and make it accessible as if it was a separate volume on the disk. You can mount any saveset stored to ''default data store Path'' or to ''Si3 data store''. Mounting is not possible if the savesets are stored to tapes or if the data is compressed or encrypted. For advantages on mounting a saveset, see [[Special:MyLanguage/SEP_sesam_Glossary#XPRFS|XPRFS]].--><translate>Click '''Next'''.</translate></li>
[[Image:KVM_restore_select_task.png|link=]]
<translate>[[Image:KVM_restore_select_task.png|link=]]</translate>
<br clear=all>
<br clear=all>
<!--<li>
<!--<li>
Line 78: Line 79:
<br />
<br />
Click '''Next''' to display the ''Select Files'' dialog. Select the data you want to restore and click '''Next'''.-->
Click '''Next''' to display the ''Select Files'' dialog. Select the data you want to restore and click '''Next'''.-->
<li>
<li><translate>Review your configured restore task and set additional options, if necessary.</translate>
Review your configured restore task and set additional options, if necessary.
* <translate>Details of the selected saveset are displayed at the top of the window. The name of the restore task is automatically generated in the '''Name''' field. You can edit the name and insert a comment below.</translate>
* Details of the selected saveset are displayed at the top of the window. The name of the restore task is automatically generated in the '''Name''' field. You can edit the name and insert a comment below.
* <translate>The '''Drive''' field shows the drive with backed up data.</translate>
* The '''Drive''' field shows the drive with backed up data.
* <translate>The '''Interface''' field shows the server (RDS server or Sesam server) with the attached data storage containing the selected saveset.</translate>
* The '''Interface''' field shows the server (RDS server or Sesam server) with the attached data storage containing the selected saveset.
* <translate>The '''Target node''' drop-down list shows the target server to which the data will be restored.</translate>
* The '''Target node''' drop-down list shows the target server to which the data will be restored.
* <translate>Under the '''Target Path''', choose between the '''Restore to original target path''' or '''New restore target''' options. If you wish to choose a new restore target, enter its target path or browse for it.</translate>
* Under the '''Target Path''', choose between the '''Restore to original target path''' or '''New restore target''' options. If you wish to choose a new restore target, enter its target path or browse for it.
* <translate>Under the '''Execution options''' drop-down list, select one of the following options:</translate>
* Under the '''Execution options''' drop-down list, select one of the following options:
** <translate>'''do not overwrite existing files''' (set by default): the VM will not be restored if it already exists on the target server</translate>
** '''do not overwrite existing files''' (set by default): the VM will not be restored if it already exists on the target server
** <translate>'''overwrite existing files''': if data exists on the target server, it will be replaced by the restored version</translate>
** '''overwrite existing files''': if data exists on the target server, it will be replaced by the restored version
** <translate>'''create a new version''': if data exists on the target server, the restored data will be restored under a different name</translate>
** '''create a new version''': if data exists on the target server, the restored data will be restored under a different name
* <translate>You can specify additional restore settings by clicking the '''Expert options''' button. In the pop-up windows that opens, you can modify the log level settings, define the pre/post script for restore, etc. For details, see the [[Special:MyLanguage/The_Restore_4.4#Restore_Wizard|Restore Wizard]].</translate></li>
* You can specify additional restore settings by clicking the '''Expert options''' button. In the pop-up windows that opens, you can modify the log level settings, define the pre/post script for restore, etc. For details, see the [[Special:MyLanguage/The Restore 4.4#Restore Wizard|Restore Wizard]].</li>
<translate>[[image:KVM_restore_save.png|link=]]</translate>
[[image:KVM_restore_save.png|link=]]
<br clear=all>
<br clear=all>
<li>If you want to start your KVM/QEMU restore immediately, click '''Start'''. If you want to save the restore task, click '''Save'''.
<li><translate>If you want to start your KVM/QEMU restore immediately, click '''Start'''. If you want to save the restore task, click '''Save'''.</translate>
<!--<li>If you chose to mount a saveset, click '''Next''' to unmount it and close your restore session.</li>--></ol>
<!--<li>If you chose to mount a saveset, click '''Next''' to unmount it 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]].}}
{{<translate>note</translate>|<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>}}
You can view the status of your restore jobs by selecting '''Job state''' -> '''Restore''' 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.
<translate>You can view the status of your restore jobs by selecting '''Job state''' -> '''Restore''' 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.


<div class="noprint">
<div class="noprint">
==See also==
==See also==
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4 4 3_Tigon:KVM_QEMU_Backup|KVM QEMU Backup]]</div>
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4 4 3_Tigon:KVM_QEMU_Backup|KVM QEMU Backup]]</div></translate>

Revision as of 15:15, 13 May 2019

Other languages:

Template:Copyright SEP AG en

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Tigon/4.4.3 Grolar. For previous documentation version(s), check documentation archive.


Overview

The restore of virtual machines (VMs) is quite similar to a regular file system restore. Restore is triggered from the Menu bar -> Activities -> Restore. Restore wizard guides you through the process of restoring your data. For step-by-step procedure, see Standard Restore Procedure.

To successfully restore a KVM QEMU backup, all preparation steps must be performed properly. For details, see KVM QEMU Backup.

SEP sesam KVM/QEMU integration advantages

  • Restore of complete virtual machines and configuration.
  • Restore of virtual machine configuration.
  • Restore into new virtual machine instances.

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 complete restore or simple path restore of your selected KVM/QEMU data directly to a directory on any system.
  • Schedule a restore task.

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.

Restoring a KVM/QEMU virtual machine

For details on how to configure a restore task and a description of different restore options, see standard restore procedure. Only KVM/QEMU-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 the saveset 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 save set 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 desired version by clicking on it, then select other relevant restore options (e.g., as path restore). Click Next.
  5. KVM restore select task.png
  6. Review your configured restore task and set additional options, if necessary.
    • Details of the selected saveset are displayed at the top of the window. The name of the restore task is automatically generated in the Name field. You can edit the name and insert a comment below.
    • The Drive field shows the drive with backed up data.
    • The Interface field shows the server (RDS server or Sesam server) with the attached data storage containing the selected saveset.
    • The Target node drop-down list shows the target server to which the data will be restored.
    • Under the Target Path, choose between the Restore to original target path or New restore target options. If you wish to choose a new restore target, enter its target path or browse for it.
    • Under the Execution options drop-down list, select one of the following options:
      • do not overwrite existing files (set by default): the VM will not be restored if it already exists on the target server
      • overwrite existing files: if data exists on the target server, it will be replaced by the restored version
      • create a new version: if data exists on the target server, the restored data will be restored under a different name
    • You can specify additional restore settings by clicking the Expert options button. In the pop-up windows that opens, you can modify the log level settings, define the pre/post script for restore, etc. For details, see the Restore Wizard.
    KVM restore save.png
  7. If you want to start your KVM/QEMU 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.

You can view the status of your restore jobs by selecting Job state -> Restore 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.