Configuration under Linux

After an initial installation of the IBM Storage Protect software, the software should be configured accordingly. Please follow the steps below.

Edit the file /opt/tivoli/tsm/client/ba/bin/dsm.sys with root user rights and enter your node name. The node name is the computer name assigned to you by the ITS.

The include-exclude file contains information about the directories or files to be backed up. The following terms are important here:

• Exclude:
  Use the exclude option to specify which directories (or files) are to be excluded from the data backup.
• Include:
  Use the include option to specify the directories (or files) to be backed up.

Please try to use these options as sensibly as possible in order to really only back up changeable data and not system files and programs. Enter the directories in which you have saved your own files and exclude everything else.

The include-exclude file prepared by the ITS contains the options specified in the following example. If these do not apply to your file systems and data, you should definitely change them.

exclude /.../*

include /etc/.../*

include /home/.../*

exclude /.../*cache/.../*

Here '...' stands for all directories and subdirectories, '*' stands for any character or all files.

Please note that the software always processes the include/exclude options from bottom to top (bottom-up).

ISP or TSM takes every file in your file systems and looks in the include-exclude file to see whether it should be saved or not.

In the example, the first option to be compared is exclude /.../*cache/.../*. If the respective file is not in a cache directory or e.g. xover-cache or similar, it is compared with the next option. In the example, this would be include /home/.../*: If the file is in any home directory, it is saved, if not, it is compared with the next option include /etc/.../*: If the file is under /etc/, it is now backed up, if not, it is compared with the next and in our example last option exclude/.../*: Here it is ultimately excluded from the backup if an include did not previously apply to it.

Then contact the backup server once by issuing the command dsmc or dsmj (Java GUI), e.g:

dsmc query file

You will now be asked to enter the name of the client (node name) and the corresponding password (see login form). Press quit to return to command level.

If you have any problems with the setup, please read our FAQs or the manufacturer's online documentation.

If you have already installed a version of the ISP (or TSM) client and saved the configuration files, you only need to copy them back.