28 May 2015

Syncope on Centos via installer

Written by ilgrosso

Apache Syncope features a very nice GUI installer you can empower to get it up and running in minutes; here's a quick summary of the steps needed on Centos 6; the reference documentation is from official project wiki.

All steps were performed as root. 


yum install java-1.7.0-openjdk-devel.x86_64


After installing MySQL 5.5

rpm -Uvh https://mirror.webtatic.com/yum/el6/latest.rpm
yum install mysql55w mysql55w-server

I have created a database 'syncope' and granted full access to user 'syncope' with password 'syncope'; then verified that I was able to connect with such credentials on localhost, port 3306.


  1. Downloaded latest 7.x (7.0.62 currently) and uncompressed under /opt
  2. Downloaded latest MySQL JDBC driver and placed the JAR library under /opt/apache-tomcat-7.0.62/lib
  3. Configured Tomcat's JAVA_OPTS in /opt/apache-tomcat-7.0.62/bin/setenv.sh and MySQL datasource in /opt/apache-tomcat-7.0.62/conf/context.xml as illustrated
  4. Configured /opt/apache-tomcat-7.0.62/conf/tomcat-users.xml as suggested, e.g. by replacing existing content with
<?xml version='1.0' encoding='utf-8'?>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="manager" password="s3cret" roles="manager-script"/>

At this point I launched Tomcat via


and started watching Tomcat's log file

tail -f /opt/apache-tomcat-7.0.62/logs/catalina.out


Downloaded the latest version available (3.3.3 currently) and uncompressed under /opt, then defined the related alias

alias mvn='/opt/apache-maven-3.3.3/bin/mvn'


Downloaded the latest version available (1.2.4 currently) and launched via

java -jar syncope-installer-1.2.4-uber.jar

At this point I've followed the instructions on screen: I only changed the installation path to /opt/syncope and rebased conf, log and bundles directory to /opt/syncope; for the rest I've left all default values.
I also started watching the installation log, in order to see in details what was happening:

tail -f /opt/syncope/install.log

It took some time to the installer to download the whole Internet (you know, the usual jokes about Maven...), but after a little while I could see it installing all required components, then deploying everything to Tomcat (with messages "Core successfully deployed" and "Console successfully deployed").

Happy ending

Voilà, everything was up and running as expected, and I could point my browser to (yes, 'sandalo' is my test machine's hostname):


and successfully authenticate with default admin credentials.


« Return