hobama / emufog

EmuFog: Extensible and Scalable Emulation of Large-Scale Fog Computing Infrastructures

EmuFog

EmuFog helps to test fog computing applications more efficiently. Instead of actual deploying large network topologies with your application to test, EmuFog helps to generate networks that can be emulated easily with MaxiNet, a distributed version of the popular Mininet. This provides more realistic results than simulations and is cheaper and faster than real deployments. As an input EmuFog supports generated topologies from BRITE or measured real world topologies from Caida. In those networks EmuFog places fog nodes efficiently based on user definied constrains such as network latency thresholds or resource constraints. Applications for clients and fog nodes can be anything shipped in a Docker container.

Build EmuFog From Source

EmuFog is build using Java 8. It uses Gradle to include dependencies and build binaries from the source code. This repository contains a Gradle wrapper file gradlew for Linux and macOS and a gradlew.bat for Windows. Local installations of Gradle can be used too.

To build EmuFog simply clone the git repository

git clone https://github.com/emufog/emufog.git

change the directory to the newly added emufog directory

cd emufog/

Run the Gradle build task to compile the sources.

./gradlew build

The compiled binaries can be found in build/libs. Those include a regular compiled version and a -fat jar.

libs/
├── emufog-<version>-fat.jar
└── emufog-<version>.jar

Running EmuFog

EmuFog can be started using Gradle

./gradlew run

or by running a precompiled jar file e.g.

java -jar build/libs/emufog-<version>-fat.jar

The wiki explains how to use EmuFog in more detail.

License

Licensed under the MIT license.