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

QueryGridâ„¢ Installation and User Guide - 3.06

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Teradata QueryGrid
Release Number
3.06
Published
December 2024
ft:locale
en-US
ft:lastEdition
2024-12-07
dita:mapPath
ndp1726122159943.ditamap
dita:ditavalPath
ft:empty
dita:id
lxg1591800469257
lifecycle
latest
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 QueryGrid Compatibility Matrix.

The required script, TDQG_DEPLOYMENT.sh, 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 QueryGrid service.
    For information about downloading tdqg-node.json, see Adding Nodes Manually.
  2. Do one of the following:
    Option Action
    Install 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 TDQG_DEPLOYMENT.sh script file is available in the path qgdeployment/hdinsight, named TDQG_DEPLOYMENT.sh.

    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 TDQG_DEPLOYMENT.sh, then provide a name for the script action.

      For more information, see https://docs.microsoft.com/azure/hdinsight/hdinsight-hadoop-customize-cluster-linux

    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 https://docs.microsoft.com/azure/hdinsight/hdinsight-hadoop-customize-cluster-linux#apply-a-script-action-to-a-running-cluster.

      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.