Skip to main content
Druva Documentation

Restore files and folders

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

The following article provides information on restoring files and folders to an original or an alternate location:

About Restore settings

Phoenix provides the following  restore options:

Note: These  restore settings will be displayed only if you have upgraded the File server client to version 4.6.9 and later.

  • 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 they 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 the 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  E://A/B/C/D to  F:// drive.
    The restored file structure will be  F://E/A/B/C/D.

    Upward tree path will always be preserved in case you are restoring to the original location. The Downward folder structure is always preserved.  

Search for files

Use the search feature to search for a file and all its available versions across the snapshots in a backup set. 

Note: Use the search bar to search for files. The search bar does not support a search for folders.

Search filters

Search for files across snapshots by filename, file type, file size, and date. You can use either one of the filters or a combination of filters to narrow down the search results. Use the search filters to quickly drill-down on your search results and view the exact files that you need. For example, to search for files modified during a time period, select a date range in the Date Modified filter to show all the files that were modified during that period. 

Start typing in the search bar to view additional search filters.  

Search.png

Here are some of the ways you can use the search filters:

  • Exact Match: Select the Match Exact Filename checkbox if you want to search for an exact filename. Specify the complete filename in the search bar along with the extension of the file, select Match Exact Filename, and then click Search.  Selecting the Match Exact Filename checkbox disables the File Type filter.

    For example, if you want to search for a file named "Phoenix_backup_2019.pdf", you must enter the complete file name with extension in the search bar and then select the Match Exact Filename check box to search for the exact file.

    To search for a file that starts with a special character, "_Phoenix_backup_2019.pdf", type the complete file name with extension "_Phoenix_backup_2019.pdf" in the search bar and select the Match Exact Filename check box to search for the file. 

    Note: If you do not select the Match Exact Filename check box, Phoenix searches for files whose name starts with similar prefix. For example, a search for file 'Phoenix_backup.txt' will return the following results: 'Phoenix_backup.txt', 'Phoenix_backup.txt.pdf' and files with similar prefixes ('Phoenix_backup.txt').

  • Partial match:  Search for files with search terms or prefixes. Search terms are substrings of a filename that are separated by a delimiter. For example, search terms for a file "Druva_Phoenix.txt" are 'Druva', 'Phoenix'. You can also use prefix of a search term to search for files.  For example, prefixes of search terms for a file "Druva_Phoenix.txt" are 'Dru', 'Druv', 'Druva', 'Pho', 'Phoe', 'Phoeni', 'Phoenix', 'Druva_Phoenix.txt'. The prefix should start from the left of the search term and must be a minimum of 3 characters and a maximum of 64 characters.

    Note: Starting the search term or prefix with a special character is not allowed in the partial filename search. If your filename starts with a special character, "_druva.txt", you can use 'druva' as the search term or 'dru', 'druv' to search for the file. Or, you can type the complete filename "_druva.txt' and check the Match Exact Filename check box and perform the search.

    To search for  Valid search terms and prefixes Invalid search terms and prefixes

    Phoenix_backup_2019.pdf
    • Pho
    • Phoe
    • Phoeni
    • Phoenix
    • back
    • backup
    • backup_2019
    • 2019
    • Phoenix_backup
    • Phoenix_backup_2019
    • Phoenix_backup_2019.pdf
    • Phoenix_backup_2019.pdf
    • _backup
    • *.pdf
    • _2019.pdf
    • nix_back
    • 019.pdf
    • enix
    • up_2019
  • File type search: You can search for files that are of a certain type, such as, image files, Office Files, etc.  The File Type list contains a list of predefined file types that you can use, or you can type custom extensions, such as 'bin', 'so', 'sh', 'py' and more. Do not add a period to the extensions. The custom extension can be of a maximum of 10 characters in length.

    To search for Valid search terms Invalid search terms

    Phoenix_backup_2019.doc
    • Select Office Files in the File Type list, or
    • Type doc in the File Type field 
    • .doc
    • *doc
    • %doc
  • Multiple file search:  Search for multiple files at once by specifying search terms or prefix of the search terms that are separated by a space. Phoenix performs an OR operation between the search terms and lists all the files that contain either term. The maximum number of search terms or prefix that you can specify at once is 10. 

    List of files in backup set Search term used Resulting files Invalid search terms
    • Phoenix_backup_2019.doc
    • druva_setup_2019.pdf
    • druva_back_up_2012.pdf
    • back_druva.txt
    • setup-backup.doc
    • Phoenix_set_up.pdf
    • set_phoe_batch.txt
    • setup druva 

       

    • druva_setup_2019.pdf
    • druva_back_up_2012.pdf
    • back_druva.txt
    • setup-backup.doc
    • setup, druva 
    • back;setup
    • setup AND druva
    • setup OR druva
    • setup+druva
    • Phoenix_backup_2019.doc
    • druva_setup_2019.pdf
    • druva_back_up_2012.pdf
    • back_druva.txt
    • setup-backup.doc
    • Phoenix_set_up.pdf
    • set_phoe_batch.txt
    • back setup druva phoe
    • Phoenix_backup_2019.doc
    • druva_setup_2019.pdf
    • druva_back_up_2012.pdf
    • back_druva.txt
    • setup-backup.doc
    • Phoenix_set_up.pdf
    • set_phoe_batch.txt
    • back, setup, druva, phoe
    • back;setup;druva;phoe
    • back AND setup AND druva AND phoe
    • back OR setup OR druva OR phoe
    • back+setup+druva+phoe
  • Date Modified filter: Search for files that were created or modified between the selected dates. For example, when you enter 3 March in the From field and 8 April in the To field, Phoenix searches for files modified between 3 March, 12:00 am to 8 April 11:59 pm.

    You can either use the To filter or From filter. For example, If you select only the From date filter, all files that are created or modified after the from date are listed in the search result. You must choose a date after 1 January 1970.

  • File Size: Specify the file size limit to filter files that fall in the desired size limit. File size can be specified in KBs, MBs, and GBs.

