Enterprise Workloads Editions: ✅ Business ✅ Enterprise ✅ Elite

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

Use the search feature to search for files and folders across recovery points in a backup set. The following table describes the search criteria and filters for new and existing customers.

In the above table,

You can use one or more filters to narrow down the search results. Click the search bar to view the available filters. For example, if you want to restore a .doc file modified between 17 May 2021 and 31 May 2021, expand Advanced Options and select the following:

If you are a new Druva customer, then you can use one or more filters to search and restore both files and folders. Click the search bar to view the available filters. For example, if you want to restore files and folders that start with the word Spreadsheet modified between 17 May 2021 and 31 May 2021, expand Advanced Options and select the following:

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

To search for the file filename.pdf, enter filename.pdf in the search bar, select Match exact name, and click Search.

📝 Note
​ If you do not select the Match exact name checkbox, Druva searches for files whose name starts with a similar prefix. For example, if you enter _filename.pdf in the search bar, keep the Match exact name checkbox deselected, and click Search, Druva returns the following results:

If you do not select the Match exact name check box, then you are performing a partial file name search.
You can 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, and Phoenix. You can also use a 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
​
​ Druva does not support performing a partial filename search using search terms or prefixes starting with special characters. For example, to search for a file _druva.txt, the valid search terms are:

Search for multiple files at once by specifying search terms or a prefix of the search terms separated by a space. Druva performs an OR operation between the search terms and lists all the files that contain the search terms and prefixes. The maximum number of search terms or prefixes that you can specify is 10.

📝 Note
​ The file name or folder name must be three characters or greater.

Search for files of predefined file types such as Office files, Image files, and so on, or enter custom extensions without periods or character prefixes to search for files with custom extensions. The custom extension can have a maximum length of 10 characters.

📝 Note
​ To see a list of file types and their associated extensions, see File types supported for backup.

This field is available if you are a new Druva user and your account was created on or after 17 May 2021. Choose to search for Both files & folders, Only files, or Only folders from the Type dropdown. The search results are filtered to show Both files and folders, Only files, or Only folders that match the other search filters.
​

📝 Note
​

Enter a file size range to search for files by file size. You can search for file sizes in KBs, MBs, and GBs. The max size must be greater than the min size.

Search for files created or modified between the selected dates. For example, when you enter a date range such as 15/03/2021 (15 March 2021) to 31/03/2021 (31 March 2021), Druva searches for files modified between 15 March 2021, 12:00 am to 31 March 2021, 11:59 pm. In the Date Modified field, you can select a date in either From or To filter, or both of them. For example, if you select only the From date filter, all files created or modified after the From date are listed in the search results. You must choose a date after 1 January 1970.

The Search Results section displays the files and folders that match the search criteria. You can hover over the search query in the search bar to view the applied search filters. You can also modify the search query (highlighted in the screenshot) at any point in time. Scroll down to see more results.

The Name field under Search Results is followed by a sort icon. Initially, the sort icon is in a neutral state, meaning the Name field is not sorted in either ascending or descending order.

📝 Note
​ You cannot sort the search results by name until all the search results are fetched. The sort icon is enabled next to the Name column once all the search results have been fetched and their count is less than one hundred thousand. Click the sort icon to sort the results in ascending or descending order.

If the number of search results exceeds one hundred thousand, then refine the search filters to reduce the results, and then sort by Name.

📝 Note
​ Sort is available for both files and folders, for example,

Select one or more files or folders from the search results and choose to restore the latest version, all versions, or specific versions of the selected file(s) or folders.
Points to be noted:

You can choose to restore the latest version, all versions, and specific versions of files and folders.

📝 Note
​ You can search for and restore folders from recovery points created on or after 17 May 2021, if you are a new Druva customer.

You can select a file or a folder or both from the search results and click Restore.

The following table lists the restore options available when you select files, folders, or a combination of the two for restores from the search results.

📝 Note
​ The option to restore all versions of

and restore specific versions of

are disabled because the size of the selected folder(s) is not available. All folder versions are not available until the search completes. The size of the selected folder(s) in combination with the number of folder versions available may be too large to be restored on the destination.

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

