Installing MDM modules using the war file - 7.3

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 DQ Portal
Talend ESB
Talend Identity and Access Management
Talend Installer
Talend JobServer
Talend LogServer
Talend MDM Server
Talend MDM Web UI
Talend Repository Manager
Talend Runtime
Talend SAP RFC Server
Talend Studio
Installation and Upgrade
Last publication date
Available in...

Data Fabric

MDM Platform

With a .war file (Talend-MDMServer-YYYYMMDD-<revision number>-VA.B.C.war) and a zipped HOME file (Talend-MDMServer-YYYYMMDD-<revision number> provided by Talend, you can also install MDM modules by deploying the .war file to Tomcat and then updating some configuration files after unzipping the HOME file.

Here, A.B.C stands for Major, Minor, Patch version respectively. Note that you must use the same versions/revisions of each module.

This installation mode assumes that you are familiar with or have some knowledge of MDM server configuration.

The following lists all the modules involved in this installation mode. To ease their management, you are recommended to centralize all the modules on one single system.

  • An application server, Apache Tomcat server in this case, which hosts the MDM web application.

  • A .war file, which contains the MDM server application required to use Talend MDM Web UI.

  • A zipped HOME file, which contains files and resources for the MDM server.

  • (Optional) An open source Bonita BPM server application bundle.


  1. Install the Apache Tomcat application server and stop the Tomcat service if it is already started.
  2. Unzip the HOME file to a local folder. In the following procedure, this local folder will be referred to as MDM_ROOT.
  3. Copy the .war file into the directory <TomcatPath>/webapps/, and then rename it to be talendmdm.war.
    Once you have copied this war file, you can either unzip it manually under the same directory, or let Tomcat unzip the web application at startup.
  4. Browse to the directory <TomcatPath>/conf.
  5. If the folder Catalina does not exist, create a new folder Catalina under the directory <TomcatPath>/conf and then create a new folder localhost under <TomcatPath>/conf/Catalina.
  6. Under the directory <TomcatPath>/conf/Catalina/localhost, create a new XML file (for example, talendmdm.xml), and populate it with the following content:
    <?xml version='1.0' encoding='utf-8'?>
    <Context path="talendmdm">
    <Parameter name="mdmRootLocation"
    Warning: The value of the Context path must be identical to the name of your war file which has been placed under <TomcatPath>/webapps, and the value for mdmRootLocation must be the local directory where the HOME file is unzipped.
  7. Under the directory <MDM_ROOT>/conf, edit the datasources.xml file to provide the connection information to the database.
    You can use datasources.xml to manage how MDM Server uses SQL databases. For more information, see Managing how MDM Server uses SQL databases.
  8. Edit the mdm.conf file to complete the configuration for the MDM server. For more information, see Configuring MDM Server.


To run the MDM server, execute in the <TomcatPath>/bin folder.

Note: The MDM server cannot start and an exception will be thrown if the product version in MDM system database to which the datasource configuration file datasources.xml points is different from your product version. You need to use the dbmigration tool if you want to do a migration. For more information about using the dbmigration tool, see Talend Migration Guide.

To shut down the MDM server, press Ctrl + C in the console window, or run bin/

For performance reasons, you can increase the memory of Tomcat. For more information about how to increase the memory size of Tomcat, see Increasing the memory of Tomcat.

If needed, you can install the Bonita BPM server manually. For more information, see Installing the Bonita BPM community server manually (deprecated).