Tivoli Header
Tivoli Storage Manager for Macintosh Backup-Archive Client Installation and User's Guide
The Tivoli Storage Manager server can define include-exclude options
using the inclexcl parameter in a client option set. The
include-exclude statements specified by the server are evaluated along with
those in the TSM System 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.
When performing an incremental backup, 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. See Excluding Directories and Exclude Options for more information about the
exclude.fs and exclude.dir
optionsoption.
- Note:
- Because directory branches excluded using the exclude.dir
option do not display in the GUI, setting this option prevents you from
performing either selective or incremental backups of data in the excluded
directories from the GUI. However, you can still perform selective
backups of such data from the command line.
After evaluating all exclude.fs and
exclude.dir statements, Tivoli Storage Manager evaluates 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 entered therefore affects which
files are included and excluded. See Using Processing Options for more information about the order in which all options
are processed.
The client program processes the include and exclude
options as follows:
- Folders are not checked; files are checked.
Therefore, if you have a volume (such as La Pomme) defined using
the domain option, all folders of that volume are backed up
regardless of what you defined for your include and
exclude options. This is the case even if the
files in those folders are not backed up.
- File names are compared to the include-exclude list from the
bottom up. When 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.
- If a match is not found, files listed are implicitly included
and backed up.
- If policy administration is in effect, files are backed up according to
the default management class, or the management class you specify on a
matching include option.
The following examples demonstrate bottom up processing.
- Example 1
- Assume that La Pomme is defined as the domain, and that you
defined the following statements for the include and
exclude options.
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:
- Rule 3 (the last include or exclude statement
defined) is checked first because of bottom up processing.
The file La Pomme:Foo:Junk:*.cpp
does not match the current file name being processed.
- Processing moves to Rule 2 and checks. This time, file La
Pomme:Foo:...:*.cpp
matches the current file name being processed. Processing stops, the
option is checked, and it is include.
- File La Pomme:Foo:Dev:test.cpp is
backed up.
- Example 2
- Assume that La Pomme is defined as the domain, and that you
defined the following statements for the include and
exclude options.
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:
- Rule 3 is checked and finds no match.
- Rule 2 is checked and finds no match.
- Rule 1 is checked and finds no match.
- Because a match is not found, file La Pomme:Widget:Sample
File is implicitly included and is backed up.
- Example 3
- Assume that La Pomme is defined as the domain, and that you
defined the following statements for the include and
exclude options.
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:
- Rule 3 is checked and finds no match.
- Rule 2 is checked and finds no match.
- Rule 1 is checked and a match is found.
- Processing stops, the option is checked, and it is
exclude.
- File La Pomme:Lib:Src:Module1.cpp is
not backed up.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]