Find Data - Windows File System iDataAgent

Restore Data Browse and Restore Find Data
Table of Contents

Understanding the Find Options Window

Find provides an easy-to-use convenience to search and restore data.

You can open the Find window from backup-set or subclient level. The sub levels displayed in the result window is based on where you start the browse operation.

Selecting Objects from the Find Window for Restore

The find window displays the contents of the selected object.

Note that the window displays only the data that was obtained by a backup. Data that is excluded by a filter, or data which did not exist as of the specified browse time does not appear in the window. Find allows you to search for a given file name, directory name, or a name pattern, modification date, file size, etc. from a backup.

Selections follow these rules:
  • All selections are recursive.
  • Clicking a box again causes the selection to be cleared.

Selection status is revealed by the selection icons as follows:

Indicates that the object is not selected for restoration.
Indicates that the entire object, including all of its child objects, are selected for restoration.

Find results work differently when Content Indexing Engine is installed and a Content Indexing job has been run after the last backup job.

  • If Content Indexing is enabled on the client and jobs are Content Indexed, all Find results will be displayed from Content Indexed data.
  • If Content Indexing is not enabled, all Find results will be displayed from what got backed up.

Find Files with Specific File Names

You can find files with specific names or name patterns. Wildcard expressions can be used to match specific file name patterns. This function provides the ability to find and restore files and/or folders/directories that have a common naming convention. For example, msde2.txt and msj4j.txt.

Note that a combination of wildcards in a single expression (e.g., access?.h*) can also be used. If the expression is specified by itself, without a path (*.txt), the system searches for and returns all data within the backup set that satisfies the expression. By preceding the expression with a path, the scope of the restored data can be narrowed. For example, specifying sys:\data\*.txt, would restore only those files and directories within the sys:\data directory with extensions of .txt.

If a wildcard pattern that matches the name of a directory was specified, the system restores the directory, but none of the directory's contents. For example, if the wildcard restore string is tem?, the system restores any and all data named with a four-character string starting with the letters t, e, and m. If a directory name satisfies the wild card condition (e.g., sys:\temp) then only the directory would be restored; however, none of the files or any subdirectories contained therein are restored.

See Supported Wildcard Characters for a list of wildcards supported.

Use the following steps to find files with specific name or name pattern:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System
  2. Right-click a Backup Set and click All Tasks | Find.
  1. Click Add and select File Name filter from the Filters tab.
  2. Add a file name or name pattern in the box, e.g. *.doc or *.*.

    Multiple filters can be specified together using spaces in between.

    You may also specify additional options to run the Find Operation, e.g. Time Range, Copy Precedence, Starting Path, Page Size etc. For detailed information on these options, see the corresponding Browse and Restore page for your Agent.

  3. Click View Content.

Supported Wildcard Characters

Wildcard

Definition

Example

* Any number of characters.

This wildcard is used in following scenarios:

  • filter all files of a specific extension
  • filter all files when the file name starts with a specific pattern
  • filter all files under a specific directory
  • filter all files under a specific drive
C:\*.log will filter all files with the .log extension on root of the C drive.

If you want to filter files with the .log extension from a folder on the C drive, you must include the path to the folder in the filter. (e.g. C:\Test\*.log)

ntuser* will filter all files for which the file name starts with the word ntuser.

C:\Finance\Test\* will filter only the files in the "Test" folder under the "Finance" folder on the C drive. Any sub-folders under the "Test" folder will get backed up.

C:\* will filter all files located on root of C drive.

**

All files and folders under a specific directory.

All files and folders under a specific drive.

C:\Test\Data\** will filter all files and subdirectories under and including C:\Test\Data

C:\**\Data\** will filter all files and subdirectories below and including any directory called "Data" at any level in the C: volume

G:\Users\**\xpprofile\*.log will filter all files with the .log extension from any xpprofile subdirectory under Users directory

G:\Users\**\xpprofile\ntuser* will filter all filenames starting with ntuser from any xpprofile subdirectory under Users directory

C:\** or C:\ will filter all files and directories in C drive

? Any one character

This wildcard can be used to filter following files or folders:

All files (or folders) for which any one character in the file name or the folder name is variable.

To filter files:

C:\access?.doc will filter any files with the extension .doc on the C drive for which the name begins with- "access" followed by any one character such as access1.doc or access5.doc. However, access12.doc or access15.doc will not be filtered because the last two characters in the name are variable.

