File-level restore and SQL restore requirements and limitations
This section provides a list of requirements and limitations that apply to virtual machine file-level restores and individual SQL database and instance restores.
All platforms
Review the following best practices and limitations that apply to all platforms:
You must install VMware Tools version 10 or later. For best results, ensure that all virtual machines run the latest available version of VMware Tools. Older versions are known to cause failures when you perform browse actions during file-level restore or SQL restore operations.
Before mounting file systems for virtual machine file level restores, ensure that the target virtual machine for the restore supports the file system type, version, and options used in the source backup. For example, the xfsprogs version of the target virtual machine must be compatible with the xfsprogs version of the source virtual machine.
File-level restore is supported only for nonsystem files or folders (for example, user-created files and folders). When restoring operating system files or folders, or system files or folders such as
C:\Windows or
C:\Program Files, perform an image-level restore.
You can only restore files or folders from a Windows backup to a Windows machine, or from a Linux backup to a Linux machine.
You can perform file-level restores across vCenter servers as long as the vCenters are configured in
PowerProtect Data Manager, and the source and target virtual machine have the same guest operating system. For example, Linux to Linux, or Windows to Windows.
When a file-level restore or SQL-restore operation is in progress on a virtual machine, no other backup or recovery operation can be performed on this virtual machine. Wait until the file-level restore session completes before starting any other operation on the virtual machine.
Ensure that the virtual machine has enough free slots to accommodate the disks that will mounted as part of the restore. The total number of supported disks is 60 (4 scsi controllers with 15 disks each).
File-level restores do not support the following virtual disk configurations:
Two or more virtual disks mapped to single partition
Drives encrypted with BitLocker
Encrypted partitions
Compressed partitions
If the
VM Direct agent service is not running on the target virtual machine, VMDKs fail to mount with the error
"Cannot connect to vProxy Agent: Unable to connect to '[::1]:<port>'. dial tcp [::1]:<port>: connectex: No connection could be made because the target machine actively refused it."
Clean up from a suspended or cancelled mount operation requires a restart of the virtual machine before you can initiate a new mount for the file-level restore.
File-level restores do not restore or browse symbolic links.
Windows platforms
Review the following best practices and limitations that apply to Windows platforms:
For non-English volume labels of virtual disk drives, it is recommended to perform the virtual machine file level restore to a target virtual machine that will recognize the non-English locale, as in the following configurations:
File level restore to the original virtual machine.
NOTE:This option does not apply when using Windows dynamic disks
File level restore to another Windows virtual machine with the same non-English locale.
File level restore to any target Windows virtual machine that has the Windows language pack of the required locale installed.
To browse all of the disk drives of a backup copy, the copy should be from a Windows virtual machine that has the following Windows permission settings in the
Advanced Security Settings for the Local Disk at each disk drive level for both the
SYSTEM and
<COMPUTER-NAME>\Administrators Principal:
Type:
Allow
Access:
Full Control
Applies to:
This folder, subfolders and files
CAUTION:If any of the source files or folders are missing
SYSTEM and
<COMPUTER-NAME>\Administrators from the path of the Windows backup copy being restored from, the file level restore browse might fail with an error indicating that access has been denied. When this occurs, the restore operation fails.
Windows 2012 R2 and earlier versions do not support paths longer than 255 characters. To reduce the number of characters in the restore path, you might be required to remove the Windows drive letter, the colon, the slash, and the trailing null character. Since the Windows
VM Direct agent mount point already uses around 90 characters, you might need to select a folder at a higher directory level for the restore.
For Windows 2016 and later, an option to enable support for longer file paths is available. For more information, see Maximum Path Length Limitation.
File-level restores of Windows virtual machines are not supported on the following file systems:
Deduplicated NTFS
Resilient File System (ReFS)
EFI bootloader
Any file system that mounts a volume as a folder
File-level restores of virtual machines with Windows dynamic disks are supported with the following limitations:
The restore can only be performed when recovering to a Windows virtual machine different from the original. Also, this virtual machine cannot be a clone of the original.
The restore can only be performed by Windows virtual machine administrator users.
If Windows virtual machines were created by cloning or deploying the same template, then all of these Windows virtual machines may end up using the same GUID on their dynamic volumes.
When you perform file-level restore on Windows 2012 R2 virtual machines, the volumes listed under the virtual machine display as "unknown." File-restore operations are not impacted by this issue.
When you enable Admin Approval Mode (AAM) on the operating system for a Windows virtual machine (for example, by setting
Registry/FilterAdministratorToken to
1), the administrator user cannot perform a file-level restore to the end user's profile, and an error displays indicating "Unable to browse destination." For any user account control (UAC) interactions, the administrator must wait for the mount operation to complete, and then access the backup folders located at
C:\Program Files (x86)\EMC\vProxy FLR Agent\flr\mountpoints by logging into the guest virtual machine using Windows Explorer or a command prompt.
Linux platforms
Review the following best practices and limitations that apply to Linux platforms:
On Linux virtual machines, Logical Volume (LV) names longer than 100 characters are not supported.
When you perform file-level restores on Ubuntu or Debian platforms, you must enable the root account in the operating system. By default, the root account will be in a locked state.
File-search and file-level restores from a Linux virtual machine backup that has more than a million files are not supported.
NOTE:The number of files being restored does not matter. To restore files from a Linux virtual machine backup that has such a large number of files, perform an Instant Access restore of the virtual machine, and then copy the files to the target Linux virtual machine.
File-level restores of files from BTRFS subvolumes are not supported. To restore files from a BTRFS subvolume, use an image-level restore.
Data is not available for the Topic
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\