Setting up a cluster of MDM Servers - 8.0

Talend Installation Guide

Operating system
Subscription type
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend Data Preparation
Talend Data Stewardship
Talend ESB
Talend Identity and Access Management
Talend Installer
Talend JobServer
Talend LogServer
Talend MDM Server
Talend MDM Web UI
Talend Runtime
Talend SAP RFC Server
Talend Studio
Installation and Upgrade
Last publication date
Available in...

Data Fabric

MDM Platform

Before you begin

  • Download and install the Apache httpd including mod_jk support and make sure it is running properly. For more information about how to install and run Apache httpd, refer to the official Apache documentation.

  • Download and install the Apache ActiveMQ standard distribution and run it. For more information about how to install and run Apache ActiveMQ on your platform, refer to the Apache ActiveMQ documentation.

    Warning: If you are using Apache ActiveMQ 5.4 or a higher version with KahaDB, it is recommended to not enable the KahaDB property concurrentStoreAndDispatchTopics in the ActiveMQ XML configuration file. For more information about the property, see


  1. Install the first MDM Server as you would for an installation on a single machine.
  2. Duplicate this first instance on as many machines as you want to include in your cluster. In this case, duplicate means rerun the installation process with exactly the same parameters each time.
    Note that you can also work with multiple instances on the same physical server, using different port numbers, but in this case you do not have the same level of protection against the physical failure of a machine.
  3. On each MDM Server instance, open the <$INSTALLDIR>/conf/mdm.conf file to edit it.
  4. Add the line system.cluster=true under the System Settings section to enable the clustering configuration.
  5. Change the value of to tcp://AMQHOST:AMQPORT, for example, tcp://localhost:61616. Here AMQHOST is the name of the server hosting ActiveMQ, and AMQPORT is the OpenWire TCP port to which Apache ActiveMQ listens.
    Important: By default, an MDM server uses an embedded Apache ActiveMQ broker as the JMS provider. In order to ensure correct communication between nodes, the JMS broker must be externalized and shared by every node of the cluster.
  6. Add the following two lines to let MDM create authenticated connections to the ActiveMQ server.<USERNAME><PASSWORD>
  7. In the file <TomcatPath>/conf/server.xml, locate the <Engine> element and add an attribute for jvmRoute.
    <Engine name="Catalina" defaultHost="localhost" jvmRoute="mdm_node1">

    Here the value of jvmRoute represents the unique identifier of each MDM server node included in the cluster and must correspond to the worker name in the file.

  8. Repeat the previous for each server instance.
  9. Restart all the MDM nodes in the cluster.


Full-text index replication is implemented within each MDM cluster.

Once you have installed and configured all the required MDM Server instances, you need to explicitly connect them together in a cluster. Different solutions exist for doing so, both hardware and software.