Installing MDM modules using the war file - 6.1

Talend MDM Platform Installation Guide

Talend MDM Platform
Installation and Upgrade
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend DQ Portal
Talend ESB
Talend Identity Management
Talend Installer
Talend JobServer
Talend Log Server
Talend MDM Server
Talend MDM Web UI
Talend Project Audit
Talend Repository Manager
Talend Runtime
Talend SAP RFC Server
Talend Studio

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 User Interface.

    Note that Talend Data Stewardship Console is embedded.

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

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


  • JRE 1.8.0 or higher must be installed. Make sure that the JAVA_HOME environment variable is set to point to the JRE directory.

    For example, if the path is C:\Java\JREx.x.x\bin, you must set the JAVA_HOME environment variable to point to C:\Java\JREx.x.x.

  • Install the Apache Tomcat application server and stop the Tomcat service if it is already started.


    Tomcat can be installed and managed as a Windows Service. For more information, see Tomcat.

To install MDM modules using the .war file and the zipped HOME file provided by Talend, proceed as follows:

  1. Unzip the HOME file to a local folder. In the following procedure, this local folder will be referred to as MDM_ROOT.

  2. 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.

  3. Browse to the directory <TomcatPath>\conf.

    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.

  4. 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"


    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.

  5. Under the directory <MDM_ROOT>\conf, do the following:

  6. 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.

The MDM server is installed along with the Talend Data Stewardship Console.

To run the MDM server, execute startup.bat (Windows) or (Linux) in the <TomcatPath>\bin folder.

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

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