Exclude options

Note: Image files do not apply to Mac OS X operating systems.

For example, you might want to exclude this type of information:

• All temporary files
• Any local caches of network files
• All files that contain compiled object code that you can easily reproduce using other methods
• Your operating system files

For example, you might want to exclude this type of information:

• All temporary files
• Any local caches of network files
• All files that contain compiled object code that you can easily reproduce using other methods
• 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.

Exclude any system files or images that could corrupt the operating system when recovered. Also exclude the directory containing the Tivoli® Storage Manager client files.

To exclude an entire directory called /any/test, enter the following:

To exclude an entire directory called any\test, enter the following:

  exclude.dir /any/test

  exclude.dir c:\any\test

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

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

  exclude.dir /any/test*

  exclude.dir c:\any\test*

Note: Defining an exclude statement without using a drive letter, such as exclude.dir code, excludes the code directory on any drive from processing.

Supported Clients

This option is valid for all clients.

Options File

Place this option in the dsm.sys file within a server stanza. You can set these options on the Include-Exclude tab, Define Include-Exclude Options section of the Preferences editor.

Place these options in the client options file (dsm.opt). You can set these options on the Include-Exclude tab, Define Include-Exclude Options section of the Preferences editor.

exclude, exclude.backup, exclude.file, exclude.file.backup

Use these options to exclude a file or group of files from backup services.

exclude, exclude.backup, exclude.file, exclude.file.backup

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.attribute.symlink

Excludes a file or a group of files that are symbolic links or aliases (aliases apply to Mac OS X) from backup processing only.

Note: For Mac OS X aliases are excluded.

exclude.compression

Excludes files from compression processing if the compression option is set to yes. This option applies to backups and archives.

exclude.dedup

Excludes files from client-side data deduplication. To control a client-side data deduplication operation, specify ieobjtype as the value of the exclude.dedup option.

Valid ieobjtype parameters are:

• File
• Image
• SYSTEMState
• Asr

The default is File.

exclude.dir

Excludes a directory, its files, and all its subdirectories and their files from backup processing. For example, the statement exclude.dir /test/dan/data1 excludes the /test/dan/data1 directory, its files, and all its subdirectories and their files.

If you exclude a directory that was previously included, Tivoli Storage Manager expires existing backup versions of the files and directories beneath it during the next incremental backup. Use this option to exclude a portion of your data that has no underlying files to back up.

Note: Avoid performing a selective backup of an individual file within an excluded directory. The next time that you perform an incremental backup, any files backed up in this manner is expired.

exclude.dir

Excludes a directory, its files, and all its subdirectories and their files from backup processing. For example, the statement exclude.dir c:\test\dan\data1 excludes the c:\test\dan\data1 directory, its files, and all its subdirectories and their files.

If you exclude a directory that was previously included, Tivoli Storage Manager expires existing backup versions of the files and directories beneath it during the next incremental backup. Use this option to exclude a portion of your data that has no underlying files to back up.

Note: Avoid performing a selective backup of an individual file within an excluded directory. The next time that you perform an incremental backup, any files backed up in this manner is expired.

Note: Defining an exclude statement without using a drive letter, such as exclude.dir code, excludes the code directory on any drive from processing.

exclude.encrypt

Excludes the specified files from encryption processing. This option does not affect whether files are excluded from backup or archive processing, only whether they are excluded from encryption processing.

exclude.fs

Excludes file systems that match the specified pattern from backup, incremental image backup, and archive operations. If files from the excluded file systems were ever backed up, then management class rebinding and deleted file expiration does not occur. However, existing backup versions remain on the server subject to associated management class settings. The files that were previously archived from the excluded file system remain on the server as archive copies.

The exclude.fs option does NOT prevent the backup or archive of any virtual mount points that are subdirectories of the excluded file system.

Use exclude.image to exclude file systems from full image backup operations.

exclude.fs.nas

Excludes file systems on the NAS file server from an image backup when used with the backup nas command. The NAS node name must be prefixed to the file system name, for example: netappsj1/vol/vol1. To apply the exclude to all NAS nodes, replace the NAS node name with a wildcard, for example: */vol/vol1. The backup nas command ignores all other exclude statements including exclude.fs and exclude.dir statements. This option is valid for AIX® and Solaris clients only.

exclude.fs.nas

Excludes file systems on the NAS file server from an image backup when used with the backup nas command. The NAS node name must be prefixed to the file system name, for example: netappsj1/vol/vol1. To apply the exclude to all NAS nodes, replace the NAS node name with a wildcard, for example: */vol/vol1. The backup nas command ignores all other exclude statements including exclude.dir statements. This option is valid for all Windows clients.

exclude.image

Excludes mounted file systems and raw logical volumes that match the specified pattern from full image backup operations. This option is valid for AIX, HP-UX, all Linux clients, and Solaris only. Use exclude.fs to exclude file systems from incremental image backup operations.

Restriction: This option does not apply to Mac OS X.

exclude.subfile

Excludes files from adaptive subfile backup processing. This option does not apply to archive processing.

exclude.systemservice

Excludes individual system services components from system state backup. Input can be the keyword or component name to be excluded from processing. If you specify the component name and there are spaces, enclose the name in quotation marks. Table 1 shows valid system services components and their corresponding keywords.

If you are specifying a component that is not listed in Table 1, you can specify the component name. This option is valid for Windows Server 2008 only.

Table 1. System services components and corresponding keywords

Component	Keyword
Background Intelligent Transfer Service	BITS
Event log	EVENTLOG
Removable Storage Management	RSM
Cluster Database	CLUSTERDB
Remote Storage Service	RSS
Terminal Server Licensing	TLS
Windows Management Instrumentation	WMI
Internet Information Services (IIS) metabase	IIS
DHCP database	DHCP
Wins database	WINSDB

Parameters

pattern

Specifies the file or group of files that you want to exclude.

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 node name 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.

pattern

Specifies the file or group of files that you want to exclude.

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 node name 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.