Talend Data Stewardship in cluster mode - 6.4

Talend ESB Installation Guide for Linux

Talend ESB
Installation and Upgrade
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend Data Preparation
Talend Data Stewardship
Talend ESB
Talend Identity Management
Talend Installer
Talend JobServer
Talend Log Server
Talend Project Audit
Talend Runtime
Talend Studio

You can install several instances of Talend Data Stewardship in cluster mode if you want to benefit from a high availability and a better scalability with your product.

Clustering is the process of grouping together a set of similar physical systems in order to ensure a level of operational continuity and minimize the risk of unplanned downtime, in particular by taking advantage of load balancing and failover features.

This documentation provides the procedures to set up a cluster for Talend Data Stewardship, and optionally Talend Dictionary Service.

Architecture of Talend Data Stewardship in cluster mode

The following diagram illustrates the architecture behind Talend Data Stewardship and Talend Dictionary Service when set up in cluster mode.

This architecture is composed of several functional blocks:

  • A Load Balancer, that distributes the workload from the different users accessing the Talend Data Stewardship Web application at the same time as well as the Talend Dictionary Service server.


    The same Load Balancer can be user for both Talend Data Stewardship and Talend Dictionary Service. In addition, the Load Balancer can be either physical, or logical.

  • The Talend Data Stewardship instances.

  • The Talend Dictionary Service instances that you can optionally install if you want to add, remove, or edit the semantic types used on data in Talend Data Stewardship.

  • A block containing the various components necessary for Talend Data Stewardship and Talend Dictionary Service to work, namely several instances of MongoDB for storage, Kafka and Zookeeper for messaging, and an instance of Talend Administration Center to manage authorizations.

Installing Talend Data Stewardship in cluster mode

To install Talend Data Stewardship in cluster mode, you need to make some modifications in the <Data_Stewardship_Path>/tds/apache-tomcat/conf/data-stewardship.properties configuration file.

To perform this installation, you need to install and configure as many instances of Talend Data Stewardship and its dependencies as necessary.


  • You have configured a Load Balancer for each module, namely Talend Data Stewardship and optionally Talend Dictionary Service.

  • You have configured MongoDB in cluster mode. For more information, see MongoDB documentation.

  • You have configured Kafka and Zookeeper in cluster mode. For more information, see Zookeeper documentation and Kafka documentation.

  1. Install a first Talend Data Stewardship instance.

    For more information on the installation procedure, see Installing and configuring Talend Data Stewardship .

  2. In the <Data_Stewardship_Path>/tds/apache-tomcat/conf/data-stewardship.properties file, edit the mongodb.host property to specify the hosts and ports of the several MongoDB instances.

    Use the following syntax:


    The hosts and ports for the different URLs must be concatenated, except for the last host, that will inherit the value of the mongodb.port property. For example:

  3. Edit the properties specifying the hosts and ports for the Kafka and Zookeeper instances.

    In the same way as the MongoDB URLs, the Kafka and Zookeeper hosts and ports must be concatenated, except for the last port, that is inherited from the dedicated properties.


    Specify also the below peer port parameters which identify the host name with the port number.

  4. To increase the session duration and reduce the risk of unexpected logouts, add the following lines:

  5. Repeat the above steps to install and configure other instances of Talend Data Stewardship. Increment the value in the service.instance.id parameter at <Data_Stewardship_Path>/tds/apache-tomcat/conf/data-stewardship.properties to use a unique identifier per instance.

  6. Edit the <Data_Stewardship_Path>/iam/apache-tomcat/clients/tds-client.json files to add the redirection URLs in the post_logout_redirect_uris and redirect_uris fields specifying the load balancer ports.

    Optionally, to access directly one of the Talend Data Stewardship instances add the redirection URLs of the other instances in the fields.

  7. Create partitions for Kafka topics in each Talend Data Stewardship instance:

    1. Launch a Talend Data Stewardship instance. This automatically creates several Kafka topics.

    2. Stop the instance and define the partitions per topics manually. You need to define as many partitions as Kafka nodes.

      For further information, see Kafka documentation.

    3. Restart the instance.

    You have installed several Talend Data Stewardship instances and configured them to work in cluster mode.