![]() |
![]() |
This section provides the following:
Use Exclude.dir statements to exclude all files and
sub-directories in the specified directory from processing. Tivoli
Storage Manager evaluates all Exclude.dir statements
first, and removes the excluded directories and files from the list
of objects available for processing. The Exclude.dir
statements override all include statements that match the pattern.
Table 4. Option for Excluding Directories
Option | Description | Page |
---|---|---|
exclude.dir | Excludes a directory, its files, and all its subdirectories and their
files from backup processing. For example, exclude.dir
nw6\sys:test/dan/data1 excludes
nw6\sys:test/dan/data1, its files, and all its subdirectories
and their files.
However, you can still back up nw6\sys:test/dan/data1, its files, and all its subdirectories and their files using a selective backup, as follows: dsmc sel -subdir=yes nw6\sys:test/dan/data1/ 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 |
After Tivoli Storage Manager evaluates all 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 |
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 and Encryption 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 |
Encryption Processing | ||
exclude.encrypt | Excludes files from encryption processing. | Exclude Options |
include.encrypt | Includes files for encryption processing. | Include Options |
We recommend that you have the following minimum include-exclude list in your client options file (dsm.opt):
Log files:
SYS:VOL$LOG.ERR SYS:TTS$LOG.ERR SYS:SYSTEM\SYS$LOG.ERR SYS:SYSTEM\EVENTS.LOG SYS:SYSTEM\SECAUDIT.LOG SYS:SYSTEM\SYSTEM.LOGGeneral files that NetWare programs always accessed and that cannot be opened for reading:
SYS:SYSTEM\CMASTER.DBA SYS:SYSTEM\BTRIEVE.TRN SYS:SYSTEM\TSA\TSA$TEMP.*
These are system files that cannot be recovered without possibly corrupting the operating system. See Tivoli Storage Manager NetWare Backup and Recovery Guide to identify other files to exclude.
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 Tivoli Storage Manager commands, see Using Wildcard Characters.
Table 7. Wildcard and Other Special Characters
Character | Function |
---|---|
? | The match-one character matches any single character except
the directory separator; it does not match the end of the string.
For example:
|
* | The match-all character. For example:
|
\... | The match-n character matches zero or more directories. |
\ |
The directory separator character limits the scope of the search for the matching n characters and directories. If a pattern does not begin with a directory separator (or one does not follow the drive specification), a match-all directories is appended to the pattern. For example, these patterns are equivalent: sys:* sys:.../*Note that both characters (\) and (/) can be used as a directory delimiter. |
[ | 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 causes the next character to be treated literally. When used outside a character class, it is used as a directory separator. For example, if you wish to include the ']' in a character class, enter [.../]...]. The escape character removes the usual meaning of ']' as the close character-class character. This is also a server name delimiter when it is placed before a volume delimiter (:). For example: servername\volumename:/directoryname/file.name |
] | The close character-class character ends the enumeration of a character class. |
: | The volume separator character separates a file specification. The
characters before the colon identify a volume name. The
characters after the colon identify either a directory name or a
file name. For example:
volumename:/directoryname/file.nam |
Tivoli Storage Manager accepts the exclude.dir option which can be used to exclude directory entries. However, include and exclude.dir cannot be used together. For example, the following statements will not produce the desired results:
exclude.dir nds:.o=adsm include nds:.o=adsm.ou=tucson.*
You must code the following statements to include only the objects in the .o=adsm.ou=tucson branch of the NDS:
exclude nds:.o=adsm include nds:.o=adsm.ou=tucson.*
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 with an extension of .bak, except those found on servera in the one:/dev directory. |
exclude servera\*:.../*.bak include servera\one:dev/*.bak |
Exclude all files and directories under any tmp directory that might exist on servera, except for the file vol:/tmp/save.fil. Include this file. |
exclude servera\*:.../tmp/.../* include servera\vol:tmp/save.fil |
Exclude any .obj file in any directory on volumec, volumee, volumef, and volumeg. |
exclude servera\volume[ce-g]:/.../ *.obj |
Exclude the .obj files found in the root directory in the volumed drive only. |
exclude servera\volumed:*.obj |
Exclude any file that resides under the tmp directory found in any file space on any volume. |
exclude servera\*:tmp/.../* |
Exclude the servera\volumed:mydir/test1 directory and any files and subdirectories under it. |
exclude.dir servera\volumed:mydir/ test1 |
Exclude all directories under the mydir directory with names beginning with test. |
exclude.dir servera\volumed:mydir/ test* |
Exclude all directories directly under the mydir directory with names beginning with test, on any volume. |
exclude.dir servera\*:mydir/test* |