Skip to main content

 

Druva Documentation

File level restore

Phoenix Editions: File:/tick.png Business File:/cross.png Enterprise File:/tick.png Elite

Phoenix provides you with a capability to restore files to CIFS share and any virtual machine in  your vCenter/ESXi. This article  will cover the following sections:

 What should you know about File level restore?  

  • The original drive names for Windows partitions and mount points for Linux partitions will not be preserved. The partition will be shown as volume0, volume1 and so on.
  • Partitions with corrupted file system, partition table or incorrect partition boundaries may not get mounted.
  • Symbolic links will not be recovered.
  • File level restore is not supported on GPT partitioned disk on Windows.
  • Sparse files on original disks will be recovered as Thick files.
  • On Linux partitions, the “/dev”, "/var/spool", "/var/run" “/proc” , /tmp, and, “/sys” folders will be excluded, if selected from the restore set.
  • On Windows partition, "CryptnetUrlCache" will be excluded if selected from restore set.
  • If you have CloudCache in your setup, make sure it is connected to backup proxy.
  • Encrypted volumes and files are not supported for File level restore.
  • File level restore may fail  for guest windows virtual machine, if the destination folder name contains consecutive special characters. For example “A%%B”.
  • P hoenix does not store guest OS credential.
  • If some files are not restored, the progress log will show the number of files missed and the detailed log will list the names of the files missed.
  • The following ACL parameters are restored along with the files:
Source virtual machine Restore type ACL parameters restored 
File level Restore to a virtual machine:
Windows virtual machine Original virtual machine
  • File modification time
  • Last access time 

 

Windows virtual machine

Alternate Windows virtual machine

  • File modification time
  • Last access time 
Alternate Linux virtual machine
  • File modification time
  • Last access time
Linux virtual machine Original virtual machine
  • Modification time
  • Last access time
  • User id
  • Group id
  • File permission

 

Linux virtual machine

Alternate Windows virtual machine

  • File modification time
  • Last access time 
Alternate Linux virtual machine
  • Modification time
  • Last access time
  • User id
  • Group id
  • File permission
File level Restore to CIFS share:
Windows virtual machine -
  • File modification time
  • Last access time 
Linux virtual machine -
  • File modification time
  • Last access time 

File level restore to CIFS share

Pre-requisites

  • For the list of supported disks, partitions, and files for File level restore, see Support matrix.
  • You must have write permission for the target location, where you want to restore the files. 

Procedure

  1. Log on to Phoenix Management Console. 
  2. On the menu bar, click VMware.
  3. On the VMware window, select the vCenter/Hypervisior.
  4. Under the Configured Virtual Machines tab,  and select the virtual machine you want to restore.
  5. On the VMware details page, click Restore.
  6. On the Restore Data page,  select one of the snapshots from the following list:
    • Hot snapshot:  In the left pane, expand Hot, and click the snapshot that you want to restore. 
    • Warm snapshots: In the left pane, expand Warm, and click the snapshot that you want to restore.
    • Thawed snapshots:  In the left pane, expand Thawed, and click the snapshot that you want to restore.
  7. Click File Restore.
  8. On the Restore Data page, select the volumes or files and click Restore.
    If any of the selected volumes or files are not mounted, an error message will be displayed on the Restore Data page, For more information see Volume mounting error.
  9. On the File Restore page, select Restore to CIFS share.
  10. Click Next.
  11. On the File Restore page, provide the following details:
Field Action

UNC Path

Valid UNC share (network share) path that is reachable from the selected vCenter/ESXi.

Valid sharename format:

  • \\<hostname> or<Ip address>\<Sharename>
  • //Host/Folder                       

Note: UNC sharename must not have any Unicode characters.

Username

Valid username of UNC share.

Note: You can specify domain name in the username of the UNC share in the "domain@username" format

Password

Valid password of UNC share.

Select vCenter/ESXi

From the drop-down list, select a vCenter/ESXi that has atleast one backup proxy in connected state.

