Customize Values Used in PUT Installation | Teradata DSA | DSE | DSU - 17.05 - Customizing Values Used in PUT Installation - BAR - Data Stream Architecture - 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
A dsainputs file, which includes the input values for all the DSA components being installed on that server, is required to install DSA components with PUT. Each DSA server needs its own dsainputs file, customized for that server. The values will vary from server to server.
  1. Create a dsainputs file under the /tmp directory on the system where the DSA packages will be installed.
    A dsainputs template is available in all DSA packages. The template for the DSC is a compilation of all inputs required for all the packages: dsacomp_tdput_template.
    Keep the dsainputs file in a secure location. The dsainputs file that is placed in /tmp cannot be used by subsequent installation or upgrade processes.
  2. Insert the parameters and values for the component you are installing. Values are specific for that server.
    For example: BURL=dsasrv1
    Important: You must add DSARESTSCHEME to the dsainputs file.
    Parameter Component Description
    BROKERLIST ClientHandler List of broker:port pairs separated by a comma. For example: dsasrv1:61616
    BURL DSC, ClientHandler, BAR Command Line Hostname or IP address of the machine running the JMS broker (ActiveMQ). Hostname or IP address of the machine running the ActiveMQ broker (where tdactivemq is installed), usually the DSC server.
    BPORT DSC, ClientHandler, BAR Command Line Port number on the server where the ActiveMQ broker is listening (61616 for tcp, 61617 for ssl). Default: 61616
    LANDINGZONE DSC /var/opt/teradata/dsa/postgres Default location for DSC repository backup files. Temporary location before replication to the target group.
    CONNECTION DSC, ClientHandler, BAR Command Line, BARPortlets 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
    DSCNAME DSC, BAR Command Line Unique name for the DSC server. Maximum of 22 characters: alphanumeric, "-", and ".".

    The first character of the name can be alphanumeric (a-z, A-Z, and 0-9) only.

    Important: DSCNAME must be specified for an upgrade or the repository restore from the previous version will fail. Analyze_read jobs may also fail.
    CBBFILEPATH ClientHandler The path needed for Change Block Backup temporary file storage: /var/opt/teradata/dsa/cbb
    POSTGRESSPASSWORD DSC Password for Postgres user.

    No space, ', or " allowed.

    BACKUPAPPCLIENTNAME AXMNetbackup The name of this media server. In NetBackup, this is the client name.
    ISMASTER ClientHandler Specify yes or no on whether this server is the Web Service master server used in incremental job communication.
    MASTERHOSTNAME ClientHandler Specify the host name of the Web Service master server used in incremental job communication.
    VIEWPOINTURL DSC Hostname or IP address of the Viewpoint server.
    VIEWPOINTPORT DSC Port number of the Viewpoint server.
    CAMPRIMARYURL DSC Hostname or IP address of primary CAM system, which enables alert messaging
    CAMPRIMARYPORT DSC CAM port number of primary CAM system. Default: 61616.

    [DSA 16.20.51 and later] CAM does not support SSL in this version. Port must be 61616.

    CAMCLUSTERENABLED DSC Flag for enabling CAM clustering
    CAMCLUSTERURL DSC Hostname or IP address of primary and failover CAM systems, which enable alert messaging
    CAMCLUSTERPORT DSC CAM port number for clustered environment. This has the same value as CAMPRIMARYPORT. Default: 61616.

    [DSA 16.20.51 and later] CAM does not support SSL in this version. Port must be 61616.

    DSARESTPORT DSC Port number for DSARest Web Service running on DSC server. Default: 9090.
    DSARESTSCHEME DSC DSARest Web Service scheme, http or https. Default: https.
    KEYSTOREPASS DSC Required if DSARESTSCHEME is https.

    Password for keystore. Minimum of 6 characters. No space, ', or " allowed.

    If JMS SSL is enabled, this password must match SSLKEYSTOREPASSWORD.

    BARPASSWORD DSC Password for the BAR user. Used for Create, Read, Update and Delete (CRUD) operations on BAR.

    No space, ', or " allowed.

    SERVERID ClientHandler The server ID is the name of a DSA media server, and is a unique logical name across a single DSA domain. It is defined using SQL 92 syntax and used as the selector for JMS message headers. If the ClientHandler package is installed on a TPA node, the server ID cannot be equal to the name of that system. It is not the ID for NetBackup or other third party servers.
    When upgrading a media server for multiple DSA Network Client (ClientHandler) instances, specify the server IDs in a comma-separated list, for example, server1,server2.
    SERVERPORT ClientHandler Port number for datapath traffic, corresponds to the server.port property in clienthandler.properties. Default: 15401.
    SSLTRUSTSTOREFILE ClientHandler Full file path for truststore file.
    SSLKEYSTOREFILE ClientHandler Full file path for keystore file.
    SSLKEYSTOREPASSWORD ClientHandler The value for the JMS SSL keystore password, in clear text.

    If DSARESTSCHEME is set to https, this value must match KEYSTOREPASS.

    SSLENCKEYSTOREPASSWORD ClientHandler The value for the JMS SSL keystore password, in clear text.

    If DSARESTSCHEME is set to https, this value must match KEYSTOREPASS.

    WSPORT ClientHandler Port number for ClientHandler Web Service traffic, corresponds to the WebService.port property in clienthandler.properties. Default: 15402.

    The following is an example of a DSC server dsainputs file:

    Important: DSCNAME must be specified for an upgrade or the repository restore from the previous version will fail. Analyze_read jobs may also fail.
    # DSC, Clienthandler, and BARCmdline AMQ Broker connection type ssl or tcp
    CONNECTION=tcp
    
    # DSC and BARCmdline shared fields
    DSCNAME=
    BURL=
    BPORT=61616
    
    # DSC dsainputs fields
    POSTGRESPASSWORD=
    BARPASSWORD=
    KEYSTOREPASS=
    DSARESTPORT=9090
    DSARESTSCHEME=https
    LANDINGZONE=/var/opt/teradata/dsa/postgres
    VIEWPOINTURL=viewpointurl
    VIEWPOINTPORT=80
    VIEWPOINTTYPE=http
    CAMCLUSTERENABLED=no
    CAMPRIMARYURL=viewpointurl
    CAMPRIMARYPORT=61616
    CAMCLUSTERURL=camurl
    CAMCLUSTERPORT=61616
    
    #BARCmdline only dsainputs
    BARCMDLINE_JAVA_HOME=
    
    # Clienthandler dsainputs fields
    BROKERLIST=
    SERVERID=
    SSLTRUSTSTOREFILE=/etc/opt/teradata/dsa/client.pem
    SSLKEYSTOREFILE=/etc/opt/teradata/dsa/client-keystore.pem
    SSLKEYSTOREPASSWORD=
    SSLENCKEYSTOREPASSWORD=
    ISMASTER=
    MASTERHOSTNAME=
    CBBFILEPATH=/var/opt/teradata/dsa/cbb
    SERVERPORT=15401
    
    # AXMNetbackup dsainputs fields
    BACKUPAPPCLIENTNAME=

    The following code is an example of a dsainputs file for a DSA media server:

    BROKERLIST=tdactivemq_server:61616
    CONNECTION=TDActiveMQ connection type, either tcp or ssl
    SERVERPROTOCOL=tcp
    SERVERID=dsams name: uname -n 
    BACKUPAPPCLIENTNAME=media server for third-party name, generally dsams name: uname -n 
    DSCUSER=dscuser
    USERID=600
    SSLTRUSTSTOREFILE=/etc/opt/teradata/dsa/client.pem
    SSLKEYSTOREFILE=/etc/opt/teradata/dsa/client-keystore.pem
    SSLKEYSTOREPASSWORD=Client keystore passwordin clear text, used for ssl on TDActiveMQ
    ISMASTER=n
    MASTERHOSTNAME=dsadsc server where the master server is running
    CBBFILEPATH=/var/opt/teradata/dsa/cbb