Configure Automatic Deployment for Azure HDInsight | Teradata QueryGrid - Automatically Deploy QueryGrid on Azure HDInsight - Teradata QueryGrid

Teradata® QueryGrid™ Installation and User Guide

Teradata QueryGrid
Release Number
July 2022
English (United States)
Last Update
Product Category
Analytical Ecosystem

Script actions are custom scripts that can be called to customize the HDInsight cluster. These scripts are used to install additional components and change configuration settings. The script must be stored on a URI that is accessible from the HDInsight cluster. For compatibility information on QueryGrid components, see the Teradata QueryGrid Compatibility Matrix.

The required script,, is packaged in the node package tdqg-node-version.tar.gz.

This procedure assumes the following prerequisites:
  • You have required privileges to provision the HDInsight cluster and scripts stored at a location accessible from HDInsight cluster.
  • The cURL tool is installed on all nodes where you intend to install QueryGrid.
  1. Add a system and download the tdqg-node.json token file that was generated by QueryGrid Manager to the Teradata QueryGrid service.
    For information about downloading tdqg-node.json, see Adding Nodes Manually.
  2. Do one of the following:
    Option Action
    Install Teradata QueryGrid on Azure HDInsight
    1. Download the node package.

      For more information, see Downloading Required Packages.

    2. Unzip the package:

      tar -xvzf tdqg-node-version.tar.gz

      The script file is available in the path qgdeployment/hdinsight, named

    3. Upload the QueryGrid deployment script to Azure Blob (or to any path accessible from HDInsight cluster).
    4. [Optional] Upload the tdqg_node.json file to Azure Blob or to any path accessible from the HDInsight cluster.
    5. Create the custom script action for TDQG_DEPLOYMENT and provide the URI as the link to the, then provide a name for the script action.

      For more information, see

    6. Provide the input parameter to the script in one of the following formats:
      • Path: --tdqg_node_json_file 'path to tdqg-node.json'
      • Text: --tdqg_node_json_file 'tdqg-node.json' file content
    7. Use the Persist this script action entry to make sure the script is applied during scaling operations and QueryGrid is automatically installed on new nodes.
    Install QueryGrid on an existing node
    1. Manually run the script action.

      For more information, see

      Script actions run as the last step in cluster creation. After the script action is successfully completed, you can check the history from Script Action History for the output and error logs.

    2. [Optional] In the case of errors, rerun the script action.
    Install QueryGrid on a new node automatically
    1. While creating the script action, select the persist action.