To filter access12 or access15, you must specify access?? in the subclient filters.

To filter folders:

Class?report will filter any folder for which the character in the place of ? is variable. For example: Class1report and Class2report will be filtered. However, Class15report will get backed up.

[ ]

Set or range of characters. C:\[a-m]*.doc will filter any file with .doc extension on the C drive for which the name begins with the letters "a" through "m”.

C:\[AEIOU]*.doc will filter any file name that ends with .doc and begins with the letters A, E, I, O, or U.

If you want to treat [] as literal characters and not as wildcards, you must use a special syntax. This will be useful when you want to filter a file which has [] in the file name. The special syntax allows you to define an escape character. Each character immediately following the escape character will then be treated literally and not as a wildcard.

For example: You want to filter a file with the name report[finance].doc on the C drive. In order for the square brackets to not be treated as wildcards, you must define an escape character. In the following example, the escape character is defined as the apostrophe (‘). The "e=" syntax is used to define the escape character. Since the square brackets are to be treated as literals, they both must be preceded by apostrophes. The filter entry in the subclient should look like this:

<P:e='>C:\report'[finance'].doc

Any character can be used as the escape character, as long as it is defined after the “e=” in the syntax and it precedes any character that is to be treated as a literal.

In addition, the escape character can itself be used as a literal. This can be achieved by prefixing it with another escape character. To filter a file with the name Test[Report]’2011’Financials.doc on the C drive, the following syntax should be used:

<P:e=’>C:\Test’[Report’]’’2011’’Financials.doc

[!]

The negation of a set or range of characters. You can use the wildcard in following scenario:

Filter all files in a directory except the files for which the name starts with any character from the specified set or range of characters.

C:\Windows\[!AEIOU]*.doc will filter all .doc files in the C:\Windows directory that start with a letter other than A, E, I, O, or U.

Find Files with Specific Modified Date

Use the following steps to find files with specific modification time:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System
  2. Right-click a Backup Set and click All Tasks | Find.
  1. Click Add and select Modified Date filter from the Filters tab.
  2. Select a modification time from the drop down list, e.g. Last Month.

    You may also specify additional options to run the Find Operation, e.g. Time Range, Copy Precedence, Starting Path, Page Size etc. For detailed information on these options, see the corresponding Browse and Restore page for your Agent.

  3. Click View Content.

Find Files with Specific File Size

Use the following steps to find files that satisfy a specific file size:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System
  2. Right-click a Backup Set and click All Tasks | Find.
  1. Click Add and select File Size filter from the Filters tab.
  2. Select an operator from the drop down list and enter the file size in the box provided, e.g. Greater than 2 MB.

    You may also specify additional options to run the Find Operation, e.g. Time Range, Copy Precedence, Starting Path, Page Size etc. For detailed information on these options, see the corresponding Browse and Restore page for your Agent.

  3. Click View Content.

Find Files That Were Stubs

Use the following steps to find files that existed as stubs when backed up:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System
  2. Right-click a Backup Set and click All Tasks | Find.
  1. Click Add and select Stubbed Objects filter from the Filters tab.
  2. You may also specify additional options to run the Find Operation, e.g. Time Range, Copy Precedence, Starting Path, Page Size etc. For detailed information on these options, see the corresponding Browse and Restore page for your Agent.

  3. Click View Content.

Find Files with Specific Wording as Their Content

Use the following steps to find the backed  up files with specific wording in their content:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System
  2. Right-click a Backup Set and click All Tasks | Find.
  1. Click Add and select Contains filter from the Filters tab.
  2. Enter the content of the file you want to find, e.g. file system.

    This filter will work only if the Content Indexing Engine is installed and a Content Indexing job has been run after the last backup job.

    You may also specify additional options to run the Find Operation, e.g. Time Range, Copy Precedence, Starting Path, Page Size etc. For detailed information on these options, see the corresponding Browse and Restore page for your Agent.

  3. Click View Content.

Add Items to a Selected List

Use the following steps to add the desired file or files from the search results to the selected items list and then to restore the respective file or files:

  1. From the results of  Find Options window list, right-click the desired file name and click Add to Selected List.
  2. Click Selected Items tab and right-click the desired file or files.
  3. Click Restore.