4 4 3 Beefalo:RHV Restore: Difference between revisions

From SEPsesam
(Updated screenshots.)
(Rewrite in progress.)
Line 1: Line 1:
<!-- {{draft‎}} -->
{{draft‎}}
{{Copyright SEP AG|en}}
<div class="noprint">{{Copyright SEP AG|en}}
{{Navigation_latest|release=4.4.3/4.4.3 ''Tigon''|link=[[Special:MyLanguage/RHEV|RHEV archive]]}}<br />
{{Navigation_latest|release=[[SEP_sesam_Release_Versions|4.4.3/4.4.3 ''Beefalo'']]|link=[[Special:MyLanguage/RHEV|RHEV archive]]}}</div><br />


=={{anchor|overview}}Overview==
=={{anchor|overview}}Overview==
Line 7: Line 7:


{|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=RHEV Requirements and Configuration]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[Special:MyLanguage/4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]] – [[Special:MyLanguage/4_4_3:RHEV_Backup|RHEV Backup]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[Special:MyLanguage/4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]] – [[Special:MyLanguage/4_4_3:RHEV_Backup|RHEV Backup]]
|}
|}
Line 26: Line 26:
|}</div>
|}</div>


SEP sesam backup solution for RHEV environments was developed together with Red Hat. SEP sesam uses components of the <tt>libvirt</tt> API to perform snapshot-based backups of virtual machines (VMs) in RHEV and provide consistent, agentless backups and restores of all Red Hat Enterprise Virtualization virtual machines, regardless of their workload or operating system. For details on how to configure a RHEV client and prepare it for backup, see [[Special:MyLanguage/4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]] and [[Special:MyLanguage/4_4_3:RHEV_Backup|RHEV Backup]].  
SEP sesam backup solution for RHEV environments was developed together with Red Hat. SEP sesam uses components of the <tt>libvirt</tt> API to perform snapshot-based backups of virtual machines (VMs) in RHEV and provide consistent, agentless backups and restores of all Red Hat Enterprise Virtualization virtual machines (RHEV VMs), regardless of their workload or operating system. The restore of RHEV VMs is quite similar to a regular file system restore. Note that you can only restore one RHEV VM at a time.


==={{anchor|options}}Restore options===
==={{anchor|options}}Restore options===
* You can restore your VM to the '''original''' or '''different''' locations with the '''same''' or a '''different''' VM name using relocation.
* You can restore your VM to the ''original'' or ''different'' locations with the ''same'' or a ''different'' VM name using relocation.
* You can restore your VM to the '''same''' or a '''different''' single RHEV server as well as to the '''same''' or a '''different''' RHEV cluster.
* You can restore your VM to the ''same'' or a ''different'' single RHEV server or RHEV cluster.
* You can perform a simple '''path restore''' of your selected RHEV virtual machine configuration directly to a directory on any system rather than restoring and importing VM to the RHEV environment.
* You can perform a simple ''path'' restore of your selected RHEV VM configuration directly to a directory on any system rather than restoring and importing VM to the RHEV environment.


=== {{anchor|workflow}}Restore workflow ===
=== {{anchor|workflow}}Restore workflow ===
The restore process uses the following workflow:
The restore process uses the following workflow:
* Virtual machine (VM) configuration is restored to the [[Special:MyLanguage/SEP_sesam_Glossary#SDM|data mover virtual machine]].
#VM configuration is restored to the [[Special:MyLanguage/SEP_sesam_Glossary#SDM|data mover]].
* Target VM is created based on the configuration.
#Target VM is created based on the configuration.
* Target VM disks are created on the target storage domain.
#Target VM disks are created on the target storage domain.
* Provisioned disks are attached to the data mover VM.
#Provisioned disks are attached to the data mover VM.
* Data of the disks is restored.
#Data of the disks is restored.
* Disks are re-attached from the data mover VM to the target VM.
#Disks are re-attached from the data mover VM to the target VM.


=== Prerequisites ===
=== Prerequisites ===
To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:
To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:
* Check the [[SEP_sesam_OS_and_Database_Support_Matrix##Red_Hat_Enterprise_Virtualization_.28RHEV.2FRHV.29|support matrix]] for the list of supported RHEV versions.
* Check the [[4_4_3_Beefalo:SEP_sesam_OS_and_Database_Support_Matrix#Red_Hat|support matrix]] for the list of supported RHEV versions.
* Check [[Special:MyLanguage/4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]].
* Make sure your RHEV environment is configured properly, as described in [[Special:MyLanguage/4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]].
*Ensure that there is sufficient free space on the target system to which you are restoring your data.  
*Ensure that there is sufficient free space on the target system to which you are restoring your data.  
{{note|During restore the virtual disk will consume complete thick provisioned space on the target storage! For example, if you have backed up a 1 TB VM disk, 1 TB must be free on the target pool where the VM is restored.}}
{{note|During restore the virtual disk will consume complete thick provisioned space on the target storage. For example, if you have backed up a 1 TB VM disk, 1 TB must be free on the target pool where the VM is created.}}


=={{anchor|procedure}}Restoring RHEV virtual machines==
=={{anchor|procedure}}Restoring RHEV virtual machines==
Create a new restore task for the RHEV Manager client. You can only restore one VM at a time.  
Create a new restore task for the RHEV Manager client. You can only restore one VM at a time.  
<ol><li>From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New restore task'' window opens.</li>
<ol><li>From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New restore task'' window opens.</li>
<li>Select the RHEV backup task you want to restore.</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.
[[File:RHEV_restore_filter_4.4.3.png|link=]]
*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>
[[File:RHEV_restore_filter_4.4.3.png|800px|link=]]
<br clear=all>
<br clear=all>
<li>Select the RHEV saveset you want to restore. Click '''Next'''.</li>


<li>Select the '''RHEV backup save set''' you want to restore.</li>
[[File:RHEV_restore_select_task_4.4.3.png|800px|link=]]
 
[[File:RHEV_restore_select_task_4.4.3.png|link=]]
<br clear=all>
<br clear=all>


<li>Select the '''target virtual machine name''' you want to restore the virtual machine to.</li>
<li>You can restore RHEV VM to the ''original VM'' or with a ''new VM name''. If the virtual machine should be restored with a different name, select the option ''Restore with new VM name'' (previously ''New restore target'') and enter a new VM name.</li>


[[File:RHEV_restore_save_4.4.3.png|link=]]
[[File:RHEV_restore_save_4.4.3.png|800px|link=]]
<br clear=all>
<br clear=all>
 
<li>As of v. [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Tigon'']], you can use the <tt>dd</tt> utility to create a thin-provisioned (sparse) disk file, thus restoring only the actual size of the VMs: Click the '''Expert Options''' button and enter the following under the ''Restore Options'': <tt>-a use_dd</tt></li>
<li>Optionally, if the virtual machine should be restored with a different name, select the option '''New restore target''' and enter a different virtual machine name.</li>
{{note|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, 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]].}}
 
<li>As of v. 4.4.3 ''Tigon'', you can use the <tt>dd</tt> utility to create a thin-provisioned (sparse) disk file, thus restoring only the actual size of the VMs: Click the '''Expert Options''' button and enter the following under the ''Restore Options'': <tt>-a use_dd</tt></li>
 
[[Image:RHV_restore-expert_options.png|link=]]
[[Image:RHV_restore-expert_options.png|link=]]
<br clear=all>
<br clear=all>
<li>If you want to start your VM restore immediately, click '''Start'''. If you want to save the restore task, click '''Save'''. </li></ol>
<li>If you want to start your VM 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]].}}
{{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]].}}
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.
 
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, media pool and message.


