Installing DataStax Enterprise 6.0 on Debian-based systems using APT
Instructions for installing DataStax Enterprise 6.0 using APT repositories on Debian-based systems. Root permissions are required.
Use these instructions for installing DataStax Enterprise (DSE) 6.0 on Debian-based systems using APT.
Some things to know about installing DataStax Enterprise:
- The latest version of DataStax Enterprise 6.0 is 6.0.x.
- When installed from a package (Yum or APT), DataStax Enterprise runs as a service. The service initialization script is located in /etc/init.d/dse. Run levels are not set by the package.
- This procedure installs DSE 6.0 and the DataStax Agent. It does not install OpsCenter, DataStax Studio, Graph Loader, or DataStax Bulk Loader.
- When connecting to DSE 6.0 from OpsCenter, use version OpsCenter 6.5; earlier versions are not supported. See DataStax OpsCenter compatibility with DSE.
Warning: When DSE is installed, it creates a
cassandra
user in the database. Do not use the
cassandra
user in production. Failing to do so is a security
risk. See .Prerequisites
- Root or sudo access.
- A supported platform.
- Aptitude Package Management (APT) application.
- Configure your operating system to use the latest version of
Java 8:
- Recommended. The latest build of a TCK (Technology Compatibility Kit) Certified OpenJDK version 8. For example, OpenJDK 8 (1.8.0_242 minimum). DataStax's recommendation changed due to the end of public updates for Oracle JRE/JDK 8. See Oracle Java SE Support Roadmap.
- Supported. Oracle Java SE 8 (JRE or JDK) (1.8.0_151 minimum)
- Python 2.7.x
Hardware requirements
See .
Important: End User License Agreement (EULA). By downloading this DataStax product,
you agree to the terms of the EULA.
In a terminal window:
-
Verify that a required version of Java is installed:
java -version
Note: DataStax recommends the latest build of a Technology Compatibility Kit (TCK) Certified OpenJDK version 8.If OpenJDK, the results should look like:openjdk version "1.8.0_171" OpenJDK Runtime Environment (build 1.8.0_171-8u171-b11-0ubuntu0.16.04.1-b11) OpenJDK 64-Bit Server VM (build 25.171-b11, mixed mode)
If Oracle Java, the results should look like:java version "1.8.0_181" Java(TM) SE Runtime Environment (build 1.8.0_181-b13) Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)
If not OpenJDK 8 or Oracle Java 8, see Installing the JDK..
-
Install the libaio package. For example:
sudo apt-get install libaio1
-
Add a DataStax repository file called
/etc/apt/sources.list.d/datastax.sources.list:
echo "deb https://debian.datastax.com/enterprise/ stable main" | sudo tee -a /etc/apt/sources.list.d/datastax.sources.list
-
Add the DataStax repository key:
curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add -
-
Update the packages:
sudo apt-get update
-
Install the DataStax Enterprise packages:
Attention: Specify all packages; otherwise, the installation fails.
- Install any 6.0.x version:Note: To view the available 6.0.x versions, see the Release notes.
sudo apt-get install dse=version_number-1 \ dse-full=version_number-1 \ dse-libcassandra=version_number-1 \ dse-libgraph=version_number-1 \ dse-libhadoop2-client-native=version_number-1 \ dse-libhadoop2-client=version_number-1 \ dse-liblog4j=version_number-1 \ dse-libsolr=version_number-1 \ dse-libspark=version_number-1 \ dse-libtomcat=version_number-1
For example:sudo apt-get install dse=6.0.x-1 \ dse-full=6.0.x-1 \ dse-libcassandra=6.0.x-1 \ dse-libgraph=6.0.x-1 \ dse-libhadoop2-client-native=6.0.x-1 \ dse-libhadoop2-client=6.0.x-1 \ dse-liblog4j=6.0.x-1 \ dse-libsolr=6.0.x-1 \ dse-libspark=6.0.x-1 \ dse-libtomcat=6.0.x-1
- Optional: Install the demos:Attention: Installing the DSE demos is not recommended for production. Only install the demos in development environments to run tutorials.
sudo apt-get install dse-demos=version_number-1
Result
DataStax Enterprise is ready for additional configuration:- For production, be sure to change the
cassandra
user. Failing to do so is a security risk. See . - DataStax Enterprise provides several types of workloads (default is transactional). See startup options for service or stand-alone installations.
- What's next below provides links to related tasks and information.
- Install any 6.0.x version:
- Optional:
Single-node cluster installations only:
What's next
- You must change or delete the
cassandra
user created on installation. See . - Configure startup options: service | stand-alone.
- If performing an upgrade, go to the next step in the Upgrade Guide.
- Configuring DataStax Enterprise - Settings for DSE Advanced Security, In-Memory, DSE Advanced Replication, DSE Multi-Instance, DSE Tiered Storage, and more.
- Default file locations for package installations
- Default file locations for tarball installations
- after installation.
- .
- Preparing DataStax Enterprise for production.
- .
- Planning and testing DSE cluster deployments.
- to avoid server crashes.
- DataStax Studio documentation.
- Installing DataStax Enterprise drivers.