7.8. FAQs of clustering

Q1. How to migrate from local to the cluster mode?
Q2. Why is startup failed with the "Port value out of range" error?
Q3. How to solve the "failed sending message to null" error?

Q1.

How to migrate from local to the cluster mode?

If you intend to migrate your production system from the local (non-cluster) to the cluster mode, follow these steps:

  1. Update the configuration to the cluster mode as explained above on your main server.

  2. Use the same configuration on other cluster nodes.

  3. Move the index and value storage to the shared file system.

  4. Start the cluster.

Q2.

Why is startup failed with the "Port value out of range" error?

On Linux, your startup is failed if you encounter the following error:

[INFO] Caused by: java.lang.IllegalArgumentException: Port value out of range: 65536

This problem happens under specific circumstances when the JGroups networking library behind the clustering attempts to detect the IP to communicate with other nodes.

You need to verify:

  • The host name is a valid IP address, served by one of the network devices, such as eth0, and eth1.

  • The host name is NOT defined as localhost or 127.0.0.1.

Q3.

How to solve the "failed sending message to null" error?

If you encounter the following error when starting up in the cluster mode on Linux:

Dec 15, 2010 6:11:31 PM org.jgroups.protocols.TP down
		SEVERE: failed sending message to null (44 bytes)
		java.lang.Exception: dest=/228.10.10.10:45588 (47 bytes)

Be aware that clustering on Linux only works with IPv4. Therefore, when using a cluster under Linux, add the following property to the JVM parameters:

 -Djava.net.preferIPv4Stack=true 

See also

Copyright ©. All rights reserved. eXo Platform SAS
blog comments powered byDisqus