Add Nodes to a System | Teradata Teradata Fabric - Add Nodes to a System - Teradata Fabric

Teradata® Fabric - Installation and User Guide - 3.11
Product
Teradata Fabric
Release Number
3.11
Published
August 2026
ft:locale
en-US
ft:lastEdition
2026-08-15
dita:mapPath
svw1780362788070.ditamap
dita:ditavalPath
ezw1784752870623.ditaval
dita:id
lxg1591800469257

Before adding nodes, if the Teradata Fabric Manager publicAddress or the additionalPublicAddresses are not IP addresses and if the addresses cannot be resolved through DNS, verify that one of the host names or IP addresses has been added to the host files of the nodes in the data source system.

Nodes are registered to systems defined in Teradata Fabric Manager by installing the tdqg-node package on the node along with the tdqg-node.json configuration file. For supported platforms, you can add the nodes through the Teradata Fabric Deployment and Scaling Service, refer to Automatic Deployment of Teradata Fabric on Scalable Clusters and Teradata Fabric / QueryGrid Compatibility Matrix for more information.

For platforms that do not support or are not using the Teradata Fabric Deployment and Scaling Service, you can perform the install automatically or manually. The following table provides guidelines on what types of nodes to add for each system type.
System Type Node Type Considerations
Teradata TPA, HSN, FICON All Teradata nodes must be added to the system. See Configuring Teradata Fabric for a Teradata FICON Node for instructions on adding nodes that do not have network connectivity to the Teradata Fabric Manager or remote systems.
Hive Master/Head, Worker/Core/Task, Edge

All worker nodes must be added to the system. Adding a subset of worker nodes is only possible if there is a specific configuration (such as using YARN queues and node labels) where Hive only uses those nodes for Teradata Fabric queries.

Each non-worker node must be added to the system if at least one of the following conditions is true:

  • HiveServer2 is running on the node and Teradata Fabric loaderfactory JARs are added at runtime using the ADD JAR command, as opposed to being added using the Hive Auxiliary JAR Path.
  • The node is a driver node.
Spark Master/Head, Worker/Core/Task, Edge

All worker nodes must be added to the system. Adding a subset of worker nodes is only possible if there is a specific configuration (such as using YARN queues and node labels) where Spark only uses those nodes for Teradata Fabric queries.

For each non-worker node, the node must be added to the system if at least one of the following conditions is true:

  • Spark Thrift Server is running on the node and is the intended execution mechanism (as opposed to Spark Application) for Teradata Fabric.
  • The node is a driver node.
Oracle Teradata Fabric driver Add one or more driver nodes to the system.
BigQuery Teradata Fabric driver Add one or more driver nodes to the system.
Arrow Flight SQL Teradata Fabric driver Add one or more driver nodes to the system.
Generic JDBC Teradata Fabric driver Add one or more driver nodes to the system.