Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Node cannot join Hazelcast cluster



The second node of a multi-node system is not communicating with the Pega Cluster, and is indicating "Node failed to start" in the logfile when attempting to boot.

Error Messages

2016-11-18 13:16:12,517 [ ip-10-255-25xxx] [ STANDARD] [ ] [ ] ( hazelcast.instance.Node) FATAL - []:5701 [bd387c6b4d0465b247bdb4f35669b73f] [3.4.1] Could not join cluster in 300000 ms. Shutting down now!
2016-11-18 13:16:12,837 [ ip-10-255-2yyy] [ STANDARD] [ ] [ ] ( internal.access.DatabaseImpl) ERROR - Encountered problem when performing a Commit
java.lang.IllegalStateException: Node failed to start!

Steps to Reproduce

Attempt to start node.

Root Cause

A defect or configuration issue in the operating environment:  

The server machines have more than one NIC installed.

During the server start up, some server instances chose to use an IP address associated to a NIC that does not map the machine's hostname and thus caused the reported hazelcast start-up failure. 


In systems with multiple network interfaces, one can can also specify which network interface Hazelcast should use.

Servers often have more than one network interface so you may want to list the valid IPs. Range characters ('*' and '-') can be used for simplicity.

So 10.255.255.*, for instance, refers to IPs between and

Interface refers to IPs between and (4 and 18 included).

If Hazelcast cannot find a matching interface, then it will print a message to the console and will not start on that node.

The setting for Hazelcast to use a specified network interface is "cluster/hazelcast/interface".

For example:

<env name="cluster/hazelcast/interface" value="10.255.255.*" />

The setting can be added to the prconfig.xml file or applied through Dynamic System Setting.

Suggest Edit

Published December 19, 2016 - Updated October 8, 2020

Did you find this content helpful? Yes No

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us