<div class="noprint">
==Known issues==
==Known issues==
For troubleshooting Red Hat Enterprise Linux issues, see [[Troubleshooting_Guide#Red_Hat_Enterprise_Linux|Troubleshooting Red Hat Enterprise Linux]].
If you have problems, check the [[Special:MyLanguage/Troubleshooting_Guide#Red_Hat_Enterprise_Linux|Troubleshooting Guide]].


==See also==
==See also==
[[Special:MyLanguage/4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]] – [[Special:MyLanguage/4_4_3:RHEV_Backup|RHEV Backup]]
[[Special:MyLanguage/4_4_3:RHEV_Requirements_and_Configuration|RHEV Requirements and Configuration]] – [[Special:MyLanguage/4_4_3:RHEV_Backup|RHEV Backup]]</div>

Revision as of 12:11, 21 October 2019

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.
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.

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


Overview

SEP sesam backup solution for RHEV environments was developed together with Red Hat. SEP sesam uses components of the libvirt API to perform snapshot-based backups of virtual machines (VMs) in RHEV and provide consistent, agentless backups and restores of all Red Hat Enterprise Virtualization virtual machines (RHEV VMs), regardless of their workload or operating system. The restore of RHEV VMs is quite similar to a regular file system restore. Note that you can only restore one RHEV VM at a time.

Restore options

  • You can restore your VM to the original or different locations with the same or a different VM name using relocation.
  • You can restore your VM to the same or a different single RHEV server or RHEV cluster.
  • You can perform a simple path restore of your selected RHEV VM configuration directly to a directory on any system rather than restoring and importing VM to the RHEV environment.

Restore workflow

The restore process uses the following workflow:

  1. VM configuration is restored to the data mover.
  2. Target VM is created based on the configuration.
  3. Target VM disks are created on the target storage domain.
  4. Provisioned disks are attached to the data mover VM.
  5. Data of the disks is restored.
  6. Disks are re-attached from the data mover VM to the target VM.

Prerequisites

To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:

  • Check the support matrix for the list of supported RHEV versions.
  • Make sure your RHEV environment is configured properly, as described in RHEV Requirements and Configuration.
  • Ensure that there is sufficient free space on the target system to which you are restoring your data.
Information sign.png Note
During restore the virtual disk will consume complete thick provisioned space on the target storage. For example, if you have backed up a 1 TB VM disk, 1 TB must be free on the target pool where the VM is created.

Restoring RHEV virtual machines

Create a new restore task for the RHEV Manager client. You can only restore one VM at a time.

  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./li> RHEV restore filter 4.4.3.png
  4. Select the RHEV saveset you want to restore. Click Next.
  5. RHEV restore select task 4.4.3.png
  6. You can restore RHEV VM to the original VM or with a new VM name. If the virtual machine should be restored with a different name, select the option Restore with new VM name (previously New restore target) and enter a new VM name.
  7. RHEV restore save 4.4.3.png
  8. As of v. 4.4.3 Tigon, you can use the dd utility to create a thin-provisioned (sparse) disk file, thus restoring only the actual size of the VMs: Click the Expert Options button and enter the following under the Restore Options: -a use_dd
  9. Information sign.png Note
    As of v. 4.4.3. Beefalo, the Expert Options button for specifying more advanced restore options is only available in the Advanced and Expert UI mode. It is not available for users that run the GUI in Basic mode. In the latter case, you first have to change the Basic UI mode to Advanced or Expert, as described in UI Mode.

    RHV restore-expert options.png

  10. If you want to start your VM 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, media pool and message.

Known issues

If you have problems, check the Troubleshooting Guide.

See also

RHEV Requirements and ConfigurationRHEV Backup