raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 10
pekko/akka-samples/akka-sample-osgi-dining-hakkers
History
Sander Mak a44d2720e0 =doc,osg Effort to get OSGi integration tests running again 
* Update protobuf dependency so mvn clean install runs again
* Bump OSGi version range in AkkaBuild to include current 2.3 for generated manifests
* Update path in dev documentation to correct TexBasic folder
2013-11-01 16:34:49 +01:00
..
api Resolve naming/packaging problems 2013-04-07 14:10:52 -04:00
assembly-dist Resolve naming/packaging problems 2013-04-07 14:10:52 -04:00
assembly-features =doc,osg Effort to get OSGi integration tests running again 2013-11-01 16:34:49 +01:00
command Resolve naming/packaging problems 2013-04-07 14:10:52 -04:00
core !clu #3416 Use plain protobuf and protoc 2013-09-19 14:46:14 +02:00
integration-test OSGi Make the integration test work again. See #3292 2013-05-29 22:27:24 +02:00
uncommons Resolve naming/packaging problems 2013-04-07 14:10:52 -04:00
karaf.sh Resolve naming/packaging problems 2013-04-07 14:10:52 -04:00
osgi-run.sh Resolve naming/packaging problems 2013-04-07 14:10:52 -04:00
pom.xml =doc,osg Effort to get OSGi integration tests running again 2013-11-01 16:34:49 +01:00
README.md akka.sample.osgi.dining-hakkers integration test 2013-03-01 21:49:50 +01:00

README.md

akka-osgi-sample : Clustered DiningHakkers

This project may be used to test akka bundles in OSGi Frameworks. The build tool (sbt for the moment) provide scripts to run in an OSGi Framework (Karaf only for the moment) a version of the DiningHakkers that runs on several nodes using the akka-cluster module.

Bundle overview

This project provides three Osgi Bundles

  • api providing an API for the Service exposed by the core and used by the command
  • core implementing the whole logic: clustered connections, Hakkers, ChopSticks. Finally it provides an ActorRef of one created Hakker
  • command use a service to get a Hakker (ActorRef) with its position around the table

An integration testing module is provided to verify OSGi functionality:

  • integration-test

Two modules that provision the project into the Karaf OSGi container for experimentation and integration testing:

  • assembly-features defines the karaf "feature" that allows Karaf to provision the bundles
  • assembly-dist creates a distribution tar.gz and zip file containing the configured Karaf runtime

How to use it

Setup with sbt

just run:

sbt clean
sbt package
sbt osgi-bundle

sbt will creates the bundles in each subproject akka-sample/akka-sample-osgi-dining-hakkers/(api, command, core)/target directories. To have integration tests and OSGi environment loaded, please use the Maven build (at least for the moment)

Setup with Maven

mvn clean install

The assembly-dist/target/ directory will now contain a tar.gz file that contains a pre-configured Karaf runtime. This can be extracted to any location, and bin/karaf executed. The provided karaf.sh script automates this.

Run

Extract the OSGi Framework from the tar.gz described above into any location, or run: ./karaf.sh

Execute the framework by running bin/karaf from inside the extracted directory.

Then try to restart some bundles, to test the stability of the bundles:

list to get the list of the bundles restart #bundle_number to restart the bundle using its ID exit or CTRL-D to exit the Karaf console

Depending on the akka version you're using, you may need to modify the core bundle when deploying on a second machine, to set its akka.remote.netty.hostname in the application.conf.