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

From SEPsesam
(Draft nearly finished (waiting for final implementation).)
(Update in progress)
Line 21: Line 21:
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | Problems? Check the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | Problems? Check the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].
|}</div></noinclude>
|}</div></noinclude>
<span style="font-size:92%; line-height: 1.3em; color:grey;">This article describe sonly the general procedure for restoring individual virtual machine (VM) files via the web ''Restore Assistant''. For details about web complete VM restore, see [[Special:MyLanguage/5_0_0:Restore_Assistant|Restore Assistant]].</span>
<span style="font-size:92%; line-height: 1.3em; color:grey;">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  [[Special:MyLanguage/5_0_0:Restore_Assistant|Restore Assistant]].</span>


SEP sesam provides simple and flexible single file restore for ''VMware'', ''Hyper-V'', ''RHV/OLVM'', ''Citrix Hypervisor'', ''KVM/QEMU'', and ''OpenNebula'' virtual machines (VMs) via the web interface ''Restore Assistant'' in ''advanced'' UI mode, if you have the appropriate permissions. Single file restore for ''Proxmox VE'' and ''Nutanix AHV'' VM is not currently supported.
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 [[Special:MyLanguage/5_0_0:User_Roles_and_Permissions|appropriate permissions]].  


Note that this article describes the general prerequisites and procedure for restoring a single file via the web Restore Assistant. However, each VM type (VMware, Citrix, etc.) has different prerequisites and available options in the Restore Assistant, so you should also check the instructions specific to your VM type:
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:
*[[Special:MyLanguage/5_0_0:VMware_Single_File_Restore|VMware Single File Restore]]
*[[Special:MyLanguage/5_0_0:VMware_Single_File_Restore|VMware Single File Restore]]
*[[Special:MyLanguage/4_4_3_Beefalo:Hyper-V_Restore#single_file|Hyper-V Single File Restore]]
*[[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore|Citrix Hypervisor Single File Restore]]
*[[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore|Citrix Hypervisor Single File Restore]]
*[[Special:MyLanguage/4_4_3_Beefalo:Hyper-V_Restore#single_file|Hyper-V Single File Restore]]
*[[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore|KVM QEMU Single File Restore]]
*[[Special:MyLanguage/5_0_0:Nutanix_AHV_Restore#single_file|Nutanix AHV Single File Restore]]
*[[Special:MyLanguage/5_0_0:OLVM_Restor#single_file|OLVM Single File Restore]]
*[[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#single_file|RHV Single File Restore]]
*[[Special:MyLanguage/4_4_3_Beefalo:RHV_Restore#single_file|RHV Single File Restore]]
*[[Special:MyLanguage/5_0_0:KVM_QEMU_Single_File_Restore|KVM QEMU Single File Restore]]
*[[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 39: Line 41:
*A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] (''Path'', ''Si3 deduplication store'', etc.) is recommended.
*A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] (''Path'', ''Si3 deduplication store'', etc.) is recommended.
*Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|encrypted]], [[Special:MyLanguage/SEP_sesam_Glossary#compression|compressed]] or stored on tape.
*Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|encrypted]], [[Special:MyLanguage/SEP_sesam_Glossary#compression|compressed]] or stored on tape.
*To restore single files via the ''Restore Assistant'', appropriate permissions are required. For details, see [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]].
*To restore single files via the ''Restore Assistant'', appropriate permissions are required. 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]].
*Make sure that there is enough free space on the target system to which you are restoring your data.
*Make sure that there is enough free space on the target system to which you are restoring your data.
{{Note|Some [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] also apply for mounting the virtual disk.}}
{{Note|Some [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] also apply for mounting the virtual disk.}}
Line 50: Line 52:
*or by entering the following address in the browser bar: ''http://[sesamserver]:11401/sep/ui/restore/''.  
*or by entering the following address in the browser bar: ''http://[sesamserver]:11401/sep/ui/restore/''.  


{{note|If you cannot access the web ''Restore Assistant'', check if you have received the appropriate permissions for online restore. For details, see [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]].}}
{{note|If you cannot access the web ''Restore Assistant'', check that you have been given the appropriate permissions for online restore. 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]].}}


=={{anchor|single_file}}Restoring single files of VMs==
=={{anchor|single_file}}Restoring single files of VMs==


You can use the web Restore Assistant to restore individual virtual machine files from ''VMware'', ''Hyper-V'', ''RHV/OLVM'', ''Citrix Hypervisor'', ''KVM/QEMU'', and ''OpenNebula''.
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 want to restore a single item from a virtual machine (VM) backup, you can select what to restore from a list of VM types. The basic restore procedure is similar for all VM types, except that additional options are available for some VM types, e.g., in the case of a VMware VM, you can attach VMDK to a VM (recommended method) instead of mounting VMDK to the file system.
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 options are available, e.g., in the case of a VMware VM, you can attach VMDK to a VM (recommended method) instead of mounting VMDK to the file system.


<ol><li>Open the ''Restore Assistant'' in the browser.</li>
<ol><li>Open the ''Restore Assistant'' in the browser.</li>
<li>In the ''Start'' window, select the ''VM restore type'': ''VMware vSphere'', ''Microsoft Hyper-V'', ''Citrix Hypervisor'', ''KVM/QEMU'', ''Red Hat/Oracle Linux VM'', or ''OpenNebula''. In our example, ''Microsoft Hyper-V'' is selected.</li>  
<li>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, ''Microsoft Hyper-V'' is selected.</li>  
Then select the option '''Advanced View'''. The ''VM or single file restore'' option is selected by default. Click '''Next'''.<br />
Then select the option '''Advanced View'''. The ''VM or single file restore'' option is selected by default. Click '''Next'''.<br />
[[image:Restore_assistant_SFR_VM_type_Jaglion.jpg|680px|link=]]
[[image:Restore_assistant_SFR_VM_type_Jaglion.jpg|680px|link=]]
Line 70: Line 72:
<br clear=all>
<br clear=all>
<li>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.</li>  
<li>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.</li>  
Then, under the ''Backup selection'', select the exact backup version you want to restore. You can use the calendar feature in the upper right corner to filter a date range for the backups displayed. Select the '''Single file restore''' option and  click '''Next'''.<br />
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. In the lower right corner select the '''Single file restore''' option and  click '''Next'''.<br />
[[image:Restore_assistant_SFR_select_backup_general_Jaglion.jpg|680px|link=]]
[[image:Restore_assistant_SFR_select_backup_general_Jaglion.jpg|680px|link=]]
<br clear=all>
<br clear=all>
<li>In the ''Files'' window, you must select the SEP sesam Server or RDS to which you want to ''mount'' (or ''attach'') the backup. You can also specify an ''alternative mount path'' and/or ''advanced mount options''.</li>
<li>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''.</li>
{{Note|
{{Note|
*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.
*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.

Revision as of 11:40, 28 October 2021

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

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 that you have been given the appropriate permissions for online restore. 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.

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 options are available, e.g., in the case of a VMware VM, you can attach VMDK to a VM (recommended method) instead of mounting VMDK to the file system.

  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, Microsoft Hyper-V 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 VM type Jaglion.jpg
  4. In the Virtual Machine window, under Selection of the server, select your target server.
  5. Then, under Selection of the virtual machine, select the VM you want to restore. Click Next.
    Restore assistant SFR select VM general 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. 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. In the lower right corner select the Single file restore option and click Next.
    Restore assistant SFR select backup general Jaglion.jpg
  8. 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.
  9. Information sign.png Note
    • 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 recommended to attach virtual disks to a Proxy-VM via NFS server instead of mounting the backup to a file system. See VMware Single File Restore.

    Restore assistant SFR mount general Jaglion.jpg

  10. Once a virtual disk is mounted/attached to the device server, select the files you want to restore and click Next.
  11. File:Restore assistant SFR files general 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. File:Restore assistant SFR select VM target Jaglion.jpg
  14. Under VM restore options, set additional restore options:
  15. Do not overwrite an existing virtual machine: The VM is restored only if it does not already exist on the target system.
    Restore an existing virtual machine with a new name: The VM will be restored with a new name. In the case of an OpenNebula restore, the name of the target VM is created automatically.
    Overwrite an existing virtual machine: If the VM exists on the target server, it will be replaced with the restored version. You can also choose to automatically shut down the running VM.
    Click Next.
    File:Restore assistant SFR VM execution options Jaglion.jpg
  16. In the Options window, you can specify additional advanced options, such as selecting a data mover and a data store, specifying target and recovery options, etc. For details on the available options, see Restoring virtual machines in advanced UI mode.
  17. Click Next.
    File:Restore assistant SFR target VM options Jaglion.jpg
  18. In the final step, review your restore task and click Start restore.

Monitoring restore

You can view the status of your restores in the GUI (Job State -> Restores) or SEP sesam Web UI (Monitoring -> Restores). Restore overview provides detailed information about 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.