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

Teradata® DSA - DSU Installation, Configuration, and Upgrade Guide

Product
BAR
Data Stream Architecture
Data Stream Utility
Release Number
17.00
Release Date
August 2020
Content Type
Configuration
Installation
Publication ID
B035-3153-129K
Language
English (United States)
Prerequisite DSC, DSAPostAMQ, ClientHandler, BARCmdline, and BARPortlets must be on the same version.
Important:

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

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 each database node. They serve as the media servers.

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

base_dir/teradata/client/version/dsa

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 16.20.00.02 or earlier to DSA 16.20.00.03 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.
  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.
  10. If you have problems, run the configure script:
    clienthandlerConfigure.sh
Postrequisite
Install the access module for the backup solutions or targets you plan to use: