Create a Diagnostic Bundle for Support | Teradata DSA | DSE | DSU - 17.05 - Creating a Diagnostic Bundle for Support - Data Stream Extensions

Teradata® DSA - DSE for IBM Spectrum Protect Installation, Configuration, and Upgrade Guide

prodname
BAR
Data Stream Architecture
Data Stream Extensions
vrm_release
17.05
created_date
September 2020
category
Configuration
Installation
featnum
B035-3155-090K
Teradata DSA provides a command-line, interactive script to collect:
  • Current time on the server
  • Component versions, for theSQL Engine / Teradata Database, DSC, DSA Network Client, Spectrum Protect, Viewpoint, BAR Command Line, ActiveMQ
  • General system configurations, such as the number of media servers, DSC server status
  • Property files and logs for the DSC component and the DSA Network Client (ClientHandler)
This information is useful for troubleshooting by Teradata Customer Support.
The dsa_support_info.sh script is installed in the root directory associated with a DSA installation package:
  • $DSA_DSC_ROOT on the DSC server
  • $CLIENTHANDLER_ROOT on a media server
  • $BARCMDLINE_ROOT on the command line server
  1. [Optional] To set up an SSH trust relationship between the DSC server and BAR servers or remote servers, run dsatrust.sh with the following syntax:
    dsatrust.sh [-a] [-l <hosts>] [-u user] [-v] [-h]
    Parameter Description
    -a Sets trusted relations between the DSC server and other BAR servers.
    -l hosts Sets trusted relations to the listed hosts.

    Host names must be separated by commas.

    -u user Specify login user name.

    You must use this parameter with the -a or -l parameter.

    -v Displays the script version.
    -h Displays help.
  2. Run dsa_support_info.sh on a server to collect local information, using the following syntax:
    dsa_support_info.sh [-c][-d <path>][g][-h][-i][-j <job>][-s <timestamp>][-t][-v][-x]
    Parameter Description
    -c Collects core dumps for the DSA Network Client (ClientHandler).
    -d path Specifies the dump directory path.

    Default: /var/opt/teradata/dsa/support/hostname_current timestamp

    -g Collects general support information.
    -h Displays help.
    -i Collects installation logs.
    -j job Collect job information. Enter the job name as job.
    -s timestamp Collects logs for the date and time specified in the timestamp.

    Specify the timestamp in the following format, for example, 2015-05-15 09:50.

    -t Triggers a TVI event.

    If the -t parameter has been used to trigger a TVI event, the data is zipped. If the 50 MB limit per TVI event is exceeded, the support bundle is split into multiple zip files, and a separate TVI event is triggered for each zip file.

    The zip files are copied to /var/opt/teradata/SupportBundle/. You can access the unzipped files in the dump directory specified by the -d parameter.

    -v Displays the script version.
    -x Bypasses all user prompts.
After the script runs, files specific to the local server are output and can include:
  • Component information in .out files
  • Job output xml and .out files
  • Log files
  • Property files
  • DSA Network Client (ClientHandler) core dumps
The output directory is /var/opt/teradata/dsa/support/hostname_current timestamp or a user-specified directory.