EnGINE Framework

Environment for Generic In-vehicular Networking Experiments (EnGINE) is a highly manageable orchestration tool built in Ansible. EnGINE a configurable, scalable, flexible, and reproducible setup that operates autonomously (once well configured). It can incorporate various real data sources and recorded footage. Besides, multiple probes can be set up to collect data during the experiment run, such as .pcaps or logs. Such data can be interpreted to provide insights into experiment outcomes. The design allows the reuse of various applications and configurations from different scenarios, minimizing the maintenance overhead. The latest extension includes the translation functionality of the scenario configuration to the OMNeT++ configuration, individual playbooks for running the simulation flow, and results post-processing. The reasons why EnGINE and OMNeT++ have been selected for a hybrid experimentation platform can be found in the submitted paper that appears at IFIP 2023.

The repository is structured as follows:

engine - contains the modified codebase of the EnGINE framework, which includes provisions for the simulation capability
results - contains the simulation results used for results in the publication
simulation - contains the installation scripts for OMNeT++ and provisions for given simulations

This repository contains the EnGINE framework and scenarios used in the publication: Methodology and Infrastructure for TSN-based Reproducible Network Experiments.

This is a supplementary repository of the following list of publications:

Marcin Bosk*, Filip Rezabek*, Johannes Abel, Max Helm, Kilian Holzinger, Georg Carle, Jörg Ott: Simulation and Practice: A Hybrid Experimentation Platform for TSN. To appear at the IFIP 2023
Marcin Bosk*, Filip Rezabek*, Kilian Holzinger, Angela Gonzalez Mariño, Abdoul Aziz Kane, Francesc Fons, Jörg Ott, Georg Carle: Methodology and Infrastructure for TSN-Based Reproducible Network Experiments. IEEE Access 10: 109203-109239 (2022), PDF: Methodology and Infrastructure - IEEE Access 2022
Filip Rezabek*, Marcin Bosk*, Thomas Paul, Kilian Holzinger, Sebastian Gallenmüller, Angela Gonzalez Mariño, Abdoul Kane, Francesc Fons, Haigang Zhang, Georg Carle, Jörg Ott: EnGINE: Flexible Research Infrastructure for Reliable and Scalable Time Sensitive Networks. J. Netw. Syst. Manag. 30(4): 74 (2022), PDF: EnGINE - JNSM 2022
Filip Rezabek, Marcin Bosk, Thomas Paul, Kilian Holzinger, Sebastian Gallenmüller, Angela Gonzalez Mariño, Abdoul Kane, Francesc Fons, Haigang Zhang, Georg Carle, Jörg Ott: EnGINE: Developing a Flexible Research Infrastructure for Reliable and Scalable Intra-Vehicular TSN Networks. CNSM 2021: 530-536, PDF: EnGINE - CNSM/HipNET 2021
Marcin Bosk*, Filip Rezabek*, Kilian Holzinger, Angela Gonzalez Mariño, Abdoul Kane, Francesc Fons, Haigang Zhang, Georg Carle, Jörg Ott: Demo: Environment for Generic In-vehicular Network Experiments - EnGINE. VNC 2021: 117-118, PDF: Demo - VNC 2021

* Authors with * contributed to the publications equally To cite the repository directly, use this reference:

Relevant publications using & Extending EnGINE

Extension of EnGINE supporting NDN is fully available since this commit and is described in publication Towards Domain-Specific Time-Sensitive Information-Centric Networking Architecture. If you want to cite this publication, use this BibTeX format:

