You are here: Restoring File-level Backups > Restore options

Restore options

When restoring data, you need to choose what data to restore. You can restore an entire backup or selected files. See the following topics for details:

ClosedSearching for a file to restore

This enables you to search for a single file that has already been backed up. Searching this way allows you to determine the backup location of a deleted or missing file.

To find files to restore

Use this procedure to search for files in a client’s backup history. These files can be deleted, viewed, or restored.

1 Click Status on the main menu.
2 Select a client in the Navigation pane and click Show Search Options above the calendar in the Center Stage as shown in the figure above.
3 Enter search criteria. Search by name, date, size, or any combination.
• Name – To search by name, check the Name box and enter text. For the quickest search, include the entire path. Wildcards, such as “*” and “?”, can be used.

For example, if the file name is: restoretest.doc. You could search by entering the following:

– *test*
–  *test.doc
– restore*

When using wildcards, such as ‘\\’, ‘%’, ‘_’, ‘*’, ‘?’, and ‘\’, do NOT check the Regular Expression box. These characters are interpreted differently as regular expressions and do not yield the same search results.

• Regular Expression: Check this box to search using regular expressions. (Do NOT check this box to search using wildcards.)
• Ignore Case: Check this box to search for filenames regardless of case.
• Date: Check this box to search for files modified within a certain time frame. Calendar icons are provided to assist with date selection.
• Size (KB): Check this box and enter a range in kilobytes to narrow the search by file size.
• Include: Select to return files that meet the search criteria you entered. This is the default setting.
• Exclude: Select to return all files other than ones that meet the search criteria you entered. Entered criteria is used to exclude files from search results.
4 Click Search. Files matching the specified criteria display on the Search: File Results tab.
5 Click on a file to view more details. This opens the Backup Information window.
• To restore this backup, continue with this procedure.
• To delete this backup and any associated dependent backups, click Delete Backup.
• To exit the Backup Information page, click Cancel.
6 Click Restore.
7 In the Restore from Backup of client window, do one of the following:
• Continue with this procedure to restore to the original location.
• Click Advanced Execution Options to specify an alternate directory and other options. For details, see Advanced Execution Options for restore.
8 Click Restore.
ClosedFile exclusion options

This option provides the ability to exclude files and folders based on file pattern. The following are different ways to exclude files from your restore:

• Drag and drop files into the exclusion pattern field from the File Selection List.
• Manually add files/folders by typing file location into the exclusion pattern field.

Note:   If files are in the exclusion list box and you wish to remove them, highlight and click Remove.

The syntax of the paths you enter depends on the client Operating System type. See the following table for information.

Operating System

Proper syntax

Windows
C:\\FolderName or C:\FolderName

Linux/ UNIX
C://FolderName or C:/FolderName

Note:  Wildcards are not supported for Linux/UNIX Operating System. Only folder-level exclusions are supported.

ClosedExample exclusion patterns

Exclusion Pattern Example

Description

*.txt

How to exclude all files where zero or more characters match the exclusion pattern. Windows only.
C:\windows\sys*

How to exclude directories and their contents within the specified path where zero or more characters match the exclusion pattern. Windows only.
C:\PCBP\Lists.dir\p_client?.spr

How to exclude all files within a specified path that matches a single character within exclusion pattern. Windows only.
C:\Programfiles\Case?\

How to exclude all directories and their contents within specified path that matches a single character within exclusion pattern. Windows only.
C:\?Log?\*.logs

An example of Exclusion lists that have multiple “?” wildcards and only one * wildcard. Windows only.

C:\\DataRestore

If an entire directory is excluded, the directory name will still appear in the backup; however, its contents will be empty. All clients.

See the table below for exclusion pattern limitations and examples.

Limitation

Example of limitation

Should not be used to exclude all folders that match folder_abc on the system. The full path must be provided.
*folder_abc

Multiple wildcard matches are not supported.

