Incremental Fast Lightweight (y) virtual network Embedding framework
Go to file
Maximilian Kratz 20cd83ac39
Merge pull request #48 from Echtzeitsysteme/feature/update-gurobi-1003
Updates Gurobi ILP solver to 10.0.3
2023-09-22 10:08:29 +02:00
.github/ISSUE_TEMPLATE Update issue templates 2021-09-22 09:26:28 +02:00
examples VNE GIPS algorithm: Objective test clean up + adds another tiny example 2022-06-14 16:22:55 +02:00
gfx Adapts screenshots to new UI + extends 2021-12-17 08:37:55 +01:00
ilp Updates Gurobi ILP solver to 10.0.3 2023-09-22 09:51:56 +02:00
network.generators Adapts vendor to FGES 2022-02-09 12:56:55 +01:00
network.metrics Fixes old junit jupiter api dependency 2022-10-13 08:53:59 +02:00
network.model.rules MANIFEST changes: JDK17 + new formatter 2023-02-23 16:08:32 +01:00
network.model.rules.racka MANIFEST changes: JDK17 + new formatter 2023-02-23 16:08:32 +01:00
network.model.rules.rackb MANIFEST changes: JDK17 + new formatter 2023-02-23 16:08:32 +01:00
network.model.rules.vnet MANIFEST changes: JDK17 + new formatter 2023-02-23 16:08:32 +01:00
network.visualization Switches to SmartEMF CodeGen + fixes dependency errors for SmartEMF 2022-03-14 08:38:35 +01:00
scripts Updates Gurobi ILP solver to 10.0.3 2023-09-22 09:51:56 +02:00
settings Removes old code-style settings 2021-12-13 10:46:24 +01:00
statistics Fixes + adapts statistics and CSV modules 2022-04-12 16:24:45 +02:00
test.suite Cleanup 2022-12-20 17:13:01 +01:00
vne.algorithms Adds GIPS API reset in case the GIPS* algorithm gets disposed 2023-04-19 09:57:07 +02:00
vne.scenarios Renames all Roam-related parts to GIPS 2022-05-03 17:03:50 +02:00
.gitignore Adds first version of the GIPS-based VNE algorithm w/ enabled migration 2022-10-26 09:18:24 +02:00
CITATION.cff Adapts citation file to v0.0.3 2021-12-23 08:42:50 +01:00
LICENSE Added license 2021-05-19 10:51:45 +02:00 Updates Gurobi ILP solver to 10.0.3 2023-09-22 09:51:56 +02:00
projectSet.psf Adds a PSF file for iflye (and all needed GIPS examples) + adapt 2023-06-22 16:12:32 +02:00


ifyle is an open-source framework for Incremental Fast Lightweight (y) virtual network Embedding.

Installation (development)

  • Install Temurin JDK17 or newer.
  • Install GIPS as described here or use the pre-built Eclipse.
  • Install Gurobi in version 10.0.3 and activate a license for your computer.
    • Currently, Gurobi is the default ILP solver used in iflye.
  • Install IBM ILOG CPLEX in version 22.1.1.
    • CPLEX is an alternative ILP solver in iflye. You do not need it explicitely, but if you did not install and configure it properly, at least one test case will fail.
    • Please notice: CPLEX does not support SOS1 constraints with equal weights (as usually desired by the PM-/ILP-based algorithms in this projects). Therefore, the adapter implementation ignores all SOS1 constraint creations.
  • Launch a runtime workspace (while using a runtime Eclipse) as stated in the eMoflon::IBeX installation steps.
    • Additionally, the runtime workspace needs some environment variables to access the Gurobi and the CPLEX solver. Do not forget to adapt them to your individual setup:

