Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Exclude Options

The exclude options exclude objects from backup, image, 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.

You can exclude remotely accessed files by specifying Universal Naming Convention (UNC) names in your exclude statement. See Excluding Files with UNC Names for examples of statements using UNC file names.

Notes:

  1. When you exclude a file that was previously included, existing backup versions become inactive during the next incremental backup.

  2. The exclude statements are not case sensitive.

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

Exclude any system files or images 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 c:\any\test

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

  exclude.dir c:\any\test*
Note:
If you define an exclude statement without using a drive letter, such as exclude.dir code, this will exclude the code directory on any drive from processing.

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:

Adaptive Subfile Backup Processing

If you want to exclude files from adaptive subfile backup processing using the exclude.subfile option, consider the following:

Processing NAS File Systems

Use the exclude.fs.nas option to exclude file systems from Network Attached Storage (NAS) image backup processing.

A NAS file system specification uses the following conventions:

For example, to exclude the /vol/vol1 file system of a NAS node called netappsj, specify the following exclude statement:

exclude.fs.nas netappsj/vol/vol1

To exclude /vol/vol1 from backup services on all NAS nodes, specify the following exclude statement:

exclude.fs.nas /vol/vol1

Supported Clients

This option is valid for all Windows clients.

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 c:\test\dan\data1 excludes c:\test\dan\data1, its files, and all its subdirectories and their files.

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

  dsmc sel -subdir=yes c:\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.

Note:
If you define an exclude statement without using a drive letter, such as exclude.dir code, this will exclude the code directory on any drive from processing.

exclude.encrypt
Excludes the specified files from encryption processing.

exclude.fs.nas
Excludes file systems on the NAS file server from an image backup when used with the backup nas command. If you do not specify a NAS node name, the file system identified applies to all NAS file servers. The backup nas command ignores all other exclude statements including exclude.dir statements. This option is for Windows NT, 2000, XP, and Windows.Net clients only.

exclude.image
Excludes mounted file systems and raw logical volumes that match the pattern from image processing. This option is valid for Windows 2000 only.

exclude.subfile
Excludes files from adaptive subfile backup processing. This option does not apply to archive processing. This option is valid for all Windows clients.

Parameters

pattern
Specifies the file or group of files that you want to exclude. End the pattern with a file specification.
Note:
For NAS file systems: You must prefix the NAS node name to the file specification to specify the file server to which the exclude statement applies. If you do not specify a NAS node name, the file system identified refers to the NAS nodename specified in the client options file (dsm.opt) or on the command line.

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.

For the exclude.image option, the pattern is the name of a file system or raw logical volume.

Examples

Options file:
exclude ?:\...\swapper.dat 
exclude "*:\ea data. sf" 
exclude ?:\io.sys 
exclude ?:\...\spart.par 
exclude c:\*\budget.fin 
exclude c:\devel\* 
exclude.dir c:\home\jodda 
exclude.archive c:\home\*.obj
exclude.encrypt c:\system32\mydocs\*
exclude.compression c:\test\file.txt
exclude.subfile c:\test\file.txt
exclude.fs.nas  netappsj/vol/vol0
exclude.image c:

Command line:
Does not apply.


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