raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 11

Merge pull request #806 from akka/wip-cluster-java-sample-run-patriknw

Browse source 
Mavenize java akka-sample-cluster
This commit is contained in:
Viktor Klang (√) 2012-10-16 05:47:00 -07:00
commit b68c7a8469
3 changed files with 148 additions and 45 deletions
Download patch file Download diff file Expand all files Collapse all files

104
akka-docs/rst/cluster/cluster-usage-java.rst
View file

@ -25,6 +25,8 @@ version from
`<http://repo.typesafe.com/typesafe/snapshots/com/typesafe/akka/akka-cluster-experimental_@binVersion@/>`_. `<http://repo.typesafe.com/typesafe/snapshots/com/typesafe/akka/akka-cluster-experimental_@binVersion@/>`_.
We recommend against using ``SNAPSHOT`` in order to obtain stable builds. We recommend against using ``SNAPSHOT`` in order to obtain stable builds.
.. _cluster_simple_example_java:
A Simple Cluster Example A Simple Cluster Example
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
@ -54,17 +56,33 @@ ip-addresses or host names of the machines in ``application.conf`` instead of ``
.. literalinclude:: ../../../akka-samples/akka-sample-cluster/src/main/java/sample/cluster/simple/japi/SimpleClusterApp.java .. literalinclude:: ../../../akka-samples/akka-sample-cluster/src/main/java/sample/cluster/simple/japi/SimpleClusterApp.java
:language: java :language: java
3. Add `maven exec plugin <http://mojo.codehaus.org/exec-maven-plugin/introduction.html>`_ to your pom.xml::
3. Start the first seed node. Open a sbt session in one terminal window and run:: <project>
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>exec-maven-plugin</artifactId>
<version>1.2.1</version>
</plugin>
</plugins>
</build>
</project>
run-main sample.cluster.simple.japi.SimpleClusterApp 2551
4. Start the first seed node. Open a terminal window and run (one line)::
mvn exec:java -Dexec.mainClass="sample.cluster.simple.japi.SimpleClusterApp" \
-Dexec.args="2551"
2551 corresponds to the port of the first seed-nodes element in the configuration. 2551 corresponds to the port of the first seed-nodes element in the configuration.
In the log output you see that the cluster node has been started and changed status to 'Up'. In the log output you see that the cluster node has been started and changed status to 'Up'.
4. Start the second seed node. Open a sbt session in another terminal window and run:: 5. Start the second seed node. Open another terminal window and run::
run-main sample.cluster.simple.japi.SimpleClusterApp 2552 mvn exec:java -Dexec.mainClass="sample.cluster.simple.japi.SimpleClusterApp" \
-Dexec.args="2552"
2552 corresponds to the port of the second seed-nodes element in the configuration. 2552 corresponds to the port of the second seed-nodes element in the configuration.
@ -73,9 +91,9 @@ and becomes a member of the cluster. It's status changed to 'Up'.
Switch over to the first terminal window and see in the log output that the member joined. Switch over to the first terminal window and see in the log output that the member joined.
5. Start another node. Open a sbt session in yet another terminal window and run:: 6. Start another node. Open a sbt session in yet another terminal window and run::
run-main sample.cluster.simple.japi.SimpleClusterApp mvn exec:java -Dexec.mainClass="sample.cluster.simple.japi.SimpleClusterApp"
Now you don't need to specify the port number, and it will use a random available port. Now you don't need to specify the port number, and it will use a random available port.
It joins one of the configured seed nodes. Look at the log output in the different terminal It joins one of the configured seed nodes. Look at the log output in the different terminal
@ -197,23 +215,28 @@ Death watch uses the cluster failure detector for nodes in the cluster, i.e. it
network failures and JVM crashes, in addition to graceful termination of watched network failures and JVM crashes, in addition to graceful termination of watched
actor. actor.
This example is included in ``akka-samples/akka-sample-cluster`` This example is included in ``akka-samples/akka-sample-cluster`` and you can try it by copying the
and you can try by starting nodes in different terminal windows. For example, starting 2 `source <https://github.com/akka/akka/tree/master/akka-samples/akka-sample-cluster>`_ to your
maven project, defined as in :ref:`cluster_simple_example_java`.
Run it by starting nodes in different terminal windows. For example, starting 2
frontend nodes and 3 backend nodes:: frontend nodes and 3 backend nodes::
sbt mvn exec:java \
-Dexec.mainClass="sample.cluster.transformation.japi.TransformationFrontendMain" \
-Dexec.args="2551"
project akka-sample-cluster-experimental mvn exec:java \
-Dexec.mainClass="sample.cluster.transformation.japi.TransformationBackendMain" \
-Dexec.args="2552"
run-main sample.cluster.transformation.japi.TransformationFrontendMain 2551 mvn exec:java \
-Dexec.mainClass="sample.cluster.transformation.japi.TransformationBackendMain"
run-main sample.cluster.transformation.japi.TransformationBackendMain 2552 mvn exec:java \
-Dexec.mainClass="sample.cluster.transformation.japi.TransformationBackendMain"
run-main sample.cluster.transformation.japi.TransformationBackendMain mvn exec:java \
-Dexec.mainClass="sample.cluster.transformation.japi.TransformationFrontendMain"
run-main sample.cluster.transformation.japi.TransformationBackendMain
run-main sample.cluster.transformation.japi.TransformationFrontendMain
.. note:: The above example should probably be designed as two separate, frontend/backend, clusters, when there is a `cluster client for decoupling clusters <https://www.assembla.com/spaces/akka/tickets/1165>`_. .. note:: The above example should probably be designed as two separate, frontend/backend, clusters, when there is a `cluster client for decoupling clusters <https://www.assembla.com/spaces/akka/tickets/1165>`_.
@ -355,21 +378,26 @@ This means that user requests can be sent to ``StatsService`` on any node and it
``StatsWorker`` on all nodes. There can only be one worker per node, but that worker could easily ``StatsWorker`` on all nodes. There can only be one worker per node, but that worker could easily
fan out to local children if more parallelism is needed. fan out to local children if more parallelism is needed.
This example is included in ``akka-samples/akka-sample-cluster`` This example is included in ``akka-samples/akka-sample-cluster`` and you can try it by copying the
and you can try by starting nodes in different terminal windows. For example, starting 3 `source <https://github.com/akka/akka/tree/master/akka-samples/akka-sample-cluster>`_ to your
maven project, defined as in :ref:`cluster_simple_example_java`.
Run it by starting nodes in different terminal windows. For example, starting 3
service nodes and 1 client:: service nodes and 1 client::
sbt mvn exec:java \
-Dexec.mainClass="run-main sample.cluster.stats.japi.StatsSampleMain" \
-Dexec.args="2551"
project akka-sample-cluster-experimental mvn exec:java \
-Dexec.mainClass="run-main sample.cluster.stats.japi.StatsSampleMain" \
-Dexec.args="2552"
run-main sample.cluster.stats.japi.StatsSampleMain 2551 mvn exec:java \
-Dexec.mainClass="run-main sample.cluster.stats.japi.StatsSampleMain"
run-main sample.cluster.stats.japi.StatsSampleMain 2552 mvn exec:java \
-Dexec.mainClass="run-main sample.cluster.stats.japi.StatsSampleMain"
run-main sample.cluster.stats.japi.StatsSampleClientMain
run-main sample.cluster.stats.japi.StatsSampleMain
The above setup is nice for this example, but we will also take a look at how to use The above setup is nice for this example, but we will also take a look at how to use
a single master node that creates and deploys workers. To keep track of a single a single master node that creates and deploys workers. To keep track of a single
@ -387,22 +415,26 @@ All nodes start ``StatsFacade`` and the router is now configured like this:
.. includecode:: ../../../akka-samples/akka-sample-cluster/src/main/java/sample/cluster/stats/japi/StatsSampleOneMasterMain.java#start-router-deploy .. includecode:: ../../../akka-samples/akka-sample-cluster/src/main/java/sample/cluster/stats/japi/StatsSampleOneMasterMain.java#start-router-deploy
This example is included in ``akka-samples/akka-sample-cluster`` and you can try it by copying the
This example is included in ``akka-samples/akka-sample-cluster`` `source <https://github.com/akka/akka/tree/master/akka-samples/akka-sample-cluster>`_ to your
and you can try by starting nodes in different terminal windows. For example, starting 3 maven project, defined as in :ref:`cluster_simple_example_java`.
Run it by starting nodes in different terminal windows. For example, starting 3
service nodes and 1 client:: service nodes and 1 client::
sbt mvn exec:java \
-Dexec.mainClass="sample.cluster.stats.japi.StatsSampleOneMasterMain" \
-Dexec.args="2551"
project akka-sample-cluster-experimental mvn exec:java \
-Dexec.mainClass="sample.cluster.stats.japi.StatsSampleOneMasterMain" \
-Dexec.args="2552"
run-main sample.cluster.stats.japi.StatsSampleOneMasterMain 2551 mvn exec:java \
-Dexec.mainClass="sample.cluster.stats.japi.StatsSampleOneMasterClientMain"
run-main sample.cluster.stats.japi.StatsSampleOneMasterMain 2552 mvn exec:java \
-Dexec.mainClass="sample.cluster.stats.japi.StatsSampleOneMasterMain"
run-main sample.cluster.stats.japi.StatsSampleOneMasterClientMain
run-main sample.cluster.stats.japi.StatsSampleOneMasterMain
.. note:: The above example, especially the last part, will be simplified when the cluster handles automatic actor partitioning. .. note:: The above example, especially the last part, will be simplified when the cluster handles automatic actor partitioning.

