Source:Single File Restore for Virtual Machines-Jaglion: Difference between revisions

From SEPsesam
(Marked this version for translation)
m (Corrected link.)
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Draft}}<noinclude><translate><!--T:1-->
<noinclude><translate><!--T:1-->
<div class="noprint"><languages />
<div class="noprint"><languages />
{{Copyright SEP AG‎|en}}
{{Copyright SEP AG‎|en}}
Line 11: Line 11:
{|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=5_0_0:Restore_Assistant]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=5_0_0:Restore_Assistant]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:3--> See also: [[Special:MyLanguage/5_0_0:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/5_0_0:VMware_Single_File_Restore|VMware SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:Hyper-V_Restore#single_file|Hyper-V SFR]] – [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore|Citrix Hypervisor SFR]] – [[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore|KVM QEMU SFR]] – [[Special:MyLanguage/5_0_0:Nutanix_AHV_Restore#single_file|Nutanix AHV SFR]] – [[Special:MyLanguage/5_0_0:OLVM_Restore#single_file|OLVM SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#single_file|RHV SFR]] – [[Special:MyLanguage/5_0_0:OpenNebula_Single_File_Restore|OpenNebula SFR]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:3--> See also: [[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing guestfs-tools on Linux]] – [[Special:MyLanguage/5_0_0:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/5_0_0:VMware_Single_File_Restore|VMware SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:Hyper-V_Restore#single_file|Hyper-V SFR]] – [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore|Citrix Hypervisor SFR]] – [[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore|KVM QEMU SFR]] – [[Special:MyLanguage/5_0_0:Nutanix_AHV_Restore#single_file|Nutanix AHV SFR]] – [[Special:MyLanguage/5_0_0:OLVM_Restore#single_file|OLVM SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#SFR|RHV SFR]] – [[Special:MyLanguage/5_0_0:OpenNebula_Single_File_Restore|OpenNebula SFR]]</translate>
|}
|}


