Tivoli Header
Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide
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:
- When you exclude a file that was previously included, existing
backup versions become inactive during the next incremental
backup.
- The exclude statements are not case sensitive.
- 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.
If you want to exclude specific files or groups of files from compression
processing during a backup or archive operation, consider the following:
- You must set the compression option to yes to enable
compression processing. If you do not specify the
compression option or you set the compression option to
no, Tivoli Storage Manager does not perform compression
processing. See Compression for more information.
If you set the compression option to yes and no
exclude.compression statements exist, Tivoli Storage Manager
considers all files for compression processing.
- Tivoli Storage Manager processes exclude.dir and other
include-exclude statements first. Tivoli Storage Manager then considers
any exclude.compression statements. For example,
consider the following include-exclude list:
exclude c:\test\*.*
exclude.compression c:\test\file.txt
include c:\test\file.txt
Tivoli Storage Manager examines the statements (reading from bottom to
top) and determines that c:\test\file.txt is a
candidate for back up. Tivoli Storage Manager then examines the
exclude.compression c:\test\file.txt statement
and determines that it is not a candidate for compression processing.
- Include-exclude compression processing is valid for backup and archive
processing only.
- For Windows NT, 2000, XP, Windows.Net: As with other
include-exclude statements, you can use the inclexcl option to
specify a file which is in Unicode format which contains
exclude.compression statements specifying Unicode
files. See Inclexcl for more information.
If you want to exclude files from adaptive subfile backup processing using
the exclude.subfile option, consider the following:
- You must set the subfilebackup option to yes to
enable include-exclude adaptive subfile backup processing. If you do
not specify the subfilebackup option or you set the
subfilebackup option to no, Tivoli Storage Manager does
not perform adaptive subfile backup processing. See Subfilebackup for more information.
If you set the subfilebackup option to yes and no
exclude.subfile statements exist, Tivoli Storage Manager
considers all files for adaptive subfile backup processing.
- Tivoli Storage Manager processes exclude.dir and other
include-exclude statements first. Tivoli Storage Manager then considers
any exclude.subfile statements. For example, consider
the following include-exclude list:
exclude c:\test\*.*
exclude.subfile c:\test\file.txt
include c:\test\file.txt
Tivoli Storage Manager examines the statements (reading from bottom to
top) and determines that c:\test\file.txt is a
candidate for back up. Tivoli Storage Manager then examines the
exclude.subfile c:\test\file.txt statement and
determines that it is not a candidate for adaptive subfile backup
- Include-exclude adaptive subfile backup processing is valid for backup and
restore processing only.
- For Windows NT, 2000, XP, Windows.Net: As with other
include-exclude statements, you can specify exclude.subfile
statements in Unicode using the inclexcl option. See Inclexcl for more information.
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:
- NAS nodes represent a new node type. The NAS node name uniquely
identifies a NAS file server and its data to Tivoli Storage Manager.
You can 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 you specify applies to all NAS file
servers.
- Regardless of the client platform, NAS file system specifications use the
forward slash (/) separator, as in this example:
/vol/vol0.
- You cannot use wildcards with exclude.fs.nas and
include.fs.nas statements.
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 ]