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 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 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, 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 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 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 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. In the Server Name column, click on the server name that you want to restore.
  6. On the Server details page, click Restore.
  7. 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 by manually expanding the snapshots in the right pane, select the snapshot that you want to restore, and 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.

  1. Click Next.

     

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

  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.

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. In the Server Name column, click on the server name that you want to restore.

  6. On the Server details page, click Restore.

  7. 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 by manually expanding the snapshots in the right pane, select the snapshot that you want to restore, and 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.
  1. Click Next.

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

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: 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