My cluster is running, but some of my nodes can't join. What do I do?

Created by Steve Place, Modified on Thu, 01 Jun 2023 at 03:30 PM by Steve Place

If none of your nodes can join, see this article.


If your node can't join because it can't obtain join lock, you need to keep waiting or stop writes to the cluster so that it can join. 


If there is some other error you are repeatedly getting, follow these steps.

  1. Back up the STARDOG_HOME directory for the node(s) that can't join.
  2. Remove all files from the home directory except the stardog.properties file and the license file.
    1. Also refrain from deleting any files not managed by Stardog, such as keystores and other files related to SSL connections. However, we strongly recommend you store these files elsewhere, so that only files managed by Stardog are in your STARDOG_HOME directory.
  3. Start the node and allow it to sync. It will copy everything it needs from the node already in the cluster.

You do not need to take your cluster offline to do this.


Please note that the 3 steps above are not part of normal operations. If you get to the point of needing to take them, please file a support ticket after you have done so. When you file your ticket, please provide all of the information listed here.


For general information on clusters, as well as instructions for installing and operating clusters, please see the docs.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article