Tivoli Header

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


Creating an Include-Exclude List (Optional)

Authorized User

This is an optional task but an important one. If you do not create an include-exclude list, Tivoli Storage Manager considers all files for backup services and uses the default management class for backup and archive services. For information on management classes and policy domains, see Chapter 8, Understanding Storage Management Policies.

You can create an include-exclude list to exclude a specific file or groups of files from backup services, and to assign specific management classes to files. Tivoli Storage Manager backs up any file that is not explicitly excluded. You should exclude Tivoli Storage Manager client directories from backup services. You can use the query inclexcl command to generate a list of the files that are currently being excluded from backup.

Specify the include-exclude list in your client system options file (dsm.sys). If you define more than one server in your dsm.sys file, each server must have its own include-exclude list. This list can also contain include-exclude statements obtained from the include-exclude files you specify with the inclexcl option.

Note:
For the AIX DFS client: Specify an include-exclude file with the dfsinclexcl option and then specify the include-exclude list in that file only. See Dfsinclexcl for more information.

When the client processes include-exclude statements, the include-exclude statements within the include-exclude file are placed at the position occupied by the inclexcl option in dsm.sys, in the same order, and processed accordingly.

See Inclexcl for detailed information about specifying an include-exclude file using the inclexcl option.

You can use one of the following methods to create an include-exclude list or specify an include-exclude file:

  1. From the client GUI, open the Edit menu and select Preferences. Then, in the Preferences dialog, click the Include/Exclude category.
  2. From the client GUI, open the Utilities menu and select Setup Wizard.

You can create an include-exclude list by performing the following steps:

  1. Determine your include and exclude requirements
  2. Locate the server stanza in your client system options file (dsm.sys)

    Note: Each server stanza must have its own include-exclude list.

  3. Enter your include and exclude statements using the appropriate include-exclude options as described in Using Include-Exclude Options. Because Tivoli Storage Manager processes your include-exclude list from the bottom of the list up, it is important to enter all your include-exclude statements in the proper order. For example, in the following include-exclude list the includefile.txt file is not backed up:
    include /home/usr/includefile.txt
    exclude /home/usr/.../*
    

    However, in the following include-exclude list the includefile.txt file is backed up:

    exclude /home/usr/.../*
    include /home/usr/includefile.txt
    
  4. If you wish, you can specify an include-exclude file using the inclexcl option. The file can be located in any directory to which all users on your workstation have read access. See Inclexcl for more information.
  5. Save the file and close it.
  6. Restart Tivoli Storage Manager client to enable your new client system options file (dsm.sys).


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