Tivoli Header

Tivoli Storage Manager for Macintosh Backup-Archive Client Installation and User's Guide

Using Include-Exclude Options

This section provides the following:

Excluding Directories

Use Exclude.fs and Exclude.dir statements to exclude all files and sub-directories in the specified directory from processing. Tivoli Storage Manager evaluates all Exclude.fs and Exclude.dir statements first, and removes the excluded file spaces, directories, and files from the list of objects available for processing. The Exclude.fs and Exclude.dir statements override all include statements that match the pattern.

Table 4. Options for Excluding File Spaces and Directories

Option Description Page
exclude.fs Excludes file spaces matching the pattern. The client does not consider the specified file space for processing and the usual deleted-file expiration process cannot occur. If you exclude a file space that was previously included, existing backup versions remain on the server subject to retention rules specified in the associated management class definition. See Exclude Options for more information. Exclude Options
exclude.dir Excludes a directory, its files, and all its subdirectories and their files from backup processing. For example, exclude.dir test:dan:data1 excludes test:dan:data1, its files, and all its subdirectories and their files.

However, you can still back up test:dan:data1, its files, and all its subdirectories and their files using a selective backup.

However, the next time you perform an incremental backup, these backup versions are expired. If you exclude a directory that was previously included, Tivoli Storage Manager marks existing backup versions of the files and directories beneath it inactive during the next incremental backup. Use this option to exclude a portion of your data in which no underlying files need to be backed up. The Tivoli Storage Manager Client API does not support this option.

Exclude Options

Controlling Backup and Archive Processing

After Tivoli Storage Manager evaluates all exclude.fs and exclude.dir statements, the following options are evaluated against the remaining list of objects available for processing.

If you exclude an object that was previously included, Tivoli Storage Manager marks existing backup versions inactive during the next incremental backup.

Table 5. Options for Controlling Backup and Archive Processing

Option Description Page
Backup Processing
exclude
exclude.backup
exclude.file
exclude.file.backup
These options are equivalent. Use these options to exclude a file or group of files from backup services. Exclude Options
include
include.backup
include.file
These options are equivalent. Use these options to include files or assign management classes for backup processing. Include Options
Archive Processing
exclude.archive Excludes a file or group of files from archive services. Exclude Options
include
include.archive
These options are equivalent. Use these options to include files or assign management classes for archive processing. Include Options

Controlling Compression Processing

After Tivoli Storage Manager evaluates Exclude.dir and any other include-exclude options controlling backup, archive, image, and system objects, it uses the following options to determine which files undergo compression, encryption, or subfile processing.

Table 6. Options for Controlling Compression Processing

Option Description Page
Compression Processing
exclude.compression Excludes files from compression processing if compression=yes is specified. This option applies to backups and archives. Exclude Options
include.compression Includes files for compression processing if compression=yes is specified. This option applies to backups and archives. Include Options

Excluding System Files

We recommend that you have the following minimum include-exclude list in your TSM System Preferences file:

Exclude ...:...:.DS_Store
Exclude ...:.TheInvisiblePropertyStore
Exclude ...:.vol
Exclude ...:DeskTop
Exclude ...:etc
Exclude ...:mach
Exclude ...:mach.sym
Exclude ...:mach_kernel
Exclude ...:OpenFolderListDF
Exclude ...:TheFindByContentIndex
Exclude ...:tmp
Exclude ...:var
Exclude ...:Wastebasket:...:*
Exclude "...:Desktop DB"
Exclude "...:Desktop DF"
Exclude "...:Norton FileSaver Data"
Exclude "...:Norton VolumeSaver Data"
Exclude "...:Norton VolumeSaver Index"
Exclude "...:VM Storage"
Exclude "...:...:TSM Sched*"
Exclude "...:...:TSM Error*"
Exclude.dir "...:System Folder:Preferences:netscape A:Cache A" 
Exclude.dir "...:System Folder:Preferences:Explorer:Temporary Files" 
Exclude.dir "...:Desktop Folder"
Exclude.dir "...:System Folder:Preferences:netscape users:...:Cache" 
Exclude.dir ...:.Trashes
Exclude.dir ...:System Folder:Preferences:cache-cache 
Exclude.dir ...:Trash
Exclude.dir ...:TheFindByContentFolder
Exclude.dir ...:TheVolumeSettingsFolder
Exclude.dir ...:Volumes
Exclude.dir ...:Network
Exclude.dir ...:Library:Caches
Exclude "...:Temporary Items"
Exclude "...:Private"
 

These are system files that cannot be recovered without possibly corrupting the operating system.

Including and Excluding Groups of Files

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

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. (See Matchonechar.) For example:
  • The pattern ab?, matches abc, but does not match ab, abab, or abzzz.
  • The pattern ab?rs, matches abfrs, but does not match abrs, or abllrs.
  • The pattern ab?ef?rs, matches abdefjrs, but does not match abefrs, abdefrs, or abefjrs.
  • The pattern ab??rs, matches abcdrs, abzzrs, but does not match abrs, abjrs, or abkkkrs.
* The match-all character. For example:
  • The pattern ab*, matches ab, abb, abxxx, but does not match a, b, aa, bb.
  • The pattern ab*rs, matches abrs, abtrs, abrsrs, but does not match ars, or aabrs, abrss.
  • The pattern ab*ef*rs, matches abefrs, abefghrs, but does not match abefr, abers.
  • The pattern abcd.*, matches abcd.c, abcd.txt, but does not match abcd, abcdc, or abcdtxt.
 ...: 

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.

Note:
This consists of three periods followed by a colon, not an ellipsis followed by a colon.
 : 

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.
Note:
For ASCII machines such as the Macintosh, characters represented by the hexadecimal codes of 61 (a) through 7A (z) will match. If the last character in the range is less than the first, only the first is used.
\ 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.

Examples Using Wildcards with Include and Exclude Patterns

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:...:*"
Exclude the HFS+:svt1:fs01 and HFS+:svt1:fs02 file systems from backup processing.
exclude.fs HFS+:svt1:*
exclude.fs HFS+:svt1:...:*


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]