Creating a default client-user options file

A client-user options file stores the backup-archive client processing options. The backup-archive installation program places a sample client-user options file on disk when you install the backup-archive client. A system administrator or root can edit this file to create a default client options file, and makes the file accessible to workstation users who use the backup-archive client. Individual users can create and use their own client options file.

Before you begin

You must be root or a system administrator to complete this procedure.

About this task

Creating a default client-user options file is an optional task.

By default, the client-user options file is named dsm.opt, and the file contains the following types of client options:

Backup and archive processing options
Restore and retrieve processing options
Scheduling options
Format options
Command processing options
Authorization options
Error processing options
Transaction processing option
Web client options

For Mac clients, the client installation program places a sample client-user options file named dsm.opt.smp in /Libraries/Preferences/Tivoli Storage Manager/. This directory is the same directory that the installation program places a sample client-system option file (dsm.sys.smp) in.

For AIX®, HP-UX, and Linux clients, the client installation program places a sample client-user options file named dsm.opt.smp in the default client installation directory. This directory is the same directory that the installation program places a sample client-system option file (dsm.sys.smp) in.

For Oracle Solaris clients, the installation program places an initial client-user options file named dsm.opt in the /usr/bin directory. This directory is the same directory that the installation program places a sample client-system option (dsm.sys) file in.

For all client operating systems, the following procedure instructs you to edit the sample client-user options file and save it with the default name, dsm.opt. You can save the file with a different name or path, if you want to, but if you change the file name or if you move the file from the default installation directory, you must use either of the following methods to specify the path and name of the client-user options file:

Set the DSM_CONFIG environment variable to indicate the path and file name of the client-user option file (dsm.opt). Set the DSM_DIR environment variable to indicate the path and file name of the client-system option file (dsm.sys). For more information about the environment variables, see Set processing environment variables.
Specify the backup-archive client optfile option to specify the path and file name of the client-user options file.
Note: All node users must have read access to the disk location where you store the client-user options file.

Procedure

Change to the directory that contains the sample client-user options file.
Copy the file to dsm.opt.
Add options for your node to the dsm.opt file. Use either of the following methods to set the client-user options:
- Edit dsm.opt with a text editor to add the options that are needed in the node.
  Note: On Mac OS X, the dsm.opt file must be saved as a plain text file and use Unicode (UTF-8) as the encoding scheme. By default, TextEdit does not save files as plain text. To save dsm.opt, in TextEdit, select Format > Make Plain Text. In the Plain Text Encoding drop-down list, select Unicode (UTF-8). Do not add the .txt extension to the file name.
- Set client options by using the preferences editior. In the backup-archive client GUI, select Edit > Client Preferences and select the options that you want to configure. The preferences editor updates the client configuration files, dsm.opt, and dsm.sys if you add, change, or remove options. If you update the dsm.opt file while the backup-archive client is running, you must restart the backup-archive client so the updates are recognized.
  The preferences editor uses the DSM_DIR environment variable to locate the client-system options file (dsm.sys) and the DSM_CONFIG environment variable to locate the client user-options file (dsm.opt). If you want dsm.opt to be in a non-default location, set DSM_CONFIG before you start backup-archive client and then use the preferences editor to set the options. The preferences editor queries the server for options on the server, but cannot change the server options file.