Tivoli Header

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

Exclude Options

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:

  1. 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.

  2. 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.

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:

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 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 ]