Source:Single File Restore for Virtual Machines-Jaglion: Difference between revisions
(Draft for single file restore in the restore assistant, in progress.) |
(Draft in progress.) |
||
Line 23: | Line 23: | ||
As of SEP sesam v. [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], it is possible to restore single files of virtual machines (VMs) by using the web interface ''Restore Assistant'' if you have been granted the appropriate permissions. | As of SEP sesam v. [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], it is possible to restore single files of virtual machines (VMs) by using the web interface ''Restore Assistant'' if you have been granted the appropriate permissions. | ||
Note that this article describes single file restore procedure for virtual machines (VMs) through the web ''Restore Assistant''. For details on | Note that this article only describes single file restore procedure for virtual machines (VMs) through the web ''Restore Assistant''. For details on its requirements and web complete VM restore, see [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]]. | ||
=== {{anchor|access}}Accessing the restore assistant === | === {{anchor|access}}Accessing the restore assistant === | ||
Line 33: | Line 33: | ||
{{note|If you cannot access the web ''Restore Assistant'', check if you have been granted appropriate permissions to perform an online restore. For details, see [[Special:MyLanguage/4_4_3_Grolar:About_Authentication_and_Authorization|About Authentication and Authorization]].}} | {{note|If you cannot access the web ''Restore Assistant'', check if you have been granted appropriate permissions to perform an online restore. For details, see [[Special:MyLanguage/4_4_3_Grolar:About_Authentication_and_Authorization|About Authentication and Authorization]].}} | ||
=={{anchor| | =={{anchor|single_file}}Restoring single files of VMs== | ||
In the web Restore assistant, you can restore single files of ''VMware'', ''Hyper-V'', ''RHV/OLVM'', ''Citrix Hypervisor'', ''KVM/QEMU'' and ''OpenNebula'' virtual machines. | In the web Restore assistant, you can restore single files of ''VMware'', ''Hyper-V'', ''RHV/OLVM'', ''Citrix Hypervisor'', ''KVM/QEMU'' and ''OpenNebula'' virtual machines. A single file restore for ''Proxmox VE'' VM is currently not supported. | ||
Note | When you choose to restore an individual item from a virtual machine (VM) backup, you can select from a list of VM types what you want to restore. The basic restore procedure is almost the same for all VM types, except that some additional options are available for some VM types, for example, in case of a VMware you can attach VMDK to a VM (recommended method) instead of mounting VMDK to the file system. | ||
{{Note|The single file restore options are available in both restore UI modes (''basic'' and ''advanced''), however, there are some additional restore options available in the ''advanced UI mode'', see [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant#VMs_advanced_restore|Restoring VMs in advanced UI mode]].}} | |||
<ol><li>Open the ''Restore Assistant'' in the browser.</li> | |||
<li>In the ''Start'' window, select your target ''restore type'': ''VMware vSphere'', ''Microsoft Hyper-V'', ''Citrix Hypervisor'', ''KVM/QEMU'', ''Red Hat/Oracle Linux VM'', or ''Open Nebula''. Click '''Next'''.</li> | |||
[[image:Restore_assistant_SFR_VM_restore_type_Jaglion.jpg|750px|link=]] | |||
<br clear=all> | |||
<li>In the ''Virtual Machine'' window, under ''Selection of the server'' select your target server.</li> | |||
[[image:Restore_assistant_SFR_select_server_Jaglion.jpg|730px|link=]] | |||
<br clear=all> | |||
<li>Then, under ''Selection of the virtual machine'' select the VM you want to restore.</li> | |||
Click '''Next'''.<br /> | |||
[[image:Restore_assistant_SFR_select_VM_Jaglion.jpg|730px|link=]] | |||
<br clear=all> | |||
<li>In the ''Task'' window, under the ''Task selection'' select your source task. A [[Special:MyLanguage/SEP_sesam_Glossary#backup_task|backup task]] defines the source data which was backed up from the client.</li> | |||
[[image:Restore_assistant_SFR_select_VM_task_Jaglion.jpg|730px|link=]] | |||
<br clear=all> | |||
<li>Then under the ''Backup selection'' select the exact backup version you want to restore. You can use the calendar function found in the upper right corner to filter a date range for the displayed backups. Select the '''Single file restore''' option and click '''Next'''.</li> | |||
[[image:Restore_assistant_SFR_select_VM_backup_Jaglion.jpg|730px|link=]] | |||
<br clear=all> | |||
<li>In the ''Files'' window, for the most VMs the backup is mounted automatically. However, in case of VMware, you have to select the option '''Attach virtual disks to a Proxy-VM via NFS server''' (recommended) or '''Mount virtual disks in file system'''. Once a virtual disk is mounted/attached to the device server, select the files you want to restore and click '''Next'''. </li> | |||
[[image:Restore_assistant_SFR_select_files_Jaglion.jpg|700px|link=]] | |||
<br clear=all> | |||
<li>In the ''Target'' window, under the ''Target selection'' select your target environment for restore. You can use the drop-down list to select or filter VMs by name.</li> | |||
[[image:Restore_assistant_SFR_select_VM_target_Jaglion.jpg|700px|link=]] | |||
<br clear=all> | |||
<li>Set additional restore options under the ''Execution options'':</li> | |||
'''''Do not overwrite an existing virtual machine:''''' VM will be restored only if it is not already present on the target system.<br /> | |||
'''''Restore an existing virtual machine with a new name:''''' VM will be restored under a new name. In case of OpenNebula restore the target VM name will be automatically created.<br /> | |||
'''''Overwrite an existing virtual machine:''''' If the VM exists on the target server, it will be replaced by the restored version. You can also select to shut down the running VM automatically.<br /> | |||
Click '''Next'''.<br /> | |||
[[File:Restore_assistant_SFR_VM_execution_options_Jaglion.jpg|700px|link=]] | |||
<li>In the ''Options'' window, select the data mover and then under the ''Recovery options'' select if you want to start VM after restore or not.</li> | |||
[[image:Restore_assistant_SFR_recovery_options_Jaglion.jpg|700px|link=]] | |||
<br clear=all> | |||
{{Note|In case of VMware restore you can also select the desired transport mode from the list of available transport modes (''HOTADD'', ''SAN'', ''NBD'', or ''NBDSSL''); click the displayed transport mode and rearrange the modes according to your preferences.}} | |||
<li>Click the option ''Target options of the virtual machine'', to set additional target options, e.g., target server, data store, network interface(s), folder, and Resource pool/vApp.</li> | |||
Click '''Next'''.<br /> | |||
[[image:Restore_assistant_SFR_target_VM_options_Jaglion.jpg|700px|link=]] | |||
<br clear=all> | |||
<li>In the last step, review your restore task and click '''Start restore'''.</li> | |||
</ol> | |||
<noinclude>==See also== | <noinclude>==See also== | ||
[[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/Virtualization|Virtualization]]</noinclude> | [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/Virtualization|Virtualization]]</noinclude> |
Revision as of 13:35, 25 November 2020
Overview
As of SEP sesam v. 5.0.0 Jaglion, it is possible to restore single files of virtual machines (VMs) by using the web interface Restore Assistant if you have been granted the appropriate permissions.
Note that this article only describes single file restore procedure for virtual machines (VMs) through the web Restore Assistant. For details on its requirements and web complete VM restore, see Restore Assistant.
Accessing the restore assistant
You can access the Restore Assistant from the SEP sesam GUI by clicking the Restore Assistant icon in the toolbar, from Activities -> Restore Assistant, or by typing the following information in the browser address bar:
http://[sesamserver]:11401/sep/ui/restore/
Note | |
If you cannot access the web Restore Assistant, check if you have been granted appropriate permissions to perform an online restore. For details, see About Authentication and Authorization. |
Restoring single files of VMs
In the web Restore assistant, you can restore single files of VMware, Hyper-V, RHV/OLVM, Citrix Hypervisor, KVM/QEMU and OpenNebula virtual machines. A single file restore for Proxmox VE VM is currently not supported.
When you choose to restore an individual item from a virtual machine (VM) backup, you can select from a list of VM types what you want to restore. The basic restore procedure is almost the same for all VM types, except that some additional options are available for some VM types, for example, in case of a VMware you can attach VMDK to a VM (recommended method) instead of mounting VMDK to the file system.
Note | |
The single file restore options are available in both restore UI modes (basic and advanced), however, there are some additional restore options available in the advanced UI mode, see Restoring VMs in advanced UI mode. |
- Open the Restore Assistant in the browser.
- In the Start window, select your target restore type: VMware vSphere, Microsoft Hyper-V, Citrix Hypervisor, KVM/QEMU, Red Hat/Oracle Linux VM, or Open Nebula. Click Next.
- In the Virtual Machine window, under Selection of the server select your target server.
- Then, under Selection of the virtual machine select the VM you want to restore. Click Next.
- In the Task window, under the Task selection select your source task. A backup task defines the source data which was backed up from the client.
- Then under the Backup selection select the exact backup version you want to restore. You can use the calendar function found in the upper right corner to filter a date range for the displayed backups. Select the Single file restore option and click Next.
- In the Files window, for the most VMs the backup is mounted automatically. However, in case of VMware, you have to select the option Attach virtual disks to a Proxy-VM via NFS server (recommended) or Mount virtual disks in file system. Once a virtual disk is mounted/attached to the device server, select the files you want to restore and click Next. File:Restore assistant SFR select files Jaglion.jpg
- In the Target window, under the Target selection select your target environment for restore. You can use the drop-down list to select or filter VMs by name. File:Restore assistant SFR select VM target Jaglion.jpg
- Set additional restore options under the Execution options: Do not overwrite an existing virtual machine: VM will be restored only if it is not already present on the target system.
- In the Options window, select the data mover and then under the Recovery options select if you want to start VM after restore or not. File:Restore assistant SFR recovery options Jaglion.jpg
- Click the option Target options of the virtual machine, to set additional target options, e.g., target server, data store, network interface(s), folder, and Resource pool/vApp. Click Next.
- In the last step, review your restore task and click Start restore.
Restore an existing virtual machine with a new name: VM will be restored under a new name. In case of OpenNebula restore the target VM name will be automatically created.
Overwrite an existing virtual machine: If the VM exists on the target server, it will be replaced by the restored version. You can also select to shut down the running VM automatically.
Click Next.
File:Restore assistant SFR VM execution options Jaglion.jpg
Note | |
In case of VMware restore you can also select the desired transport mode from the list of available transport modes (HOTADD, SAN, NBD, or NBDSSL); click the displayed transport mode and rearrange the modes according to your preferences. |
File:Restore assistant SFR target VM options Jaglion.jpg