Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients

Modify your Include-Exclude Options File

You might want to keep certain files, such as system files or files that the HSM client creates and uses, on your local file system at all times. Or, you might want to include certain files for backup or migration. Set the statements in your include-exclude options file to exclude or include specific files from space management and assign specific management classes to these files. If you do not create an include-exclude options file, all files are considered for backup services and the default management class is used.

For AIX GPFS file systems only: Do not use the inclexcl option with the AIX GPFS failover environment. Unlike dsm.opt and dsm.sys files, include-exclude options files are not shared between different nodes of a failover group. Add the include-exclude list directly to the dsm.sys file, or verify that the include-exclude list files match on all nodes participating in the local failover group or node set.

For all other file systems: Use the inclexcl option in your dsm.sys file to specify the name of your include-exclude options file. You can create an include-exclude options file for each TSM server that your client node contacts for services. For example, if your dsm.sys file contains two stanzas with options for two servers, you can include an inclexcl option in each stanza. Each inclexcl option can point to a different include-exclude options file. The files that you create must reside in a directory to which all users on your workstation have read access.

Follow these rules when you use the options in Table 9 to include or exclude files from either backup or migration:


Table 9. Include and Exclude Statements

Option Description
exclude.backup Excludes a file from backup.
exclude.file.spacemgmt Excludes a file from HSM services only. Use this option when you have both the backup-archive client and the HSM client installed.
exclude.spacemgmt Excludes files and directories from HSM backup only. Use this option when you have both the backup-archive client and the HSM client installed.
include Includes files for backup.
include.file Includes a file for backup.

The following example displays a sample include-exclude options file:

   exclude /.../core
   include /home/.../*  personal_files
   include /home/davehil/dsnew/.../*
   include /home/davehil/driver5/.../*  source_code
   exclude.spacemgmt /home/jones/proj1/status/.../*
   exclude /home/root/cron.log

In the sample include-exclude options file, personal_files and source_code identify management classes that are assigned to specific files. If you do not assign a management class to your files, the default management class is used.

Include-exclude options are processed from the bottom up. For example, when you build a migration candidates list for a file system, and the files that you included in that list migrate, each file is tested against the options in the include-exclude options file beginning with the last option that you specified and working up. If a match is found, it does not test the file against any additional options. It either excludes or includes the file as the option specifies. If a match is not found, the file is implicitly included for space management and backup services.

If you exclude a file from space management after it migrates to storage, it remains migrated until it is automatically or selectively recalled. After it is recalled, it is no longer eligible for migration. To prevent a file migrating to storage from a local file system, assign the file to a management class without automatic or selective migration.

Create an Include-Exclude List

To create an include-exclude list from the graphical user interface:

  1. Determine your include and exclude requirements.
  2. Select the Utilities menu> Setup Wizard.
  3. Check the Help me configure the TSM Backup Archive Client box.
  4. Select Update my options file.
  5. Click Next several times until the Domain and include/exclude lists screen displays.
  6. Edit your include-exclude list.

To create an include-exclude list from the command line:

  1. Determine your include and exclude requirements.
  2. Create a file. Store your file in any directory to which all users on your workstation have read access.
  3. Enter your include and exclude statements.
  4. Enter the inclexcl option and the name of your include-exclude options file in your dsm.sys file.


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