You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2015/01/21 18:44:57 UTC

karaf-cellar git commit: Upgrade user guide about Hazelcast multicast/tcp-ip configuration.

Repository: karaf-cellar
Updated Branches:
  refs/heads/master 37942b9d4 -> 4285d4253


Upgrade user guide about Hazelcast multicast/tcp-ip configuration.


Project: http://git-wip-us.apache.org/repos/asf/karaf-cellar/repo
Commit: http://git-wip-us.apache.org/repos/asf/karaf-cellar/commit/4285d425
Tree: http://git-wip-us.apache.org/repos/asf/karaf-cellar/tree/4285d425
Diff: http://git-wip-us.apache.org/repos/asf/karaf-cellar/diff/4285d425

Branch: refs/heads/master
Commit: 4285d4253b3d75313c4bb0a8121da4dd81169a8a
Parents: 37942b9
Author: Jean-Baptiste Onofré <jb...@apache.org>
Authored: Wed Jan 21 18:44:29 2015 +0100
Committer: Jean-Baptiste Onofré <jb...@apache.org>
Committed: Wed Jan 21 18:44:29 2015 +0100

----------------------------------------------------------------------
 manual/src/main/webapp/user-guide/hazelcast.conf | 6 +++++-
 manual/src/main/webapp/user-guide/nodes.conf     | 8 +++++++-
 2 files changed, 12 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/karaf-cellar/blob/4285d425/manual/src/main/webapp/user-guide/hazelcast.conf
----------------------------------------------------------------------
diff --git a/manual/src/main/webapp/user-guide/hazelcast.conf b/manual/src/main/webapp/user-guide/hazelcast.conf
index ba76906..72613ce 100644
--- a/manual/src/main/webapp/user-guide/hazelcast.conf
+++ b/manual/src/main/webapp/user-guide/hazelcast.conf
@@ -61,6 +61,10 @@ Cellar nodes:
             </tcp-ip>
 {code}
 
+NB: in previous Hazelcast versions (especially the one used by Cellar 2.3.x), it was possible to have multicast and tcp-ip enabled in the same time.
+In Hazelcast 3.3.x (the version currently used by Cellar 3.0.x), only one discover mechanism can be enabled at a time. Cellar uses multicast by default (tcp-ip is disabled).
+If your network or network interface don't support multicast, you have to enable tcp-ip and disable multicast.
+
 You can also discover nodes located on a Amazon instance:
 
 {code}
@@ -112,4 +116,4 @@ Two modes are supported:
             <!-- iteration count to use when generating the secret key -->
             <iteration-count>19</iteration-count>
         </symmetric-encryption>
-{code}
\ No newline at end of file
+{code}

http://git-wip-us.apache.org/repos/asf/karaf-cellar/blob/4285d425/manual/src/main/webapp/user-guide/nodes.conf
----------------------------------------------------------------------
diff --git a/manual/src/main/webapp/user-guide/nodes.conf b/manual/src/main/webapp/user-guide/nodes.conf
index a367be8..ce8114f 100644
--- a/manual/src/main/webapp/user-guide/nodes.conf
+++ b/manual/src/main/webapp/user-guide/nodes.conf
@@ -19,6 +19,12 @@ x | node2:5702     | node2 | 5702
 
 The starting 'x' indicates that it's the Karaf instance on which you are logged on (the local node).
 
+NB: if you don't see the other nodes there (whereas they should be there), it's probably due to a network issue. By default, Cellar uses multicast to discover the nodes.
+If your network or network interface don't support multicast, you have to switch to tcp-ip instead of multicast. See [Core Configuration|hazelcast] for details.
+
+NB: in Cellar 2.3.x, Cellar used both multicast and tcp-ip by default. Due to a change in Hazelcast, it's no more possible to have both. Now, in Cellar 3.0.x, the default
+configuration is multicast enabled, tcp-ip disabled. See [Core Configuration|hazelcast] for details.
+
 h2. Testing nodes
 
 You can ping a node to test it:
@@ -175,4 +181,4 @@ h2. Clustered resources
 
 Cellar provides dedicated commands and MBeans for clustered resources.
 
-Please, go into the [cluster groups|groups] section for details.
\ No newline at end of file
+Please, go into the [cluster groups|groups] section for details.