Backup Proxy Pool From the drop-down list, select a backup proxy pool. It is recommended that you select a backup proxy pool with backup proxies that are locally connected to the destination hypervisor for restore.
  1. Click Finish
    The restored file will be available on UNC share in the "[vmname] -[jobid]" folder. 
    See Error messages, if you encounter any error while performing the procedure.

File level restore to a virtual machine

Pre-requisites

Procedure 

  1. Log on to Phoenix Management Console. 
  2. On the menu bar, click VMware.
  3. On the VMware window, select the vCenter/Hypervisior that you want to restore.
  4. Under the Configured Virtual Machines tab,  and select the virtual machine you want to restore.
  5. On the VMware details page, click Restore.
  6. On the Restore Data page,  select one of the snapshots from the following list:
    • Hot snapshot:  In the left pane, expand Hot, and click the snapshot that you want to restore. 
    • Warm snapshots: In the left pane, expand Warm, and click the snapshot that you want to restore.
    • Thawed snapshots:  In the left pane, expand Thawed, and click the snapshot that you want to restore.
  7. Click File Restore.
  8. On the Restore Data page, select the volumes or files and click Restore.
    If any of the volumes or files of the selected virtual machine are not mounted, an error message will be displayed on the Restore Data page, For more information see Volume Mounting error.
  9. On the File Restore page, select Restore to VM.
  10. Click Next.
  11. On the File Restore page, select one of the following options and provide appropriate information for each field:
    • Restore to Original VM: Select this option if you want to restore the selected files to the same virtual machine.
    • Restore to an Alternate VM: Select this option if you want to restore the selected files to a different virtual machine.
Field      Action
Restore to Original VM
Guest OS Credentials:
User Valid username
Password Valid password
Location Browse or type the location where you want to restore files.
Restore to an Alternate VM
Destination VMware Setup From the drop-down list, select the required vCenter/ESXi.
Destination Hypervisor From the drop-down list, select the required Hypervisor.
Destination VM

From the drop-down list, select the required virtual machine where you want to restore the files.

Note: The timestamp under the Destination VM  drop-down lists the last time the virtual machine listing  page was refreshed.

Backup Proxy Pool From the drop down list, select a backup proxy pool. It is recommended that you select a backup proxy pool with backup proxies that are locally connected to the destination hypervisor for restore.
 
Note: If the virtual machine has a backup proxy pool mapped to it, the mapped backup proxy pool is selected by default. 
Guest OS Credentials: 
User Valid username
Password Valid password
Location Browse or type the location where you want to restore files.
  1.  Click Next.
  2. On the File Restore page, select one of the following options:
    • Always overwrite
    • Overwrite if original is older
    • Always skip 
    • Restore and move original to .orig

      For more information on the above options, see About Restore settings.

Note: The above restore options will be displayed only if you have upgraded the backup proxy agent to version 4.6.9 and later.

  1. Select the Preserve upward tree path option, if you want to restore the parent folders.  For more information, see Restore a File server to the original server.
  2. Click Finish.
    The selected files will be restored to original or alternate virtual machine.

Note

  • If the Phoenix agent restarts during the file restore operation, the job is not retried as Phoenix does not store any guest OS credential. This job will fail with  PHOENIX250. For more information  see, Phoenix errors.
  • The  target virtual machine should have enough space to store the restored files. If the target virtual machine does not have enough space, the triggered restore job will be marked as successful with error.
  • See Error messages, if you encounter any error while performing the procedure.

Restore options

