Installing Syncope with an external Tomcat - 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

Data Services Platform


MDM Platform

Real-Time Big Data Platform

After installing Apache Tomcat, configure Syncope with the right Tomcat port.

Before you begin

Download and install the latest 9.0.x Tomcat release version from the Apache Tomcat site.


  1. If Tomcat is running, stop it.
  2. In apache-tomcat\webapps, open or create a file called setenv.bat and add or modify the value of JAVA_OPTS as follows:
  3. Go to Talend-ESB-V8.0.1.RXXXX-XX-RT\container\system\com\h2database\h2\2.2.220, copy the h2-2.2.220.jar file and paste it in the apache-tomcat-xxx\lib folder.
  4. Copy the add-ons\syncope\ files located in the ESB installation files and paste them in the apache-tomcat-xxx\webapps folder of your Tomcat.
  5. Unzip the following files:
    • syncope-console.war
    • syncope-enduser.war

    You do not need to unzip syncope.war nor sts.war.

  6. Open the following files and update the port value to 9080:
    • syncope-enduser\WEB-INF\classes\
    • syncope-console\WEB-INF\classes\
  7. Align the Tomcat port value: in the apache-tomcat-xxx\conf folder, open server.xml and change the connector port value to 9080.
  8. Optional: To improve security, change the default credentials of the default Apache Syncope user account by editing the adminPassword parameter in the syncope\WEB-INF\classes\ file.
    For more information, see Apache Syncope documentation
  9. Start Tomcat.


You can access the Apache Syncope Console with the following URL: http://localhost:9080/syncope-console/.