This repository contains the software used for Case Study #1 in https://doi.org/10.1145/3731599.3767698, with the objective of making the experiments and results in that case study reproducible.
The software is comprised of two parts:
- The simulator: A workflow execution simulator implemented with WRENCH, located in the
simulator/directory. - Calibration scripts: A set of python scripts that use Simcal to calibrate the simulator, located in the the
calibration/directory.
The experiments in the case study are conducted with the ground-truth data available on figshare.
--
A Dockerfile is provided in the root directory to build a Docker image that has all the necessary software installed.
In particular, the Docker image will include:
- SimGrid 4.0,
- WRENCH 2.6
- Simcal (commit tag
86445d59177922fa3711473bbf4e5e207005fcc2was used in the experiments) - The simulator in
simulator/
Make sure you are in the root directory of this repository before running the following commands.
-
Build the Docker image:
docker build -t case-study-1-env . -
Run the container:
This command will launch an interactive bash shell inside the container. The current directory on your host machine will be mounted into the
/workspacedirectory inside the container.docker run -it -v $(pwd):/workspace case-study-1-env bashOnce inside the container's shell, you can proceed to the "Running the Software" section.
Reading the Dockerfile should make it very clear how to install all necessary software locally on a recent Ubuntu system.
The simulator is invoked by the calibration scripts in (see below). But the simulator can also be invoked stand-alone.
Please refer to the README.md in the simulator/ directory for detailed guideline on how to run the simulator.
Please refer to the README.md in the calibration/ directory for detailed guidelines on how to run the calibration scripts.