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 back to NAS Filer: 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 server or a different NAS share of a different NAS device. You can also restore on a NAS device in a different administrative group.

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 back to NAS Filer 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.

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

  • 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.orig1filename.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.

    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
  • 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 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.
    Upward tree path is preserved when the user restores 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 version across the snapshots in a backup set. 

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.

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

  • 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'. 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
    • _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. Scroll down to view search results until you see the search complete message.

Restore_data_new.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, then you must defreeze the snapshot before restoring the file.

Restore_file_versioning.PNG

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.

Restore a NAS share to the original server 

  1. Log on to Phoenix Management Console.
  2. On the menu bar, click All Organizations, and select the organization containing the NAS device.
  3. On the menu bar, click Protect > NAS.
  4. Click the NAS device containing the NAS share that you want to restore.
  5. Select the NAS share that you want to restore and click Restore.
  6. On the Restore Data window:
    1. Under Backup Sets, select the backup policies from which you want to restore.
    2. Under Snapshots, 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 by manually expanding the snapshots in the right pane, select the snapshot that you want to restore, and click Restore.
  7. On the Restore page, select Restore back to NAS Filer and click Next.
  8. Under Restore Settings select one of the following. See Common restore settings above for more information.
    • Always overwrite
    • Overwrite if original is older
    • Restore and move original to .orig 
    • Always skip
      Note: The above restore setting will be displayed only if you have upgraded the File server client to version 4.6.9 and later.

      RestoreToNASFiler.png  
  9. To restore the parent folders during restore, select Preserve upward tree path option. 
    Note: The upward tree path is always preserved while restoring to the original location. 
  10. Click Finish. Phoenix will perform restore of the NAS share data to the original location based on your selected restore settings. 
     
    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 NAS share to an alternate location

  1. Log on to Phoenix Management Console.
  2. On the menu bar, click All Organizations, and select the organization containing the NAS devices.
  3. On the menu bar, click Protect > NAS.
  4. Click the NAS device containing the NAS share that you want to restore.
  5. Select the NAS share that you want to restore and click Restore.
  6. On the Restore Data window:
    1. Under Backup Sets, select the backup policies from which you want to restore.
    2. Under Snapshots, select 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 by manually expanding the snapshots in the right pane, select the snapshot that you want to restore, and click Restore.
  7. On the Restore page, select Restore to alternate location and specify the alternate restore location using the field description in the table below.
     
    Field Description
    Specify NAS device Select the NAS device to restore data.
    Specify NAS share Select the NAS share to restore data.
    Specify Path Select and specify the path to the restore location. 
    NAS proxy Select the NAS proxy using which Phoenix can restore data to the alternate location.
  8. Under Restore Settings select one of the following. See Common restore settings above for more information.
    • Always overwrite
    • Overwrite if original is older
    • Restore and move original to .orig 
    • Always skip
      Note: The above restore setting will be displayed only if you have upgraded the File server client to version 4.6.9 and later.


      RestoreToNASFiler.png   
  9. To restore the parent folders during restore, select Preserve upward tree path option.
    Note: Phoenix always preserves the upward tree path while restoring to the original location. 
  10. Click Finish. Phoenix will perform restore of the NAS share data to the alternate restore location based on your selected restore settings. 
    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 the PHOENIX17  error. 

    Note: In the restore data window, if the selected folder contains a lot of items and the window encounters a time-out, you see

    • The highlighted message, and
    • The option to select a file or folder for restore 

    Restore_data_information.png