Troubleshooting
Use these troubleshooting examples to discover and resolve problems with DSE.
The following common problems, solutions, or workarounds have been reported about using DataStax Enterprise. Be sure to also check the Cassandra troubleshooting documentation.
Unable to write to the standard tmp directory for JNA
JVM_OPTS="$JVM_OPTS -Djna.tmpdir=/var/tmp"
Package installations | /etc/dse/cassandra/cassandra-env.sh |
Tarball installations | install_location/resources/cassandra/conf/cassandra-env.sh |
Mahout Jobs that Use Lucene Not Supported
DataStax does not currently support Mahout jobs, such as built-in support for creating vectors from Lucene indexes, that use Lucene features. Attempting to run Mahout jobs that use Lucene features results in this type of error message:
Error: class org.apache.mahout.vectorizer.
DefaultAnalyzer overrides final method
tokenStream.
MX4J warning message during installation
When Cassandra loads, you may notice a message that MX4J will not load and that mx4j-tools.jar is not in the classpath.
You can ignore this message. MX4j provides an HTML and HTTP interface to JMX and is not necessary to run Cassandra. DataStax recommends using OpsCenter. It has more monitoring capabilities than MX4J.
DSE Search cannot find custom files
Solr supports relative paths that are set by the <lib> property in the solrconfig.xml, but DSE Search does not. Configuring the Solr library path describes a workaround for this issue.
Subprocesses not killed when DataStax Enterprise is shut down improperly
kill 9
and shut
down DataStax Enterprise as described in Stopping a DataStax Enterprise node.kill -9
, you must reboot the node
or manually kill any remaining sub-processes:- Installer-Services and Package installations: For example, if DataStax Enterprise was started using
sudo services dse start
orsudo /etc/init.d/dse start
and the main process was killed using$ kill -9 `cat /var/run/dse/dse.pid`
:- To view the subprocesses left behind (all DSE processes run under user
"cassandra"):
pgrep -c -ucassandra >/dev/null && ps -o pid,ppid,user,args `pgrep -ucassandra`
- To shut down the subprocesses:
sudo pkill -ucassandra
- To view the subprocesses left behind (all DSE processes run under user
"cassandra"):
- Installer-No Services and Tarball installations: For example, if DataStax Enterprise 4.8 was started using
$ sudo dse cassandra -k -t
and the main process was killed using$ sudo kill -9 `cat /var/run/dse/dse.pid`
or$ sudo pkill -9 -f jmxremote.port=7199
:- To view the subprocesses left
behind:
pgrep -c -f dse-4.8 >/dev/null && ps -o pid,ppid,user,args `pgrep -f dse-4.8
All DSE processes run under user
cassandra
. - To shut down the subprocesses:
sudo pkill -f dse-4.8
- To view the subprocesses left
behind:
kill
command (SIGTERM) shuts down the subprocesses.