HP-UX File System Agent: Browse and Restore

Updated

The tasks that appear on this page are specific to the HP-UX File System Agent. For instructions about common Browse and Restore operations, see Browse and Restore Data: Advanced. For information about the Browse and Restore feature, see Browse and Restore: Overview.

Browse and Restore Using Filters and Wildcards

Filters allow you to specify parameters to include specific files and folders when browsing data. You can specify filters for filename, modified date, file size, stubbed files, failed files and folder size for the files you need to browse.

Wildcard expressions can be used with filters to match specific file name patterns. This function provides the ability to 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.

When restoring directories, 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 procedure below to browse using the available filters:

  1. In the CommCell Browser, navigate to Client Computers > client > Agent.

  2. Right-click a backup_set, then click All Tasks > Browse and Restore.

  3. From the Restore Options dialog box, click the Filter tab.

  4. Select Add from Filter Criteria and choose a desired filter.

    Note

    If more than one filter is used in the browse request, the objects qualifying all the filters will be displayed in the browse results.

  5. Click View Content.

Supported File System Filters

The following filters can be used to include files and folders when browsing data:

Filter

Description

File Name

You can filter files by name patterns. For example, each asterisk (*) represents zero, one or many characters:

  • *.doc

  • *.*

  • data*.*

    You can enter multiple keywords by separating them with "AND" or "OR" logical operators, in all capital letters. For example:

  • *.docx AND data*

  • *.txt OR *.xlsx

  • *.docx data*

  • Windows* OR Name*

    Notes:

  • Patterns separated by spaces without a logical operator have an implied "AND" relationship.

  • While you can use more than one operator, you cannot combine "AND" and "OR" logical operators.

    You can enter a keyword phrase that contain spaces, but you must enclose the keyword phrase in double quotation marks ("). For example, to find a file named my data, enter:

  • "my data"

    Note: This form of keyword entry does not support wild cards.

Modified Date

You can filter files based on modification date. Options include:

  • Today

  • Yesterday

  • This Week

  • This Month

  • This Year

    All folders that satisfy this filter are shown.

File Size

This can be used to filter files based on a size range in KB, MB or GB. Comparison options provided are:

  • greater than

  • less than

  • greater than or equal to

  • less than or equal to

Stubbed Objects

Use this to filter stubbed files that were backed up.

Contains

This filters file content against the words you enter. The results differ with different combinations of backup and content indexing jobs that ran on the client, as follows:

  • This filter retrieves more-precise results when Content Indexing is enabled, and at least one Content Indexing job has been run after the last backup job.

  • When Content Indexing is enabled, and other filters are used along with this filter, the results are retrieved from the combination of what got backed up and content indexed.

  • If Content Indexing is not enabled, the reference copy job waits for Content Indexing to run on the source subclient. If data is pushed to multiple Content Indexing servers, data from the most-recent Content Indexing server is processed.

    Two or more filter words or phrases can be combined by placing "AND" or "OR" logical operators between the words. You cannot combine "AND" and "OR" logical operators.

Supported Wildcard Characters

Wildcards

Description

Examples

*

Any number of characters. This wildcard is used in the following scenarios:

  • Filter all files of a specific extension

  • Filter all files under a specific directory

  • Filter all files of a specific extension where the file name starts with a specific pattern.

  • *.doc filters all files with the extension .doc, for example "status.doc" and "mission.doc," on all partitions on the client computer.

    /Test/*.doc filters all .doc files only in the /Test directory.

  • a*.so filters all files with the extension .so, for example "alsvc.so" and "advdcc.so" on the client computer which have the name beginning with "a".

  • /Finance/Test/* filters all the files and directories in the "Test" directory under the "Finance" directory on the / partition. Any sub-directories under the Test directory are not get backed up.

?

Any one character.

  • This wildcard can be used in the following scenario:

  • All files (or directories) for which any one character in the file name or the directory name is variable.

  • /access? filters any directory or file on the machine for which the name begins with- "access" followed by any one character such as "access1" or "access5". However, "access12" or "access15" are not backed up because the last two characters in the name are variable.

  • /Class/report? filters any directory or file under the /Class directory where the character in place of the question mark (?) is variable. For example: "/Class/report1" and "/Class/report2" are backed up. However, "/Class/report15" is not backed up.

[]

Set or range of characters.

  • /[a-m]*.doc filters any file with .doc extension on the / partition for which the name begins with the letters "a" through "m”.

  • /[AEIOU]*.doc filters any file name that ends with .doc and begins with the letters A, E, I, O, or U.

  • /Finance/report[1-47-9] filters files report1, report2, report4, report7, report8, report9 under the Finance directory.

  • /Department-[A-CS] filters files Department-A, Department-B, Department-C, and Department-S.

[!]

The negation of a set or range of characters. You can use the wildcard in the 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.

/root/[!AEIOU]*.doc filters all .doc files in the /root directory that start with a letter other than A, E, I, O, or U.

**

Matches any directory level.

  • /**/move.cpp filters the file named move.cpp located at any directory level. For example: /root/newapp/move.cpp/opt/kde3/src/move.cpp.

  • /etc/** filters all directories, sub-directories, and files under the /etc directory.

***

Matches any directory level, including the parent directory

  • /etc/*** filters all directories, sub-directories, and files under the /etc directory, and the /etc directory itself.

  • To filter all directories, sub-directories, and files under the /etc directory, specifying /etc/*** instead of /etc/** improves performance because /etc/*** filters the /etc directory itself. This is especially useful if you have a large subset of the file system under the /etc directory.

Notes:

  • When you use wildcards to specify the subclient content, the content path appears in Italics.

  • If you want all the files with the file extension ".doc" to be filtered from any level, then specify the content as "*.doc". If any subclient content does not start with a forward slash (/), then "/**/" will be prefixed to the content to match at any level. For example: "*.doc" will become "/**/*.doc".

  • If you wants to treat the asterisk (*), question mark (?), and square brackets ([ ]) as literal, and not as wildcards, then add a forward slash (\) before the wildcard. For example: /Report\[2011-2012\]/*.doc will filter all the .doc files under /Report[2011-2012]

  • More than one type of wildcard can be used when specifying subclient content. For example: /Dcvol?/oracle[1-47]/**/*.log).