Cluster Deployed Teradata Fabric Manager Instances | Teradata Fabric - Clustering Deployed Teradata Fabric Manager Instances - Teradata Fabric

Teradata® Fabric - Installation and User Guide - 3.11

Product
Teradata Fabric
Release Number
3.11
Publication Date
August 2026
Content Type
Administration
Configuration
Installation
User Guide
Publication ID
B035-5991-086K
ft:locale
en-US
ft:lastEdition
2026-08-15
dita:mapPath
svw1780362788070.ditamap
dita:ditavalPath
ezw1784752870623.ditaval
ft:sourceId
dita
dita:id
lxg1591800469257

When more than one Teradata Fabric Manager instance is installed, cluster the Teradata Fabric Manager instances for high availability and scalability. Clustering makes sure that all the instances have the same configuration so each instance can administer and monitor Teradata Fabric. Create multiple Teradata Fabric Manager clusters to maintain separate production and test environments.

Instances are joined by one of the following join methods:
  • SSH – Provide SSH credentials to access cluster seed files.
  • Token – Provide token to access cluster seed files using QGM web service. If the standard SSH connectivity is disabled or not available, see Creating a Join Token on generating a join token.
  1. Sign in to the Teradata Fabric Manager TMS, VM, or server to include in a cluster.
  2. From a console window, run the join-cluster script as root or the tdqgm user:
    /opt/teradata/tdqgm/bin/join-cluster.sh
  3. Select a join method.
    Join Method
    -----------
    1. SSH - Provide SSH credentials to access cluster seed files
    2. Token - Provide token to access cluster seed files using QGM web service
    
    Select join method [1-2]:
  4. Enter the hostname of an existing Teradata Fabric Manager instance to join; if using the token join method, specify the hostname of the Teradata Fabric Manager instance where the create-join-cluster-token script was run.
  5. Depending on the join method selected, enter one of the following:
    Option Description
    SSH Specify the logon credentials for a user granted read permission to /etc/opt/teradata/tdqgm on that instance.
    Token Enter the token generated by the create-join-cluster-token script on one of the other Teradata Fabric Manager instances.
  6. Enter the Data Center for this instance.
    By default, data source nodes communicate with Teradata Fabric Managers in the same data center.
  7. Type y at the prompt to continue with the clustering process.
    If you want to cluster Teradata Fabric Manager 3.02 or later with Teradata Fabric Manager version 3.00 or 3.01, clustering must be performed from the 3.02+ Teradata Fabric Manager to the 3.00 or 3.01 Teradata Fabric Manager, not the reverse direction. After clustering, a password reset or new user creation must be performed on the 3.00 or 3.01 Teradata Fabric Manager, not the 3.02 version.
    All the data on the instance that the cluster command is run from is replaced with the data from the first Teradata Fabric Manager instance, or the existing cluster, being joined.