Tutorial



Welcome to Our Tutorial!

The individual steps of the tutorial are listed on the right side in the menu. You can read serially or jump back and forth as you like.

Preparations

Please unpack the RAR archive into a directory of your choice. The files are located under the directory "D1-2.0.1" (depending on the version).

To translate the JAVA™ files we use the build system Gradle. If it is not yet on your system, download and install it from the Gradle Website.

To change the examples, install the JAVA™ IDE Eclipse. Here you can find the Eclipse-Homepage.

Translation of the Examples and Download of the Required Libraries

The translation with Gradle is quite simple. Create a command line shell and go to the project directory "D1-2.0.1/D1". Now start Gradle in "Continuous Build" mode with gradle -t jar. Gradle will download the required third-party libraries and translate the sample code. The libraries end up in the directory "D1-2.0.1/D1/lib", the Plug-In JARs in the directory "D1-2.0.1/D1/plugins".

Now you can start one or more NODEs. We have prepared 6 NODEs that can run on the same computer. We simply use different ports for each NODE. Go to the node001 directory and have a look on the start.cmd batch file. You can simply start the NODE with it.

The first NODE (001) loads some plug-ins for a user interface, the monitor. This is used to display LOG files and message sequences (not only that of the local NODE). It also loads the first sample plug-in.

The NODEs 002-006 don't do anything special. They start without user interface. NODE 002 additionally loads the second example plugin.

Starting from Eclipse

Start Eclipse and select the "D1-2.0.1" directory as Workbench directory. Under File/Import you can load the projects of the examples. In the dialog select "Existing Projects into Workspace".

As root directory, select the "D1-2.0.1" directory. Select all displayed projects and confirm.

The projects "D1ExamplesXXX" are the sample projects. They are compiled to plug-ins and loaded in NODE 001 or 002.

You can start the NODEs in the menu: Run/Run Configurations.... It is possible to debug several NODEs at the same time. If you started Gradle in "Continuous Build" mode, it will create the JAR files every time you save your changes. So you can try out your changes immediately after saving.

The PDF in the D1 directory shows you an overview of the 6 NODEs:

You can create further NODEs (for example by copying the node006 directory). Then you have to adjust the configuration of the new NODE, especially NODEID (all must be different) and the TCP links.

Have fun playing!