OLIVE: Microservice Framework



OmiLab Integrated Virtual Environment



 Olive is a Microservice Framework made available by OMiLAB

The main idea behind is that the functionality of the system is composed by different (web-)services, running in their own processes and communicating with each other using standard network protocols. This approach brings the advantage of absolute technology independence. The only requirement for services is that they can communicate in HTTP using standardized JSON messages (OMiLAB Generic Interface).

More informations about the concepts behind the Olive Framework can be found in the Springer book: "OMiLAB: An Open Collaborative Environment for Modeling Method Engineering".


Fast Deployment

Use one of the following packages to easily deploy and test the Olive framework in your local machine:

Olive_Portable_x86_win_v1.2.zip : All-in-one portable package, only for Windows operating system

Olive_Portable_Docker_v1.1.zip : All-in-one portable package using Docker Compose

Project specific versions:

- Olive_Portable_x86_win_v1.3_CALIBRaiTE.zip : CALIBRaiTE specific customized version of the All-in-one portable package. Instructions HERE.

- Olive_Portable_x86_win_v1.3_complAI.zip : ComplAI specific customized version of the All-in-one portable package. Instructions HERE.

- Olive_Portable_x86_win_v0.1._EIS2020.zip : EIS 2020 specific costomized version of the All-in-one portable package. Instructions HERE.


Custom Deployment

Here you can download the single components of the Olive framework for a customized deployment:

 Core   Version      
  Project and Service Manager (PSM)   0.6.2   Download     Documentation  
  Activity Logging Service 0.2.5 Download Documentation
  Repository 0.2.4 Download Documentation
  Role Service 0.3.1 Download Documentation
  Text Service 0.3.5 Download Documentation
  LDAP Configuration 0.1 Download Documentation
  PWM 1.8 Download Documentation
  CAS 0.2 Download Documentation
 Microservice Controller      
  Microservice Controller REST Interface  1.0 Download Documentation


Getting Started

All the components of the Olive platform are released as individual .war files. In order to deploy them, simply download every war file and copy in the webapp folder of your Tomcat application server. By default every component is configured to work with localhost adresses and recognize the other components deployed in the same application server.

Please be aware that every component require its own database and custom configuration, both detailed in the Documentation section of the component. Usually the schema for the DB creation and the istructions and material for the custom configuration are available inside the INSTALL folder of every component.

Java 8 is required in order to correctly execute the Olive framework.

Have a look at the Installation Manual for more details on the installation process.

Have a look at the Service Development Manual in order to learn how to create your own service.


Source Code

Olive is released as Open Source and its code is available in the following GitLab repository: https://git.boc-group.eu/olive

Instructions for the building processes are explained in the DevOp section of the documentation for every component.

The source code of the Olive Microservice Controller is available in the following GitLab reporitory: https://git.boc-group.eu/adoxx/microservice-controller-rest



The following tables specify the detailed hardware/software requirement to get the Olive Framework up and running on your system.

 Minimum Hardware Requirements


 Minimum Software Requirements


 Minimum Skill Required

 The following skills are required in order to deploy correctly Olive: 

- Basic MySQL administration skills

- Basic Tomcat administration skills

- Basic Java knowledge


Futher Questions

In case of problems and for more informations contact us at faq@adoxx.org.