Tivoli Header

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

Exclude Options

System Administrator

The exclude options exclude objects from backup or archive services. For example, you might want to exclude all temporary files, any local caches of network files, all files that contain compiled object code that you can easily reproduce using other methods, or your operating system files.

Notes:

  1. With the exception of exclude.fs, when you exclude a file that was previously included, existing backup versions become inactive during the next incremental backup.

  2. The server can define exclude options with the inclexcl option.

Exclude any system files that could corrupt the operating system when recovered. You should also exclude the client directory containing the client files.

Use wildcard characters to exclude a broad range of files. See "Including and Excluding Groups of Files" for a list of wildcard characters that you can use. Then, if necessary, use the include option to make exceptions.

To exclude an entire directory called any:test, enter the following:

  exclude.dir any:test

To exclude subdirectories that begin with test under the any directory, enter the following:

  exclude.dir any:test*

Attention: See "Excluding System Files" for a list of files that you should always exclude.

Compression Processing

If you want to exclude specific files or groups of files from compression processing during a backup or archive operation, consider the following:

Preferences File

Place these options in the TSM System Preferences file.

Syntax

>>-options pattern---------------------------------------------><
 
 

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.archive
Excludes a file or a group of files that match the pattern from archive services only.

exclude.compression
Excludes files from compression processing if the compression option is set to yes. This option applies to backups and archives.

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

Parameters

pattern
Specifies the file or group of files that you want to exclude. End the pattern with a file specification.

If the pattern begins with a single or double quote or contains any embedded blanks or equal signs, you must surround the value in either single (') or double (") quotation marks. The opening and closing quotation marks must be the same type of quotation marks.

Examples

TSM System Preferences:
exclude ...:DeskTop
exclude HFS+:svt1:testdir:...:*
exclude.archive "HFS+:svt1:testdir:...:*"
exclude.fs HFS+:svt1:testdir:...:*
exclude.backup HFS+:svt1:testdir:...:*
exclude.dir HFS+:svt1:testdir:...:*
exclude.file HFS+:svt1:testdir:...:*
exclude.compression home:jones:proj1:file.txt


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