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:


  Items Description Version Instruction Download
1.Olive Framework          
  1.1 Olive-Portable for Windows All-in-one portable package,
only for Windows operating system


  1.2 Olive-Portable Docker All-in-one portable package
using Docker Compose


2.Project Specific Versions          
  2.1 BIMERR BIMERR specific customized version of the All-in-one portable package. BIMERR_v1.3 OMILAB Olive portal Olive_Portable_x86_win_v1.3_BIMERR.7z
  2.2c CALIBRaiTE_v1.6 CALIBRaiTE specific customized version of the All-in-one portable package. CALIBRaiTE_v1.6 OMILAB Olive portal Olive_Portable_x86_win_v1.6_CALIBRaiTE.zip
  2.3 complAI ComplAI specific customized version of the All-in-one portable package complAI_v1.2 OMILAB Olive portal Olive_Portable_x86_win_v1.2_complAI.zip
  2.4 Change2Twin Change2Twin specific customized version of the All-in-one portable package Change2Twin_v1.0 OMILAB Olive portal Olive_Portable_x86_win_v1.0_change2twin.7z
  2.5 EIS 2020 EIS 2020 specific costomized version of the All-in-one portable package. EIS2020_1.0 OMILAB Olive portal Olive_Portable_x86_win_v0.1._EIS2020.zip
  2.6 Model Simulation with City Bike Scenario Model Simulation with city bike Scenario for the ADOxx Training in an All-in-one portable package. Model_Simulation(city-bike-scenario)_v1.0 City Bike Simulation Scenario Olive_Portable_x86_win_v1.0_Model_Simulation(city-bike-scenario).zip
3.Olive Services          
  3.1 KPI Design The Renovation process KPI design tool is an application build with ADOxx, a meta-modelling platform that allows to define your own meta-model and automatically generate the modelling environment for you accordingly it. BIMERR 1.0_A1.5 Renovation Process KPI Design Tool KPI Dashboard
  3.2 Knowledge Based Process Simulation The simulation of a renovation process complements the monitoring by providing a forward-looking simulation of the renovation process and hence estimates the expected duration and execution time. BIMERR 1.0 Simulation of Renovation Process Knowledge Based Model Simulation
  3.3 Process Model Wiki The Model Wiki web application allow to generate xWiki pages from any model in the ADOxx modelling environment and as soon as the pages are generated allow to import any existing comments in the wiki back to the model. OLIVE2XWIKI_V0.1 Collaborative Reflection of Renovation Process Model2Wiki

Custom Deployment

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

  Items Version Documentation Download
  1.1 Project and Service Manager (PSM) 0.6.2   Project and Service Manager     PSM.war  
  1.2 Activity Logging Service 0.2.5 ActivityLoggingService Logging.war
  1.3 Repository 0.2.4 Repository Repo.war
  1.4 Role Service 0.3.1 RoleService Role.war
  2.1 Text Service 0.3.5 TextService TextService.war
  3.1 LDAP Configuration 0.1 LDAP Configuration Olive_Ldap_Schema.ldif
  3.2 PWM 1.8 PWM PWM.war
  3.3 CAS 0.2 CAS CAS.war
4.Microservice Controller        
  4.1 Microservice Controller REST Interface 1.0 Microservice Controller Rest Micro-Service-Controller-Rest.war


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.