Troubleshooting
Problem
Purging gossip state on a node
The DataStax Enterprise Help Center also provides troubleshooting information.
Gossip information is persisted locally by each node to use immediately on node restart without having to wait for gossip communications.
Procedure
In the unlikely event you need to correct a problem in the gossip state:
- Use the nodetool assassinate to shut down the problem node.
This takes approximately 35 seconds to complete, so wait for confirmation that the node is deleted.
- If this method doesn't solve the problem, stop your client application from sending writes to the cluster.
- Take the entire cluster offline:
- Drain each node.
nodetool options drain
- Stop each node.
- Drain each node.
- Clear the data from the peers directory, remove all directories in the peers-UUID directory, where UUID is the particular directory that corresponds to the appropriate node:
sudo rm -r /var/lib/cassandra/data/system/peers-UUID/*
CAUTION:
Use caution when performing this step. The action clears internal system data from the database and may cause application outage without careful execution and validation of the results. To validate the results, run the following query individually on each node to confirm that all of the nodes are able to see all other nodes.select * from system.peers; - Clear the gossip state when the node starts:
- For tarball or Installer No-Services installations, use a command line option or edit the cassandra-env.sh. To use the command line:
installation_location/bin/cassandra -Dcassandra.load_ring_state=false
- For package or Installer Services installations or if you are not using the command line option above, add the following line to the cassandra-env.sh file:
JVM_OPTS="$JVM_OPTS -Dcassandra.load_ring_state=false"
- For tarball or Installer No-Services installations, use a command line option or edit the cassandra-env.sh. To use the command line:
- Bring the cluster online one node at a time, starting with the seed nodes.
See Starting and stopping DataStax Enterprise.
What's next
Remove the line you added in the cassandra-env.sh file.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB76","label":"Data Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCR56","label":"IBM DataStax Enterprise"},"ARM Category":[{"code":"","label":""}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]
Historical Number
ka06R000000VotXQAS
Was this topic helpful?
Document Information
Modified date:
30 January 2026
UID
ibm17259121