This option lets you restore all versions of the selected file(s). This option is available for single and multiple file selections. This option is not available if you select one or more files with folders.
​

📝 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. Druva restricts you from restoring these to the original location on the original server to avoid an overwrite of the original files.

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

📝 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. Druva 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/folders 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/folders in a single restore job, you cannot proceed to restore without reducing the number of selected files/folders. Modify the search filters to reduce the number of files/folders and then proceed to restore.

You can restore folder versions based on the modification time. A folder can be considered modified when:

Depending on the search criteria, the latest folder versions are displayed by default.

However, the modification time of files inside this folder can be different than the modification time of the folder. Therefore, you can restore specific versions of a folder by selecting the folder modified time from the drop-down.

After you select a specific date and time, the same is reflected as the latest version:

📝 Note
​ You can also browse the folder on the selected modified time, and can restore any other folders/files included within it.

📝 Note
​ In the above example, if the file1_abcdef_test folder contains more than 6144 files/folders, then the Load More option will be visible to load the next set of results.

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 Druva 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 administrator can restore them from the Restore Data page.

📝 Note
​ The directories and files listed in the .CSV file generated by the Export File/Folder listing option are not arranged in alphabetical order.

Druva provides the following restore options:

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

This option overwrites files and folders with the same name at the destination irrespective of the file/folder version or date. This option is selected by default.

Druva will overwrite files/folders with the same name only if they are older than the version being restored.

If the file/folders you want to restore already exists on the destination, Druva renames the existing file/folder to filename.extension.orig while the version you want to restore is saved with the same name. Subsequent restores append an incremental number to the existing file at the destination. For example filename.extension.orig1, filename.extension.orig2, and so on.

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.
​
​ Example: Assume that one of the files you are restoring from Druva is file.txt, which already exists at the destination. This scenario will explain the naming changes that file.txt undergoes over several restore cycles.

Recreate the source directory structure at the destination while restoring a file to an alternate location. The upward tree path of the file is always preserved while restoring to the original location. The downward tree path is always preserved by default.

An example of preserve original directory structure:
If you restore a folder called Department from the path

at the source location to the F: drive on the destination, the restored folder hierarchy will be

.

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.

📝 Note
​ If you select files with different parent paths to restore at a destination, for example,

and enable the Preserve original directory structure option on the Restore to Server page, then ideally the tree path of the files must be preserved at the set destination as follows:

However, if the CPU in use has less than 3 cores or has memory less than 3 GB, then the older version of Enterprise Workloads agent is used for restore.
As a result, it preserves the upward tree path of the first file and restores it at the set destination. But for the second file, it does not honor the selected upward tree path and restores it at the same location. Therefore both the files are getting restored at

that is,

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 recovery point. For more information, see Recovery points that you can restore.

In case of restore after search, if you restore files to the original location or alternate location, the restore job creates a folder with the name of the selected recovery point on the destination and restores the files inside this folder. For example, a folder called Mon_Apr_13_10_46_19_2021 is created on the destination and the files are restored inside this folder.

📝 Note
​ While restoring a folder with a Restore specific version option, the recovery point folder is not created.

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 recovery points that contain these files. These restore jobs will queue up and run serially. You can find job details in the Audit Trails.

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.

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

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

📝 Note
​ Symbolic links and mounted folders do not appear in the folder structure. If the server is not connected to Druva Cloud, Druva 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 Druva Cloud with PHOENIX17 error.

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

📝 Note
​ The recovery point 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.

📝 Note
​ Servers running an earlier version of Enterprise Workloads agent, unconfigured servers, and servers belonging to a different platform do not appear in this list.
Servers that are not currently connected to Druva Cloud appear in the Specify server list, but Druva 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 Druva Cloud with PHOENIX17 error.

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

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

📝 Note
​Cold recovery points are applicable to LTR and Archive customers. Customers can have only warm recovery points, if LTR and Archive are not enabled. To know more about LTR and Archive, see About long term retention and Protect File Server and NAS data in Archive Storage tier.