MAPEK-FRAMEWORK

The first framework to implement a MAPE-K Loop.
This project enable the community to create auto-adaptative systems based on
a simple version of the MAPE-K Loop.

Information about auto-adaptative software and the MAPE-K loop: http://www.uio.no/studier/emner/matnat/ifi/INF5360/v12/undervisningsmateriale/MAPE-K%20adap%20control%20loop.pdf

This framework is avaiable as an npm module: https://www.npmjs.com/package/mapek

Getting started

It's mandatory to create a .ini or .properties file and pass it the path when instantiating a mapekloop
This framework automatically creates a REST api wich only supports:
- POST http://..../monitor and a JSON in the body of the request

Calling this api fires a monitor event with the JSON received in the REST interface.
Furthermore it's possible to easily pass data from the monitor phase to the process phase.

It's also possible to create networks of MAPE-K loops with the configuration file and the network module.

Example of use

First of all
``



npm install --save mapek



And then



var mapek = require("mapek");



var loop = mapek.node("mapek.properties");

var network = loop.network;





loop.monitor(function(data, next){

    console.log("Monitoring "+JSON.stringify(data));

    data.modified = true; //for example

    //calling next we can send data to process phase

    next(data);

});



loop.process(function(data){

   //do something with the data

   //for example, this sends the JSON called data to the monitor phase of anotherMapekLoop

   network.send("anotherMapekLoop",data);

});



//in the configuration file

[rest]

port=8080

[network]

anotherMapekLoop.hostname=localhost

anotherMapekLoop.port=9999

``

There is a couple of example implementations in the samples folder.

Future plans

- create a cloud service to share the configurations
- improve the properties system
- Implement a generic repository to enable diferent types of databases
- add more phases to the loop(analysis,execute)

About

This project was created initially with research purposes, but can be extended and
improved with the help and support of the community.

Example of use

npm install --save mapek

And then

var mapek = require("mapek");

var loop = mapek.node("mapek.properties");
var network = loop.network;

loop.monitor(function(data, next){
console.log("Monitoring "+JSON.stringify(data));
data.modified = true; //for example
//calling next we can send data to process phase
next(data);
});

loop.process(function(data){
//do something with the data
//for example, this sends the JSON called data to the monitor phase of anotherMapekLoop
network.send("anotherMapekLoop",data);
});

//in the configuration file
[rest]
port=8080
[network]
anotherMapekLoop.hostname=localhost
anotherMapekLoop.port=9999