Troubleshooting DataStax Studio 6.8
Studio will not start with wrong Java version
Studio checks the JAVA_HOME environment variable at startup.
To ensure that Studio starts with the correct version of Java, make sure the JAVA_HOME environment variable points to the installation directory with the supported version of Java.
See Supported platforms.
Note that even when the
java -version command shows a supported Java version, it is possible that JAVA_HOME environment variable is not set to the correct Java installation directory.
Out of memory error (OOM)
Studio crashes during runtime or startup and the following stack trace is observed in the log:
Exception in thread "Thread-0" java.lang.OutOfMemoryError: Java heap space at java.util.Arrays.copyOfRange(Unknown Source) at java.lang.String.<init>(Unknown Source) at java.lang.String.substring(Unknown Source) at com.datastax.studio.server.Bootstrap$ProgressBarTraditional.run(Bootstrap.java:638) Uncaught error from thread [Studio-eventuate.log.dispatchers.read-dispatcher-43]: Java heap space, shutting down JVM since 'akka.jvm-exit-on-fatal-error' is enabled for for ActorSystem[Studio] java.lang.OutOfMemoryError: Java heap space
Fix this problem by increasing the max heap allocation (
-Xmx) for Studio’s Java Virtual Machine (JVM).
For more, see Specifying JVM settings for DataStax Studio.
NOT ENABLED error: AlwaysOn SQL cell cannot be executed
The AlwaysOn SQL cell cannot be executed when the connection is to a DSE cluster that is not correctly configured for the AlwaysOn SQL service.
In order to run AlwaysOn SQL, you must have:
A running datacenter with DSE Analytics nodes enabled.
Enabled AlwaysOn SQL on every Analytics node in the datacenter.
Modify the replication factor for all Analytics nodes, if necessary.
Set the native_transport_address in
cassandra.yamlto an IP address that is accessible by the AlwaysOn SQL clients. This address depends on your network topology and deployment scenario.
Configured AlwaysOn SQL for security, if authentication is enabled.
STOPPED error: AlwaysOn SQL cell cannot be executed
The AlwaysOn SQL cell cannot be executed when the AlwaysOn SQL service is stopped on the DSE node. See Checking the status of AlwaysOn SQL.
DataStax Studio does not run with HTTPS everywhere. Preface the URL used to run DataStax Studio with HTTP and not HTTPS.
Studio won’t accept connections from external addresses
By default, Studio binds itself to the IP address
Please refer to Configuring DataStax Studio for details on how to change the listen IP address.
Content assist not working
On MacOS 10.12, a network configuration issue when running Studio causes content assist functionality to become slow or unresponsive. For troubleshooting steps to resolve this networking issue, see this Stack Overflow post.
Unable to connect Studio to a secured DSE cluster
If you are unable to connect Studio when client-to-node encryption enabled on a DSE cluster, the Studio log has this entry:
Cannot support TLS_RSA_WITH_AES_256_CBC_SHA with currently installed providers
Prior to Oracle Java 8u161, the Java Cryptography Extension (JCE) Unlimited Strength Policy was not enabled by default. On older versions of Oracle Java, the policy files are required to ensure support for all encryption algorithms. See Oracle’s instructions on Enabling Unlimited Cryptographic Policy for Java on installing the policy files for Studio’s Java Virual Machine.
Notebook needs troubleshooting
When you export a notebook, you can specify actions for the notebook. As appropriate, select to include cell code and results or cell code only. For either of these actions, you can also select to include diagnostics. Exporting a notebook with diagnostics might include sensitive information. Credentials are not included in the export.
Studio UI behaves strangely after upgrade
If you leave an old Studio session open in a browser, using an older version of Studio, and then upgrade to a new version, you can experience strange behavior.
This is caused by caching in the browser.
You can solve this problem by force-loading the
For example, if using the Chrome browser, you can navigate to the top-level
index.html page and click on the refresh button while holding down the control key.
Starting Studio on Windows
While running Studio on the Microsoft Windows operating system, out-of-date libraries can prevent system-specific JNI libraries from being loaded correctly. The result is the following stack trace on Windows 10:
[Studio-akka.actor.default-dispatcher-4] ERROR akka.actor.OneForOneStrategy ID: TS: - head of empty list java.util.NoSuchElementException: head of empty list at scala.collection.immutable.Nil$.head(List.scala:420) ~[scala-library-2.11.8.jar:?] at scala.collection.immutable.Nil$.head(List.scala:417) ~[scala-library-2.11.8.jar:?] at akka.actor.ActorCell.receiveMessage(ActorCell.scala:526) ~[akka-actor_2.11-2.4.17.jar:?] at akka.actor.ActorCell.invoke(ActorCell.scala:495) ~[akka-actor_2.11-2.4.17.jar:?] at akka.dispatch.Mailbox.processMailbox(Mailbox.scala:257) ~[akka-actor_2.11-2.4.17.jar:?] at akka.dispatch.Mailbox.run(Mailbox.scala:224) ~[akka-actor_2.11-2.4.17.jar:?] at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149
And the following stack trace on Windows 7:
leveldbjni-64-1-6036870325998847314.8: Can't find dependent libraries] at org.fusesource.hawtjni.runtime.Library.doLoad(Library.java:182) at org.fusesource.hawtjni.runtime.Library.load(Library.java:140) at org.fusesource.leveldbjni.JniDBFactory.<clinit>(JniDBFactory.java:48) at com.rbmhtechnology.eventuate.log.leveldb.LeveldbEventLog.<init>(Level dbEventLog.scala:97) at com.rbmhtechnology.eventuate.log.leveldb.LeveldbEventLog$$anonfun$7.apply(LeveldbEventLog.scala:358) at com.rbmhtechnology.eventuate.log.leveldb.LeveldbEventLog$$anonfun$7.apply(LeveldbEventLog.scala:358) at akka.actor.TypedCreatorFunctionConsumer.produce(IndirectActorProducer.scala:87)
You can fix this problem by updating the Microsoft Visual C++ 2010 Redistributable Package libraries in question:
When deciding whether to download the 32-bit or 64-bit version of the MS Visual C libraries, you should use the version that *matches the OS architecture*. Even if your node is running a 64-bit OS, it's possible that you have 64-bit or 32-bit (or both) MS Visual C libraries installed.
To determine the installed MS Visual C architecture (x64 or x86, or both), open Settings, Apps & features, and search for "c".