Tivoli Header
Tivoli Storage Manager for UNIX Backup-Archive Clients Installation and User's Guide
Authorized User
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.
Notes:
- With the exception of exclude.fs, when you exclude
a file that was previously included, existing backup versions become inactive
during the next incremental backup.
- 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 /any/test
To exclude subdirectories that begin with test under the
any directory, enter the following:
exclude.dir /any/test*
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.fs,
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 /home/jones/proj1/*.*
exclude.compression /home/jones/proj1/file.txt
include /home/jones/proj1/file.txt
Tivoli Storage Manager examines the statements (reading from bottom to
top) and determines that /home/jones/proj1/file.txt is a
candidate for back up. Tivoli Storage Manager then examines the
exclude.compression /home/jones/proj1/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.
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 UNIX clients.
Options File
Place these options in the client system options file
dsm.sys.
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 and space management
services (if the HSM client is installed). The
exclude.backup option only excludes files from normal
backup, but not from HSM.
- 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
/test/dan/data1 excludes /test/dan/data1, its files, and all
its subdirectories and their files.
However, you can still back up /test/dan/data1, its files, and
all its subdirectories and their files using a selective backup, as
follows:
dsmc sel -subdir=yes /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.
- exclude.fs
- Excludes file spaces matching the pattern. The client does not
consider the specified file space for processing and the usual deleted-file
expiration process cannot occur. If you exclude a file space that was
previously included, existing backup versions remain on the server subject to
retention rules specified in the associated management class
definition.
- 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.fs and
exclude.dir statements. This option is for AIX, AIX
5L, and Solaris clients only.
- exclude.image
- Excludes mounted file systems and raw logical volumes that match the
pattern from image processing. This option is valid for AIX, AIX 5L,
HP-UX, Linux86, and Solaris only.
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 system options
file (dsm.sys) 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 mounted file system or raw logical volume.
Examples
- Options file:
-
exclude /unix/
exclude /.../core
exclude /home/jones/proj1/*
exclude.archive /.../core
exclude.backup /home/jones/proj1/devplan/
exclude.dir /home/jones/tmp
exclude.backup /users/home1/file1
exclude.image /usr/*/*
exclude.encrypt /users/home2/file1
exclude.compression /home/gordon/proj1/*
exclude.fs.nas netappsj/vol/vol0
- Command line:
- Does not apply.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]