Line 35: Line 35:
*<translate><!--T:13--> [[Special:MyLanguage/5_0_0:Nutanix_AHV_Restore#single_file|Nutanix AHV Single File Restore]]</translate>
*<translate><!--T:13--> [[Special:MyLanguage/5_0_0:Nutanix_AHV_Restore#single_file|Nutanix AHV Single File Restore]]</translate>
*<translate><!--T:14--> [[Special:MyLanguage/5_0_0:OLVM_Restore#single_file|OLVM Single File Restore]]</translate>
*<translate><!--T:14--> [[Special:MyLanguage/5_0_0:OLVM_Restore#single_file|OLVM Single File Restore]]</translate>
*<translate><!--T:15--> [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#single_file|RHV Single File Restore]]</translate>
*<translate><!--T:15--> [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#SFR|RHV Single File Restore]]</translate>
*<translate><!--T:16-->
*<translate><!--T:16-->
[[Special:MyLanguage/5_0_0:OpenNebula_Single_File_Restore|OpenNebula Single File Restore]]
[[Special:MyLanguage/5_0_0:OpenNebula_Single_File_Restore|OpenNebula Single File Restore]]
Line 44: Line 44:
To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:</translate>
To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:</translate>
*<translate><!--T:19--> SEP sesam Server version ≥ [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']]. For the list of supported systems, see [[4_4_3_Beefalo:SEP_sesam_OS_and_Database_Support_Matrix|Support Matrix]].</translate>
*<translate><!--T:19--> SEP sesam Server version ≥ [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']]. For the list of supported systems, see [[4_4_3_Beefalo:SEP_sesam_OS_and_Database_Support_Matrix|Support Matrix]].</translate>
*<translate><!--T:76--> SFR of backups from virtualization platforms requires the ''guestfs-tools package'' to be installed on Linux in order to access and mount VM disk image on Linux. If the package is not installed on your SEP sesam Server or Linux RDS, it is not possible to mount VMDK and perform SFR. Refer to [[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing guestfs-tools on Linux]].</translate>
*<translate><!--T:20--> A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] (''Path'', ''Si3 deduplication store'', etc.) is recommended.</translate>
*<translate><!--T:20--> A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] (''Path'', ''Si3 deduplication store'', etc.) is recommended.</translate>
*<translate><!--T:21--> Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|encrypted]], [[Special:MyLanguage/SEP_sesam_Glossary#compression|compressed]] or stored on tape.</translate>
*<translate><!--T:21--> Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|encrypted]], [[Special:MyLanguage/SEP_sesam_Glossary#compression|compressed]] or stored on tape.</translate>
Line 86: Line 87:
<li><translate><!--T:48--> In the ''Files'' window, select the SEP sesam Server or RDS to which you want to ''mount'' <!--(or ''attach'' for VMware, see the following note) -->the backup. You can also specify an ''alternative mount path'' (by entering an absolute path or using the Browse button) and set ''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>
<li><translate><!--T:48--> In the ''Files'' window, select the SEP sesam Server or RDS to which you want to ''mount'' <!--(or ''attach'' for VMware, see the following note) -->the backup. You can also specify an ''alternative mount path'' (by entering an absolute path or using the Browse button) and set ''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><!--T:49--> Note</translate>|
{{<translate><!--T:49--> Note</translate>|
*<translate><!--T:77--> SFR of backups from virtualization platforms requires the ''guestfs-tools package'' to be installed on Linux in order to access and mount VM disk image on Linux. If the package is not installed on your SEP sesam Server or Linux RDS, it is not possible to mount VMDK and perform SFR. Refer to [[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing guestfs-tools on Linux]].</translate>
*<translate><!--T:50--> Mounting is not possible if the savesets are stored on tapes or if the data is compressed or encrypted. For mounting also some other [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|XPRFS restrictions]] apply.</translate>
*<translate><!--T:50--> Mounting is not possible if the savesets are stored on tapes or if the data is compressed or encrypted. For mounting also some other [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|XPRFS restrictions]] apply.</translate>
*<translate><!--T:51--> In the case of '''''VMware''''', it is posible to ''attach virtual disks to a Proxy-VM via NFS server'' instead of mounting the backup to a file system, but this is currently only supported in the SEP sesam GUI. See [[Special:MyLanguage/5_0_0:VMware_Single_File_Restore#attach|VMware Single File Restore]].</translate>}}
*<translate><!--T:51--> In the case of '''''VMware''''', it is posible to ''attach virtual disks to a Proxy-VM via NFS server'' instead of mounting the backup to a file system, but this is currently only supported in the SEP sesam GUI. See [[Special:MyLanguage/5_0_0:VMware_Single_File_Restore#attach|VMware Single File Restore]].</translate>}}
Line 116: Line 118:


<!--T:72-->
<!--T:72-->
You can monitor the restore progress using the ''Web UI'' (''Monitoring'' -> ''Restores'') or view the status in the ''GUI'' (''Main Selection'' -> ''Job State'' -> ''Restores''). The restore overview provides detailed information on the last run of restore jobs, including task name, status (successful, error, in queue ...), start and stop time of the last backup, data size, throughput, etc. For details, see [[Special:MyLanguage/5_0_0:SEP_sesam_Web_UI#restores|SEP sesam Web UI]] or [[Special:MyLanguage/4_4_3_Beefalo:Restores_by_State|Restores by State in the GUI]].
You can view the status of your restore jobs in the ''Restore Assistant'' by clicking the ''monitoring'' icon (second icon in the upper right corner), via SEP sesam ''Web UI'' (''Monitoring'' -> ''Restores''), or view the status in the ''GUI'' (''Main Selection'' -> ''Job State'' -> ''Restores''). The restore overview provides detailed information on the last run of restore jobs, including task name, status (successful, error, in queue ...), start and stop time of the last backup, data size, throughput, etc. For details, see [[Special:MyLanguage/5_0_0:SEP_sesam_Web_UI#restores|SEP sesam Web UI]] or [[Special:MyLanguage/4_4_3_Beefalo:Restores_by_State|Restores by State in the GUI]].


<div class="noprint">
<div class="noprint">
==See also== <!--T:73-->
==See also== <!--T:73-->
[[Special:MyLanguage/5_0_0:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/5_0_0:VMware_Single_File_Restore|VMware SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:Hyper-V_Restore#single_file|Hyper-V SFR]] – [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore|Citrix Hypervisor SFR]] – [[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore|KVM QEMU SFR]] – [[Special:MyLanguage/5_0_0:Nutanix_AHV_Restore#single_file|Nutanix AHV SFR]] – [[Special:MyLanguage/5_0_0:OLVM_Restore#single_file|OLVM SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#single_file|RHV SFR]] – [[Special:MyLanguage/5_0_0:OpenNebula_Single_File_Restore|OpenNebula SFR]]</div></translate>
[[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing guestfs-tools on Linux]] – [[Special:MyLanguage/5_0_0:VMware_Single_File_Restore|VMware SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:Hyper-V_Restore#single_file|Hyper-V SFR]] – [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore|Citrix Hypervisor SFR]] – [[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore|KVM QEMU SFR]] – [[Special:MyLanguage/5_0_0:Nutanix_AHV_Restore#single_file|Nutanix AHV SFR]] – [[Special:MyLanguage/5_0_0:OLVM_Restore#single_file|OLVM SFR]] – [[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#single_file|RHV SFR]] – [[Special:MyLanguage/5_0_0:OpenNebula_Single_File_Restore|OpenNebula SFR]]</div></translate>

Revision as of 11:48, 28 December 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.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 5.0.0 Jaglion. For previous documentation version(s), check Documentation archive.


Overview

This article describes the general procedure for single file restore (SFR) of VM files via the web Restore Assistant. For details on how to fully restore VMs via the web, see the description in Restore Assistant. SEP sesam provides simple and flexible single file restore (SFR) for almost all VMs (except Proxmox VE): VMware vSphere, Microsoft Hyper-V, Citrix Hypervisor, KVM/QEMU, Nutanix AHV, Oracle Linux Virtualization Manager (OLVM), Red Hat Virtualization (RHV), and OpenNebula virtual machines via the web Restore Assistant in advanced UI mode, if you have the appropriate permissions.

Note that this article describes the general prerequisites and the procedure for restoring a single file (SFR) via the web Restore Assistant. As each VM type (VMware, Citrix, etc.) has different prerequisites and options for restoring, you should also check the instructions specific to your VM type:

Prerequisites

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

  • SEP sesam Server version ≥ 5.0.0 Jaglion. For the list of supported systems, see Support Matrix.
  • SFR of backups from virtualization platforms requires the guestfs-tools package to be installed on Linux in order to access and mount VM disk image on Linux. If the package is not installed on your SEP sesam Server or Linux RDS, it is not possible to mount VMDK and perform SFR. Refer to Installing guestfs-tools on Linux.
  • A SEP sesam data store (Path, Si3 deduplication store, etc.) is recommended.
  • Backups must not be encrypted, compressed or stored on tape.
  • To restore single files via the Restore Assistant, appropriate permissions are required. For details, see About Authentication and Authorization and User Roles and Permissions.
  • Make sure that there is enough free space on the target system to which you are restoring your data.
Information sign.png Note
Some restrictions also apply for mounting the virtual disk.

Accessing the restore assistant

You can access the restore assisstant in one of the following ways:

  • via the GUI: by clicking the Restore Assistant icon in the toolbar or from Activities -> Restore Assistant
  • from SEP sesam Web UI: left menu -> Restore Assistant
  • or by entering the following address in the browser bar: http://[sesamserver]:11401/sep/ui/restore/.
Information sign.png Note
  • If you cannot access the web Restore Assistant, check if you have received the appropriate permissions for online restore.
  • 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 UI mode.
    For details, see About Authentication and Authorization and User Roles and Permissions.

Restoring single files of VMs

You can use the web Restore Assistant to restore individual VM files from VMware vSphere, Microsoft Hyper-V, Citrix Hypervisor, KVM/QEMU, Nutanix AHV, Oracle Linux Virtualization Manager (OLVM), Red Hat Virtualization (RHV), and OpenNebula if you have the appropriate permissions.

To restore a single item from a VM backup, select what to restore from a list of VM types. The basic restore procedure is similar for all VM types, except that for some VM types additional restore options are available.

  1. Open the Restore Assistant in the browser.
  2. In the Start window, select the VM restore type: VMware vSphere, Microsoft Hyper-V, Citrix Hypervisor, KVM/QEMU, Nutanix AHV, Oracle Linux Virtualization Manager (OLVM), Red Hat Virtualization (RHV), or OpenNebula. In our example, Citrix Hypervisor is selected.
  3. Then select the option Advanced View. The VM or single file restore option is selected by default. Click Next.
    Restore assistant SFR Citrix start Jaglion.jpg
  4. In the Virtual Machine window, under Selection of the server, select your target server to which the data will be restored.
  5. Then, under Selection of the virtual machine, select the VM that you want to restore and click Next.
    Restore assistant Citrix select server Jaglion.jpg
  6. In the Task window, under Task selection, select your source task. A backup task defines the source data that was backed up by the client.
  7. 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. Restore assistant SFR Citrix select task Jaglion.jpg
  8. In the Files window, select the SEP sesam Server or RDS to which you want to mount the backup. You can also specify an alternative mount path (by entering an absolute path or using the Browse button) and set advanced mount options. Then click the button Mount this backup in filesystem. A new window will appear showing the progress of the mount process.
  9. Information sign.png Note
    • SFR of backups from virtualization platforms requires the guestfs-tools package to be installed on Linux in order to access and mount VM disk image on Linux. If the package is not installed on your SEP sesam Server or Linux RDS, it is not possible to mount VMDK and perform SFR. Refer to Installing guestfs-tools on Linux.
    • Mounting is not possible if the savesets are stored on tapes or if the data is compressed or encrypted. For mounting also some other XPRFS restrictions apply.
    • In the case of VMware, it is posible to attach virtual disks to a Proxy-VM via NFS server instead of mounting the backup to a file system, but this is currently only supported in the SEP sesam GUI. See VMware Single File Restore.

    Restore assistant SFR mount general Jaglion.jpg

  10. Once a virtual disk is mounted to the device server, select the files you want to restore and click Next.
  11. Restore assistant SFR Citrix files Jaglion.jpg
  12. In the Target window, under Target selection, select your target environment for restore. You can use the drop-down list to select or filter VMs by name.
  13. Then enter or browse for your target path and select an appropriate Execution option:
    Do not overwrite existing items: Files are only restored if they do not already exist on the target system.
    Create new version: Restore files under a new name.
    Overwrite existing items: If the data exists on the target server, it is replaced with the restored version.
    Then decide how you want to restore your data (keep the original tree structure or flat):
    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.
    Restore all items flat in the selected target directory: The backup is simply restored to a file without recreating the directory structure.
    You can also select to skip ACL settings during restore.
    Click Next.
    Restore assistant SFR select Citrix target Jaglion.jpg
  14. 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 Online restore in advanced UI mode.
  15. Click Next.
    Restore assistant SFR Citrix recovery options Jaglion.jpg
  16. In the last step, check the summary of your restore task (restore type (based on task type, selected backup, its date and details, restore options, etc.) and click Start restore.
  17. Restore assistant SFR Citrix final Jaglion.jpg

Monitoring restore

You can view the status of your restore jobs in the Restore Assistant by clicking the monitoring icon (second icon in the upper right corner), via SEP sesam Web UI (Monitoring -> Restores), or view the status in the GUI (Main Selection -> Job State -> Restores). The restore overview provides detailed information on the last run of restore jobs, including task name, status (successful, error, in queue ...), start and stop time of the last backup, data size, throughput, etc. For details, see SEP sesam Web UI or Restores by State in the GUI.