OLIVE: Microservice Framework

olive

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".

Downloads

Core	Version
Project and Service Manager (PSM)	0.6.1	Download	Documentation
Activity Logging Service	0.2.4	Download	Documentation
Repository	0.2.3	Download	Documentation
Role Service	0.3.0	Download	Documentation
Services
Text Service	0.3.4	Download	Documentation
Authentication
LDAP Configuration	0.1	Download	Documentation
PWM	1.8	Download	Documentation
CAS	0.1	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 9 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 11 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

Requirements

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

Minimum Hardware Requirements
- Server-class computer - Dual-Core processor - 2048 MB RAM minimum, depending on service number and simultaneous users (3072 MB or more are recommended) - 5 GB free disk space, depending on number services and space requirements for pictures, modelling toolkits (more recommended) - 1 Network card and a static and world-wide routed IP address

Minimum Software Requirements
The portal should work pretty much work on any operating system that supports Tomcat, Java and any kind of SQL server. Although the system is only well-tested in the following environment: - Ubuntu 18 - JRE 11 - Tomcat 9 - MySQL 5.7 and - Windows 10 - JRE 11 - Tomcat 9 - MySQL 5.7

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.