Tivoli Header

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

Exclude Options

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.

You can exclude specific files from encryption processing during a backup.

Notes:

  1. 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 nw2:\sys:any/test

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

  exclude.dir nw2:\sys:any/test*

Wildcards are not supported for the server name or volume name. If you do not specify a server name, Tivoli Storage Manager uses the local server name.

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:

Options File

Place these options in the client options file dsm.opt.

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 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.encrypt
Excludes the specified files from encryption processing.

Parameters

pattern
Specifies the file or group of files that you want to exclude. End the pattern with a file specification.
Note:
If you do not specify a server name, Tivoli Storage Manager uses the local server name.

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

Options file:
exclude servera\*:.../swapper.dat
exclude n1\*:io.sys
exclude tfr\*:.../spart.par
exclude nw2\sys:*/budget.fin
exclude nw6\sys:devel/*
exclude.archive servera*:/.../events.log
exclude.compression nw6\sys:devel/*
exclude.encrypt servera\*:.../gordon.dat
 

Command line:
Does not apply.


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