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

Still need help?

The Atlassian Community is here for you.

Ask the community

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

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:

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.
Last modified on Jan 14, 2025

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.