C:\*\*\abc.txt

Wildcards are not supported on Linux/Unix systems. Folder-level exclusions only.
C://BobsFolder
ClosedAdvanced Execution Options for restore

The options in this section allow you to input a target directory, overwrite existing files, restore only the newest versions, and exclude files. See below for a description of each option:

ClosedTarget Directory
If no Target Directory is entered, the files or folders are restored to their original location. Using spaces in a Target Directory name should be avoided. An example of a correct Target Directory is: C:\\RestoredData. To restore to the appliance's Samba share, enter /backups/samba.
ClosedClient Pre-Restore Commands
Use this field to specify commands or scripts to run on the client before starting the restore. For example, enter the command to shut down the database before a restore. The output from the command is directed to the restore summary.
To specify a pre-restore command, enter the full path to the command in the Pre-Restore Commands field. For example, C:\Data\script.bat or /usr/jsmith/script.sh.

Note:   For Linux clients, running long pre-restore commands can cause restores to fail. To prevent this, adjust the timeouts setting in the client’s master.ini file as described in KB 3107.

ClosedClient Post-Restore Commands
Use this field to specify commands or scripts to run on the client after the restore completes. For example, enter the command to restart a database after a restore completes. The output from the command is directed to the restore summary.
To specify a post- restore command, enter the full path to the command in the Post-Restore Commands field. For example, C:\Data\script.bat or /usr/jsmith/script.sh.

Note:   For Linux clients, running long post-restore commands can cause restores to fail. To prevent this, adjust the timeouts setting in the client’s master.ini file as described in KB 3107.

ClosedSave Selected Options
Allows you to save field inputs for future use. You can save multiple versions and designate a name. Once you select a saved option from the drop-down list, you have the option to load or delete the selected options.
ClosedPreserve Directory Structure
This option is selected by default. If selected, this preserves the existing file structure within the target directory.

Note:   If you wish to restore the file(s) to the original location, Preserve Directory Structure must be selected. If you attempt a restore to the original location and uncheck this box, the restore fails.

Below is an example of the file selection screen in the Administrator Interface. When files are selected, their parent folders are selected by default. In the example, the Target Directory is C:\\AmandaVelez. All files selected for restore are restored to this folder on the target client.

If Preserve Directory Structure is checked, parent folders are restored as shown here:

If Preserve Directory Structure is not checked, parent folders are not restored, as shown here:

ClosedOverwrite Existing Files and Restore Newer Files Only options

How you set these options determines which files are restored and whether existing files on the target client are overwritten.

• Overwrite Existing Files - This option is selected by default. If selected, files in the Target Directory may be overwritten. (See the table below to determine when overwrite will happen.) This is useful if you are restoring an updated version of a document and only want the most up to date version.
• Restore Newer Files Only - This restores a file only if its date is newer than the existing version in the Target Directory. (See the table below to determine when newer files overwrite existing files.) If the file does not exist in the Target Directory, the file is restored. 
• How these options work if the file exists in the Target Directory:

Option selected?

Restore behavior
  Windows backup Non-Windows backup
Overwrite Existing Files = Yes
Restore Newer Files Only = Yes

Restores the file and overwrites the existing file.
• If the file to restore is newer than the one in the Target Directory, restores the file and overwrites the existing file.
• If the file to restore is older than the one in the Target Directory, does not restore the file.
Overwrite Existing Files = Yes
Restore Newer Files Only = No

Restores the file and overwrites the existing file.

 Restores the file and overwrites the existing file.
Overwrite Existing Files = No
Restore Newer Files Only = Yes

Does not restore the file.

Does not restore the file.

ClosedSet file Dates to Today
This stamps the restored files with the restore date and time. If not checked, file dates are not updated during the restore.
ClosedUNIX Text Conversion
This option is selected by default. When restoring UNIX Text files to MS-DOS systems, checking this option prevents new lines from being converted to CR-LF.