The two projects akka-tutorial and octopus demonstrate how to use the actor programming framework Akka with Java in a distributed setting. The akka-tutorial project is a very simple grid computing app for determining all prime numbers in a given range of numbers. The octopus project, in contrast, performs a binary tree traversal where each node represents some arbitrary work that needs to be performed. Both projects let you start a master system that can be supported in its tasks by arbitrary many slave systems. For a high-level overview of the apps' architectures, have a look at the tutorial slides and the teaching slides.
In order to build and execute the code, you will need Java 8 and Maven.
To make sure that your project is set up correctly in an IDE, you can run the tests in the akka-tutorial/src/test/java folder. If you are operating from a command line instead, run mvn test in the folder with pom.xml file.
Just run the main class de.hpi.akka_tutorial.Main or de.hpi.octopus.OctopusApp, respectively, from within your IDE or from the command line. The app will then print an overview of the different possible parameters. Append parameters of your choice to the run configuration in your IDE or to your command line call, as exemplified below:
- Parameters to start a master with two local workers:
master --workers 2 - Parameters to start a slave that tries to connect to a remote master:
slave --master <master host>:<master port>
mvn package
e.g. java -jar octopus-1.0.jar master -w 2 -h localhost