Federation Server

Table of content


This section is a quick guide to install and use CHOReVOLUTION Federation Server from user point of view.

The Federation Server is in charge of solving, as much as possible, the different security authentication interoperability issues. For that, its design is based on the fact that the different services, involved in choreographies, will need authentication mechanisms. The Federation Server is composed of two elements, the Security Token Service (STS) and the provisioning element.

The deployment of the different elements must be realized on Ubuntu Linux distribution with a running Tomcat server.

It is Open Source and released under the terms of Apache License 2.0.

Back to top

Installation Guide


To make the most out of the CHOReVOLUTION products, please consider the following hardware requirements:

  • CPU: dual core, 2 GHz (minimum), 32-bit or 64 bit (recommended)
  • RAM: 1,5 GB or 2+ GB (recommended)
  • Disk: 1,5 GB (minimum, depends on your projects)

The software requirements can be summarized as:

  • Essentially any 64bit operating system capable of running the JDK and MongoDB(as enlisted above) is supported, with preference for Debian GNU / Linux and Ubuntu Server LTS.
  • Latest Oracle JDK 8  available is recommended, latest Oracle JDK 7 available is also supported with limitation
  • Latest Apache Tomcat 8 available;
  • MongoDB 2.4.9

Download information

In the Download section of the CHOReVOLUTION project website, a CHOReVOLUTION Federation Server package is available for your Operating System. Save the installer file to your system.

Installation steps

Follow the instructions in this section to install the Federation Server on your system. These installation instructions apply to all supported platforms. For the list of supported platforms and system requirements, see the Requirements section.

Microsoft Windows

Not supported

Unix and Linux

Installation of the Oracle JDK 8

The installation procedure for the Oracle JDK is the follow:

  • sudo apt-add-repository ppa:webupd8team/java
  • sudo apt-get update
  • sudo apt-get install oracle-java8-installer
Installation of Tomcat

The installation procedure for the Tomcat is the following:

  • wget http://www.apache.org/dist/tomcat/tomcat-8/v8.0.30/bin/apache-tomcat-8.0.30.tar.gz
  • sudo tar -zxvf apache-tomcat-8.0.30.tar.gz -C /opt

To start tomcat:

  • sudo /opt/apache-tomcat_8.0.30/bin/startup.sh

To stop Tomcat:

  • sudo /opt/apache-tomcat_8.0.30/bin/shutdown.sh
Installation of mongodb

The installation procedure for the mongodbis the following:

  • sudo apt-get install mongodb

after the installation the service is started automatically. To stop, start, and restart MongoDB using the service command (e.g. service mongodb stop, service mongodb start).

Installation of the Federation Server

The FS is provided as a war archive ready to deployed into a running tomcat. For that, copy the FS war archive to the webapps directory of tomcat. No specific tomcat configuration are required (Except tomcat port configuration).


Not supported

Back to top

Uninstalling steps

The Federation Server could be complete undeployed using the following commands

Microsoft Windows

Not supported

Unix and Linux

  • Undeploy WAR files from Apache Tomcat
  • Drop the MongoDB database using the mongo shell


Not Supported

Back to top

User Guide

The Federation Server is a component used internally into the choreography infrastructure without human interaction. This component receives information from the Identity Manager which realize the end-user provisionning.
Consequently, this component has no specific User interface.

Back to top