Configuring Hazelcast ports
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Hazelcast is a third-party technology that is used when Confluence Data Center is installed in a cluster configuration. It is used both by Confluence and Synchrony.
Hazelcast can be configured to use different ports by passing in Java System Properties. See Configuring System Properties to find out the various ways system properties can be set for your site.
Hazelcast port for Confluence
The Hazelcast port for Confluence can be changed by setting the confluence.cluster.hazelcast.listenPort
system property. The way this property is set is by adding the confluence.cluster.hazelcast.listenPort property in the
<installation-directory>/bin/setenv.sh
file's CATALINA_OPTS= section as such:
CATALINA_OPTS="-Dconfluence.cluster.hazelcast.listenPort=5801 ${CATALINA_OPTS}"
If the confluence.cluster.hazelcast.listenPort
system property is not present, the Hazelcast port for Confluence will default to port 5801.
Hazelcast port for Synchrony
The Hazelcast port for Synchrony can be changed by setting the cluster.listen.port system
property. The way this property is passed to Synchrony depends on how you run Synchrony and the Confluence version.
- If you run a Synchrony standalone cluster, the Hazelcast port is customized by adding the
cluster.listen.port
property in thestart-synchrony.sh
orstart-synchrony.bat
script.LinuxOPTIONAL_OVERRIDES="-Dcluster.listen.port=5701"
Windowsset OPTIONAL_OVERRIDES=-Dcluster.listen.port=5701
- If you use Confluence managed Synchrony, the Hazelcast port is customized by:
- For Confluence 9.1.0+, add the
cluster.listen.port
property to the main Confluence JVM flags as per Configuring System Properties which will flow onto managed Synchrony process. e.g. On Linux:CATALINA_OPTS="-Dcluster.listen.port=5701 ${CATALINA_OPTS}"
- For versions older than Confluence 9.1.0, add the
cluster.listen.port
property to thesynchrony-args.properties
file.cluster.listen.port=5701
- For Confluence 9.1.0+, add the
If the cluster.listen.port
property is not present, the Hazelcast port for Synchrony will default to port 5701.