@inproceedings{bosk2024tsnicn,
  author={Marcin Bosk and J{\"o}rg Ott},
  title={Towards {Domain-Specific} {Time-Sensitive} {Information-Centric} Networking Architecture},
  booktitle={2024 IFIP Networking Conference (IFIP Networking)  (IFIP Networking 2024)},
  address={Thessaloniki, Greece},
  pages={5.99},
  days={2},
  month={jun},
  year={2024},
  keywords={TSN; IVN; IACS; ICN; Network Architecture}
}

The associated implementation code for long-lived interests is available in the following repositories:

Extension of EnGINE is present in Multilayer Environment and Toolchain for Holistic NetwOrk Design and Analysis:

@misc{rezabek2023multilayer,
      title={Multilayer Environment and Toolchain for Holistic NetwOrk Design and Analysis}, 
      author={Filip Rezabek and Kilian Glas and Richard von Seck and Achraf Aroua and Tizian Leonhardt and Georg Carle},
      year={2023},
      eprint={2310.16190},
      archivePrefix={arXiv},
      primaryClass={cs.DC}
}

EnGINE was used in Playing the MEV Game on a First-Come-First-Served Blockchain:

@misc{öz2024playing,
      title={Playing the MEV Game on a First-Come-First-Served Blockchain}, 
      author={Burak Öz and Jonas Gebele and Parshant Singh and Filip Rezabek and Florian Matthes},
      year={2024},
      eprint={2401.07992},
      archivePrefix={arXiv},
      primaryClass={cs.CR}
}

EnGINE was used in TSN Experiments Using COTS Hardware and Open-Source Solutions: Lessons Learned:

@inproceedings{10150312,
  author={Rezabek, Filip and Bosk, Marcin and Carle, Georg and Ott, Jörg},
  booktitle={2023 IEEE International Conference on Pervasive Computing and Communications Workshops and other Affiliated Events (PerCom Workshops)}, 
  title={TSN Experiments Using COTS Hardware and Open-Source Solutions: Lessons Learned}, 
  year={2023},
  volume={},
  number={},
  pages={466-471},
  keywords={Pervasive computing;Performance evaluation;Protocols;Conferences;Hardware;Behavioral sciences;Network interfaces;TSN;COTS;Open-Source;PTP;Experiments},
  doi={10.1109/PerComWorkshops56833.2023.10150312}}

If you want to cite the Simulation and Practice: A Hybrid Experimentation Platform for TSN publication, use this BibTeX format:

@inproceedings{BoskRez23IFIP,
  title = {{Simulation and Practice: A Hybrid Experimentation Platform for TSN}},
  author = {Bosk*, Marcin and Rezabek*, Filip and Abel, Johannes and Holzinger, Kilian and Helm, Max and Carle, Georg and Ott, J\"org},
  booktitle = {22nd International Federation for Information Processing (IFIP) Networking Conference},
  year = {2023},
  address = {Barcelona, Spain},
  month = jun,
  month_numeric = {6}
}

EnGINE was used in PTP Security Measures and their Impact on Synchronization Accuracy:

@inproceedings{9964658,
  author={Rezabek, Filip and Helm, Max and Leonhardt, Tizian and Carle, Georg},
  booktitle={2022 18th International Conference on Network and Service Management (CNSM)}, 
  title={PTP Security Measures and their Impact on Synchronization Accuracy}, 
  year={2022},
  volume={},
  number={},
  pages={109-117},
  keywords={Protocols;Power system protection;Peer-to-peer computing;Topology;Security;Synchronization;Power system faults;PTP;security;clocks;synchronicity;TSN},
  doi={10.23919/CNSM55787.2022.9964658}}

If you want to cite the Methodology and Infrastructure for TSN-Based Reproducible Network Experiments publication, use this BibTeX format:

@article{Bosk2022MethodologyInfrastructureIEEEAccess,
  author = {Bosk*, Marcin and Rezabek*, Filip and Holzinger, Kilian and Marino, Angela G. and Fons, Francesc and Kane, Abdoul A. and Ott, J{\"o}rg and Carle, Georg},
  title = {Methodology and Infrastructure for TSN-based Reproducible Network Experiments},
  journal = {IEEE Access},
  year = {2022},
  month = sep,
  issn = {2169-3536},
  doi = {10.1109/ACCESS.2022.3211969},
  url = {https://doi.org/10.1109/ACCESS.2022.3211969},
  pdf = {https://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&arnumber=9910175},
  month_numeric = {9}
}

If you want to cite the EnGINE: Flexible Research Infrastructure for Reliable and Scalable Time Sensitive Networks publication, use this BibTeX format:

@article{Rezabek2022EngineJNSM,
  author = {Rezabek*, Filip and Bosk*, Marcin and Paul, Thomas and Holzinger, Kilian and Gallenm{\"u}ller, Sebastian and Gonzalez, Angela and Kane, Abdoul and Fons, Francesc and Haigang, Zhang and Carle, Georg and Ott, J{\"o}rg},
  title = {EnGINE: Flexible Research Infrastructure for Reliable and Scalable Time Sensitive Networks},
  journal = {Journal of Network and Systems Management},
  year = {2022},
  month = sep,
  day = {08},
  volume = {30},
  number = {4},
  pages = {74},
  issn = {1573-7705},
  doi = {10.1007/s10922-022-09686-0},
  url = {https://doi.org/10.1007/s10922-022-09686-0},
  pdf = {https://link.springer.com/content/pdf/10.1007/s10922-022-09686-0.pdf},
  month_numeric = {9}
}

If you want to cite the EnGINE: Developing a Flexible Research Infrastructure for Reliable and Scalable Intra-Vehicular TSN Networks publication, use this BibTeX format:

@inproceedings{RezBosk21,
  title = {{EnGINE: Developing a Flexible Research Infrastructure for Reliable and Scalable Intra-Vehicular TSN Networks}},
  author = {Rezabek, Filip and Bosk, Marcin and Paul, Thomas and Holzinger, Kilian and Gallenm\"uller, Sebastian and Gonzalez, Angela and Kane, Abdoul and Fons, Francesc and Haigang, Zhang and Carle, Georg and Ott, J\"org},
  booktitle = {3rd International Workshop on High-Precision, Predictable, and Low-Latency Networking (HiPNet 2021)},
  year = {2021},
  address = {Izmir, Turkey},
  month = oct,
  pdf = {http://www.net.in.tum.de/fileadmin/bibtex/publications/papers/rezabek_hipnet2021.pdf},
  month_numeric = {10}
}

If you want to cite the Demo: Environment for Generic In-vehicular Network Experiments - EnGINE publication, use this BibTeX format:

@inproceedings{BoskRez21,
  title = {{Demo: Environment for Generic In-vehicular Network Experiments - EnGINE}},
  author = {Bosk, Marcin and Rezabek, Filip and Holzinger, Kilian and Gonzalez, Angela and Kane, Abdoul and Fons, Francesc and Haigang, Zhang and Carle, Georg and Ott, J\"org},
  booktitle = {13th IEEE Vehicular Networking Conference (VNC 2021)},
  year = {2021},
  address = {Ulm, Germany},
  month = nov,
  pdf = {http://www.net.in.tum.de/fileadmin/bibtex/publications/papers/bosk_vnc2021.pdf},
  month_numeric = {11}
}

Licensing

The source code of EnGINE is published under the MIT license. Its main contributors are (alphabetically):

Marcin Bosk
Thomas Paul
Filip Rezabek

In case another license applies, it is mentioned in the header of the given file, e.g.,send_udp_tai.c. Similarly, if another license applies, it is mentioned in the header of the given file, e.g., Iperf3LikePacketSource.ned. Externally libraries that are used as a part of the experiment execution have their corresponding licensing, e.g., linuxptp, iperf3. OMNeT++ is distributed under the Academic Public License. For commercial purposes, navigate to the https://omnest.com/.

rezabfil-sec / engine-framework

EnGINE Framework

Relevant publications using & Extending EnGINE

Licensing

About

Languages