Project setup (manual)

  • Clone this Git repository to your local machine and import it into Eclipse: File -> Import -> General -> Existing Projects into Workspace. Import all projects.
  • Clone the GIPS examples repo to your local machine and import it into Eclipse: File -> Import -> General -> Existing Projects into Workspace. Import (at least) the following projects:
    • network.model
    • org.emoflon.gips.gipsl.examples.mdvne
    • org.emoflon.gips.gipsl.examples.mdvne.migration
  • Inside the runtime workspace, build all projects (Project -> Clean... -> Clean all projects) to trigger code generation.
    • Build the projects network.model, network.model.rules, network.model.rules.racka, network.model.rules.rackb, and network.model.rules.vnet with the black eMoflon hammer symbol.

A good start point to verify your installation is to run the included unit tests, refer to the test section.

Project setup (PSF)

  • As an alternative to the previous project setup section, you can use this PSF file for the import of all necessary projects.


This project uses the built-in code-style and code-formatter of Eclipse. Before contributing, please set-up your Eclipse code-style settings as follows:

  • Window -> Preferences -> Java
    • -> Code Style -> Clean Up -> Active profile: -> "Eclipse [built-in]" (default)
    • -> Code Style -> Formatter -> Active profile: -> "Eclipse [built-in]" (default)
    • -> Code Style -> _Organize Imports: -> "java, javax, org, com" (default)
    • -> Editor -> _Save Actions:
      • Check "Perform the selected actions on save"
      • Check "Format source code"
      • Check "Format all lines"
      • Check "Organize imports"
      • Check "Additional actions"

By using this settings, you should be unable to commit unformatted code.

Usage (running simulations)

After finishing the installation steps, you may run simulations, e.g., from the examples project. There are some examples for network generators as well as embedding algorithms. All examples contain a public static void main(final String[] args) method as entry point and can be run as Java appication from within the Eclipse workspace.

CLI usage

You may want to run the whole program as one exported file, e.g., on a server via the CLI for measurement purposes. To export the whole project as executable JAR file, follow this step:

  • File -> Export... -> Java/Runnable JAR file -> Next -> (Chose your launch configuration) -> (Chose the export destination) -> Library handling: Package required libraries into generated JAR -> Finish

Depending on your launch configuration, you can start the JAR file with additional arguments. Example: $ java -jar iflye.jar --algorithm taf --objective total-taf-comm --snetfile resources/two-tier-12-pods/snet.json --vnetfile resources/two-tier-12-pods/vnets.json --csvpath metrics.csv

For larger simulations, you may want to increase the Java heap space. Example with 32 GiB: $ java -Xmx32g -jar iflye.jar $parameters

In the subfolder scripts/ are some basic Bash scripts to run parameter sweeps as well as CLI argument parsing into the scenario.

Scenario loader

As this project is the small sibling of the iDyVE project, you may want to run the same scenarios in both frameworks, e.g., to compare the performance. For this purpose, iflye has a built in model converter which can read virtual and substrate networks from JSON export files (e.g., from iDyVE).

The chosen JSON format is loosly coupled with the used metamodel. Therefore, it acts as a kind of abstract model representation to transfer models from one metamodel/framework to the other.

Feel free to check out some examples in vne.scenarios/resources/*/.


Various test cases to test the framework as well as some of the implemented VNE algorithms are implemented in the project test.suite. To start them, follow this step:

  • Right click on test.suite -> Run As... -> JUnit Test

Please notice: The test IlpSolverSetupTest will check your Gurobi/CPLEX installation and configuration. If this test fails, at least one of the two ILP solvers is not configured properly.


For easier debugging purposes, a basic GUI for visualizing networks is implemented in the project network.visualization based on GraphViz. Currently, it can render tree-based networks as tree structures or use the automatic mode of GraphViz from a model file model.xmi in the examples project. Therefore, launch the class Ui with these arguments: ../examples/model.xmi sub 1

  • ../examples/model.xmi is the path of the model to read.
  • sub is the name of the (substrate) network to visualize.
  • 1 configures the automatic layout. You can also chose 0 to use a tree-like layout.


This project is licensed under the GNU General Public License v3.0 - see the file for more details.