Search result

The search results section displays the files that match the search criteria. You can modify the search query (highlighted in the screenshot) displayed at the top of the dialog box at any point in time. Scroll down to see more results.

Search results.png

From the search result, you can select a  file and a version of it and restore the file. If the selected file version belongs to a cold snapshot and you click Proceed to Restore, the data will move temporarily to the warm tier and will then be restored from there. To know more, see About Long Term Retention.

Points to be noted:

  • Searching requires the data to be indexed. Post backup, the data is indexed automatically after some time. The files in the backup are available for search once the indexing completes.
  • Search will be available only for those backup sets whose backup completes successfully after the release of this feature.
  • The search feature does not work for the agents that are not connected or are in the disabled state.
  • If you search for a file to be restored through the search view and that file belongs to a quarantined snapshot, you cannot restore that file.  When you click Proceed to Restore on the Select File version screen, you are informed that you cannot restore the file since it belongs to a quarantined snapshot. 

Restore latest, all or specific versions of files

You can choose to restore the latest version, all versions, and specific versions of files. These restore options are available when you search for files using any filter in the search bar.

Restore options.png

Restore a single file selected from search results

If you select a single file for restore from the search results, you have the following options:

Single file.png

Restore multiple files, selected from search results

If you select multiple files from the search results, you have the following options:

Restore multiple files.png

Restore latest versions

This option allows you to restore the latest version of the selected file(s) to the original server or a different server. This option is available for single and multiple file selections. The latest versions of a file(s) are restricted to the specified search parameters.

Restore latest file version.png

Restore all versions

This option lets you restore all versions of the selected file(s). This option is available for single and multiple file selections.

Restore all file versions.png

Note: If you select one or more files that have multiple versions from the search results and choose to restore all versions of those files, you can restore them to a custom location on the original server or a different server. Phoenix restricts you from restoring these to the original location on the original server to avoid an overwrite of the original files.

Restore specific versions

This option allows you to restore specific versions of a single file. This option is not available if you select multiple files from the search results.

Restore specific versions.png

Note: If you choose to restore multiple versions of a single file, you can restore them to a custom location on the original server and a different server. Phoenix restricts you from restoring multiple versions of a single file to the original location on the original server to avoid an overwrite of the original file.

Note: Restore of 5000 or more files in a single restore job is not supported. This restriction applies to restore of all versions, latest versions, and specific versions. If you select 5000 or more files in a single restore job, you cannot proceed to restore without reducing the number of selected files. Modify the search filters to reduce the number of files and then proceed to restore.

Restore of 5000 files or more.png 

Preserve original directory structure 

If you choose to restore to the original location on the original server, you cannot deselect the Preserve original directory structure option. If you restore to a custom location on the original server or another server, you can deselect this option. Druva does not recommend deselecting this option, as an overwrite of files can lead to potential data loss.

To view the file attributes that can or cannot be restored, see About restoring files and folders.

You cannot restore a file that you've selected from search if it belongs to a quarantined or deleted snapshot. For more information, see Snapshots that you can restore

Whether you restore files to the original location or alternate location, the restore job creates a folder with the name of the selected restore point on the destination and restores the files inside this folder. For example: A folder called Mon_Apr_13_10_46_19_2020 is created on the destination and the files are restored inside this folder.

