Repository: camel Updated Branches: refs/heads/camel-2.13.x 933d1ba6d -> 9afb04ab8
CAMEL-7472: Polished Javadoc describing the required steps for the manual run of the test. Project: http://git-wip-us.apache.org/repos/asf/camel/repo Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/9afb04ab Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/9afb04ab Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/9afb04ab Branch: refs/heads/camel-2.13.x Commit: 9afb04ab8a9d45d16826610ad3482c6f0e9bdeff Parents: 933d1ba Author: Babak Vahdat <bvah...@apache.org> Authored: Fri May 30 00:14:43 2014 +0200 Committer: Babak Vahdat <bvah...@apache.org> Committed: Fri May 30 00:15:41 2014 +0200 ---------------------------------------------------------------------- .../netty/NettyUDPMulticastAsyncTest.java | 32 +++++++++----------- 1 file changed, 15 insertions(+), 17 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/camel/blob/9afb04ab/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java ---------------------------------------------------------------------- diff --git a/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java b/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java index 78bc7ce..4d9e816 100644 --- a/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java +++ b/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java @@ -29,28 +29,26 @@ import org.junit.Test; /** * To run this test manually through Maven first remove the {@link Ignore} - * annotation below, then make sure you've got a Network interface with the name + * annotation below, then make sure you've got a network interface with the name * <code>en0</code> as given by the route below. If this is not the case run - * your OS specific command to find out which Network interfaces you've got - * supporting IPv4. For example on OS-X you can use the following command for - * this: + * your OS specific command to find out which network interfaces you've got + * supporting IPv4 (e.g. on OS-X that would be the {@code ifconfig -a} command. + * Next you need to enable UDP multicast on your OS for the given multicast + * address of this test ({@code 224.1.2.3}). For this purpose e.g. on OS-X + * follow the steps being described <a href= + * "http://blogs.agilefaqs.com/2009/11/08/enabling-multicast-on-your-macos-unix/" + * >here</a>. Now running the test manually should succeed (<b>but only</b> when + * using Java7+): * * <pre> - * <code>$> ifconfig -a</code> + * mvn test -Djava.net.preferIPv4Stack=true -Dtest=NettyUDPMulticastAsyncTest * </pre> * - * Then replace the <code>en0</code> Network interface name below with your own - * one. Now running the test manually should succeed (<b>only</b> when using - * Java7+): - * - * <pre> - * <code>mvn test -Djava.net.preferIPv4Stack=true -Dtest=NettyUDPMulticastAsyncTest</code> - * </pre> - * - * Note that the usage of JUnit {@link BeforeClass} annotation to achieve the - * same effect would not work in this case as at that stage it would be too late - * to use {@link System#setProperty(String, String) the Java API} to reach the - * same effect. Also setting such a system property through the surefire-plugin + * Please note that using the JUnit {@link BeforeClass} annotation together with + * the corresponding {@link System#setProperty(String, String) Java API} to set + * the {@code java.net.preferIPv4Stack} system property would not work here as + * at that moment it would be too <b>late</b> to set this system property. On + * the other hand setting such a system property through the surefire-plugin * would cause side effect by the other tests of this component. */ @Ignore("See the Javadoc")