16.20 - Installing Ecosystem Manager on VMware - Teradata Ecosystem Manager

Teradata® Ecosystem Manager Installation, Configuration, and Upgrade Guide for Customers

Teradata Ecosystem Manager
December 2020
  1. Connect to the vCenter server where you want to deploy Ecosystem Manager using the vSphere Client (the server where the ova file is downloaded).
  2. On the Home tab, under Inventories, select Hosts and Clusters.
  3. In the Navigator pane, right-click a host and select Deploy OVF Template.
  4. Select Select an OVF Template and then:
    1. Select the Local file method.
    2. Click Choose Files and browse to the .ova file in the folder you created when you downloaded the file.
  5. Click Next in the next two windows, then click Finish.
  6. In the Navigator pane, right-click the VM and select Power > Power On.
  7. Once the VM instance is running, login to the network using SSH and the following credentials:
    linux login: root
    Password: iumb123
    The IP address is displayed on the Summary screen of the vSphere client.
    The root logon through the vSphere client is disabled by default.
  8. [Optional] Run -echo "tty1" >> /etc/securetty to enable the root logon through the console.
  9. After login, configure the network:
    1. Run the #yast command.
    2. Under Global Options, make the following selections:
      • Network Setup Method: Traditional Method with ifup
      • IPv6 Protocol Settings: Enable IPv6
      • DHCP Client Options: Change Default Route via DHCP
    3. Select Overview, then select Edit, and update the IP address.
    4. Select Host Name/DNS, then update the Hostname, Domain Name, Name Servers, and Domain Search URLs.
    5. Select Routing, and add the Default Gateway.
  10. Make sure the time zone service is set to UTC.
    1. Run #yast timezone.
    2. Under Clock and Time Zone, select Global, then UTC.
  11. Make sure Teradata DBS is running:
    1. Run pdestate -a.
      The following is an example output showing DBS is running:
      PDE state is RUN/STARTED.
      DBS state is 4: Logons are enabled - Users are logged on
    2. Check file /etc/pde.conf to make sure the AutoStart is 1.
      If the value is not set to 1, change to 1 and save the file.
    User = 'teradata'
    Group = 'tdtrusted'
    UDFUser = 'tdatuser'
    UDFGroup = 'tdatudf'
    SSON = 'teradata:tdatuser'
    LegacyAuth = '1'
    SysAdminUDF - is not set
    AutoStart= '1'
  12. As root user, run em-syncuser-update in the folder /opt/teradata/emserver/bin.
  13. As root user, run ssh-setup-single.sh in the folder /opt/teradata/emserver/bin and configure the following parameters:
    Positional Parameter Description
    Active Ecosystem Manager Hostname Hostname of Active Ecosystem Manager Server
    Active Ecosystem Manager Root Password Root Password of Active Ecosystem Manager Server
  14. Finish configuration for the Ecosystem Manager environment, as a syncuser, run config_single.sh in the folder /opt/teradata/emserver/bin and set the following parameters:
    Positional Parameter Description
    ActiveEcosystemID Ecosystem ID defined for Active (usually the Datacenter name where the Viewpoint system is located)
    ActiveTeradataAlertAMQ Hostname of the Active Viewpoint server.
    Viewpoint DCS User Viewpoint user assigned to the role to access system health service
    Viewpoint DCS Password Password for Viewpoint DCS User
  15. As syncuser user, run the script camconfig.sh in /opt/teradata/emserver/bin on successful completion of config_single.sh.
    If you are installing Action
    Ecosystem Manager This step is mandatory.
    Ecosystem Manager release earlier than and paired with a Viewpoint server that is version or higher This step is optional unless you see the following message after running config_single.sh and setting the parameters in the previous step:

    “-- Please run the script /opt/teradata/emserver/bin/camconfig.sh as syncuser to complete the configuration.—”

  16. Select one of the following options:
    To use the Action
    Key file to connect to the Viewpoint host
    1. Type 1.
    2. Enter the full path to the key file.

      For example, /tmp/server.pem

    Root password to connect to the Viewpoint host
    1. Type 2.
    2. Provide the OS login username for the Viewpoint host.
      1. To use default user [root], press Enter.
      2. Otherwise, enter a username.
    3. Enter the password for the OS login username specified above.
  17. Run emstatus.sh to verify Ecosystem Manager services are running in the right mode.
    For example, in single mode, verify the following services are running.
    emreplicateagent is unused
    emreplicate is unused
    empublisher is running
    emeventconsumer is running
    emcontrol is running
    emcontrolagent is running
    emdcs is running