Install DataStax Enterprise 6.8 on a single node
Use these instructions to install a single instance of DataStax Enterprise (DSE) on Linux-based platforms using a binary tarball. This single node can introduce you to DSE, which includes DSE Security, DataStax Graph, DSE Analytics, and DSE Search.
This installation is intended only for demonstration purposes. For other installations, see Which install method should I use?
Some things to know about installing DataStax Enterprise:
-
These instructions apply to all versions of DSE 6.8. For specific changes please see the DSE 6.8 release notes.
-
When installed from the binary tarball, DSE runs as a stand-alone process.
-
When DSE is installed, it creates a
cassandrauser in the database and runs as this user. Do not use thecassandrauser in production. Using thecassandrauser is a security risk. See Adding a superuser login.
Prerequisites
-
An IBMid.
-
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.
-
-
Java 8. If you don’t have a recent version of Java 8, download and install OpenJDK 8.
-
Python 3.6 through 3.11, or Python 2.7.x. Each listed version provides support for
cqlsh, but DataStax recommends using Python 3.11.
Procedure
In a terminal window:
-
Verify that a required version of Java is installed:
java -versionIf OpenJDK, the results should look like:
openjdk version "1.8.0_242" OpenJDK Runtime Environment (build 1.8.0_242-b09) OpenJDK 64-Bit Server VM (build 25.242-b09, mixed mode)If Oracle Java, the results should look like:
java version "1.8.0_241" Java(TM) SE Runtime Environment (build 1.8.0_241-b11) Java HotSpot(TM) 64-Bit Server VM (build 25.241-b11, mixed mode)If not Oracle Java 8 or OpenJDK 8, see Install the Java Virtual Machine.
Package management tools do not install Oracle Java.
-
Install the libaio package. For example:
-
RHEL platforms:
sudo yum install libaio -
Debian platforms:
sudo apt-get install libaio1
-
-
Download the DSE tarball from Fix Central:
-
Sign in to Fix Central.
-
In the Product selector field, enter
IBM DataStax Enterprise. -
Select the DSE version you want to install from the Select from IBM DataStax Enterprise list.
-
Select All in the Platform list, and then click Continue.
-
On the Identify fixes page, click Continue to use the default Browse for fixes option.
-
Select the fixes (DSE version) you want to install, and then click Continue.
-
Review the terms and conditions, and then click I agree.
-
-
Click the DSE tarball link to download the file, for example,
dse-6.8.60-bin.tar.gz. -
Extract the tarball file into the directory where you want to install DSE 6.8:
sudo tar -xzvf dse-6.8.60-bin.tar.gz -C INSTALLATION_DIRECTORY -
Change to the directory where you extracted the tarball:
cd INSTALLATION_DIRECTORY/dse-VERSIONReplace the following:
-
INSTALLATION_DIRECTORY: The path to the installation directory -
VERSION: The version of DSE you installed
-
-
Create the default data and logging directories:
-
/var/lib/cassandra -
/var/log/cassandrasudo mkdir -p /var/lib/cassandra; sudo chown -R $USER:$GROUP /var/lib/cassandrasudo mkdir -p /var/log/cassandra; sudo chown -R $USER:$GROUP /var/log/cassandra
-
-
Start DSE from the installation directory:
bin/dse cassandra -
Verify that DSE is running from the installation directory:
bin/nodetool statusResults:
Datacenter: Cassandra ===================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns Host ID Rack UN 127.0.0.1 82.43 KB 128 ? 40725dc8-7843-43ae-9c98-7c532b1f517e rack1
Results not using vnodes:
Datacenter: Analytics ===================== Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Owns Host ID Token Rack UN 172.16.222.136 103.24 KB ? 3c1d0657-0990-4f78-a3c0-3e0c37fc3a06 1647352612226902707 rack1
-
Start
cqlshfrom the installation directory:bin/cqlshFor more, see Accessing data using CQL.