50
akka-docs/rst/project/links.rst
View file

@ -1,13 +1,17 @@
.. _support: .. _support:
#########
Project
#########
Commercial Support Commercial Support
================== ^^^^^^^^^^^^^^^^^^
Commercial support is provided by `Typesafe <http://typesafe.com>`_. Commercial support is provided by `Typesafe <http://typesafe.com>`_.
Akka is now part of the `Typesafe Stack <http://typesafe.com/stack>`_. Akka is now part of the `Typesafe Stack <http://typesafe.com/stack>`_.
Mailing List Mailing List
============ ^^^^^^^^^^^^
`Akka User Google Group <http://groups.google.com/group/akka-user>`_ `Akka User Google Group <http://groups.google.com/group/akka-user>`_
@ -15,13 +19,13 @@ Mailing List
Downloads Downloads
========= ^^^^^^^^^
`<http://akka.io/downloads/>`_ `<http://akka.io/downloads/>`_
Source Code Source Code
=========== ^^^^^^^^^^^
Akka uses Git and is hosted at `Github <http://github.com>`_. Akka uses Git and is hosted at `Github <http://github.com>`_.
@ -29,7 +33,7 @@ Akka uses Git and is hosted at `Github <http://github.com>`_.
Releases Repository Releases Repository
=================== ^^^^^^^^^^^^^^^^^^^
The Akka Maven repository can be found at http://repo.akka.io/releases/. The Akka Maven repository can be found at http://repo.akka.io/releases/.
@ -50,7 +54,7 @@ underlying repositories directly.
Snapshots Repository Snapshots Repository
==================== ^^^^^^^^^^^^^^^^^^^^
Nightly builds are available in http://repo.akka.io/snapshots/ and proxied through Nightly builds are available in http://repo.akka.io/snapshots/ and proxied through
http://repo.typesafe.com/typesafe/snapshots/ as both ``SNAPSHOT`` and http://repo.typesafe.com/typesafe/snapshots/ as both ``SNAPSHOT`` and
@ -60,12 +64,40 @@ For timestamped versions, pick a timestamp from
http://repo.typesafe.com/typesafe/snapshots/com/typesafe/akka/akka-actor_@binVersion@/. http://repo.typesafe.com/typesafe/snapshots/com/typesafe/akka/akka-actor_@binVersion@/.
All Akka modules that belong to the same build have the same timestamp. All Akka modules that belong to the same build have the same timestamp.
Make sure that you add the repository to the sbt resolvers or maven repositories:: sbt definition of snapshot repository
-------------------------------------
Make sure that you add the repository to the sbt resolvers::
resolvers += "Typesafe Snapshots" at "http://repo.typesafe.com/typesafe/snapshots/" resolvers += "Typesafe Snapshots" at "http://repo.typesafe.com/typesafe/snapshots/"
Define the library dependencies with the timestamp as version. For example:: Define the library dependencies with the timestamp as version. For example::
libraryDependencies += "com.typesafe.akka" % "akka-actor_@binVersion@" % "2.1-20120913-000917" libraryDependencies += "com.typesafe.akka" % "akka-remote_@binVersion@" % "2.1-20121016-001042"
maven definition of snapshot repository
---------------------------------------
Make sure that you add the repository to the maven repositories in pom.xml::
<repositories>
<repository>
<id>typesafe-snapshots</id>
<name>Typesafe Snapshots</name>
<url>http://repo.typesafe.com/typesafe/snapshots/</url>
<layout>default</layout>
</repository>
</repositories>
Define the library dependencies with the timestamp as version. For example::
<dependencies>
<dependency>
<groupId>com.typesafe.akka</groupId>
<artifactId>akka-remote_@binVersion@</artifactId>
<version>2.1-20121016-001042</version>
</dependency>
</dependencies>
libraryDependencies += "com.typesafe.akka" % "akka-remote_@binVersion@" % "2.1-20120913-000917"

39
akka-samples/akka-sample-cluster/pom.xml Normal file
View file

@ -0,0 +1,39 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.typesafe.akka</groupId>
<artifactId>akka-sample-cluster-experimental-japi</artifactId>
<version>2.1-SNAPSHOT</version>
<packaging>jar</packaging>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>com.typesafe.akka</groupId>
<artifactId>akka-cluster-experimental_2.10.0-RC1</artifactId>
<version>2.1-20121016-001042</version>
</dependency>
</dependencies>
<repositories>
<repository>
<id>typesafe-snapshots</id>
<name>Typesafe Snapshots</name>
<url>http://repo.typesafe.com/typesafe/snapshots/</url>
<layout>default</layout>
</repository>
</repositories>
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>exec-maven-plugin</artifactId>
<version>1.2.1</version>
</plugin>
</plugins>
</build>
</project>