You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by cl...@apache.org on 2015/09/02 16:23:12 UTC
[5/6] activemq-artemis git commit: Adding chapter about UDP
troubleshooting
Adding chapter about UDP troubleshooting
This is mostly importing some information that used to exist on old docs
Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo
Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/2cf0bb71
Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/2cf0bb71
Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/2cf0bb71
Branch: refs/heads/master
Commit: 2cf0bb71c412504b42405bc918405b8af54f4412
Parents: fa15b29
Author: Clebert Suconic <cl...@apache.org>
Authored: Tue Sep 1 23:27:34 2015 -0400
Committer: Clebert Suconic <cl...@apache.org>
Committed: Wed Sep 2 10:21:33 2015 -0400
----------------------------------------------------------------------
docs/user-manual/en/SUMMARY.md | 2 +-
docs/user-manual/en/perf-tuning.md | 19 +++++++++++++++++++
2 files changed, 20 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/2cf0bb71/docs/user-manual/en/SUMMARY.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md
index 923b905..1bb6552 100644
--- a/docs/user-manual/en/SUMMARY.md
+++ b/docs/user-manual/en/SUMMARY.md
@@ -54,6 +54,6 @@
* [Protocols and Interoperability](protocols-interoperability.md)
* [Tools](tools.md)
* [Maven Plugin](maven-plugin.md)
-* [Performance Tuning](perf-tuning.md)
+* [Troubleshooting and Performance Tuning](perf-tuning.md)
* [Configuration Reference](configuration-index.md)
http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/2cf0bb71/docs/user-manual/en/perf-tuning.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/perf-tuning.md b/docs/user-manual/en/perf-tuning.md
index b9de082..beb387b 100644
--- a/docs/user-manual/en/perf-tuning.md
+++ b/docs/user-manual/en/perf-tuning.md
@@ -250,4 +250,23 @@ tunings won't apply to JDKs from other providers (e.g. IBM or JRockit)
yourself do you really need MDBs? Can you accomplish the same task
using just a normal message consumer?
+## Troubleshooting
+
+### UDP not working
+
+In certain situations UDP used on discovery may not work. Typical situations are:
+
+1. The nodes are behind a firewall. If your nodes are on different machines then it is possible that the firewall is blocking the multicasts. you can test this by disabling the firewall for each node or adding the appropriate rules.
+2. You are using a home network or are behind a gateway. Typically home networks will redirect any UDP traffic to the Internet Service Provider which is then either dropped by the ISP or just lost. To fix this you will need to add a route to the firewall/gateway that will redirect any multicast traffic back on to the local network instead.
+3. All the nodes are in one machine. If this is the case then it is a similar problem to point 2 and the same solution should fix it. Alternatively you could add a multicast route to the loopback interface. On linux the command would be:
+```sh
+# you should run this as root
+route add -net 224.0.0.0 netmask 240.0.0.0 dev lo
+```
+ This will redirect any traffic directed to the 224.0.0.0 to the loopback interface. This will also work if you have no network at all.
+
+ * on Mac OS X, the command is slightly different:
+```sh
+sudo route add 224.0.0.0 127.0.0.1 -netmask 240.0.0.0
+```