Skip to main content Skip to complementary content

Installing Syncope with an external Tomcat

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.

Procedure

  1. If Tomcat is running, stop it.
  2. In apache-tomcat-xxx/bin, open or create a file called setenv.sh and add or modify the value of JAVA_OPTS as follows:
    JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
    Information noteNote: Apache Syncope supports Java 8.

    The JAVA_HOME or JRE_HOME environment variables (depending on the Java distribution used) are not strictly required, but recommended to be set.

  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/enduser.properties
    • syncope-console/WEB-INF/classes/console.properties
  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/security.properties file.
    For more information, see Apache Syncope documentation
  9. Start Tomcat.

Results

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

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!