Install QueryGrid Manager | Teradata QueryGrid - Installing Teradata QueryGrid Manager - Teradata QueryGrid

Teradata® QueryGrid™ Installation and User Guide

Teradata QueryGrid
Release Number
July 2022
English (United States)
Last Update
Product Category
Analytical Ecosystem
Install Teradata QueryGrid Manager software on one or more dedicated physical or virtual machines other than the data source nodes of your Teradata QueryGrid environment. For system requirements, see Prerequisites.
  1. Install the latest version of Java 8 or 11 on each dedicated physical or virtual machines.
    If the correct version of Java is not automatically detected, you can set the path to the Java home directory in /etc/opt/teradata/tdqgm/ after installing the tdqg-manager rpm.
    For example:
    export TDQGM_JAVA_HOME=/usr/java/jdk1.8.0_101
  2. Download the latest Teradata QueryGrid Manager package (file name tdqg-manager-version.rpm).
  3. Log on to the TMS, VM, or server.
  4. From a console window, install Teradata QueryGrid Manager by typing the following:
    rpm -ivh tdqg-manager-version.rpm

    Installation takes approximately one minute.

  5. Verify the installation.
    1. Open a browser.
    2. Access the Teradata QueryGrid Manager instance by typing the following:
  6. If you are unable to access Teradata QueryGrid Manager, do the following:
    1. Review the following logs.
      • /var/opt/teradata/tdqgm/logs/tdqgm-boot.log
      • /var/opt/teradata/tdqgm/logs/tdqgm-main.log
      • /var/opt/teradata/tdqgm/logs/init.log
    2. Fix all identified problems.
    3. From the console window, restart QueryGrid Manager using the following command:
      service tdqgm restart
  7. If this is the first Teradata QueryGrid Manager instance installed, confirm that the default value for the publicAddress is correct:
    1. Open the /etc/opt/teradata/tdqgm/ file.
    2. If necessary, see Modifying the publicAddress, bindAddress, and clusterAddress.
      You can also edit the bindAddress and clusterAddress.
  8. If the publicAddress is a hostname (not an IP Address) and cannot be resolved from the data source nodes using DNS, add the QueryGrid Manager server or servers to the /etc/hosts file of each node in the data source system.