Confluence Datacenter Clustering page stuck with configure your cluster message

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs 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

Summary

The Clustering page is stuck with the following message:

(Auto-migrated image: description temporarily unavailable)

Environment

Confluence Datacenter

Diagnosis

Confluence Datacenter offers the clustering option for your installation. After installing Confluence and configuring the cluster, you may navigate to the Clustering page as a Confluence administrator to check the configuration after the installation. However, the clustering page is stuck with the message – Cluster mode is now enabled. Restart Confluence to create and configure your cluster.

Following the message guidance, restarting Confluence should allow you to complete the cluster configuration but the same message is presented. The Clustering page should present the following when configured:

(Auto-migrated image: description temporarily unavailable)

Cause

The root cause is unknown but the Clustering option is set in the confluence.cfg.xml file and if the values of the properties are wrong, this problem will appear. In this case, the problem is with two parameters:

1 2 <property name="cluster.setup.ready">true</property> <property name="confluence.cluster">false</property>

After completing the cluster configuration, the property –  cluster.setup.ready – shouldn't exist. Also, the property – confluence.cluster – should be set to true.

Solution

The solution is only available to an installation that already completed the clustering configuration during the setup process.

  1. Shutdown Confluence

  2. Navigate to <confluence-home-folder>

  3. Find and edit the confluence.cfg.xml file

    1. Not to be confused with the confluence.cfg.xml file that exists in the shared-home. The file we're going to edit is from the home folder of a node, each node has its own home folder and a unique shared-home folder exists for the cluster.

  4. Delete the following property:

    1 <property name="cluster.setup.ready">true</property>
  5. Change the following property value from false to true:

    1 <property name="confluence.cluster">true</property>
  6. Save the change

  7. Restart Confluence

Updated on March 13, 2025

Still need help?

The Atlassian Community is here for you.