[atlassian.jira.startup.ClusteringChecklistLauncher] Clustering startup check failed

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

Symptoms

One or more of the nodes fail to start up, the web UI for the node says either or both of the following:

  • JIRA is configured with a cluster.properties file, but the node ID is not set.

  • JIRA is configured with a cluster.properties file, but the shared home directory is not set.

The following appears in the atlassian-jira.log:

1 2 3 4 5 6 7 8 9 10 11 12 2014-06-17 15:20:32,925 localhost-startStop-1 FATAL [atlassian.jira.startup.JiraStartupLogger] ******************************************************************************************** JIRA is configured with a cluster.properties file, but the shared home directory is not set. ******************************************************************************************** 2014-06-17 15:20:32,925 localhost-startStop-1 FATAL [atlassian.jira.startup.JiraStartupLogger] ****************************************************************************** JIRA is configured with a cluster.properties file, but the node ID is not set. ****************************************************************************** 2014-06-17 15:20:33,138 localhost-startStop-1 FATAL [atlassian.jira.startup.ClusteringChecklistLauncher] JIRA Cluster Shared Home Check failed: JIRA is configured with a cluster.properties file, but the shared home directory is not set. 2014-06-17 15:20:33,138 localhost-startStop-1 FATAL [atlassian.jira.startup.ClusteringChecklistLauncher] Clustering startup check failed. 2014-06-17 15:20:33,138 localhost-startStop-1 FATAL [atlassian.jira.startup.ClusteringChecklistLauncher] JIRA Cluster Node ID Check failed: JIRA is configured with a cluster.properties file, but the node ID is not set. 2014-06-17 15:20:33,138 localhost-startStop-1 FATAL [atlassian.jira.startup.ClusteringChecklistLauncher] Clustering startup check failed.

Cause

The cluster.properties file under the local <JIRA-HOME> is missing or not readable by the user running JIRA.

Resolution

  • Make sure the cluster.properties file is readable by the user running JIRA on the cluster node.

  • Make sure it has the node id and the shared home properly defined.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.