Installing DataStax Enterprise 5.1 on Debian-based systems using APT
Instructions for installing DataStax Enterprise 5.1 using APT repositories on Debian-based systems.
Instructions for installing DataStax Enterprise (DSE) 5.1 on Debian-based systems using APT.
Some things to know about installing DSE
- The latest version of DataStax Enterprise 5.1 is 5.1.22.
- When installed with 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 DataStax Enterprise 5.1 and
the DataStax Agent. It does not install OpsCenter, Studio, or Graph Loader. Note: The DataStax Installer has options to install developer related tools: Javadoc, DataStax Enterprise demos, DataStax Studio, and the DSE Graph Loader.
- If using OpCenter 6.0, override the default DataStax Agent. See compatibility of OpsCenter with DSE.
After
installation:
sudo apt-get install datastax-agent-6.0.supported_version-1
Note: You can also install the agent during installation by addingdatastax-agent-6.0.supported_version-1
to the installation command in 5.
Warning: When DSE is installed, it creates a
cassandra
user in the database and runs as this user. It also
creates a cassandra
user in the operating system. Do not use the
cassandra
user in production. Using the
cassandra
user is a security risk. See Adding a superuser login.Note: For more information about managing Java, see Managing Java installs.
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_151 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
Procedure
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.
-
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 apt-get:
sudo apt-get update
-
Install the DataStax Enterprise packages:
Attention: Specify all packages; otherwise, the installation fails.
- Install any 5.1.x version:Note: To view the available 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
sudo apt-get install dse=5.1.22-1 \ dse-full=5.1.22-1 \ dse-libcassandra=5.1.22-1 \ dse-libgraph=5.1.22-1 \ dse-libhadoop2-client-native=5.1.22-1 \ dse-libhadoop2-client=5.1.22-1 \ dse-liblog4j=5.1.22-1 \ dse-libsolr=5.1.22-1 \ dse-libspark=5.1.22-1 \ dse-libtomcat=5.1.22-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 Creating superuser accounts. - 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 5.1.x version:
- Optional:
Single-node cluster installations only:
What's next
- You must change or delete the
cassandra
user created on installation. See Creating superuser accounts. - 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.
- Configuration and log file locations - Services and package installations.
- Configuration and log file locations - No Services and tarball installations.
- Changing logging locations after installation.
- Starting and stopping DataStax Enterprise.
- Preparing DataStax Enterprise for production.
- Recommended production settings.
- Planning and testing DSE and Apache Cassandra cluster deployments.
- Configuring the heap dump directory to avoid server crashes.
- DataStax Studio documentation.