Install DataStax Studio

DataStax Studio is an interactive developer tool for Cassandra Query Language (CQL), Spark SQL, and DSE Graph.

Prerequisites

DataStax Studio 6.8 requires the following:

An IBMid account with MFA enabled to download DataStax Studio:
- If you are an existing IBM customer with an IBMid, you can continue to use your established account.
- If you don’t have an IBMid, you can create one.
- If your company uses Enterprise Federation (EF) for authentication with corporate credentials, see the EF documentation.
OpenJDK 8 or Oracle Java 8 version 1.8.0_151 or later. JDK 11 is recommended.
Astra DB or a supported version of DataStax Enterprise (DSE). For compatibility details, see Supported platforms for DataStax Studio.
A supported web browser.

DataStax Studio is tested on the following platforms (64-bit) with the latest versions of the specified web browsers at the time of the most recent DataStax Studio release:
- macOS 10.11, 10.12, 10.13: Safari, Chrome, Firefox
- Microsoft Windows 7, 10: Chrome, Firefox
- Ubuntu 14.04 LTS, 16.04 LTS: Chrome, Firefox
- CentOS 7: Chrome, Firefox
- CentOS 6.8: Firefox
Internet Explorer, Microsoft Edge, and all other browsers, platforms, and versions are either not supported or not tested. They might not be fully compatible.

Prepare to upgrade DataStax Studio (optional)

If you are upgrading to DataStax Studio 6.8, back up the user data directory (~/.datastax_studio) before you install a new version.

When you start DataStax Studio after an upgrade, all of your existing notebooks are upgraded to the new version. Notebooks aren’t backward compatible after being upgraded.

Download DataStax Studio

Sign in to Fix Central.
In the Product selector field, enter IBM DataStax Studio.
Select the DataStax Studio version you want to install from the Select from IBM DataStax Studio list.
Select the fix pack (DataStax Studio version) you want to install, and then click Continue.
On the Download options page, select the Download using your browser (HTTPS), and then click Continue.

This step is only required the first time you download a file using Fix Central. If you need to change your download method for subsequent downloads, use the Change download options link in the Download options section of Fix Central pages.
Review the terms and conditions, and then click I agree.
Click the applicable link to download the DataStax Studio tarball or ZIP file for your operating system.

Install and run DataStax Studio on Linux or macOS

Extract the DataStax Studio archive:
```
tar -xzf datastax-studio-VERSION.tar.gz
```
Replace VERSION with the version number of the tarball you downloaded, such as 6.8.0.
Change to the DataStax Studio installation directory:
```
cd installation_location/datastax-studio-VERSION
```
Run the DataStax Studio Server shell script:
```
./bin/server.sh
```
Alternatively, to start DataStax Studio in the background, run the following command:
```
./bin/server.sh &
```
When the server starts, the URL is printed in the terminal:
```
Studio is now running at: http://127.0.0.1:9091
```
The URL depends on your cluster configuration. For example, for DSE running on localhost, the URL is localhost:port. For remote clusters, the URL uses the hostname or IP address of the remote machine.
In a web browser, navigate to the URL where DataStax Studio is running to access the DataStax Studio UI.

Install and run DataStax Studio on Windows

Extract the DataStax Studio archive:
1. In File Explorer, locate your DataStax Studio archive, such as ~\datastax-studio-VERSION.zip where VERSION is the version number you downloaded.
2. Right-click the ZIP file, and then select Extract All….

Change to the DataStax Studio installation directory:

C:/> cd installation_location\datastax-studio-VERSION\bin\

Run the DataStax Studio Server shell script:
```
C:/> server.bat
```
When the server starts, the URL is printed in the terminal:
```
Studio is now running at: http://127.0.0.1:9091
```
The URL depends on your cluster configuration. For example, for DSE running on localhost, the URL is localhost:port. For remote clusters, the URL uses the hostname or IP address of the remote machine.
In a web browser, navigate to the URL where DataStax Studio is running to access the DataStax Studio UI.

Stop and restart DataStax Studio

To stop DataStax Studio on Linux or macOS, run pkill -f studio.

To stop DataStax Studio on Windows, press Control+C in your terminal to end the running process.

To restart DataStax Studio, navigate to the DataStax Studio installation directory, and then rerun the server script, as described in Install and run DataStax Studio on Linux or macOS and Install and run DataStax Studio on Windows.