Install the ClientHandler Package | Teradata DSA | DSE | DSU - Installing the ClientHandler Package - BAR - Data Stream Architecture

Teradata® DSA Quick Start Guide

Data Stream Architecture
Release Number
October 2021
English (United States)
Last Update
Product Category
Teradata Tools and Utilities
Install the ClientHandler package on the DSC server.

You can specify the base directory (base_dir) for the ClientHandler installation. It is installed here:


Do not use / or /usr as the installation directory. The permissions for the specified directory are modified so that the service user can access the directory.
  1. On the DSC server, verify that the DSC is up and running.
    /etc/init.d/dsc status
  2. On the ClientHandler server, extract the script rpm file:
    tar zxvf ClientHandler_slesxx_arch.xx.xx.xx.xx-######.tar.gz
    A directory with the format ClientHandler.xx.xx.xx.xx is extracted in the current working directory.
  3. Change to the ClientHandler.xx.xx.xx.xx directory.
  4. Run the installation script.
    ./ -r ClientHandler-xx.xx.xx.xx-######.rpm
  5. Enter values for ClientHandler.
    ClientHandler Prompts Description and Default Values
    Enter the base directory base_dir/teradata/client/version/dsa
    ActiveMQ Broker Host Name and Port Hostname or IP address of the machine running the ActiveMQ broker and port number on the server where the ActiveMQ broker is listening (61616 for tcp, 61617 for ssl). Default: 61616

    Usually the DSC server, the format is: hostname:port, for example dsc1:61616

    You can enter multiple hostnames and ports. Press Enter when done to continue.

    ActiveMQ Connection Type of ActiveMQ connection (tcp or ssl). If tcp is chosen, the ActiveMQ connection is validated during install. If ssl is chosen, the ActiveMQ (jms ssl) password should match the DSA REST API https password. Default: tcp
    Filepath of SSL truststore If you are using SSL, enter filepath of the SSL truststore file. Default: none
    Filepath of SSL keystore If you are using SSL, enter filepath of the SSL keystore file. Default: none
    SSL Keystore Password If you are using SSL, enter the value for the client's keystore password in clear text. Default: none

    If you set DSARest web services to https, the SSL Keystore password must match the DSARest keystore password.

    Server ID Unique Server ID for this ClientHandler. The hostname of the server is recommended. Default: hostname
    Is Master Server? Indicates whether this server is the CBB web service master server used in incremental job communication.
    All media servers defined in the target group for a Changed Block Backup (CBB) restore job must have the same web service master server, or the restore job will fail.
    CBB File Path The web service master uses this path, which is a shared directory required for Change Block Backup (CBB) temporary file storage during restore operations. Default: /var/opt/teradata/dsa/cbb
    Master Server's Hostname The hostname of the CBB web service master server used in incremental job communication. This prompt appears only if you respond No to the "Is Master Server?" prompt.
  6. Log off and log back in to the DSC to set the Linux environment variables.
  7. Verify ClientHandler is running:
    /etc/init.d/clienthandler status
  8. If necessary, repeat these steps for each ClientHandler server.
  9. If you have problems, run the configure script: