Cloud Native Renew

Cloud Native Renew aims towards incorporating aspects of observability, operability, agility, and resilience into reference net simulations based on Renew. Its intended use is the deployment in cloud environments without direct administrative access to the system itself. Our current implementation is based on Renew 4.0 (see ​http://www.renew.de)

The approach is in line with other related contributions, such as RenewKube and PetriNetSagas.

The following figure shows the overall architecture of a full cloud native Renew deployment.

Download

The latest version of the cloud native Renew plugin (shown in bold font in the figure) can be downloaded here.

Usage

This section describes the usage in an isolated context, meaning a simple start of a Renew instance along with the cloud native plugin, but not the entire deployment outlined in the figure above. Information on the full deployment will be shown later.

• Make sure to you have Java 11+ and any HTTP enabled tool, such as curl installed on the machine, you want to run Renew on.
• Download the package above and unzip it.
• (optional) If port 8085 is in use on your machine, open the file application.properties and change the entry server.port to an unused port. For the remainder of this guide, it is assumed, that port 8085 is used. If it was changed in the application.properties, it also needs to be changed in the following command line invocations.
• Navigate to the main directory and run ./gradlew build (or .\gradlew build on Windows CMD)
• To start use the following command:
  • Linux/Unix: java -p .:libs -m de.renew.loader gui (depending on your shell you might need to escape the colon character: java -p .\:libs -m de.renew.loader gui
  • Windows: java -p .;libs -m de.renew.loader gui

• Open a command shell and execute curl localhost:8085/log (or use the port you specified earlier in the application.properties file). The log files of the simulator will be returned from the moment onward the cloud native plugin was initialized.
• Open a web browser and navigate to http://localhost:8085/swagger-ui.html to see an API documentation of the service endpoints with their required parameters.

• You can for example upload an existing shadown net system .sns.
  • To create a shadow net system, open up a Renew instance (or use the one spawned by the startup earlier), draw a reference net, save it with a specific name (File -> Save Drawing As...), and hit File -> Export -> Export all drawings (merged file) -> ShadowNetSystem
  • If you created the net within the here supplied Renew instance with the cloud native plugin, close the net drawing, but not Renew itself.
  • Assume the shadow net system file is namend example.sns: Upload the net using: curl -F 'snsZipFile=@example.sns' localhost:8085/upload/sns?fileName=example.sns
• After uploading you can start a simulation. Assume you named the net within example.sns also example.
  • Use this command: curl -X POST 'localhost:8085/simulation/start?mainNet=example&sns=example.sns'
  • The simulation can now be controlled by the endpoint: curl -X POST 'localhost:8085/simulation/control?command=step' Use the keywords:
    • run (To run simulations, that have been paused or only initialized)
    • step (To execute a single step in the simulation)
    • stop or halt (To suspend the simulation but do not terminate it)
    • term (To terminate a simulation irreversibly. Subsequent control commands will have no effects until a new simulation is started.)