4 4 3:VMware Single File Restore: Difference between revisions

From SEPsesam
(Added Special:MyLanguage to links and corrected because of GUI change (backup type to backup level).)
(Marked not latest; link to new version)
 
(40 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<translate>
<!--T:1-->
<div class="noprint"><languages />
{{Copyright SEP AG|en}}
{{Copyright SEP AG|en}}


{{Navigation_latest|release=4.4.3/4.4.3 ''Tigon''|link=[[Special:MyLanguage/VMware|VMware archive]]}}<br />
<!--T:2-->
==Overview==
{{Navigation_previous|link=[[VMware Single File Restore|VMware Single File Restore]] for the new version}}</div></translate><br />
<div class="boilerplate metadata" id="Additional resources" style="background-color: #f0f0f0; color:#636f73; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b>Additional resources</b></center>
<translate>==Overview== <!--T:3--></translate>
<div class="boilerplate metadata" id="Additional resources" style="background-color: #f0f0f0; color:#636f73; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b><translate><!--T:4-->
Additional resources</translate></b></center>


{|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/VMware Restore]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:5-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[Special:MyLanguage/4_4_3_Tigon:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3 ''Tigon'']] – [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3]] – [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]] – [[Special:MyLanguage/4_4_3_Tigon:VMware Backup|VMware Backup 4.4.3 ''Tigon'']] – [[Special:MyLanguage/4_4_3_Tigon:VMware Backup|VMware Backup 4.4.3]] – [[Special:MyLanguage/4_4_3:VMware Restore|VMware Restore]] – [[Special:MyLanguage/4_4_3:VMware Instant Recovery|VMware Instant Recovery]]
[[File:SEP_next.png|45px|link=Special:MyLanguage/VMware_Restore]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:6-->
See also: [[Special:MyLanguage/4_4_3_Tigon:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix (latest)]] – [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3]] – [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] –  [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]] – [[Special:MyLanguage/4_4_3_Tigon:VMware_Backup|VMware Backup (latest)]] – [[Special:MyLanguage/4_4_3_Tigon:VMware Backup|VMware Backup 4.4.3]] – [[Special:MyLanguage/4_4_3:VMware Restore|VMware Restore]] – [[Special:MyLanguage/VMware Instant Recovery|VMware Instant Recovery]]</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;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide#VMware_vStorage_API]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:7-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | If you have a problem with your ''VMware'' ''restore'', check the [[Special:MyLanguage/Troubleshooting_Guide#VMware_vStorage_API|VMware troubleshooting]].
[[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/VMware_Troubleshooting]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:8-->
If you have a problem with your ''VMware'', check the [[Special:MyLanguage/VMware_Troubleshooting|VMware Troubleshooting]].</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;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:icon_archived_docs.png|45px|link=Special:MyLanguage/VMware]]
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:9-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | If you are using an older SEP sesam version, refer to [[Special:MyLanguage/VMware|VMware archive]].
[[File:icon_archived_docs.png|45px|link=Special:MyLanguage/VMware]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:10-->
If you are using an older SEP sesam version, refer to [[Special:MyLanguage/VMware|VMware archive]].</translate>
|}</div>
|}</div>
{{cheatsheet|
{{cheatsheet|
<ol><li>[[#attach|Attach VMDK to a virtual machine.]] </li>
<ol><li><translate><!--T:11-->
<li>[[#client|Configure a virtual host as a SEP sesam client.]]</li>
[[#attach|Attach VMDK to a virtual machine.]]</translate> </li>
<li>[[#NFS|Prepare the NFS share on Linux.]]</li>  
<li><translate><!--T:12-->
<li>[[#restore_VM|Restore a VM using the attached VMDK.]]</li>  
[[#client|Configure a virtual host as a SEP sesam client.]]</translate></li>
OR
<li><translate><!--T:13-->
<li>[[#mount|Mount VMDK ]] to a SEP sesam RDS.</li>
[[#NFS|Prepare the NFS share on Linux.]]</translate></li>  
<li>[[#restore|Restore a single file]] using the mounted VMDK.</li></ol>
<li><translate><!--T:14-->
[[#restore_VM|Restore a VM using the attached VMDK.]]</translate></li>
<translate><!--T:15-->
OR</translate>
<li><translate><!--T:16-->
[[#mount|Mount VMDK]] to a SEP sesam RDS.</translate></li>
<li><translate><!--T:17-->
[[#restore|Restore a single file]] using the mounted VMDK.</translate></li></ol>
}}<br />
}}<br />
<translate><!--T:18-->
It is estimated that about three quarters of the typical VMware virtual machine restore cases only require a single file restore rather than a restore of an entire virtual machine. As of version 4.4.3, SEP sesam introduces '''simple and flexible single file restore''' that enables you to '''restore an individual item without any special backup preparation''' from '''full/differential/incremental backups'''. To learn what applies to single file restore and instant recovery, which [[Special:MyLanguage/SEP_sesam_Glossary#backup_level|backup level]] supports it and how it relates to the disk size usage, see [[Special:MyLanguage/4_4_3_Tigon:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3 ''Tigon'']].
It is estimated that about three quarters of the typical VMware virtual machine restore cases only require a single file restore rather than a restore of an entire virtual machine. As of version 4.4.3, SEP sesam introduces '''simple and flexible single file restore''' that enables you to '''restore an individual item without any special backup preparation''' from '''full/differential/incremental backups'''. To learn what applies to single file restore and instant recovery, which [[Special:MyLanguage/SEP_sesam_Glossary#backup_level|backup level]] supports it and how it relates to the disk size usage, see [[Special:MyLanguage/4_4_3_Tigon:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3 ''Tigon'']].


This article provides information for restoring an '''individual item from a vSphere backup'''. For details on how to a restore a single VMware virtual machine, see [[Special:MyLanguage/4_4_3:VMware Restore|VMware Restore]]. For details on how to perform a VMware virtual machine instant recovery, see [[Special:MyLanguage/4_4_3:VMware Instant Recovery|VMware Instant Recovery]].
<!--T:19-->
This article provides information for restoring an '''individual item from a vSphere backup'''. For details on how to a restore a single VMware virtual machine, see [[Special:MyLanguage/4_4_3:VMware Restore|VMware Restore]]. For details on how to perform a VMware virtual machine instant recovery, see [[Special:MyLanguage/VMware Instant Recovery|VMware Instant Recovery]].


You can restore individual items from any successful VMware backup by using any of the following procedures:
<!--T:239-->
*[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#attach|Attaching VMDK to a virtual machine]]
Note that SEP sesam provides the web ''Restore Assistant'' interface which is designed to be more intuitive and offers additional advanced options compared to ''GUI restore wizard'' while, on the other hand, it does not support ''VMware single file restore'', so you can use only the GUI restore wizard to restore an individual item.
*[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#mount|Mounting VMDK on a device server]]


<!--T:20-->
In the GUI, you can restore individual items from any successful VMware backup by using any of the following procedures:</translate>
*<translate><!--T:21-->
[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#attach|Attaching VMDK to a virtual machine]]</translate>
*<translate><!--T:22-->
[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#mount|Mounting VMDK on a device server]]</translate>
{{<translate><!--T:240--> Note</translate>|<translate><!--T:241--> VMware single file restore ''mount'' and ''attach'' options are only available in [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|''Expert'' UI mode]].</translate>}}
<translate><!--T:23-->
Before starting a restore, check the supported file systems and restrictions.
Before starting a restore, check the supported file systems and restrictions.


===Supported file systems===
===Supported file systems=== <!--T:24-->
SEP sesam can in general recover '''all file systems''' as long as the '''respective operating system''' offers <u>read/write support</u> for it.
 
<!--T:25-->
SEP sesam can in general recover '''all file systems''' as long as the '''respective operating system''' offers <u>read/write support</u> for it.</translate>
 
* <translate><!--T:26-->
Example 1: A restore of files from ''ReFS'' on Windows is only possible if the data mover is able to read the ReFS file system which is supported since Windows Server 2012.</translate>
* <translate><!--T:27-->
Example 2: A restore of files from a ''Btrfs'' is only possible if the data mover is a Linux with Kernel support for it, for example SLES 12.</translate>
* <translate><!--T:28-->
Example 3: If the file system on OES Linux is NSS, the data mover must be able to read the NSS file system data.
 
<!--T:29-->
When '''restoring files from the NSS file system''' some '''limitations''' apply:</translate>
* <translate><!--T:30-->
The restore process itself does not differ from the restore of native Linux or Windows files, but the proxy VM must be an OES11 or higher Server. For prerequisites, check [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#Linux_recommendations|Recommendations for Linux proxy]].</translate>
* <translate><!--T:31-->
Files from a native NetWare VM can be restored only to an OES Linux or native Linux target.</translate>
*<translate><!--T:32-->
To restore trustees, the extended attributes on NSS must be enabled before backup. For details, refer to ''Novell OES documentation for NSS''.</translate>
*<translate><!--T:33-->
If you restore NSS files to a server in the original tree and on an NSS file system, the restored files will keep the original trustees (regardless of the tree of the proxy OES VM you used for restore).</translate>
* <translate><!--T:34-->
Trustees from native NetWare VMs cannot be restored because native NetWare has no extended attributes to store the trustees into the file system.


* Example 1: A restore of files from ReFS on Windows is only possible if the data mover is able to read the ReFS file system which is supported since Windows Server 2012.
===Restrictions=== <!--T:35--></translate>
* Example 2: A restore of files from a Btrfs is only possible if the data mover is a Linux with Kernel support for it, for example SLES 12.
*<translate><!--T:36-->
* Example 3: If the file system on OES Linux is NSS, the data mover must be able to read the NSS file system data.
SEP sesam does not support a restore of files from the DOS boot partition of a native NetWare server.</translate>
*<translate><!--T:37-->
SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. The following limitations exist:</translate>
**<translate><!--T:38-->
[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#mount|Mounting VMDK]] to a SEP sesam Server/RDS is not supported.</translate>
**<translate><!--T:39-->
[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#attach|Attaching VMDK]] to original virtual machine is not supported if the original disks are still attached (as is typically the case in most scenarios).</translate>
*<translate><!--T:40-->
The attach method does not work with a virtual SEP sesam Server or a virtual RDS to itself. For example, a virtual SEP sesam Server stores the virtual disk(s) on the SEP sesam data store. It is not possible to attach VMDK to the respective virtual SEP sesam Server; another VM must be used for this.


When '''restoring files from the NSS file system''' some '''limitations''' apply:
==={{anchor|best_practice}}Best practice for individual file restore for Windows and Linux VMs=== <!--T:41-->
* The restore process itself does not differ from the restore of native Linux or Windows files, but the proxy VM must be an OES11 Server. For prerequisites, check [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#Recommendations for Linux proxy|Recommendations for Linux proxy]].
* Files from a native NetWare VM can be restored only to an OES Linux or native Linux target.
*To restore trustees, the extended attributes on NSS must be enabled before backup. For details, refer to ''Novell OES documentation for NSS''.
*If you restore NSS files to a server in the original tree and on an NSS file system, the restored files will keep the original trustees (regardless of the tree of the proxy OES VM you used for restore).
* Trustees from native NetWare VMs cannot be restored because native NetWare has no extended attributes to store the trustees into the file system.


===Restrictions===
<!--T:42-->
*SEP sesam does not support a restore of files from the DOS boot partition of a native NetWare server.
SEP sesam provides simple restore of individual files without any special backup preparation from VMware CBT snapshot. The following steps represent best practices and latest recommendations from SEP sesam support. Detailed instructions on VMware requirements and backup configuration can be found in related articles [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]] and [[Special:MyLanguage/4_4_3:VMware_Backup|VMware Backup]].</translate> 
*SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. The following limitations exist:
<ul><li><translate><!--T:43-->
**[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#mount|Mounting VMDK]] to a SEP sesam Server/RDS is not supported.
For version 4.4.3, the following limitation applies: Windows SEP sesam Server or Windows RDS is not supported in v. 4.4.3, therefore use Linux SEP sesam Server or RDS. In v. ≥ 4.4.3 ''Tigon'', Windows can be used as a SEP sesam Server or RDS.</translate></li>
**[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#attach|Attaching VMDK]] to original virtual machine is not supported if the original disks are still attached (as is typically the case in most scenarios).
<li><translate><!--T:44-->
*The attach method does not work with a virtual SEP sesam Server or a virtual RDS to itself. For example, a virtual SEP sesam Server stores the virtual disk(s) on the SEP sesam data store. It is not possible to attach VMDK to the respective virtual SEP sesam Server; another VM must be used for this.
Enable the NFS server on the SEP sesam Server or RDS as described in section [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#NFS|Preparing the NFS share]].</translate></li>
<li><translate><!--T:45-->
Install SEP sesam Client to a Linux VM (sandbox for Linux single file restore). VDDK is only required if this VM is also the data mover. In this case, check [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]].</translate></li>
<li><translate><!--T:46-->
Add the Linux VM as a client as described in [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#client|Step 1: Configuring a virtual host as a SEP sesam client]]. Make sure that you select the check box '''Client is a virtual machine'''.</translate></li>
{{<translate><!--T:47-->
note</translate>|
*<translate><!--T:48-->
Any operating system can be used except in case that you need a sandbox for Netware single file restore. Search the wiki for Netware reference.</translate>
*<translate><!--T:49-->
Do not use a productive system as a sandbox!</translate>}}
<li><translate><!--T:50-->
Install SEP sesam Client to a Windows VM (sandbox for Windows single file restore). No specific Windows version is required. VDDK is only required if this VM is also the data mover. In this case, check [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]].</translate></li>
<li><translate><!--T:51-->
Add the Windows VM as a client as described in [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#client|Step 1: Configuring a virtual host as a SEP sesam client]]. Make sure that you select the check box '''Client is a virtual machine'''.</translate></li>
<li><translate><!--T:52-->
Follow [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#restore_VM|Step 3: Restore a VM using the attached VMDK
]]: Select the VMware snapshot and select the check box '''Attach virtual disk(s) (VMDK) to a Proxy-VM via NFS server'''. Then click ''Next'' and under ''Select VM'' use the drop-down list to select Linux or Windows sandbox VM.</translate></li></ul>


==={{anchor|best_practice}}Best practice for individual file restore for Windows and Linux VMs===
<translate>=={{anchor|attach}}Attaching VMDK to a virtual machine <span style="font-size:74%; font-weight:550; font-family:Arial">([[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Expert mode]] only)</span>== <!--T:53-->
SEP sesam provides simple restore of individual files without any special backup preparation from VMware CBT snapshot. The following steps represent best practices and latest recommendations from SEP sesam support. Detailed instructions on VMware requirements and backup configuration can be found in related articles [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]] and [[Special:MyLanguage/4_4_3:VMware_Backup|VMware Backup]]. 
<ul><li>For version 4.4.3, the following limitation applies: Windows SEP sesam Server or Windows RDS is not supported in v. 4.4.3, therefore use Linux SEP sesam Server or RDS. In case of v. 4.4.3 ''Tigon'', Windows can be used as a SEP sesam Server or RDS.</li>
<li>Enable the NFS server on the SEP sesam Server or RDS as described in section [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#NFS|Preparing the NFS share]].</li>
<li>Install SEP sesam Client to a Linux VM (sandbox for Linux single file restore). VDDK is only required if this VM is also the data mover. In this case, check [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]].</li>
<li>Add the Linux VM as a client as described in [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#client|Step 1: Configuring a virtual host as a SEP sesam client]]. Make sure that you select the check box '''Client is a virtual machine'''.</li>
{{note|
*Any operating system can be used except in case that you need a sandbox for Netware single file restore. Search the wiki for Netware reference.
*Do not use a productive system as a sandbox!}}
<li>Install SEP sesam Client to a Windows VM (sandbox for Windows single file restore). No specific Windows version is required. VDDK is only required if this VM is also the data mover. In this case, check [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]].</li>
<li>Add the Windows VM as a client as described in [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#client|Step 1: Configuring a virtual host as a SEP sesam client]]. Make sure that you select the check box '''Client is a virtual machine'''.</li>
<li>Follow [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#restore|Step 3: Restore a VM using the attached VMDK
]]: Select the VMware snapshot and select the check box '''Attach virtual disk(s) (VMDK) to a Proxy-VM via NFS server'''. Then click Next and under ''Select VM'' use the drop-down list to select Linux or Windows sandbox VM.</li></ul>


=={{anchor|attach}}Attaching VMDK to a virtual machine==
<!--T:54-->
Attaching VMDK to a virtual machine is the '''recommended option for single file restore''' for Windows and Linux that requires only one SEP sesam Server or Remote Device Server (RDS).
Attaching VMDK to a virtual machine is the '''recommended option for single file restore''' for Windows and Linux that requires only one SEP sesam Server or Remote Device Server (RDS).</translate>
{{note|SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. Attaching VMDK to the original virtual machine is not supported if the original disks are still attached. You can only attach VMDK to another Windows host, because Microsoft does not allow to use the same volumes twice when having spanned volumes. Then the disks will be marked as ''Foreign'' in Disk Management. Only possible workaround is to bring these disks online manually using Disk Management. For details, see section [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#manage_VMs|Managing virtual machines with spanned volumes]].}}
{{<translate><!--T:55-->
note</translate>|<translate><!--T:56-->
SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. Attaching VMDK to the original virtual machine is not supported if the original disks are still attached. You can only attach VMDK to another Windows host, because Microsoft does not allow to use the same volumes twice when having spanned volumes. Then the disks will be marked as ''Foreign'' in Disk Management. Only possible workaround is to bring these disks online manually using Disk Management. For details, see section [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#manage_VMs|Managing virtual machines with spanned volumes]].</translate>}}


''Conceptual view of a single item restore with the attached VMDK''
<translate><!--T:57-->
[[File:SEP sesam instant-recovery and single-file-restore 04 attach 03.png|link=]]
''Conceptual view of a single item restore with the attached VMDK''</translate><br />
<translate><!--T:58-->
[[File:SEP sesam instant-recovery and single-file-restore 04 attach 03.png|link=]]</translate>
<br clear=all>
<br clear=all>
===Prerequisites===
<translate>===Prerequisites=== <!--T:59-->
 
<!--T:60-->
Before attempting to attach VMDK and performing a single file restore, all preparation steps have to be performed properly, including configuration and VM backup. Depending on your SEP sesam version, see the relevant [[Special:MyLanguage/VMware|VMware guide]] for details.  
Before attempting to attach VMDK and performing a single file restore, all preparation steps have to be performed properly, including configuration and VM backup. Depending on your SEP sesam version, see the relevant [[Special:MyLanguage/VMware|VMware guide]] for details.  


<!--T:61-->
The VMware single file restore prerequisites differ slightly depending on your SEP sesam version. For example, 4.4.3 ''Tigon'' already supports all backup levels and provides selective restore.
The VMware single file restore prerequisites differ slightly depending on your SEP sesam version. For example, 4.4.3 ''Tigon'' already supports all backup levels and provides selective restore.
Make sure that the following conditions are met:
Make sure that the following conditions are met:</translate>
* SEP sesam Server version ≥ 4.4.3. For the list of supported systems, see [[SEP sesam OS and Database Support Matrix]].
* <translate><!--T:62-->
* A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] ''Path'' or SEP sesam ''Si3'' data store:  
SEP sesam Server version ≥ 4.4.3. For the list of supported systems, see [[SEP sesam OS and Database Support Matrix]].</translate>
** SEP sesam v. 4.4.3 ''Tigon'' supports the UNC path (e.g., <tt>\\server\folder</tt>) for data store.
* <translate><!--T:63-->
** In SEP sesam v. 4.4.3, data store via UNC path is not supported. A volume must be visible as a locally attached storage (not as a network drive letter). Only iSCSI, SAN and locally connected drives can be used as a locally attached storage.
A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] ''Path'', SEP sesam ''Si3 deduplication store'' or ''HPE StoreOnce'':</translate>
* Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|'''encrypted''']] or [[Special:MyLanguage/SEP_sesam_Glossary#compression|'''compressed''']], and they must not be migrated to another media – only the original backup on SEP sesam data store can be used for restore.
** <translate><!--T:64-->
* At least one virtual host of VMware vCenter needs to be added as a SEP sesam Client ≥ 4.4.3 to attach VMDKs.
SEP sesam v. 4.4.3 ''Tigon'' supports the UNC path (e.g., <tt>\\server\folder</tt>) for data store.</translate>
* Encrypted file systems within the virtual machine can only be read if the system (proxy VM) with the attached virtual disk is able to decrypt the data.
** <translate><!--T:65-->
* The system that stores the VMDK files to SEP sesam data store (either SEP sesam Server or SEP sesam RDS) must provide NFS (network file system) services:  
In SEP sesam v. 4.4.3, data store via UNC path is not supported. A volume must be visible as a locally attached storage (not as a network drive letter). Only iSCSI, SAN and locally connected drives can be used as a locally attached storage.</translate>
**V. 4.4.3 ''Tigon'' already includes the NFS server and does not require a regular NFS server provided by Windows.
* <translate><!--T:66-->
** For SEP sesam v. 4.4.3 with the NFS service on Windows, it is recommended to use Windows 2012 (R2) for providing a higher level of NFS support.
Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|encrypted]] or [[Special:MyLanguage/SEP_sesam_Glossary#compression|compressed]], and they must not be migrated to another media – only the original backup on SEP sesam data store can be used for restore.</translate>
*A proxy server (either Windows or Linux VM) should be a non-production environment. For more details, see [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#Recommendations for Linux proxy|Recommendations for Linux proxy]] below.
* <translate><!--T:67-->
*When using both, virtual Linux and Windows hosts, it is recommended to add one virtual Linux and one virtual Windows host to ensure file system compatibility.
At least one virtual host of VMware vCenter needs to be added as a SEP sesam Client ≥ 4.4.3 to attach VMDKs.</translate>
{{note|
* <translate><!--T:68-->
Encrypted file systems within the virtual machine can only be read if the system (proxy VM) with the attached virtual disk is able to decrypt the data.</translate>
* <translate><!--T:69-->
The system that stores the VMDK files to SEP sesam data store (either SEP sesam Server or SEP sesam RDS) must provide NFS (network file system) services:</translate>
**<translate><!--T:70-->
V. 4.4.3 ''Tigon'' already includes the NFS server and does not require a regular NFS server provided by Windows.</translate>
** <translate><!--T:71-->
For SEP sesam v. 4.4.3 with the NFS service on Windows, it is recommended to use Windows 2012 (R2) for providing a higher level of NFS support.</translate>
*<translate><!--T:72-->
A proxy server (either Windows or Linux VM) should be a non-production environment. For more details, see [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#Linux_recommendations|Recommendations for Linux proxy]] below.</translate>
*<translate><!--T:73-->
When using both, virtual Linux and Windows hosts, it is recommended to add one virtual Linux and one virtual Windows host to ensure file system compatibility.</translate>
*<translate><!--T:74-->
Some versions, for example, VDDK 6.5.x on Windows, might require rebooting the host after the update, followed by running the <tt>vstor2install.bat script</tt>. For details, see [[Special:MyLanguage/VMware_Troubleshooting#VDDK|VMware Troubleshooting]].</translate>
{{<translate><!--T:75-->
note</translate>|
<translate><!--T:76-->
SEP sesam can restore all file systems for which the respective operating system provides a read/write support. For example, a restore of files on Windows ReFS is only possible if the system with the attached disk is able to read ReFS data. Or, if the file system on OES Linux is NSS, the system with the attached disk must be able to read the NSS file system data.}}
SEP sesam can restore all file systems for which the respective operating system provides a read/write support. For example, a restore of files on Windows ReFS is only possible if the system with the attached disk is able to read ReFS data. Or, if the file system on OES Linux is NSS, the system with the attached disk must be able to read the NSS file system data.}}


==={{anchor|client}}Step 1: Configuring a virtual host as a SEP sesam client===
==={{anchor|client}}Step 1: Configuring a virtual host as a SEP sesam client=== <!--T:77-->


To be able to attach a VMDK file to a virtual host, SEP sesam needs to know where to attach the VMDK file(s). You have to add at least one virtual host as a SEP sesam client and this system must be assigned to the virtual host.
<!--T:78-->
<ol><li>From '''Main Selection -> Components -> Topology''', select your location and click the '''New client''' button. The ''New client'' window opens.</li>
To be able to attach a VMDK file to a virtual host, SEP sesam needs to know where to attach the VMDK file(s). You have to add at least one virtual host as a SEP sesam client and this system must be assigned to the virtual host.</translate>
<li>In the ''New client'' window, configure the following options:
<ol><li><translate><!--T:79-->
<ul><li>Enter the name of the virtual host in the '''Client name''' field.</li>
From '''Main Selection''' -> '''Components''' -> '''Topology''', select your VMware location and click the '''New Client''' button. The ''New Client'' window opens.</translate></li>
<li>Select the relevant platform from the '''Platform''' drop-down list and the relevant OS under '''Operating system'''.</li>
<li><translate><!--T:81-->
<li>Choose the '''Access mode''' (SMSSH) for the SEP sesam server-client communication (the default setting is ''CTRL'').</li>
Enter the name of the virtual host in the '''Name''' field.</translate></li>
<li>On the left, under the ''SBC Version info'', select the check box '''Client is a virtual machine'''.</li>
<li><translate><!--T:82-->
<li>From the drop-down list on the right,select the name of your vCenter under '''VM host'''.</li>
Select the relevant platform from the '''Platform''' drop-down list and the relevant OS under '''Operating System'''.</translate></li>
<li>Then select the virtual machine from the '''VM name''' list and click '''Create'''.</li></ul></li>
<li><translate><!--T:83-->
[[image:add_client_VH.png|600px|link=]]
Choose the '''SMSSH''' access mode (default in ≥ 4.4.3 ''Tigon V2'') for the SEP sesam server-client communication. Note that ''CTRL'' was default access mode up until v. 4.4.3 ''Tigon V2''.</translate></li>
<li><translate><!--T:85-->
Select the name of your vCenter under '''VM host'''.</translate></li>
<li><translate><!--T:86-->
Select the virtual machine from the '''VM name''' drop-down list.</translate></li>
<li><translate><!--T:84-->
Then select the check box '''Client is a virtual machine''' and click '''OK'''.</translate></li>
<translate><!--T:87-->
[[image:VMware_new_client_Beefalo_V2.jpg|650px|link=]]</translate>
<br clear=all></ol>
<br clear=all></ol>
<translate><!--T:88-->
Your new client is displayed in the ''Topology'' content pane.
Your new client is displayed in the ''Topology'' content pane.


==={{anchor|NFS}}Step 2: Preparing the NFS share on Linux===
<!--T:225-->
NFS (Network File System) is a client/server application that allows to share files across a network. You have to set up the NFS service on the Linux SEP sesam Server or RDS system, which stores the VMDK files.  
In the client properties, additional tabs are available for specifying permissions and access. Double-click the client to open its properties, and set client permissions and vCenter/OS access under the respective tabs. For details, see [[Special:MyLanguage/Configuring Clients|Configuring Clients]].
 
==={{anchor|NFS}}Step 2: Preparing the NFS share on Linux=== <!--T:89-->
NFS (Network File System) is a client/server application that allows to share files across a network. You have to set up the NFS service on the Linux SEP sesam Server or RDS system, which stores the VMDK files.</translate>
<!--
<!--
The procedure for creating a NFS share depends on your SEP sesam Server/RDS operating sytem:
The procedure for creating a NFS share depends on your SEP sesam Server/RDS operating sytem:
*[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#NFS on Windows|NFS on Windows]]
*[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#NFS on Windows|NFS on Windows]]
*[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#NFS on Linux|NFS on Linux]]
*[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore#NFS on Linux|NFS on Linux]]
====NFS on Windows====
<translate>====NFS on Windows==== <!--T:90-->
SEP '''recommends using Windows 2012 (R2)''' for providing a higher level of NFS support. SEP sesam creates the required NFS share on Windows 2012 automatically (if the NFS share is not added, follow the procedure below to add it manually). '''On Windows 2008(R2), you have to set up the NFS share manually''':
 
<ol><li>Login to your SEP sesam Server or RDS which stores the VMDK files and for which you want to configure the NFS share.</li>
<!--T:91-->
<li>To install server for NFS services, execute the following command as administrator via ''Powershell version 2'' at {{Sesamroot|\bin\sesam}}: <tt>sm_installnfs.ps1</tt>. The installation starts automatically.</li>
SEP '''recommends using Windows 2012 (R2)''' for providing a higher level of NFS support. SEP sesam creates the required NFS share on Windows 2012 automatically (if the NFS share is not added, follow the procedure below to add it manually). '''On Windows 2008(R2), you have to set up the NFS share manually''':</translate>
<li>Create the NFS share by using ''Server Manager'': Log on your SEP sesam Server or RDS as a member of the local Administrators group. Use Start menu to start ''servermanager.exe'' if it does not start automatically. Then click '''File Services''' ->  '''Share and Storage Management''' -> '''Provision Share''', and specify the following:
<ol><li><translate><!--T:92-->
[[File:NFS_Server_share.jpg|700px|left|link=]]
Login to your SEP sesam Server or RDS which stores the VMDK files and for which you want to configure the NFS share.</translate></li>
<li><translate><!--T:93-->
To install server for NFS services, execute the following command as administrator via ''Powershell version 2'' at {{Sesamroot|\bin\sesam}}: <tt>sm_installnfs.ps1</tt>. The installation starts automatically.</translate></li>
<li><translate><!--T:94-->
Create the NFS share by using ''Server Manager'': Log on your SEP sesam Server or RDS as a member of the local Administrators group. Use Start menu to start ''servermanager.exe'' if it does not start automatically. Then click '''File Services''' ->  '''Share and Storage Management''' -> '''Provision Share''', and specify the following:</translate><br />
<translate><!--T:95-->
[[File:NFS_Server_share.jpg|700px|link=]]</translate>
<br clear=all>
<br clear=all>
<ul><li>'''Shared Folder Location''': Browse for the path where the SEP sesam data store is located.
<ul><li><translate><!--T:96-->
{{note|The path of the NFS share must be the same as the path of the SEP sesam data store and the name of the NFS share must be the same as the name of the SEP sesam data store where the VMDK files are stored.}}
'''Shared Folder Location''': Browse for the path where the SEP sesam data store is located.</translate>
In our example, the name of the NFS share must be ''NFS-Store1'' and the path must be set to ''E:\nfs'' (see above data store screenshot). Click Next.</li>
{{<translate><!--T:97-->
<li>'''NTFS Permissions''': Leave default NTFS permissions. Click Next.</li>
note</translate>|<translate><!--T:98-->
<li>'''Share Protocols''': Select '''NFS''' and specify a name for the new share – the name of the SEP sesam data store, e.g. ''NFS-Store1''. Click Next.</li>
The path of the NFS share must be the same as the path of the SEP sesam data store and the name of the NFS share must be the same as the name of the SEP sesam data store where the VMDK files are stored.}}
<li>NFS Authentication: Leave default settings.</li>
In our example, the name of the NFS share must be ''NFS-Store1'' and the path must be set to ''E:\nfs'' (see above data store screenshot). Click '''Next'''.</translate></li>
<li>NFS Permissions: Change the ''Type of access'' to '''Read-Write''', and select the check box '''Allow root access'''. Click Next.</li>
<li><translate><!--T:99-->
<li>Confirmation: Review your configuration, and click '''Create''' to create the NFS file share.</li></ul></li>
'''NTFS Permissions''': Leave default NTFS permissions. Click '''Next'''.</translate></li>
<li>Once you created the share, right-click it and select '''Properties''', select the tab '''NFS Sharing''', and click on '''Manage NFS Sharing'''. In the '''NFS Advanced Sharing''' window, set the authentication for the NFS share: select option '''No server authentication''' with sub-option '''Enable unmapped user access''' and radio button '''Allow unmapped user access by UID/GID'''.</li>
<li><translate><!--T:100-->
[[Image:NFS_settings.jpg|left|link=]]
'''Share Protocols''': Select '''NFS''' and specify a name for the new share – the name of the SEP sesam data store, e.g. ''NFS-Store1''. Click '''Next'''.</translate></li>
<li><translate><!--T:101-->
NFS Authentication: Leave default settings.</translate></li>
<li><translate><!--T:102-->
NFS Permissions: Change the ''Type of access'' to '''Read-Write''', and select the check box '''Allow root access'''. Click '''Next'''.</translate></li>
<li><translate><!--T:103-->
Confirmation: Review your configuration, and click '''Create''' to create the NFS file share.</translate></li></ul></li>
<li><translate><!--T:104-->
Once you created the share, right-click it and select '''Properties''', select the tab '''NFS Sharing''', and click on '''Manage NFS Sharing'''. In the '''NFS Advanced Sharing''' window, set the authentication for the NFS share: select option '''No server authentication''' with sub-option '''Enable unmapped user access''' and radio button '''Allow unmapped user access by UID/GID'''.</translate></li>
<translate><!--T:105-->
[[Image:NFS_settings.jpg|link=]]</translate>
<br clear=all>
<br clear=all>
<li>Then click the '''Permissions''' button to open the ''NFS Share Permission'' dialog. Check that the ''Type of access'' is set to '''Read-Write''', and that the check box '''Allow root access''' is enabled to give the root user Administrative privileges. You can set the share permissions for all machines or just for the vCenter server.</li></ol>
<li><translate><!--T:106-->
Then click the '''Permissions''' button to open the ''NFS Share Permission'' dialog. Check that the ''Type of access'' is set to '''Read-Write''', and that the check box '''Allow root access''' is enabled to give the root user Administrative privileges. You can set the share permissions for all machines or just for the vCenter server.</translate></li></ol>
<translate><!--T:107-->
For more details on NFS configuration, see Microsoft article [https://technet.microsoft.com/en-us/library/dd758767(v=ws.10).aspx Services for NFS – Step-by-Step Guide for Windows Server 2008 R2].
For more details on NFS configuration, see Microsoft article [https://technet.microsoft.com/en-us/library/dd758767(v=ws.10).aspx Services for NFS – Step-by-Step Guide for Windows Server 2008 R2].


====NFS on Linux====-->
====NFS on Linux==== <!--T:108--></translate>-->
SEP sesam automatically creates a VMware data store to attach the VMDK file(s) to a virtual host.
 
[[Image:VSphere SF Datastore en.jpg|600px|link=]]
<!--T:109-->
<br clear=all>
<translate><!--T:207-->
SEP sesam automatically creates a VMware data store to attach the VMDK file(s) to a virtual host.</translate><br />


The following overview provides only basic information for configuring NFS on Linux. For details, see relevant Linux documentation, for example, the article [https://linuxconfig.org/how-to-configure-nfs-on-linux How to configure NFS on Linux].
<translate><!--T:111-->
* NFS server must be installed and NFS service must run.  
The following overview provides only basic information for configuring NFS on Linux. For details, see relevant Linux documentation, for example, the article [https://linuxconfig.org/how-to-configure-nfs-on-linux How to configure NFS on Linux].</translate>
* Exports will be created dynamically during restore by SEP sesam. Note that exports can also be created manually by editing the <tt>/etc/exports</tt> file. The exported path has to match the location of the SEP sesam data store or any of its parent directories on the same file system.
* <translate><!--T:112-->
* All ESX servers must be allowed to mount the directory.
NFS server must be installed and NFS service must run.</translate>
* ''Read/write'' permission should be set.
* <translate><!--T:113-->
Exports will be created dynamically during restore by SEP sesam. Note that exports can also be created manually by editing the <tt>/etc/exports</tt> file. The exported path has to match the location of the SEP sesam data store or any of its parent directories on the same file system.</translate>
* <translate><!--T:114-->
All ESX servers must be allowed to mount the directory.</translate>
* <translate><!--T:115-->
''Read/write'' permission should be set.


===Recommendations for Linux proxy===
==={{anchor|Linux_recommendations}}Recommendations for Linux proxy=== <!--T:116-->


'''OES Linux proxy VM (for restore from NSS file systems)'''
<!--T:117-->
'''OES Linux proxy VM (for restore from NSS file systems)'''</translate>
* <translate><!--T:118-->
VM with OES11 SP2 or higher, newest OES version is recommended (the proxy VM must support the NSS version inside the VMDK)</translate>
* <translate><!--T:119-->
OES pattern to install: NSS (all other dependencies will be selected automatically)</translate>
* <translate><!--T:120-->
Recommended to install the NetIQ eDirectory as a separate tree.</translate>
* <translate><!--T:121-->
Static IP address (required by NetIQ eDirectory).</translate>
* <translate><!--T:122-->
Only minimal system is required, X server is not required.</translate>
* <translate><!--T:123-->
Size of file system only for operating system + OES extension of the proxy VM.</translate>
* <translate><!--T:124-->
Current SEP sesam client for SLES11 + SEP sesam Netware module (for OES2/11/2015) or SEP sesam client for SLES12 (for OES2018, SEP NSS module already included in the SLES12 client package).


* VM with OES11 SP2 or higher
<!--T:125-->
* OES pattern to install: NSS (all other dependencies will be selected automatically)
'''OES Linux'''</translate>
* Recommended to install the NetIQ eDirectory as a separate tree.
* Static IP address (required by NetIQ eDirectory).
* Only minimal system is required, X server is not required.
* Size of file system only for SLES11 SP3 + OES11 SP2 (or higher versions).
* Current SEP sesam client for SLES11.


'''OES Linux'''
* <translate><!--T:126-->
Use a separate, non-production OES VM</translate>
* <translate><!--T:127-->
Install the NetIQ eDirectory as a separate tree.</translate>
* <translate><!--T:128-->
Do not add NSS pools and volumes to the OES server – all non-active pools are automatically activated and deactivated after restore</translate>
* <translate><!--T:129-->
Do not change the mounted NSS file systems – they are your backup!


*Use a separate, non-production OES VM
==={{anchor|restore_VM}}Step 3: Restore a VM using the attached VMDK=== <!--T:130-->
* Install the NetIQ eDirectory as a separate tree.
* Do not add NSS pools and volumes to the OES server – all non-active pools are automatically avtivated and deactivated after restore
* Do not change the mounted NSS file systems – they are your backup!


==={{anchor|restore_VM}}Step 3: Restore a VM using the attached VMDK===
<!--T:131-->
Create a new restore task for individual file(s) you want to restore.
Create a new restore task for individual file(s) you want to restore.</translate>
<ol><li>From the SEP sesam GUI menu bar, select '''Activities -> Restore'''. The ''New restore task'' window opens.</li>
<ol><li><translate><!--T:132-->
<li>Select what you want to restore. You can search save sets by ''task name'' or by ''filename or path''.
From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</translate></li>
* 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.
<li><translate><!--T:133-->
* If you are searching by filename/path, select the option '''Filename or path in save set''' and enter your search expression in the search pattern field.</li>
Select what you want to restore. You can search savesets by ''task name'' or by ''filename or path''.</translate>
<li>Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</li>
* <translate><!--T:134-->
<li>The search results are displayed. From the list of save sets matching your query, select the version from which you want to restore an individual file. Then select the check box '''Attach virtual disk(s) (VMDK) to a Proxy-VM via NFS server'''. Click '''Next'''.</li>
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.</translate>
[[Image:VSphere SF attach mount 4.4 en.jpg|600px|link=]]
* <translate><!--T:135-->
If you are searching by filename/path, select the option '''Filename or path in saveset''' and enter your search expression in the search pattern field.</translate></li>
<li><translate><!--T:136-->
Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</translate></li>
<li><translate><!--T:137-->
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 '''Attach virtual disk(s) (VMDK) to a Proxy-VM via NFS server'''. Click '''Next'''.</translate></li>
<translate><!--T:138-->
[[Image:VMware_SF_select_task_Beefalo_V2.jpg|760px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>Under the ''Select VM'', use the drop-down list to select the relevant '''vSphere server''', '''Sesam client name of the proxy VM''' and '''vSphere internal name of proxy VM'''. The vSphere server is the vCenter where the virtual host  – vSphere internal name of proxy VM – is running, which is assigned as a SEP sesam Client – Sesam client name of the proxy VM. If the host that attaches the disk(s) uses multiple network cards, you must also specify '''NFS interface'''; otherwise this option does not need to be specified. Click '''Next'''.</li>
<li><translate><!--T:139-->
[[Image:VSphere SF select vm 4.4 en.jpg|600px|link=]]
Under the ''Select VM'', use the drop-down list to select the relevant '''vSphere server''', '''SEP sesam Client name of the proxy VM''' and '''vSphere internal name of proxy VM'''. The vSphere server is the vCenter where the virtual host  – vSphere internal name of proxy VM – is running, which is assigned as a SEP sesam Client – SEP sesam client name of the proxy VM. If the host that attaches the disk(s) uses multiple network cards, you must also specify '''NFS interface'''; otherwise this option does not need to be specified. Click '''Next'''.</translate></li>
<translate><!--T:140-->
[[Image:VMware_SF_select_VM_Beefalo_V2.jpg|760px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>On the page '''Select Files''' only the drives of the chosen VMDK(s) are shown. Note that it might take form 5 to 20 seconds to load the drive list. SEP sesam automatically enables the automount function of Windows on host, which attaches the VMDK(s). The automount function of Windows assigns a drive letter to a new disk drive without interaction of a user. SEP sesam automatically sets all connected drives on this particular host to '''Online'''. <br />
<li><translate><!--T:141-->
If no drives are shown, either an invalid partition was chosen (for example, if a Windows host tries to attach Linux partitions) or the drives did not start in expected time. You can use the refresh button (on the right side of the table) to display the list of all drives, local and the attached ones. Click '''Next'''.</li>
In the '''Select Files''' dialog, only the drives of the selected VMDK(s) are shown. Note that it might take from 5 to 20 seconds to load the drive list. SEP sesam automatically enables the automount function of Windows on host, which attaches the VMDK(s). The automount function of Windows assigns a drive letter to a new disk drive without interaction of a user. SEP sesam automatically sets all connected drives on this particular host to '''Online'''.</translate> <br />
[[Image:VSphere SF list drives en.jpg|600px|link=]]
<translate><!--T:142-->
If no drives are shown, either an invalid partition was chosen (for example, if a Windows host tries to attach Linux partitions) or the drives did not start in expected time. You can use the refresh button to display the list of all drives, local and the attached ones. Click '''Next'''.</translate></li>
<li><translate><!--T:144-->
In the ''Target Settings'' window, you only need to select the '''Target node''' from the drop-down list and '''New restore target''' by browsing.</translate></li>
<translate><!--T:145-->
[[Image:VMware_SF_target_Beefalo_V2.jpg|760px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>On the last '''Save and Start''' page of the restore wizard, you only need to select the client and the destination.</li>
<li><translate><!--T:146-->
[[Image:VSphere SF restore options en.jpg|600px|link=]]
In the final step of the restore wizard, you can review all the settings of your restore task. If you want to start your restore immediately, click '''Start'''. If you want to save the restore task, click '''Save'''.</translate></li>
<br clear=all>
<li><translate><!--T:237--> Click '''OK''' to detach VMDK(s) from the VM and close your restore session.</translate></li></ol>
<li>You can start your VM restore immediately by clicking '''Start'''. If you want to save the restore task, click '''Save'''. </li></ol>
 
{{<translate><!--T:226--> note</translate>|<translate><!--T:227--> 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:228-->
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.


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.
<!--T:229-->
As of [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can also monitor the restore progress using the Web UI. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_Web_UI|SEP sesam Web UI]].  


==={{anchor|manage_VMs}}Managing virtual machines with spanned volumes===
==={{anchor|manage_VMs}}Managing virtual machines with spanned volumes=== <!--T:148-->


<!--T:149-->
SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. Attaching VMDK to the original virtual machine is not supported if the original disks are still attached.  
SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. Attaching VMDK to the original virtual machine is not supported if the original disks are still attached.  


<!--T:150-->
You can only attach VMDK to another Windows host, because Microsoft does not allow to use the same volumes twice when having spanned volumes. Then the disks will be marked as ''Foreign'' in Disk Management. Only possible workaround is to bring these disks online manually using Disk Management.
You can only attach VMDK to another Windows host, because Microsoft does not allow to use the same volumes twice when having spanned volumes. Then the disks will be marked as ''Foreign'' in Disk Management. Only possible workaround is to bring these disks online manually using Disk Management.


====Steps====
====Steps==== <!--T:151--></translate>
<ol><li>Open '''Computer Management''' -> '''Disk Management''', and click '''Import Foreign Disks''' option. This lists one or more disk groups, identified by the name of the computer where they were created. If you expand the details on a disk group, it lists the locally-connected disks.</li>
<ol><li><translate><!--T:152-->
<li>Select the relevant ''Disk Group''. The dialog box with a list of volumes in the Disk Group opens.</li>
Open '''Computer Management''' -> '''Disk Management''', and click '''Import Foreign Disks''' option. This lists one or more disk groups, identified by the name of the computer where they were created. If you expand the details on a disk group, it lists the locally-connected disks.</translate></li>
<li>Select the relevant volumes and click '''OK''' to add the foreign disks to your system configuration.
<li><translate><!--T:153-->
Select the relevant ''Disk Group''. The dialog box with a list of volumes in the Disk Group opens.</translate></li>
<li><translate><!--T:154-->
Select the relevant volumes and click '''OK''' to add the foreign disks to your system configuration.</translate>
</ol>
</ol>
<translate><!--T:155-->
The operation is slightly different, depending on whether there are pre-existing online foreign (dynamic) disks on the target computer. For details, see [https://support.microsoft.com/en-us/help/222189/description-of-disk-groups-in-windows-disk-management Microsoft support article Description of Disk Groups in Windows Disk Management].
The operation is slightly different, depending on whether there are pre-existing online foreign (dynamic) disks on the target computer. For details, see [https://support.microsoft.com/en-us/help/222189/description-of-disk-groups-in-windows-disk-management Microsoft support article Description of Disk Groups in Windows Disk Management].


=={{anchor|mount}}Mounting VMDK to a SEP sesam RDS==
=={{anchor|mount}}Mounting VMDK to a SEP sesam RDS <span style="font-size:74%; font-weight:550; font-family:Arial">([[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Expert mode]] only)</span>== <!--T:156-->
You can mount any non-compressed VMDK save set stored to ''default data store Path'' or to ''Si3 data store'' to the local system, which is used as a [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions#data_mover|VMware data mover]] and SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#RDS|RDS]] with a [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]]. The target VMDK is mounted to the SEP sesam home directory <code>var\tmp\mnt</code>, e.g., <code>C:\Program Files\SEPsesam\var\tmp\mnt\''save_set_ID''</code>. This way the VMDK is instantly accessible for browsing and searching before the actual restore is even triggered, providing you with quick access to your data. The mounted VMDK is basically a '''virtual read-only file system''', therefore it cannot be altered or otherwise damaged. Comparing to the ''attach'' method, mounting has the advantage of much easier setup and requires less configuration steps.
 
<!--T:157-->
You can mount any non-compressed VMDK saveset stored to ''default data store Path'' or to ''Si3 data store'' to the local system, which is used as a [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions#data_mover|VMware data mover]] and SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#RDS|RDS]] with a [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]].  
 
<!--T:158-->
The target VMDK is mounted to the SEP sesam home directory <code>var\tmp\mnt</code>, e.g., <code>C:\Program Files\SEPsesam\var\tmp\mnt\''save_set_ID''</code>. This way the VMDK is instantly accessible for browsing and searching before the actual restore is even triggered, providing you with quick access to your data. The mounted VMDK is basically a '''virtual read-only file system''', therefore it cannot be altered or otherwise damaged. Comparing to the ''attach'' method, mounting has the advantage of much easier setup and requires less configuration steps.</translate>


{{note|
{{<translate><!--T:159-->
*Mounting is not possible if the save sets are stored to tapes or if the save sets are compressed.  
note</translate>|
*Mounting is not supported on Windows virtual machines with spanned volumes due to Microsoft's restriction.}}
*<translate><!--T:160-->
Mounting is not possible if the savesets are stored to tapes or if the savesets are compressed.</translate>
*<translate><!--T:161-->
Mounting is not supported on Windows virtual machines with spanned volumes due to Microsoft's restriction.</translate>}}


''Conceptual view of a single item restore with mounted VMDK''
<translate><!--T:162-->
[[File:SEP sesam instant-recovery and single-file-restore 03 mount 03.png|link=]]
''Conceptual view of a single item restore with mounted VMDK''</translate><br />
<translate><!--T:163-->
[[File:SEP sesam instant-recovery and single-file-restore 03 mount 03.png|link=]]</translate>
<br clear=all>
<br clear=all>
===Prerequisites===
<translate>===Prerequisites=== <!--T:164-->
Before attempting to mount VMDK and performing a single file restore, all preparation steps have to be performed properly, including configuration and VM backup. Depending on your SEP sesam version, see the relevant [[Special:MyLanguage/VMware|VMware guide]] for details. Make sure that the following conditions are met:
 
* SEP sesam Server version ≥ 4.4.3. For the list of supported systems, see [[SEP sesam OS and Database Support Matrix]].
<!--T:165-->
* A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] ''Path'' or SEP sesam ''Si3'' data store:  
Before attempting to mount VMDK and performing a single file restore, all preparation steps have to be performed properly, including configuration and VM backup. Depending on your SEP sesam version, see the relevant [[Special:MyLanguage/VMware|VMware guide]] for details. Make sure that the following conditions are met:</translate>
** SEP sesam v. 4.4.3 ''Tigon'' supports the UNC path (e.g., <tt>\\server\folder</tt>) for data store.
<ul><li><translate><!--T:166-->
** In SEP sesam v. 4.4.3, data store via UNC path is not supported. A volume must be visible as a locally attached storage (not as a network drive letter). Only iSCSI, SAN and locally connected drives can be used as a locally attached storage.
SEP sesam Server version ≥ 4.4.3. For the list of supported systems, see [[SEP sesam OS and Database Support Matrix]].</translate></li>
* Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|'''encrypted''']] or [[Special:MyLanguage/SEP_sesam_Glossary#compression|'''compressed''']], and they must not be migrated to another media – only the original backup on SEP sesam data store can be used for restore.
<li><translate><!--T:167-->
* VDDK 5.5.x must be installed on the system, which is used as a VMware data mover and SEP sesam RDS with a data store. On Windows, VDDK is a part of the SEP sesam installation. SEP sesam version 4.4.3 is using VDDK version 6. If you are using a Linux system or any of the previous SEP sesam versions, you have to install the VDDK manually. For details, see [[Special:MyLanguage/Installing_VDDK_on_Linux|Installing VDDK on Linux]].
A SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] ''Path'', SEP sesam ''Si3 deduplication store'' or ''HPE StoreOnce'':</translate> </li>
* When using a Linux data mover to mount the VMDK, it must be able to read Linux and Windows systems. Note that mounting Windows VMDKs with Linux data mover might result in ACL-related problems and is therefore not recommended.
<ul><li><translate><!--T:168-->
*When using a Windows data mover to mount the VMDK, it is required to have a second data mover on Linux with installed VDDK 5.5.x which is also a SEP sesam RDS. Virtual Windows hosts must be stored on Windows RDS and Linux virtual hosts must be stored on Linux RDS.
SEP sesam v. 4.4.3 ''Tigon'' supports the UNC path (e.g., <tt>\\server\folder</tt>) for data store.</translate></li>
{{note|
<li><translate><!--T:169-->
SEP sesam can restore all file systems for which the respective operating system provides a read/write support. For example, a restore of files on Windows ReFS is only possible if the data mover is able to read ReFS data. Or, if the file system on OES Linux is NSS, the data mover must be able to read the NSS file system data.}}
In SEP sesam v. 4.4.3, data store via UNC path is not supported. A volume must be visible as a locally attached storage (not as a network drive letter). Only iSCSI, SAN and locally connected drives can be used as a locally attached storage.</translate></li></ul>
<li><translate><!--T:170-->
Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|'''encrypted''']] or [[Special:MyLanguage/SEP_sesam_Glossary#compression|'''compressed''']], and they must not be migrated to another media – only the original backup on SEP sesam data store can be used for restore.</translate></li>
<li><translate><!--T:218--> '''''Windows specific'''''</translate></li>
<ul><li><translate><!--T:219--> The required [[Special:MyLanguage/VDDK_Compatibility_Matrix|VDDK version]] must be installed on the system, which is used as a VMware data mover and SEP sesam RDS with a data store. On Windows, VDDK is a part of the SEP sesam installation. If you are using a Linux system (see below) or any of the previous SEP sesam versions, you have to install the VDDK manually.</translate></li>
<li><translate><!--T:173-->
When using a Windows data mover to mount the VMDK, it is required to have a second data mover on Linux (which is also a SEP sesam RDS) with installed required VDDK version. Virtual Windows hosts must be stored on Windows RDS and Linux virtual hosts must be stored on Linux RDS.</translate></li></ul>
<li><translate><!--T:220--> '''''Linux specific'''''</translate></li>
<ul><li><translate><!--T:221--> You have to install the VDDK on Linux manually. For details, see [[Special:MyLanguage/Installing_VDDK#Linux|Installing VDDK on Linux]].</translate></li>
<li><translate><!--T:222--> Additionally, to be able to access and mount the file system of an image on Linux, you have to install the <tt>guestfs-tools</tt> package. For details, see [[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing <tt>guestfs-tools</tt> on Linux]].</translate></li>
<li><translate><!--T:223--> When using a Linux data mover to mount the VMDK, it must be able to read Linux and Windows systems. Note that mounting Windows VMDKs with Linux data mover might result in ACL-related problems and is therefore not recommended.</translate></li></ul></ul>
{{<translate><!--T:174-->
note</translate>|
<translate><!--T:175-->
SEP sesam can restore all file systems for which the respective operating system provides a read/write support. For example, a restore of files on Windows ReFS is only possible if the data mover is able to read ReFS data. Or, if the file system on OES Linux is NSS, the data mover must be able to read the NSS file system data.</translate>}}


==={{anchor|restore}}Restore a single file using the mounted VMDK===
<translate>==={{anchor|restore}}Restore a single file using the mounted VMDK=== <!--T:176-->
Create a new restore task for individual file(s) you want to restore.
 
<ol><li>From the SEP sesam GUI menu bar, select '''Activities -> Restore'''. The ''New restore task'' window opens.</li>
<!--T:177-->
<li>Select what you want to restore. You can search save sets by ''task name'' or by ''filename or path''.
Create a new restore task for individual file(s) you want to restore.</translate>
* 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.
<ol><li><translate><!--T:178-->
* If you are searching by filename/path, select the option '''Filename or path in save set''' and enter your search expression in the search pattern field.</li>
From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</translate></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>
<li><translate><!--T:179-->
<li>The search results are displayed. From the list of save sets matching your query, select the version from which you want to restore an individual file. Then select the check box '''Mount virtual disk(s) via VMware API'''. A mount action is triggered and your VMDK is mounted to the SEP sesam home directory <tt>var\tmp\mnt</tt>, e.g., <tt>C:\Program Files\SEPsesam\var\tmp\mnt\''save_set_ID''</tt>. Click '''Next'''.</li>
Select what you want to restore. You can search savesets by ''task name'' or by ''filename or path''.</translate>
[[Image:VSphere SF attach mount 4.4 en.jpg|600px|link=]]
* <translate><!--T:180-->
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.</translate>
* <translate><!--T:181-->
If you are searching by filename/path, select the option '''Filename or path in saveset''' and enter your search expression in the search pattern field.</translate></li>
<li><translate><!--T:182-->
Under the '''Saved in period''' drop-down list, specify the time frame for which you want to conduct the search. Click '''Next'''.</translate></li>
<li><translate><!--T:183-->
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)'''. A mount action is triggered and your VMDK is mounted to the SEP sesam home directory <tt>var\tmp\mnt</tt>, e.g., <tt>C:\Program Files\SEPsesam\var\tmp\mnt\''save_set_ID''</tt>. Click '''Next'''.</translate></li>
<translate><!--T:184-->
[[Image:VMware_SF_mount_Beefalo_V2.jpg|760px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>On the page '''Select Files''only the mounted VDMK drives are shown (the local drives are not displayed). Select the files you want to restore and click '''Next'''.</li>
<li><translate><!--T:185-->
<li>On the last '''Save and Start''' page of the restore wizard, select where you want to restore your files.</li>
In the ''Select Files'' dialog, only the mounted VDMK drives are shown (the local drives are not displayed). Select the files you want to restore and click '''Next'''.</translate></li>
<li>You can start your single file restore immediately by clicking '''Start'''. If you want to save the restore task, click '''Save'''. </li></ol>
<translate><!--T:230--> [[Image:VMware_SF_select_files_mount_Beefalo_V2.jpg|760px|link=]]</translate>
<br clear=all>
<li><translate><!--T:231--> In the ''Target Settings'' window, you only need to select the '''Target node''' from the drop-down list and '''New restore target''' by browsing.</translate></li>
<li><translate><!--T:232--> In the final step of the restore wizard, you can review all the settings of your restore task. If you want to start your restore immediately, click '''Start'''. If you want to save the restore task, click '''Save'''.</translate></li>
<li><translate><!--T:238--> Click '''OK''' to unmount the VMDK(s) and close your restore session.</translate></li></ol>
 
{{<translate><!--T:233--> note</translate>|<translate><!--T:234--> 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:235-->
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.


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.
<!--T:236-->
As of [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can also monitor the restore progress using the Web UI. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_Web_UI|SEP sesam Web UI]].


==Troubleshooting==
<div class="noprint">
'''Problem'''
==Known issues== <!--T:216-->
*In SEP sesam version ≥ 4.4.3..48 in combination with a Linux proxy VM, when trying to select the restore source in the restore wizard (step 4: ''Select Files''), no items are displayed in the browser.


'''Cause'''
<!--T:217-->
*This issue seems to be related to the SCSI controller of the proxy VM. When trying to restore a single file from a virtual machine, SEP sesam cannot access storage on a virtual machine that is configured with the SCSI LSI Logic SAS adapter.
If you have problems with VMware, check the [[Special:MyLanguage/Troubleshooting_Guide#VMware|VMware Troubleshooting]].
&rArr; '''Solution'''
*Open the properties of the proxy VM in your vCenter and change the controller on the VM from the LSI Logic SAS controller (on some VMs, this is selected by default) to an LSI Logic Parallel controller. For more information, see VMware Docs article [https://docs.vmware.com/en/VMware-vSphere/6.0/com.vmware.vsphere.hostclient.doc/GUID-B70BF1B1-5DEB-4C85-A3D0-931DA37E995B.html Change the SCSI Controller Type in the vSphere Client].   
*Restart the restore wizard. If there are still no items displayed in the restore browser, reboot the proxy VM and then click the '''Update''' button.


==See also==
==See also== <!--T:206-->
[[Special:MyLanguage/4_4_3_Tigon:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3 ''Tigon'']] – [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3]] – [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]] – [[Special:MyLanguage/4_4_3_Tigon:VMware Backup|VMware Backup 4.4.3 ''Tigon'']] – [[Special:MyLanguage/4_4_3_Tigon:VMware Backup|VMware Backup 4.4.3]] – [[Special:MyLanguage/4_4_3:VMware Restore|VMware Restore]] – [[Special:MyLanguage/4_4_3:VMware Instant Recovery|VMware Instant Recovery]] – [[Special:MyLanguage/Scheduling Restore|Scheduling Restore]] – [[Special:MyLanguage/Troubleshooting_Guide#VMware_vStorage_API|Troubleshooting]]
[[Special:MyLanguage/4_4_3_Tigon:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix (latest)]] – [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore_and_Instant_Recovery_Support_Matrix|SF & IR support matrix 4.4.3]] – [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]] –  [[Special:MyLanguage/4_4_3:VMware_Requirements_%26_Restrictions|VMware Requirements & Restrictions]] – [[Special:MyLanguage/4_4_3_Tigon:VMware Backup|VMware Backup (latest)]] – [[Special:MyLanguage/4_4_3_Tigon:VMware Backup|VMware Backup 4.4.3]] – [[Special:MyLanguage/4_4_3:VMware Restore|VMware Restore]] – [[Special:MyLanguage/VMware Instant Recovery|VMware Instant Recovery]] – [[Special:MyLanguage/Scheduling Restore|Scheduling Restore]] – [[Special:MyLanguage/Troubleshooting_Guide#VMware_vStorage_API|Troubleshooting]]</div></translate>

Latest revision as of 15:39, 13 January 2022

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.

Icon archived docs.png This is not the latest version of SEP sesam documentation and, as such, does not provide information on features introduced in the latest release. For more information on SEP sesam releases, see SEP sesam Release Versions. For the latest documentation, check VMware Single File Restore for the new version.


Overview

Quick Start 3.png
Quick setup
  1. Attach VMDK to a virtual machine.
  2. Configure a virtual host as a SEP sesam client.
  3. Prepare the NFS share on Linux.
  4. Restore a VM using the attached VMDK.
  5. OR
  6. Mount VMDK to a SEP sesam RDS.
  7. Restore a single file using the mounted VMDK.


It is estimated that about three quarters of the typical VMware virtual machine restore cases only require a single file restore rather than a restore of an entire virtual machine. As of version 4.4.3, SEP sesam introduces simple and flexible single file restore that enables you to restore an individual item without any special backup preparation from full/differential/incremental backups. To learn what applies to single file restore and instant recovery, which backup level supports it and how it relates to the disk size usage, see SF & IR support matrix 4.4.3 Tigon.

This article provides information for restoring an individual item from a vSphere backup. For details on how to a restore a single VMware virtual machine, see VMware Restore. For details on how to perform a VMware virtual machine instant recovery, see VMware Instant Recovery.

Note that SEP sesam provides the web Restore Assistant interface which is designed to be more intuitive and offers additional advanced options compared to GUI restore wizard while, on the other hand, it does not support VMware single file restore, so you can use only the GUI restore wizard to restore an individual item.

In the GUI, you can restore individual items from any successful VMware backup by using any of the following procedures:

Information sign.png Note
VMware single file restore mount and attach options are only available in Expert UI mode.

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

Supported file systems

SEP sesam can in general recover all file systems as long as the respective operating system offers read/write support for it.

  • Example 1: A restore of files from ReFS on Windows is only possible if the data mover is able to read the ReFS file system which is supported since Windows Server 2012.
  • Example 2: A restore of files from a Btrfs is only possible if the data mover is a Linux with Kernel support for it, for example SLES 12.
  • Example 3: If the file system on OES Linux is NSS, the data mover must be able to read the NSS file system data.

When restoring files from the NSS file system some limitations apply:

  • The restore process itself does not differ from the restore of native Linux or Windows files, but the proxy VM must be an OES11 or higher Server. For prerequisites, check Recommendations for Linux proxy.
  • Files from a native NetWare VM can be restored only to an OES Linux or native Linux target.
  • To restore trustees, the extended attributes on NSS must be enabled before backup. For details, refer to Novell OES documentation for NSS.
  • If you restore NSS files to a server in the original tree and on an NSS file system, the restored files will keep the original trustees (regardless of the tree of the proxy OES VM you used for restore).
  • Trustees from native NetWare VMs cannot be restored because native NetWare has no extended attributes to store the trustees into the file system.

Restrictions

  • SEP sesam does not support a restore of files from the DOS boot partition of a native NetWare server.
  • SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. The following limitations exist:
    • Mounting VMDK to a SEP sesam Server/RDS is not supported.
    • Attaching VMDK to original virtual machine is not supported if the original disks are still attached (as is typically the case in most scenarios).
  • The attach method does not work with a virtual SEP sesam Server or a virtual RDS to itself. For example, a virtual SEP sesam Server stores the virtual disk(s) on the SEP sesam data store. It is not possible to attach VMDK to the respective virtual SEP sesam Server; another VM must be used for this.

Best practice for individual file restore for Windows and Linux VMs

SEP sesam provides simple restore of individual files without any special backup preparation from VMware CBT snapshot. The following steps represent best practices and latest recommendations from SEP sesam support. Detailed instructions on VMware requirements and backup configuration can be found in related articles VMware Requirements & Restrictions and VMware Backup.

  • For version 4.4.3, the following limitation applies: Windows SEP sesam Server or Windows RDS is not supported in v. 4.4.3, therefore use Linux SEP sesam Server or RDS. In v. ≥ 4.4.3 Tigon, Windows can be used as a SEP sesam Server or RDS.
  • Enable the NFS server on the SEP sesam Server or RDS as described in section Preparing the NFS share.
  • Install SEP sesam Client to a Linux VM (sandbox for Linux single file restore). VDDK is only required if this VM is also the data mover. In this case, check VMware Requirements & Restrictions.
  • Add the Linux VM as a client as described in Step 1: Configuring a virtual host as a SEP sesam client. Make sure that you select the check box Client is a virtual machine.
  • Information sign.png Note
    • Any operating system can be used except in case that you need a sandbox for Netware single file restore. Search the wiki for Netware reference.
    • Do not use a productive system as a sandbox!
  • Install SEP sesam Client to a Windows VM (sandbox for Windows single file restore). No specific Windows version is required. VDDK is only required if this VM is also the data mover. In this case, check VMware Requirements & Restrictions.
  • Add the Windows VM as a client as described in Step 1: Configuring a virtual host as a SEP sesam client. Make sure that you select the check box Client is a virtual machine.
  • Follow Step 3: Restore a VM using the attached VMDK : Select the VMware snapshot and select the check box Attach virtual disk(s) (VMDK) to a Proxy-VM via NFS server. Then click Next and under Select VM use the drop-down list to select Linux or Windows sandbox VM.

Attaching VMDK to a virtual machine (Expert mode only)

Attaching VMDK to a virtual machine is the recommended option for single file restore for Windows and Linux that requires only one SEP sesam Server or Remote Device Server (RDS).

Information sign.png Note
SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. Attaching VMDK to the original virtual machine is not supported if the original disks are still attached. You can only attach VMDK to another Windows host, because Microsoft does not allow to use the same volumes twice when having spanned volumes. Then the disks will be marked as Foreign in Disk Management. Only possible workaround is to bring these disks online manually using Disk Management. For details, see section Managing virtual machines with spanned volumes.

Conceptual view of a single item restore with the attached VMDK
SEP sesam instant-recovery and single-file-restore 04 attach 03.png

Prerequisites

Before attempting to attach VMDK and performing a single file restore, all preparation steps have to be performed properly, including configuration and VM backup. Depending on your SEP sesam version, see the relevant VMware guide for details.

The VMware single file restore prerequisites differ slightly depending on your SEP sesam version. For example, 4.4.3 Tigon already supports all backup levels and provides selective restore. Make sure that the following conditions are met:

  • SEP sesam Server version ≥ 4.4.3. For the list of supported systems, see SEP sesam OS and Database Support Matrix.
  • A SEP sesam data store Path, SEP sesam Si3 deduplication store or HPE StoreOnce:
    • SEP sesam v. 4.4.3 Tigon supports the UNC path (e.g., \\server\folder) for data store.
    • In SEP sesam v. 4.4.3, data store via UNC path is not supported. A volume must be visible as a locally attached storage (not as a network drive letter). Only iSCSI, SAN and locally connected drives can be used as a locally attached storage.
  • Backups must not be encrypted or compressed, and they must not be migrated to another media – only the original backup on SEP sesam data store can be used for restore.
  • At least one virtual host of VMware vCenter needs to be added as a SEP sesam Client ≥ 4.4.3 to attach VMDKs.
  • Encrypted file systems within the virtual machine can only be read if the system (proxy VM) with the attached virtual disk is able to decrypt the data.
  • The system that stores the VMDK files to SEP sesam data store (either SEP sesam Server or SEP sesam RDS) must provide NFS (network file system) services:
    • V. 4.4.3 Tigon already includes the NFS server and does not require a regular NFS server provided by Windows.
    • For SEP sesam v. 4.4.3 with the NFS service on Windows, it is recommended to use Windows 2012 (R2) for providing a higher level of NFS support.
  • A proxy server (either Windows or Linux VM) should be a non-production environment. For more details, see Recommendations for Linux proxy below.
  • When using both, virtual Linux and Windows hosts, it is recommended to add one virtual Linux and one virtual Windows host to ensure file system compatibility.
  • Some versions, for example, VDDK 6.5.x on Windows, might require rebooting the host after the update, followed by running the vstor2install.bat script. For details, see VMware Troubleshooting.
Information sign.png Note

SEP sesam can restore all file systems for which the respective operating system provides a read/write support. For example, a restore of files on Windows ReFS is only possible if the system with the attached disk is able to read ReFS data. Or, if the file system on OES Linux is NSS, the system with the attached disk must be able to read the NSS file system data.

Step 1: Configuring a virtual host as a SEP sesam client

To be able to attach a VMDK file to a virtual host, SEP sesam needs to know where to attach the VMDK file(s). You have to add at least one virtual host as a SEP sesam client and this system must be assigned to the virtual host.

  1. From Main Selection -> Components -> Topology, select your VMware location and click the New Client button. The New Client window opens.
  2. Enter the name of the virtual host in the Name field.
  3. Select the relevant platform from the Platform drop-down list and the relevant OS under Operating System.
  4. Choose the SMSSH access mode (default in ≥ 4.4.3 Tigon V2) for the SEP sesam server-client communication. Note that CTRL was default access mode up until v. 4.4.3 Tigon V2.
  5. Select the name of your vCenter under VM host.
  6. Select the virtual machine from the VM name drop-down list.
  7. Then select the check box Client is a virtual machine and click OK.
  8. VMware new client Beefalo V2.jpg

Your new client is displayed in the Topology content pane.

In the client properties, additional tabs are available for specifying permissions and access. Double-click the client to open its properties, and set client permissions and vCenter/OS access under the respective tabs. For details, see Configuring Clients.

Step 2: Preparing the NFS share on Linux

NFS (Network File System) is a client/server application that allows to share files across a network. You have to set up the NFS service on the Linux SEP sesam Server or RDS system, which stores the VMDK files.

SEP sesam automatically creates a VMware data store to attach the VMDK file(s) to a virtual host.

The following overview provides only basic information for configuring NFS on Linux. For details, see relevant Linux documentation, for example, the article How to configure NFS on Linux.

  • NFS server must be installed and NFS service must run.
  • Exports will be created dynamically during restore by SEP sesam. Note that exports can also be created manually by editing the /etc/exports file. The exported path has to match the location of the SEP sesam data store or any of its parent directories on the same file system.
  • All ESX servers must be allowed to mount the directory.
  • Read/write permission should be set.

Recommendations for Linux proxy

OES Linux proxy VM (for restore from NSS file systems)

  • VM with OES11 SP2 or higher, newest OES version is recommended (the proxy VM must support the NSS version inside the VMDK)
  • OES pattern to install: NSS (all other dependencies will be selected automatically)
  • Recommended to install the NetIQ eDirectory as a separate tree.
  • Static IP address (required by NetIQ eDirectory).
  • Only minimal system is required, X server is not required.
  • Size of file system only for operating system + OES extension of the proxy VM.
  • Current SEP sesam client for SLES11 + SEP sesam Netware module (for OES2/11/2015) or SEP sesam client for SLES12 (for OES2018, SEP NSS module already included in the SLES12 client package).

OES Linux

  • Use a separate, non-production OES VM
  • Install the NetIQ eDirectory as a separate tree.
  • Do not add NSS pools and volumes to the OES server – all non-active pools are automatically activated and deactivated after restore
  • Do not change the mounted NSS file systems – they are your backup!

Step 3: Restore a VM using the attached VMDK

Create a new restore task for individual file(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 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 Attach virtual disk(s) (VMDK) to a Proxy-VM via NFS server. Click Next.
  5. VMware SF select task Beefalo V2.jpg
  6. Under the Select VM, use the drop-down list to select the relevant vSphere server, SEP sesam Client name of the proxy VM and vSphere internal name of proxy VM. The vSphere server is the vCenter where the virtual host – vSphere internal name of proxy VM – is running, which is assigned as a SEP sesam Client – SEP sesam client name of the proxy VM. If the host that attaches the disk(s) uses multiple network cards, you must also specify NFS interface; otherwise this option does not need to be specified. Click Next.
  7. VMware SF select VM Beefalo V2.jpg
  8. In the Select Files dialog, only the drives of the selected VMDK(s) are shown. Note that it might take from 5 to 20 seconds to load the drive list. SEP sesam automatically enables the automount function of Windows on host, which attaches the VMDK(s). The automount function of Windows assigns a drive letter to a new disk drive without interaction of a user. SEP sesam automatically sets all connected drives on this particular host to Online.
    If no drives are shown, either an invalid partition was chosen (for example, if a Windows host tries to attach Linux partitions) or the drives did not start in expected time. You can use the refresh button to display the list of all drives, local and the attached ones. Click Next.
  9. In the Target Settings window, you only need to select the Target node from the drop-down list and New restore target by browsing.
  10. VMware SF target Beefalo V2.jpg
  11. In the final step of the restore wizard, you can review all the settings of your restore task. If you want to start your restore immediately, click Start. If you want to save the restore task, click Save.
  12. Click OK to detach VMDK(s) from the VM 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.

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.

Managing virtual machines with spanned volumes

SEP sesam provides limited support for single file restore on Windows virtual machines with spanned volumes due to Microsoft's restrictions. Attaching VMDK to the original virtual machine is not supported if the original disks are still attached.

You can only attach VMDK to another Windows host, because Microsoft does not allow to use the same volumes twice when having spanned volumes. Then the disks will be marked as Foreign in Disk Management. Only possible workaround is to bring these disks online manually using Disk Management.

Steps

  1. Open Computer Management -> Disk Management, and click Import Foreign Disks option. This lists one or more disk groups, identified by the name of the computer where they were created. If you expand the details on a disk group, it lists the locally-connected disks.
  2. Select the relevant Disk Group. The dialog box with a list of volumes in the Disk Group opens.
  3. Select the relevant volumes and click OK to add the foreign disks to your system configuration.

The operation is slightly different, depending on whether there are pre-existing online foreign (dynamic) disks on the target computer. For details, see Microsoft support article Description of Disk Groups in Windows Disk Management.

Mounting VMDK to a SEP sesam RDS (Expert mode only)

You can mount any non-compressed VMDK saveset stored to default data store Path or to Si3 data store to the local system, which is used as a VMware data mover and SEP sesam RDS with a data store.

The target VMDK is mounted to the SEP sesam home directory var\tmp\mnt, e.g., C:\Program Files\SEPsesam\var\tmp\mnt\save_set_ID. This way the VMDK is instantly accessible for browsing and searching before the actual restore is even triggered, providing you with quick access to your data. The mounted VMDK is basically a virtual read-only file system, therefore it cannot be altered or otherwise damaged. Comparing to the attach method, mounting has the advantage of much easier setup and requires less configuration steps.

Information sign.png Note
  • Mounting is not possible if the savesets are stored to tapes or if the savesets are compressed.
  • Mounting is not supported on Windows virtual machines with spanned volumes due to Microsoft's restriction.

Conceptual view of a single item restore with mounted VMDK
SEP sesam instant-recovery and single-file-restore 03 mount 03.png

Prerequisites

Before attempting to mount VMDK and performing a single file restore, all preparation steps have to be performed properly, including configuration and VM backup. Depending on your SEP sesam version, see the relevant VMware guide for details. Make sure that the following conditions are met:

  • SEP sesam Server version ≥ 4.4.3. For the list of supported systems, see SEP sesam OS and Database Support Matrix.
  • A SEP sesam data store Path, SEP sesam Si3 deduplication store or HPE StoreOnce:
    • SEP sesam v. 4.4.3 Tigon supports the UNC path (e.g., \\server\folder) for data store.
    • In SEP sesam v. 4.4.3, data store via UNC path is not supported. A volume must be visible as a locally attached storage (not as a network drive letter). Only iSCSI, SAN and locally connected drives can be used as a locally attached storage.
  • Backups must not be encrypted or compressed, and they must not be migrated to another media – only the original backup on SEP sesam data store can be used for restore.
  • Windows specific
    • The required VDDK version must be installed on the system, which is used as a VMware data mover and SEP sesam RDS with a data store. On Windows, VDDK is a part of the SEP sesam installation. If you are using a Linux system (see below) or any of the previous SEP sesam versions, you have to install the VDDK manually.
    • When using a Windows data mover to mount the VMDK, it is required to have a second data mover on Linux (which is also a SEP sesam RDS) with installed required VDDK version. Virtual Windows hosts must be stored on Windows RDS and Linux virtual hosts must be stored on Linux RDS.
  • Linux specific
    • You have to install the VDDK on Linux manually. For details, see Installing VDDK on Linux.
    • Additionally, to be able to access and mount the file system of an image on Linux, you have to install the guestfs-tools package. For details, see Installing guestfs-tools on Linux.
    • When using a Linux data mover to mount the VMDK, it must be able to read Linux and Windows systems. Note that mounting Windows VMDKs with Linux data mover might result in ACL-related problems and is therefore not recommended.
Information sign.png Note

SEP sesam can restore all file systems for which the respective operating system provides a read/write support. For example, a restore of files on Windows ReFS is only possible if the data mover is able to read ReFS data. Or, if the file system on OES Linux is NSS, the data mover must be able to read the NSS file system data.

Restore a single file using the mounted VMDK

Create a new restore task for individual file(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 saveset and enter your search expression in the search pattern field.
  3. Under the Saved in period drop-down list, 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). A mount action is triggered and your VMDK is mounted to the SEP sesam home directory var\tmp\mnt, e.g., C:\Program Files\SEPsesam\var\tmp\mnt\save_set_ID. Click Next.
  5. VMware SF mount Beefalo V2.jpg
  6. In the Select Files dialog, only the mounted VDMK drives are shown (the local drives are not displayed). Select the files you want to restore and click Next.
  7. VMware SF select files mount Beefalo V2.jpg
  8. In the Target Settings window, you only need to select the Target node from the drop-down list and New restore target by browsing.
  9. In the final step of the restore wizard, you can review all the settings of your restore task. If you want to start your restore immediately, click Start. If you want to save the restore task, click Save.
  10. Click OK to unmount the VMDK(s) 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.

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.