Creating and modifying the client system-options file
The client system-options file is an editable file that identifies the server and communication method, and provides the configuration for backup, archiving, hierarchical storage management, and scheduling.
About this task
Creating and modifying the client system-options file (dsm.sys) is a required task.
The backup-archive client GUI provides a Configuration Wizard that can be used to create basic configuration files and test the connection to the IBM Spectrum Protect server. The Configuration Wizard starts automatically if the configuration files are not found when the GUI starts. If you want to modify the configuration files after they are created, click on Setup Wizard from the Tools menu of the GUI.
If you do not use the Configuration Wizard, you can create and modify the client options file manually.
For Mac OS X, copy the dsm.sys.smp file to dsm.sys in one of the following locations. The default locations are listed in the order that they are searched.
- A location identified by the DSM_DIR environment variable
/Library/Application Support/tivoli/tsm/client/ba/bin/
/Library/Preferences/Tivoli Storage Manager/
The client uses the first options file that is found. You must use the name dsm.sys for this file. The dsm.sys file is controlled by the system administrator.
For Oracle Solaris systems, copying dsm.sys.smp to dsm.sys is not required. The client options files (dsm.opt and dsm.sys) are automatically created in /usr/bin, if they do not already exist, and they are linked to the client installation directory when you install the client. Note that the files are not removed if you uninstall the client, so you can reuse your settings if you upgrade or reinstall the client.
For the other platforms, as the root user, copy the dsm.sys.smp file to dsm.sys and then edit that file to configure your settings. The client looks for dsm.sys in the directory specified by the DSM_DIR environment variable (if it is set and exported), and then in the installation directory.
Use the dsm.sys file to specify one or more servers to contact for services, and communications options for each server. This file can also include authorization options, backup and archive processing options, and scheduling options.
Servername server_a
COMMMethod TCPip
TCPPort 1500
TCPServeraddress node.domain.company.com
As the default, your client node contacts the first server identified in the dsm.sys file. You can specify a different server to contact by entering the servername option in your own client user-options file (dsm.opt), or by entering that option with a command.
You can also specify a default server and a migration server (if you have the HSM client installed on your workstation) in your dsm.sys file.
The dsm.sys file can also contain the following option categories:
- Communication options
- Backup and archive processing options
- Restore and retrieve processing options
- Scheduling options
- Authorization options
- Error processing options
- Transaction processing option
- Web client options
You can modify your dsm.sys file using one of the following methods:
- From the client Java™ GUI main window, select .
- Use your favorite text editor.
If you update the dsm.sys file while the client is running, you must restart the process to pick up the changes.