Projects



Changes between Version 3 and Version 4 of RenewKube


Ignore:
Timestamp:
Feb 8, 2019, 2:04:58 AM (6 years ago)
Author:
moldt
Comment:

First complete version for virtualbox support

Legend:

Unmodified
Added
Removed
Modified
  • RenewKube

    v3 v4  
    22= This is the webpage for RenewKube. =
    33
    4 Petri nets require powerful tools to be executed for token game, visualizations, simulations, programming execution or analysis (verification and validation). Due to the non-recursive size of the state space of Petri net models in the general case in combination with dynamically growing and shrinking numbers of Petri net models have the need for scaling. RenewKube addresses this problem.
     4Petri nets require powerful tools to be executed for token game, visualizations, simulations, programming execution or analysis (verification and validation). The state space of Petri net models can be of the size of non primitiv recursive functions. In combination with dynamically growing and shrinking numbers of Petri net models, like in reference nets, there is a strong need for scaling of simulation execution. RenewKube addresses this problem.
    55
    6 RenewKube is a plugin for the Petri net tool [http://renew.de Renew]. It provides necessary technical frameworks for the design of large models. Embedding into virtual machines and Docker containers becomes easier. Starting from previous solutions with [http://renew.de Renew], Web Services, agent-based models, virtual machines and simple Cloud based implementations RenewKube integrates Docker and Kubernetes in its environment. It offers the scaling of the execution of complex models. 
     6RenewKube is a plugin for the Petri net tool [http://renew.de Renew]. It provides necessary technical frameworks for the design of large models. Embedding into virtual machines and Docker containers becomes easier. Starting from previous solutions with [http://renew.de Renew], Web Services, agent-based models, virtual machines and simple Cloud based implementations RenewKube integrates Docker and Kubernetes in its environment. It offers the scaling of the execution of complex models.
    77
    88RenewKube supports the installation and application of the frameworks and additional software enhancements for [http://renew.de Renew] by scripts and provides a lean interface for distributed simulations. Currently it is a prototypical proof-of-concept implementation, that inherits all basic necessary features for the distributed simulation support.
     
    1010On the one hand some software needs to be installed beside [http://renew.de Renew] and the RenewKube Plugin. With respect to the Petri net models it is also possible to control the scaling from within the Petri net models via two main commands getScale(); and setScale(<number>); inscriptions. These inscriptions are used in addition to the formerly developed DistributePlugin, which is considerably developed further for RenewKube. Starting from a first instance the simulation can grow in remote locations or within other local virtual machines. The Kubernetes Pod concept allows to loose containers at runtime. Up to now [http://renew.de Renew] model simulations on different machines were coupled in a stronger way, so that the whole simulation died when one of the nodes (the simulation running on a node) disappeared. However, this is an experimental features that will be tested in depth during the further development of RenewKube.
    1111
     12
    1213= Architecture =
    1314== Main Components of the software ==
    14 At runtime the simulation has three major parts:
     15At runtime the simulation uses three kinds of major parts:
    1516
    16 1. User node: 
     171. User node:
    1718Contains a [http://renew.de Renew] simulator.
    18 Provides the interface of [http://renew.de Renew] to the user and ensures the communication with the cluster master node. 
     19Provides the interface of [http://renew.de Renew] to the user and ensures the communication with the cluster master node.
    1920
    20 2. N additional worker nodes:
     212. 1 - N additional worker nodes:
    2122Each node contains an own [http://renew.de Renew] simulator.
    22 Each worker node simulation waits until it is called to execute a net simulation. 
     23Each worker node simulation waits until it is called to execute a net simulation.
    2324
    24253. Cluster master node:
    2526Does not contain a [http://renew.de Renew] simulator.
    26 The cluster master node covers most administrative matters. 
    27 It offers four services / components: 
     27The cluster master node covers most administrative matters.
     28It offers four services / components:
    2829a. The container manager (that is provided by Kubernetes) alongside with a network abstraction layer,
    29 b. a private Docker image registry, 
    30 c. the Java RMI registry and 
     30b. a private Docker image registry,
     31c. the Java RMI registry and
    3132d. an integration service called RenewKube manager.
    3233
     34
    3335=== RenewKube manager ===
    34 The RenewKube manager is a stateless application based on Java Spring and the REST technology, which handles multiple things like 
     36The RenewKube manager is a stateless application based on Java Spring and the REST technology, which handles multiple things like
    3537* the integration of additional physical nodes,
    36 * authorization against the Kubernetes manager, 
     38* authorization against the Kubernetes manager,
    3739* relaying information,
    3840* accepting tasks,
    39 * providing the net templates to additional running simulations and 
    40 * handling individual [http://renew.de Renew] extension containers in regards to accessibility from the user node.
     41* providing the net templates to additional running simulations and
     42* handling individual [http://renew.de Renew] extension containers in regard to accessibility from the user node.
    4143
    4244
    43 '''Here we provide a temporarily download for reviewers: [http://www.informatik.uni-hamburg.de/TGI/moldt/renewkube.zip RenewKube.zip]'''
     45'''Here we provide a temporarily download for reviewers: [http://www.informatik.uni-hamburg.de/TGI/moldt/renewkube/renewkube-190207.ova renewkube-190207.ova]'''
     46
    4447
    4548= Prerequisites =
    4649
    47 Installation for the CCPN tools is supported for Unix-like systems (macOS, Linux, BSD,...) and requires the installation of:
     50Installation for RenewKube is supported for Unix-like systems (macOS, Linux, BSD,...) and requires the installation of:
    4851
     52- [https://www.virtualbox.org/ VirtualBox]
     53and several other tools for individual installations
    4954- Java Runtime / Development Environment in Version 9 or later
    5055- [https://git-scm.com/downloads Git]
     
    5257- [https://kubernetes.io/ Kubernetes]
    5358- [http://www.Renew.de/ Renew]
    54 - [https://www.virtualbox.org/ VirtualBox]
    5559- several further operating system specific tools
    5660
    5761= Installation =
    5862
    59 There is one major script that will support the installation process. 
    60 Environment variables like JAVA_HOME etc. must be set according to your specific needs of you environment.
     63There is one major script that will support the installation process.
     64Environment variables like JAVA_HOME etc. must be set according to your specific needs of your environment.
    6165Every component can be installed separately, but we recommend to use our script.
    6266
    6367The steps one needs to take are:
    64 1. Install the basic environment for RenewKube.
    65 2. Download the zip file with all scripts, software for RenewKube provided by us, examples and documentation.
    66 3. Start installer script.
    67 4. Load examples and start the system
     681. Install [https://www.virtualbox.org/ VirtualBox] as the basic environment for RenewKube.
     692. Download the ova file which contains all scripts, software for RenewKube provided by us, a simple example and some documentation.
     703. Follow the [http://www.informatik.uni-hamburg.de/TGI/moldt/renewkube/installer_text.txt installer_text.txt] for installation with [https://www.virtualbox.org/ VirtualBox].
     714. Test the system.
    6872
    6973
    70 The final version of RenewKube will be downloadable soon.
    71 Thank you for your patience!
     74The version of RenewKube can now be downloaded.
     75The current version already works, but is not as comfortable as our local version.
    7276
    73 More information will come soon.
     77We might setup an improved version during next week.
     78For reviewing the http://www.informatik.uni-hamburg.de/TGI/moldt/renewkube/installer_text.txt installer_text.txt] will help to support the installation process.
     79
     80More information will come with our following releases.