Skip to main content
Druva Documentation

Restore a NAS share

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

This section provides information about the restore options for NAS share and describes how you can restore data to the original or an alternate location.

About NAS share restore

Phoenix provides the following  restore options for NAS share:

  • Restore to original location: Restores the data at the original location with the original settings.

  • Restore to alternate location:  The alternate location can be a different NAS share of the same NAS device or a different NAS share on a different NAS device. You can also specify a custom restore path and select a NAS Proxy that will handle the restore request.

You can configure both the above restore options with a set of restore settings common across both the options. The common restore settings control how Phoenix restores the NAS share data when the data is likely to get duplicated or overwritten at the restore location. 

Common restore settings

The following restore settings define how data restore occurs if the files and folders already exist at the target location. These settings are common to both Restore to original location and Restore to alternate location restore options.

  • Always overwrite: The files with the same name will always be overwritten at the destination regardless of the file version or date. This is the default restore setting.
  • 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 Phoenix detects the same file name at the restore location, it renames it to filename.ext.orig and completes the restore. Hence the file names at the restore location are appended with an incremental number,  such as filename.ext.orig1, filename.ext.orig2, and so on in the subsequent restores.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.
  • Always skip: Phoenix does not restore files with the same name at the restore location. The number of files skipped will be displayed in the progress logs.
  • Preserve original directory structure: You can preserve the source directory structure while restoring data to an alternate location. For example: If you restore folder “X” from the source share location A/B/C/D to the F share, then the restored file structure is  F/A_B_C_D/X. The original directory structure is preserved by default when you restore data to the original location. The downward folder structure is also preserved.

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.

RestoreMoveOrigToOrig.png

  • 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.orig - The oldest version present on the destination server.
    • foo.txt.orig1 - The version restored as part of the previous (first)  restore operation.
    • foo.txt - The latest version restored from Phoenix

Search for files

Use the search feature to search for a file and all its available versions across 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. You can use the complete filename or partial filename to search for a file.

Search Filters.png

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

  • Exact Match: Select the Match Exact Filename check box 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 press 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 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 or Prefix used Resulting files Invalid search terms or prefixes
    • 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.

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 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.
  • The search feature does not work for the agents that are not connected or are in the disabled state.

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 latest all specific versions.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:

Restore 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 versions.png

Restore latest versions

This option allows you to restore the latest version of the selected file(s). 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.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 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 an alternate location. Phoenix restricts you from restoring these to the original location 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 the single file, you can restore them to an alternate location. Phoenix restricts you from restoring them to the original location to avoid an overwrite of the original files.

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.png

 Preserve original directory structure

If you choose to restore to the original location, you cannot deselect the Preserve original directory structure option. If you restore to an alternate location, 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 NAS share restore

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 Jobs page. 

Export file/folder listing

The Export file/folder listing capability in the Restore Data page allows you to export the 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 Folder listing.png

Restore NAS share

  1. Log in to the Phoenix Management Console.
  2. On the menu bar, click the drop-down next to All Organizations, and select the organization that has the NAS device.
  3. On the menu bar, click Protect > NAS.
  4. From the device-specific navigation pane on the left, select the NAS device. 
  5. In the right pane, click the NAS share from which you want to restore data.
  6. From the share details page, in the Configured Backup Sets section, select the backup set to be restored from, and then click Restore.
  7. In the Restore Files dialog box, you can either search for the file to be restored or manually browse the folder hierarchy for it.
    1. Search: Click in the search box to bring up the Search File Name dialog box. You can search for a file by entering the file name. You can also use one or more filters like File Extension, File Size and Time Modified to find your file. Once the search parameters have been defined, click Search. Select the file to be restored, and then click Restore. Depending on the number of files selected, you can either choose to restore specific, all or latest versions of the file. Select the file versions, and then click Proceed to Restore.
    2. Browse: Click the down arrow next to the date and time stamp and select the snapshot type. Select the snapshot that you want to restore from. In the folder hierarchy, browse for the file(s) to be restored. Select the file to be restored, and then click Restore.
  8. In the Restore Target tab, choose to either
Restore to original location
  1. In the Restore to Server dialog box, in the Restore Target tab, click Restore to original location, and then click Next.
  2. In the Restore Settings tab, define the restore settings.

    Always overwrite.png

    Select from:
    1. Always overwrite
    2. Overwrite if original is older
    3. Restore and move original to .orig
    4. Always skip

Note: The Preserve original directory structure is selected by default while restoring to the original location.

  1. Click Finish.
Restore to an alternate location
  1. In the Restore to Server dialog box, in the Restore Target tab, click Restore to alternate location, and enter the following details.

    Restore to alternate location.png
    Enter the following details:
    1. Specify NAS Device: Select the NAS device.
    2. Specify Share: Select the share on which you want to restore data.
    3. Specify Path:  Specify a path where the data has to be restored.
    4. NAS Proxy: Select the NAS proxy Phoenix can use to restore data to the alternate location.
  2. In the Restore Settings tab, define the restore settings. Select from:
    1. Always overwrite
    2. Overwrite if original is older
    3. Restore and move original to .orig
    4. Always skip
    5. Select Preserve original directory structure to restore the files in the original folder hierarchy.
  3. Click Finish.