Restoring one or many versions of single or multiple files generates multiple restore jobs. The number of restore jobs created depends upon the number of selected files and their selected versions, and also the number of restore points that contain these files. These restore jobs will queue up and run serially. You can find job details in the Audit Trails.

Restore multiple files across folder hierarchies

If you browse the folder hierarchy, you can now select multiple files from folders across hierarchies. When you click Finish in the Restore wizard, you see a message letting you know that you've selected folders from multiple hierarchies, and this will trigger multiple restore jobs. 

Export File/Folder listing

The Export file/folder listing capability in the Restore Data page allows you to export a list of all the files and folders in the selected folder to a .CSV file.Users who don’t have access to the Phoenix Administration console can use this exported file to determine the files or folders they want to restore. After they have identified the files that they need, the Phoenix administrator can restore them from the Restore Data page.

Export File and Folder Listing.png

Restore a file to the original server

  1. Log in to the Phoenix Management Console.
  2. On the menu bar, click All Organizations, and select the required organization from the drop-down list.
  3. On the menu bar, click Protect > Windows/Linux Servers.
  4. Select the File Backup Sets tab.
  5. Select the backup set that you want to restore data from, and then click Restore
  6. On the Restore Data page, do one of the following: 
  • Search for a file using the search bar or use the filters to narrow down search results,  select the required file and a version of it and then click Restore.
  • Search for the file manually by selecting the snapshot in the snapshot viewer, selecting the type of snapshot and then selecting the restore point. Browse the folder hierarchy to select the file that has to be restored and then click Restore.
  1. On the Restore to Server page, click Restore to original server and click one of the following options:
    • Original location: Select this option if you want to restore the selected files to its original location.
    • Custom location: Select this option if you want to restore the selected files to a custom location.  In the Specify custom location box, type or select the absolute path to the custom location.

Restore to original server - original location - Restore target.png

  1. Click Next.
    Restore to original server - original location - Restore settings.png
  2. Under Restore Settings, select one of the following options:
    • Always overwrite
    • Overwrite if original is older
    • Restore and move original to .orig
    • Always skip

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

Note:  Upward tree path will always be preserved while restoring to original location.

  1. Click Finish.

Note: Symbolic links and mounted folders do not appear in the folder structure. If the server is not connected to Phoenix Cloud, Phoenix cannot fetch the folder structure data. To initiate a restore, you must type the absolute path to the restore destination. The restore operation fails if the server is not connected to Phoenix Cloud with PHOENIX17  error. 

Restore a file to an alternate server

  1. Log in to the Phoenix Management Console.
  2. On the menu bar, click All Organizations, and select the required organization from the drop-down list.
  3. On the menu bar, click Protect > Windows/Linux Servers.
  4. Click the File Backup Sets tab.
  5. Select the backup set that you want to restore from, and then click Restore.
  6. On Restore Data page, do one of the following:
    • Search for a file using the search bar or use the filters to narrow down search results, select the required file and then click Restore.
    • Search for the file manually by selecting the snapshot in the snapshot viewer, selecting the type of snapshot and then selecting the restore point. Browse the folder hierarchy to select the file that has to be restored and then click Restore.

Note: Symbolic links and mounted folders do not appear in the folder structure.

Note: The snapshot timestamps are displayed according to the server time zone. For example, for servers located in New York and London, the time stamps are displayed according to EST and UTC time zones, respectively.

  1. Click Restore to a different server and provide the following details:

Field

Description

Specify server    
 
From the drop-down list, select the server to which you want to restore this data.
Specify location   Type or select the absolute path to the restore destination.

Restore to Different Server.png 

  1. Click Next.
    Restore to Different Server - Restore Settings.png

 

Note: Servers running an earlier version of Phoenix agent, unconfigured servers, and servers belonging to a different platform do not appear in this list.
Servers that are not currently connected to Phoenix Cloud appear in the Specify server list, but Phoenix Cloud cannot fetch their folder structure data. To initiate restores to such servers, you must type the absolute path to the restore destination. The restore operation fails if the server is not connected to Phoenix Cloud  with PHOENIX17  error.

  1. Under Restore Settings, select one of the following options:

    • Always overwrite

    • Overwrite if original is older

    • Restore and move original to .orig

    • Always skip 

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

  1. Select 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.

Note: Upward tree path will always be preserved while restoring to original location.

  1. Click Finish.

Note: If the folder hierarchy has a large number of files, then you see a message, "More files in this folder can be viewed by search" at the bottom. In this case, you can use the search bar instead of browsing the hierarchy manually.

Too many search results.png

Cold snapshots are applicable to only the LTR customers. The non-LTR customers can only have warm snapshots. To know more about LTR, see About long term retention.