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.
- 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.
- Insert the parameters and values for the component you are installing. Values are specific for that server.For example: BURL=dsasrv1Important: 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 128 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