16.20 - Installing the ClientHandler Package - Data Stream Extensions

Teradata® DSA - DSE for Veritas NetBackup Installation, Configuration, and Upgrade Guide

Data Stream Architecture
Data Stream Extensions
September 2019
DSC, DSAPostAMQ, ClientHandler, BARCmdline, and BARPortlets must be on the same version.

Make sure the DSC is up and running before installing DSA Network Client (ClientHandler).

Beginning with DSA release 16.10, the BARNC [DSA Network Client (ClientHandler)] process queries the broker (ActiveMQ) for the existing DSC instances pointing to the broker. If the DSC is not running, autodiscovery fails.

Install the ClientHandler package on the hardware media 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. If you are upgrading from DSA or earlier to DSA or later, you must remove the installed AXM packages before reinstalling ClientHandler.
    1. Get a list of the installed packages: rpm -qa | grep AXM
    2. Remove each package: rpm -e nameofpackage
  2. On the DSC server, verify that the DSC is up and running. /etc/init.d/dsc status
  3. On the ClientHandler server, extract the script rpm file: tar zxvf ClientHandler_slesxx_arch.xx.xx.xx.xx-######.tar.gz

    where slesxx is the OS, arch is the architecture, xx.xx.xx.xx is the version number, and ###### is a unique number

    A directory with the format ClientHandler.xx.xx.xx.xx is extracted in the current working directory.
  4. Change to the ClientHandler.xx.xx.xx.xx directory.
  5. Run the installation script. ./clienthandler_install.sh -r ClientHandler-xx.xx.xx.xx-######.rpm
  6. Enter values for ClientHandler. For an upgrade, the previous settings are displayed and can be changed.
    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.
    Account for running ClientHandler Username to set up an account for running the DSA ClientHandler. Applicable to an install only, not an upgrade. Default: dscuser
    UserId Userid of the dscuser. The userid must be the same across all DSA components and servers in the environment. For DSU when using NFS mounted storage targets, this ID must match the anonuid configured in the NFS server.
  7. Log off and log back in to the DSC to set the Linux environment variables.
  8. Verify ClientHandler is running: /etc/init.d/clienthandler status
  9. If necessary, repeat these steps for each ClientHandler server.
Install the access module for the backup solutions or targets you plan to use: