Loading...

Global Filters - Advanced

Table of Contents

Modify Global Filters

To modify an exclusion from the Global Filters window:

  1. From the CommCell Console ribbon, click Home and then click Control Panel.
  2. Under the Configure section, click Global Filters.
  3. Select the appropriate category (agent option) from the Global Filters Category list.
  4. Select an exclusion entry in the Exclude Global Filters list, then click Modify.
  5. In the Enter Path dialog box, make the change to the path or pattern, then click OK.

  6. To save changes, click OK.

Delete Global Filters

To delete an exclusion from the Global Filters window:

  1. From the CommCell Console ribbon, click Home and then click Control Panel.
  2. Under the Configure section, click Global Filters.
  3. Select the appropriate category (agent type) from the Global Filters Category list.
  4. Select an exclusion entry in the Exclude Global Filters list, then click Delete.
  5. To save changes, click OK.

Enable Global Filters from a Master CommCell

If your CommCell is registered with a another CommCell, your CommCell can inherit Windows and UNIX global filters from that CommCell if the SetGlobalFilteronCommCell workflow is run on that "master" CommCell. For information on registering a CommCell, see Registering a Remote CommCell.

Before You Begin

Run the SetGlobalFilteronCommCell workflow on the master CommCell. The master CommCell is the CommCell other CommCells are registered with.

Procedure

  1. From the CommCell Console ribbon, click Home and then click Control Panel.
  2. Under Data, click Global Filters.
  3. The inherited global filters are visible in the Master CommCell Global Filter list.

    Important: The Master CommCell Global Filter list is only populated when the SetGlobalFilteronCommCell workflow is run on the master CommCell.

  4. To apply inherited global filters, select Use Global Filters from Master CommCell.

    The master CommCell global filters are applied to Windows and UNIX category (agent type).

  5. To save changes, click OK.

Wildcards for Windows File Systems

The following wildcards can be used to filter content for Windows file systems:

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.

Wildcards for Unix, Linux, and Macintosh File Systems

The following wildcards can be used to filter content for Unix, Linux, and Macintosh file systems:

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 will filter all files with the extension .doc (e.g., status.doc, mission.doc) on all partitions on the client computer.

/Test/*.doc will  filter all .doc files only in the /Test directory

a*.so will  filter all files with the extension .so (e.g., alsvc.so, advdcc.so) on the client computer which have the name beginning with "a".

/Finance/Test/* will  filter all the files and directories in the "Test" directory under the "Finance" directory on the / partition. Any sub-directories under the Test directory will 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? will  filter 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 will not get backed up because the last two characters in the name are variable.

/Class/report? will  filter any directory or file under /Class directory for which the character in the place of ? is variable. For example: /Class/report1 and /Class/report2 will get backed up. However, /Class/report15 will not get backed up.

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

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

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

/Department-[A-CS] will  filter 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 would filter all .doc files in the /root directory that start with a letter other than A, E, I, O, or U.
** Any number of characters across any number of path levels. /**/move.cpp - the file named move.cpp located at any directory level. (e.g., /root/newapp/move.cpp/opt/kde3/src/move.cpp)

/etc/** - will  filter all directories and files under /etc. All the sub-directories under these directories will also be included.

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 doesn’t start with /, then /**/ will be prefixed to the content to match at any level. E.g., *.doc will be /**/*.doc

If user wants to treat *, ?, [ ] as literals in the subclient content and not as wildcards, then the user can escape the wildcard by adding ‘\’ before the wildcard. E.g., /Report\[2011-2012\]/*.doc  filters all the .doc files under /Report[2011-2012]

More than one type of wildcard can be used when specifying subclient content (e.g., /Dcvol?/oracle[1-47]/**/*.log).

Wildcards for Exchange Mailbox Folders

You can use the following wildcards to filter Exchange Mailbox folders:

Wildcards

The supported wildcards include:

Wildcards Description
* Any number of any characters. For example:

*.doc -  any file name with the extension ".doc" (e.g., status.doc, mission.doc)

a*.dll - any file name that begins with "a" and has the extension .dll (e.g., alsvc.dll, advdcc.dll)

? Any one character. For example:

access? - any file name that begins with- "access" followed by any one character (e.g., access1, access5).

[ ] Any range of characters. For example:

[ei]nsure.doc - any file name that ends with "nsure.doc" and begins either "e" or "i". (e.g., ensure.doc, insure.doc)

[a-m].doc - any file name that ends with ".doc" and begins with the letters "a" through "m" inclusive.

[! ] The negation of a range of characters. For example:

[!ei]nsure.doc - any file name that ends with "nsure.doc", but does not begin with "e" or "i". (e.g., unsure.doc)

Wildcards and Filter Patterns for NAS Agents

Some, but not all NAS vendors support filters. Also, each supported vendor has different guidelines for formatting filters. When adding a filter that will be applied across different NAS vendors, the filter must be valid for each NAS vendor.

For more information about supported NAS vendors and vendor specific guidelines for filter patterns, see the Filter Guidelines section under Configuring Filters for Backups.

Recommended Filters

To see a list of filters recommended by various software vendors, see Content, Filters and Regular Expressions (Best Practices).