You can create an include-exclude list to exclude a specific file or groups of files from backup services, and to assign specific management classes to files. TSM backs up any file that is not explicitly excluded. TSM client folders should be excluded from backup services.
To create an include-exclude list, you can use the TSM preference editor as follows:
You can also create an include-exclude list by selecting Utilities> Setup Assistant from the TSM GUI.
You can also create an include-exclude list, by performing the following steps:
Table 6 provides brief descriptions of the include and
exclude options that you can specify in your Preferences
file. See table references for more information about each
option.
Table 6. Include-Exclude Options
Option | Description | Page |
---|---|---|
exclude | Excludes a file or group of files from backup services. Any file in your client domain that is not specifically excluded with this option is considered for backup. | Exclude Options |
exclude.archive | Excludes a file or group of files from archive services. | Exclude Options |
exclude.backup | Excludes a file or a group of files from backup services only. | Exclude Options |
exclude.dir | Locates matching directory names. If a matching directory is found, that directory, its files, and all its subdirectories and their files are excluded from backup services. | Exclude Options |
exclude.file | Excludes files, but not directories, that match a pattern. | Exclude Options |
exclude.file.backup | Excludes a file from normal backup services. | Exclude Options |
include | Includes files or management classes for backup or archive processing. | Include Options |
include.file | Includes a file for backup services, or assigns a management class to a file. | Include Options |
We recommend that you have the following minimum include-exclude list in your Preferences file:
exclude "...:Desktop DB" exclude "...:Desktop DF" exclude "...:Desktop" exclude "...:Trash:...:*" exclude "...:VM Storage" exclude "...:Norton FileSaver Data" exclude "...:Norton VolumeSaver Data" exclude "...:Norton VolumeSaver Index"
These are system files that cannot be recovered without possibly corrupting the operating system.
To specify groups of files that you want to include or exclude, use the
wildcard characters listed in Table 7. This table applies to include and
exclude statements only. For information about
using wildcard characters in a file specification, see Using Wildcard Characters.
Table 7. Wildcard and Other Special Characters
Character | Function | ||
---|---|---|---|
? | The match-one character matches any single character except
the folder separator; it does not match the end of the string. You
cannot use the match-all character (or any wildcard character) when specifying
the high-level qualifier of an object, only use it for the low-level
qualifier. (See Matchonechar). For example:
| ||
* | The match-all character. You cannot use the match-all character
(or any wildcard character) when specifying the high-level qualifier of an
object, only use it for the low-level qualifier. For example:
| ||
...: |
Matches all volumes or folders. For example: ...:...:* matches any file in any folder on any volume. The first group specifies the volume and the second group specifies the folder.
| ||
: |
The volume or folder separator. It limits the scope of search for
matching all characters and matching all volumes.
| ||
[ | The open character-class character begins the enumeration of a character
class. For example:
xxx[abc] matches xxxa, xxxb, or xxxc. | ||
- | The character-class range includes characters from the first character to
the last character specified. For example:
xxx[a-z] matches xxxa, xxxb, xxxc, ... xxxz.
| ||
\ | The literal escape character. When used within a character class, it treats the next character literally. When used outside of a character class, it is not specially treated. | ||
] | The close character-class character ends the enumeration of a character class. |
Table 8 contains examples of ways you might use wildcard characters with
include and exclude patterns.
Table 8. Using Wildcard Characters with Include and Exclude Patterns
Task | Pattern |
---|---|
Exclude all files that end with doc, except those found on volume La Pomme in the Documents folder. |
exclude "...:...:*doc" include "La Pomme:Documents:*doc" |
Exclude all files and folders under any Documents folder that might exist, except for the file, La Pomme:Documents:Current Resume. Include this file. |
exclude "...:...:Documents:...:*" include "La Pomme:Documents: Current Resume" |
Exclude any .cpp file in any folder on the Vol1, Vol2, Vol3, and Vol4 volumes. |
exclude "Vol[1-4]:...:*.cpp" |
Exclude the .cpp files found in the root folder of the Vol2 volume. |
exclude "Vol2:*.cpp" |
Exclude any file found on any volume that resides under the Development folder. |
exclude "...:Development:...:*" |
Include-exclude options can be defined on the server using the inclexcl parameter. The include-exclude statements specified by the server are evaluated along with those in the Preferences file. The server include-exclude statements are always enforced and placed at the bottom of the include-exclude list and evaluated before the client include-exclude statements. TSM processes the include-exclude list from the bottom up, and stops when it finds an include or exclude statement that matches the file it is processing. The order in which the include and exclude options are listed therefore affects which files are included and excluded. See Chapter 8, "Setting Common Options" for more information about the order in which all options are processed.
The TSM client program processes the include and exclude options as follows:
If a match is found, the processing stops and checks whether the option is include or exclude. If the option is include, the file is backed up. If the option is exclude, the file is not backed up.
The following examples demonstrate bottom up processing.
exclude "...:*.cpp" include "La Pomme:Foo:...:*.cpp" exclude "La Pomme:Foo:Junk:*.cpp"
The current file being processed is La Pomme:Foo:Dev:test.cpp. The processing follows these steps:
exclude "...:*.cpp" include "La Pomme:Foo:...:*.cpp" exclude "La Pomme:Foo:Junk:*.cpp"
The current file being processed is La Pomme:Widget:Sample File. The processing follows these steps:
exclude "...:...:*.cpp" include "La Pomme:Foo:...:*.cpp" exclude "La Pomme:Foo:Junk:*.cpp"
The current file being processed is La Pomme:Lib:Src:Module1.cpp. The processing follows these steps: