Loading...

Find

Table of Contents

Understanding the Find Options Window

The Find feature lets you search through backed-up data and restore it from the search results.

You can start a Find operation at the backup set or subclient level. The sub-levels shown on the Search Results tab are based on where you start the Find operation.

From the Find Options window, you can set filtering criteria for a number of different file- or folder-related values, such as its name or modification date, when it was backed up, or its content if it is a file that has been content-indexed. This page tells how to use the available options.

Note: For large restores (those with more than approximately 10,000 items), restoring by filtered browsing (see Browse and Restore Using Filters) may provide better performance than restoring by the Find feature.

Using the Search Results Tab to Select Objects to Restore

The Search Results tab shows the results of a Find operation. Using Find, you can search through backed-up a file or folder information based on its metadata, such as name, modification date, size, or backup date. Data that is excluded by filtering does not appear in the search results.

Notes:
  • All selections of folders are recursive.
  • If you sort the Find results by clicking a column heading on the Search Results tab, any selections that you have made will be lost.

The selection icons indicate these conditions:

The object is not selected for restoration.
The object is selected for restoration. If the object is a folder, all child objects are selected also.

Find results work differently when a Content Indexing job has been run after the last backup job, as follows:

  • If Content Indexing is enabled on the client, and jobs are Content Indexed, Find results are displayed from Content Indexed data.
  • If Content Indexing is not enabled, Find results are displayed from backed-up file and folder metadata.

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. (for example, 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 the 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:\** will filter all the directories located on C drive

C:\**\* will filter all the files and directories on 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.

    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.

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

Restoring Items using the Selected Items List

Use these steps to add files or folders that appear on the Search Results tab to the list on the Selected Items tab, and then restore them:

  1. In the Find Options window, select one or more items.
  2. Add all currently selected items by right-clicking one selected item, then clicking Add to Selected List.
  3. Click the Selected Items tab, then right-click a selected item in the list.
  4. Click Restore.