About Cassandra
The flowchart below is intended to be used for DataMiner Systems with Cassandra running on the server or on external Windows or Linux nodes.
As the Cassandra database is one of the main components of DataMiner, it is very important that you know how to check and get information from this database. This page contains information related to Cassandra administration and troubleshooting. For more information about this, please refer to the official supporting documentation available at Cassandra Apache Documentation.
Initial checks
If you encounter an issue related to Cassandra, we recommend that you perform these initial checks and gather the data mentioned below to start the troubleshooting or investigation.
- Collect DataMiner logs running the SLLogCollector tool. You can also collect an SLDataGateway dump using this tool.
- In the SLDataGateway.txt and SLDBConnections.txt log files, check for errors and status information related to the communication between DataMiner and the Cassandra database. You can find these files on each DMA in the folder C:\Skyline DataMiner\Logging.
- Make a copy of the Cassandra logs folder C:\Program Files\Cassandra\logs. Check the Cassandra system and debug logs.
- In a command window or PowerShell window, execute "nodetool status" (from the directory C:\Program Files\Cassandra\bin). In a Failover setup, execute this command on both Cassandra nodes of the Failover pair.
- Check connectivity to Cassandra using DevCenter. On the DMA, go to C:\Program Files\Cassandra\DevCenter\ and double-click Run DevCenter.
Cassandra troubleshooting flowchart
Cassandra.yaml file
The Cassandra.yaml file is the main configuration file for the Cassandra database. It can be found in the folder C:\Program Files\Cassandra\Conf.
These are the main parameters you should check in this file:
- Cluster name: Should be the same for all DMAs (cluster_name: dms).
- Listen address: The address or interface to bind to and tell other Cassandra nodes to connect to.
- Seeds: Cassandra nodes use this list of hosts to find each other and learn the topology of the ring.
- RPC Address: The address or interface to bind the Thrift RPC service and native transport server to.
- Broadcast RPC Address: The RPC address to broadcast to drivers and other Cassandra nodes.
- Disk Optimization Strategy: Performance could be improved by updating the strategy for optimizing disk reads. Possible values are:
- ssd – for solid state disks (default)
- spinning – for spinning disks
For a Failover setup: Each DMA (main or backup) has its own distinct .yaml file.
- listen_address: [IP of the main or backup DMA] (depending on the DMA)
- seeds: [IP of the main DMA],[IP of the backup DMA] (same for both DMAs)
- rpc_address: 0.0.0.0 (same for both DMAs)
- broadcast_rpc_address: [IP of the main or backup DMA] (depending on the DMA)
For a single DMA setup:
- listen_address: 127.0.0.1
- seeds: 127.0.0.1
- rpc_address: 0.0.0.0
- broadcast_rpc_address: 127.0.0.1