Phoenix provides the following  restore options when you are restoring files to a virtual machine:

  • Always overwrite
    The files with the same name will always be overwritten at the destination regardless of the file version or date. By default, this option is always selected. 

  • Always skip
    The files with the same name will not be restored to the destination. The number of files skipped will be displayed in the progress logs.

  • Overwrite if original is older
    The files with the same name will be overwritten only if the files are older than the version being restored.

  • Restore and move original to .orig
    If the file being restored already exists at the destination, the version being restored will be saved with the same filename. While the existing file will be renamed to filename.ext.orig. On subsequent restores, the existing file versions at the destination will be appended with an incremental number such as filename.ext.orig1, filename.ext.orig2, and so on.

    Example: Assume that one of the files you are restoring from Phoenix is “foo.txt” which already exists at the destination. This scenario will explain the naming changes that foo.txt undergoes over several restore cycles.

    |View larger image|

    •  First restore operation: The “foo.txt” file which already exists at destination will be renamed to “foo.txt.orig” while the file being restored will be saved as “foo.txt”.
    • Second restore operation: The existing “foo.txt” will be renamed to “foo.txt.orig1” while the file being restored will be saved as “foo.txt. You will now see three versions at the destination:
      • foo.txt - The latest version restored from Phoenix.
      • foo.txt.orig1 - The version restored as part of the previous (first)  restore operation.
      • foo.txt.orig - The oldest version present on the destination server.
  • Preserve upward tree path
    You can preserve the entire source location, that is tree path while restoring a file to an alternate location.

    An example of upward tree path: If you are restoring folder “B” from the source location  Volume1/A/B/C/D to  F:/.
    The restored file structure will be  F:/A/B/C/D.

Error messages

You may encounter errors while performing the File level restore. The following table describes the error message and its solution.

Error message   Description  Solution

Could not mount volumes.

 

*Error applicable for CIFS share and Restore to virtual machine.

This error is displayed on the Restore Data page when some of the volumes are not mounted for restore.  
Click More details, to know the reason why the volume could not be mounted.

For more information on supported disk partitions, see Support matrix.

 

Invalid Credentials. Please provide correct UNC path, username and password for the specified network share.

*Error applicable only to CIFS share

This error is displayed if you enter invalid credentials or UNC path for the specified network share.

To resolve the error, enter valid credentials or UNC path for the specified network share.

Could not access the network share from the specified vCenter.

*Error applicable only to CIFS share

This error is displayed if the destination network share is not reachable from the backup proxy. 

 

To resolve the error, provide network share that  is reachable from the backup proxy.

Failed to browse the guest vm. Error: Cannot proceed with restore operation. VMware Tools not present in the selected VM.

*Error applicable only for restore to virtual machine.

This error is displayed if  VMware tools are not installed on the destination virtual machine.

To resolve the error,  install the VMware tools on destination virtual machine. For more information see:

Failed to schedule restore. Error: No Backup Proxy found with version 4.6.9 or later in the Vcenter. Please upgrade backup proxies to the latest version.

*Error applicable only for restore to virtual machine.

This error is displayed if there is no backup proxy with version 4.6.9 or later in the selected vCenter/Hypervisior.

OR

No backup proxy with version 4.6.9 or later is connected to Phoenix.

To resolve the error, you must have at least one backup proxy with version 4.6.9 or later connected to Phoenix in the selected vCenter/Hypervisior.

 

Failed to browse the guest vm. Error: Invalid Credentials. Please provide correct username and password for the specified VM.

*Error applicable only for restore to virtual machine.

This error is displayed if you provide invalid username and password for the destination virtual machine.

To resolve the error, provide valid username and password for the destination virtual machine.

Failed to schedule restore. Error: Invalid location. Please provide correct location on the specified VM.

*Error applicable only for restore to virtual machine.

This error is displayed if you provide an invalid restore location.

To resolve the error, provide valid restore location.

Failed to browse the guest vm. Error: Selected VM not found on destination VMware setup and hypervisor. Please select another VM.

*Error applicable only for restore to virtual machine.

This error is displayed if the selected destination virtual machine is deleted. The deleted virtual machine may still appear in the virtual machine listing page as the virtual machine listing page is refreshed once every 24 hours.

To resolve the error, select a different virtual machine

Failed to browse the guest vm. Error: Cannot connect to the selected VM for restore. Ensure VM is powered on or select another VM.

*Error applicable only for restore to virtual machine.

This error is displayed if the destination virtual machine is powered off.

To resolve the error, power-on the virtual machine.

Failed to schedule restore. Error: User does not have write permission on the specified location. Please provide credentials for another user or provide write permission for specified location.


*Error applicable only for restore to virtual machine.

This error is displayed if you do not have write permissions on the destination virtual machine.

To resolve the error, you must have write permission to the destination virtual machine. OR

Provide a path to a different virtual machine where you have write permissions.