dsainputs File | DSA | DSU | DSE - dsainputs File - BAR - Data Stream Architecture - Data Stream Extensions

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

Product
BAR
Data Stream Architecture
Data Stream Extensions
Release Number
17.05
Published
September 2020
Language
English (United States)
Last Update
2021-04-02
dita:mapPath
ayz1599061175868.ditamap
dita:ditavalPath
ufq1576617582483.ditaval
dita:id
B035-3151
lifecycle
previous
Product Category
Software
Teradata Tools and Utilities

Use the existing dsainputs file in the /tmp location to edit the new dsainputs_template file that you just downloaded. Save the new file as dsainputs in the /tmp location.

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=