16.20 - Installing the DSC Package - Data Stream Extensions

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

prodname
BAR
Data Stream Architecture
Data Stream Extensions
vrm_release
16.20
created_date
September 2019
category
Configuration
Installation
featnum
B035-3151-127K
Install the DSC package on the server you want to be the DSC server.

You cannot change the installation directory. The software is installed here:

/opt/teradata/client/version/dsa

  1. If this is an upgrade, follow these steps first:
    1. Back up the DSC repository .
    2. Verify the existing DSC server is accessible in the BAR Setup portlet. See Enabling or Adding a DSC Server.
  2. On the DSC server, extract the script rpm file: tar zxvf DSC_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 DSC.xx.xx.xx.xx is extracted in the current working directory.
  3. Change to the DSC.xx.xx.xx.xx directory.
  4. Run the installation script. ./dscinstall.sh -r DSC-xx.xx.xx.xx-######.arch.rpm
  5. Enter values for the DSC component. If you are doing an upgrade, the previous settings are displayed and can be changed.
    DSC Prompts Description and Default Values
    Port for the DSARest web service Port number for the DSAREST web service. Default: 9090
    Scheme for the DSARest web service Scheme for the DSAREST web service, http or https. Default: https
    Keystore password for the DSARest web service Prompt appears if REST is set to https.

    Keystore password for DSARest web service. Must be at least 6 characters. If using SSL for ActiveMQ Connection, this password must match the JMS SSL keystore password.

    Username for account to run DSC Applicable to an install only, not an upgrade. Username to set up a Linux account for running the DSC services. Default: dscuser
    Userid (dscuser) Userid of the dscuser. The userid must be the same across all DSA components and servers in the environment. For DSU when using NFS mounted storage targets, this ID must match the anonuid configured in the NFS server. Default: 600
    Viewpoint URL Hostname of the Viewpoint server.

    Used only for Viewpoint authentication.

    Viewpoint port Port number on the Viewpoint server. Default: 80

    Used only for Viewpoint authentication.

    Is CAM environment clustered Specifies whether the CAM environment is clustered (two Viewpoint servers, primary or failover). Default: no
    Primary URL CAM communication Primary hostname or IP address for CAM communication, which enables alert messaging.
    Failover CAM URL If CAM environment is clustered, failover hostname or IP address for CAM communication.
    CAM Communication port Port number for CAM communication, which enables alert messaging. (61616 for tcp, 61617 for ssl). Default: 61616

    [DSA 16.20.51] CAM currently does not support SSL so the port must be 61616.

    DBS Host Name (Repository) Name of the NewSQL Engine / Teradata Database host where the DSC repository resides. Default: Hostname of the current DSC server
    DBS IP Address (Repository) Select the option number representing the IP Address of the NewSQL Engine / Teradata Database system where the DSC repository resides. Default: none
    DBS Superuser Username (Repository) NewSQL Engine / Teradata Database user used to create the DSC repository. The space to create the BAR and BARBACKUP databases is allocated from this user.
    DBS Superuser Password Password associated with the Superuser Name.
    Size in GB for BAR DBS User Applicable to an install only, not an upgrade. The MaxPerm of the BAR database that holds the DSC repository. Between 1 and 800. Default: 400
    Admin DBS Username Name of a user to be used for DSC repository jobs and who has the ability to create tables under BAR and BARBACKUP databases. Default: none
    Admin DBS Password Password associated with the DSC repository database user "DBS Admin".
    Password for BAR DBS User Password for the BAR database user. Used for create, read, update, and delete operations on the BAR database, which contains information for operational jobs.
    Password for BARBACKUP DBS User Password for the BARBACKUP database user. Used for create, read, update, and delete operations on the BARBACKUP database, which contains information for repository jobs.
    Unique DSC Name Nickname for this DSC. Used to differentiate this DSC from other DSCs in the portlets.

    Maximum of 22 characters: alphanumeric, "-" and "."

    First character must be alphanumeric (a-z, A-Z, and 0-9) only.

    If this is an upgrade and you change the name of an existing DSC server, you must rerun the repository backup after the upgrade. See Backing Up DSC Repository and Configuration Before Upgrading.
    ActiveMQ Broker URL Hostname or IP address of the machine running the ActiveMQ broker (where tdactivemq is installed), usually the DSC server.
    ActiveMQ Broker Port Port number on the server where the ActiveMQ broker is listening (61616 for tcp, 61617 for ssl). Default: 61616
    Type of 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
  6. Log off and log back in to the DSC to set the Linux environment variables.
  7. [DSA 16.20.00.02 and DSA 16.20.00.03 only] If you selected https as the DSARest web services scheme, you must create the self-signed certificate and set up the permissions.
    1. Extract the package: SSLsetup_sles11_x8664.xx.xx.xx.xx-#######.tar.gz
    2. Run the script: ./enable_https.sh
    3. Restart the DSC: /etc/init.d/dsc restart