Federation Server
Table of content
Introduction
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.
Installation Guide
Requirements
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).
OS X
Not supported
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
OS X
Not Supported
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.