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

SocketException[Connection refused]: Designer Studio UI fails



After Pega 7.1.7 is installed (new installation), the Designer Studio user interface does not rendered properly, and links and buttons don't work when clicked.

Error Messages

INFO: [IP1]:5701 [2b4a77682db77b8047ecf40f390ae591] [3.2] Could not connect to: /your_IP_address;your_port#]. Reason: SocketException[Connection refused: connect to address /your_IP_address;your_port#]
May 26, 2015 12:30:35 PM com.hazelcast.cluster.TcpIpJoiner
your_port# [2b4a77682db77b8047ecf40f390ae591] [3.2])

2015-05-26 18:27:39,912 [ PegaRULES-Batch-2] [ STANDARD] [ ] [ PegaRULES:07.10] ( internal.async.AgentQueue) ERROR - Agent Pega-ImportExport #0: @baseclass.pzInstallation encountered an execution error. Restarting after delay. Full text search cluster is not in a ready state. Possible reason(s): Initialization failed / master node not reachable.
at com.pegarules.generated.activity.ra_action_pzftscreateindex_15b2601963759b19f52b48d4545570a4.step1_circum0(
at com.pegarules.generated.activity.ra_action_pzftscreateindex_15b2601963759b19f52b48d4545570a4.perform(

Steps to Reproduce

Log in to a fresh Pega 7.1.7 installation and attempt to use links and buttons in the Designer Studio.

Root Cause

The root cause of this problem is defect or misconfiguration in the operating environment.
The errors in the PegaRULES logs indicate that Initialization of the Search sub-system and hazelcast clustering failed.
A socket issue during hazelcast initialization caused the PRPC node on port 5702 to refuse the connection.


Perform the following local-change. 
Add the following entries in the prconfig.xml file and restart the JVM:

<env name="cluster/hazelcast/multicast/enabled" value="true" />
<env name="identification/cluster/protocol" value="hazelcast" />

For more information about these environment settings for hazelcast clustering, see SA-9502, HazelcastException after upgrading from 7.1.6 to 7.1.7.

Published September 15, 2015 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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