4 4 3 Beefalo:RHV Restore: Difference between revisions

From SEPsesam
(Minor correction.)
(Jaglion SFR update nearly finished, currently commented out (screenshots TBD).)
(One intermediate revision by the same user not shown)
Line 8: Line 8:
{|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=Special:MyLanguage/4_4_3_Beefalo:Standard_Restore_Procedure|Standard Restore Procedure]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=Special:MyLanguage/4_4_3_Beefalo:Standard_Restore_Procedure|Standard Restore Procedure]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:5--> See also: [[Special:MyLanguage/4_4_3_Beefalo:Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Configuration|RHV Configuration]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Backup|RHV Backup]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:5--> See also: [[Special:MyLanguage/4_4_3_Beefalo:Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Configuration|RHV Configuration]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Backup|RHV 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;"
Line 42: Line 42:
* <translate><!--T:18--> You can perform a simple ''path'' restore of the selected RHV VM configuration directly to a directory on any system instead of restoring and importing VM to the RHV environment.</translate>
* <translate><!--T:18--> You can perform a simple ''path'' restore of the selected RHV VM configuration directly to a directory on any system instead of restoring and importing VM to the RHV environment.</translate>
* <translate><!--T:19-->
* <translate><!--T:19-->
In SEP sesam ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can perform a ''single file restore'' by mounting RHV/OLVM virtual disk if your UI mode is set to ''Expert''; see [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].  
In SEP sesam ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can perform a ''single file restore'' by mounting RHV/OLVM virtual disk if your UI mode is set to ''Expert''; see [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].
<!--* In SEP sesam ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can perform a [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#GUI|single file restore in the GUI]] if your UI mode is set to ''Expert''. With 5.0.0 ''Jaglion'', you can also perform a single file restore via the [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#restore_assistant|web Restore Assistant]].--> 


=== {{anchor|workflow}}Restore workflow === <!--T:20-->
=== {{anchor|workflow}}Restore workflow === <!--T:20-->
Line 109: Line 110:
<!--T:64-->
<!--T:64-->
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 ''COPY'' backup of RHV/OLVM virtual machine by mounting a virtual disk on the device server and browsing the content of a virtual disk file.</translate>
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 ''COPY'' backup of RHV/OLVM virtual machine by mounting a virtual disk on the device server and browsing the content of a virtual disk file.</translate>
<!--
You can restore individual files via the [[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore#GUI|SEP sesam GUI]] (v. ≥ [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']]) or the [[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore#restore_assistant|web Restore Assistant]] (v. ≥ 5.0.0 ''Jaglion''). Restoring a single file is only supported in the UI mode where all options are available, i.e. in the ''Expert'' UI mode when you perform a single file restore via the GUI or in the ''Advanced'' UI mode when you use the web Restore Assistant. For details on switching the UI mode, see [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Setting the UI mode in the GUI]] and [[Special:MyLanguage/5_0_0:Restore_Assistant#UI_mode|Setting UI mode in the Restore Assistant]].
{{Note|
*To restore single files via the web interface ''Restore Assistant'', appropriate permissions are required. For details, see [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]].
*Before starting a restore, check the [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] for mounting the virtual disk (VHD file).
}}-->


{{<translate><!--T:65--> tip</translate>|<translate><!--T:66--> 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 and restore of RHV/OLVM'' on {{SEP youtube}}.</translate>}}
{{<translate><!--T:65--> tip</translate>|<translate><!--T:66--> 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 and restore of RHV/OLVM'' on {{SEP youtube}}.</translate>}}
Line 116: Line 124:


==={{anchor|mount}}Mounting RHV/OLVM virtual disk=== <!--T:68-->  
==={{anchor|mount}}Mounting RHV/OLVM virtual disk=== <!--T:68-->  
<!--==={{anchor|GUI}}Using the GUI restore wizard===-->


<!--T:69-->
<!--T:69-->
Create a new restore task for individual item(s) you want to restore.</translate>
Create a new restore task for individual item(s) you want to restore.
<!--After [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|setting the UI mode to ''Expert'']], create a new restore task for the individual item(s) you want to restore.--></translate>
<ol><li><translate><!--T:70--> From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</translate></li>
<ol><li><translate><!--T:70--> From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</translate></li>
<li><translate><!--T:71--> Select what you want to restore. You can search savesets by ''task name'' or by ''filename or path''.</translate>
<li><translate><!--T:71--> Select what you want to restore. You can search savesets by ''task name'' or by ''filename or path''.</translate>
Line 140: Line 151:
{{<translate><!--T:84--> note</translate>|<translate><!--T:85--> 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:84--> note</translate>|<translate><!--T:85--> 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|restore_assistant}}Using the web Restore Assistant===
With v. [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], you can restore individual files of an RHV VM in the web interface in the ''advanced'' UI mode if you have the appropriate permissions. For more details on the UI mode, see
[[Special:MyLanguage/5_0_0:Restore_Assistant#UI_mode|Setting UI mode in the Restore Assistant]].</translate>
<translate>You can access the ''Restore Assistant'' in one of the following ways:</translate>
*<translate>via the GUI: by clicking the ''Restore Assistant icon'' in the toolbar or from ''Activities'' -> ''Restore Assistant''</translate>
*<translate>from SEP sesam Web UI: left menu -> ''Restore Assistant''</translate>
*<translate>or by entering the following address in the browser bar:</translate> ''http://[sesamserver]:11401/sep/ui/restore/''.
{{<translate>note</translate>|
*<translate>If you cannot access the web ''Restore Assistant'', check if you have received the appropriate permissions for online restore.</translate>
*<translate>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 [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''UI mode'']].</translate><br /><translate>For details, see [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]] and [[Special:MyLanguage/5_0_0:User_Roles_and_Permissions|User Roles and Permissions]].</translate>}}
<ol><li><translate>Open the ''Restore Assistant'' in the browser.</translate></li>
<li><translate>In the ''Start'' window, select '''Red Hat Virtualization'''. Then select the option '''Advanced View'''. The ''VM or single file restore'' option is selected by default. Click '''Next'''.</translate></li>
<translate>[[image:Restore_assistant_SFR_RHV_start_Jaglion.jpg|680px|link=]]</translate>
<br clear=all>
<li><translate>In the ''Virtual Machine'' window, under ''Selection of the server'', select your target RHV server to which the data will be restored.</translate></li>
<translate>Then, under ''Selection of the virtual machine'', select the VM that you want to restore and click '''Next'''.</translate></li>
<translate>[[image:Restore_assistant_RHV_select_server_Jaglion.jpg|680px|link=]]</translate>
<br clear=all>
<li><translate>In the ''Task'' window, under ''Task selection'', select your source task. A [[Special:MyLanguage/SEP_sesam_Glossary#backup_task|backup task]] defines the source data that was backed up by the client.</translate></li>
<translate>Then, under ''Backup selection'', select the exact backup version you want to restore. You can use the calendar function in the upper right corner to set a date range for the backups. Select the '''Single file restore''' option (in the lower right corner) and  click '''Next'''.</translate></li>
<translate>[[image:RA_SFR_RHV_select_task_Jaglion.jpg|680px|link=]]</translate>
<br clear=all>
<li><translate>In the ''Files'' window, select the SEP sesam Server or RDS to which you want to ''mount'' the backup. You can also specify an ''alternate mount path'' and/or ''advanced mount options''. Then click the button '''Mount this backup in filesystem'''. A new window will appear showing the progress of the mount process.</translate></li>
{{<translate>Note</translate>|<translate>Mounting is not possible if the savesets are stored on tapes or if the data is compressed or encrypted. Some other [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|XPRFS restrictions]] also apply to mounting.</translate>}}
<translate>[[image:RA_SFR_RHV_mount_Jaglion.jpg|680px|link=]]</translate>
<br clear=all>
<li><translate>Once a virtual disk is mounted on the device server, select the files or folders you want to restore and click '''Next'''.</translate></li>
<translate>[[image:RA_SFR_RHV_files_Jaglion.jpg|680px|link=]]</translate>
<br clear=all>
<li><translate>In the ''Target'' window, under ''Target selection'', select your target environment for the restore. You can use the drop-down list to select or filter VMs by name. You can also select a ''custom target path'' by browsing.</translate></li>
Under the ''Execution options'', set additional restore options:<br />
<translate>'''''Do not overwrite existing items'':''' Files are only restored if they do not already exist on the target system.</translate><br />
<translate>'''''Create new version'':''' Restore files under a new name.</translate><br />
<translate>'''''Overwrite existing items'':''' If the data exists on the target server, it is replaced with the restored version.</translate><br />
<translate>Then decide how you want  to restore your data (keep the original tree structure or flat):</translate><br />
<translate>'''''Keep original tree structure''''': When restoring to the original location, the ''Keep original tree structure'' option is selected by default. The directory structure of the restored files is the same as the original directory structure of the backed up data.</translate><br />
<translate>'''''Restore all items flat in the selected target directory'':''' The backup is simply restored to a file without recreating the directory structure.</translate><br />
<translate>You can also select to '''''skip ACL settings during restore'''''.</translate><br />
<translate>Click '''Next'''.</translate><br />
<translate>[[File:Restore_assistant_SFR_RHV-target_Jaglion.jpg|680px|link=]]</translate>
<li><translate>In the ''Options'' window, you can specify additional advanced options, such as selecting a data source (media pool, drive, etc.), set include/exclude filters, etc. For details on the available options, see [[Special:MyLanguage/5_0_0:Restore_Assistant#advanced_restore|Online restore in advanced UI mode]].</translate></li>
<translate>Click '''Next'''.</translate><br />
<translate>[[image:RA_SFR_RHV_recovery_options_Jaglion.jpg|680px|link=]]</translate>
<br clear=all>
<li><translate>In the last step, check the summary of your restore task (restore type (based on [[Special:MyLanguage/SEP_sesam_Glossary#task_type|task type]], selected backup, its date and details, restore options, etc.) and click '''Start restore'''.</translate></li>
<translate>[[image:RA_SFR_RHV_finish_Jaglion.jpg|750px|link=]]</translate>
<br clear=all>
</ol>
-->
<translate>=={{anchor|monitor}}Monitoring restore== <!--T:86-->  
<translate>=={{anchor|monitor}}Monitoring restore== <!--T:86-->  



Revision as of 10:01, 9 November 2021

Other languages:

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.

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 Beefalo/4.4.3 Beefalo V2. For previous documentation version(s), check RHV archive.


Overview

SEP sesam backup solution for RHV* environments was developed together with Red Hat. SEP sesam uses RHV Manager backup (libvirt) API to perform snapshot-based backups of virtual machines (VMs) in RHV environments and enables consistent, agentless backup and restore of all RHV VMs.

As of v. 4.4.3 Beefalo, the RHV module also provides support for oVirt-based platforms within Oracle Linux Virtualization Manager (OLVM) in the same way as for RHV environments. Since the RHV module now supports OLVM the same GUI options and steps apply for restoring OLVM VM, with the only difference that the relevant OLVM objects should be selected instead of RHV.

The restore of RHV/OLVM VMs is very similar to regular file system restore. There are two ways to restore your RHV virtual machines (VMs) in SEP sesam: by using GUI restore wizard (described below) or through the web interface Restore Assistant (only RHV VMs). 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. Note that you can only restore one VM at a time. For step-by-step procedure, see Standard Restore Procedure.

*RHV is a rebranding of Red Hat Enterprise Virtualization (RHEV).

Restore options

  • You can restore your RHV VM to the original or different location with the same or a different VM name using relocation.
  • You can restore your VM to the same or a different single RHV server or RHV cluster.
  • You can perform a simple path restore of the selected RHV VM configuration directly to a directory on any system instead of restoring and importing VM to the RHV environment.
  • In SEP sesam ≥ 4.4.3 Beefalo V2, you can perform a single file restore by mounting RHV/OLVM virtual disk if your UI mode is set to Expert; see Selecting UI mode.

Restore workflow

The restore process uses the following workflow:

  1. The VM configuration is restored to the SEP sesam data mover VM.
  2. The target VM is created from this.
  3. The disks on the target VM are created and attached to the SEP sesam data mover VM.
  4. The data is then restored.
  5. The disks are detached from the data mover VM and attached 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 RHV support matrix for the list of supported RHV versions and OLVM support matrix for supported OLVM versions.
  • Make sure that your RHV/OLVM environment is configured properly, as described in RHV Configuration.
  • Make sure that there is enough 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 1 TB VM disk, 1 TB must be free on the target pool where the VM is created.

Restoring RHV virtual machines

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

  1. In 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 filename or path.
    • When searching by task name, use the drop-down list of available tasks and select the one you want to restore. This option is enabled 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. In the Saved in period drop-down lists, specify the time frame for which you want to conduct the search. Click Next.
  4. RHV rst task-filter.jpg
  5. Select the RHV/OLVM saveset you want to restore. Click Next.
  6. RHV rst task-task.jpg
  7. Review your restore task configuration and set additional options, if required.
  8. 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 RHV/OLVM VM to the original VM (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) 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.
    Target node
    It shows the target server to which the data will be restored. By clicking Change VM target selection you can restore a task from a cluster to a different standalone server by selecting the appropriate RHV target node and data store path. If no target path is defined, the VM is restored to the default location of the RHV server or cluster.
    VM restore options
    Select one of the following from the drop-down list:
    • Do not overwrite existing items (default): VM will be restored only if it does not exist on the target server.
    • Overwrite existing items: If the VM exists on the target server, it will be replaced by its restored version.
    • Create a new version will restore VM under a new name.
    • If you are performing a standard VM restore, 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 (selected by default).

    RHV rst task-target.jpg

  9. Optionally, if you want to restore only the actual size of the VMs, you can use the dd utility to create a thin-provisioned (sparse) disk file: Click the Expert Options button and enter the following under Restore options: -a use_dd
  10. 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.

    RHV rst task-expert options.jpg

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

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

SEP Tip.png 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 and restore of RHV/OLVM on SEP sesam YouTube channel.

Before starting a restore, check the supported file systems and restrictions.

Mounting RHV/OLVM 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. RHV 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. RHV SFR mount Beefalo V2.jpg
  8. In the Select Files window, select the folders or files you want to restore, for example, the home directory, and click Next.
  9. RHV SFR select files Beefalo V2.jpg
  10. In the fourth step of the restore wizard (Target Settings), select a 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.

Known issues

If you have problems, check the Troubleshooting Guide.

See also

Standard Restore ProcedureRestore AssistantRHV ConfigurationRHV Backup