Installing DataStax Enterprise 6.0 on RHEL-based systems using Yum
Instructions for installing DataStax Enterprise 6.0 using Yum repositories on RHEL-based systems.
Instructions for installing DataStax Enterprise (DSE) 6.0 on RHEL-based systems using Yum.
To install on SUSE, use the binary tarball installation.
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.
- Yum Package Management 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)
- RedHat-compatible distributions require EPEL (Extra Packages for Enterprise Linux).
-
Python 2.7.x
For older RHEL distributions, see Installing Python 2.7 on older RHEL-based package installations.
Note: For more information about managing Java, see .
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 yum install libaio
-
Add the DataStax Yum repository to a file called
/etc/yum.repos.d/datastax.repo:
Note: Set the
gpgcheck=1
to perform a GPG signature check.[datastax] name=DataStax Repo for DataStax Enterprise baseurl=https://rpm.datastax.com/enterprise/ enabled=1 gpgcheck=0
-
If you have enabled signature verification (
gpgcheck=1
), import the DataStax Enterprise repository key:sudo rpm --import https://rpm.datastax.com/rpm/repo_key
-
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 yum install dse-6.0.version_number-1 \ dse-full-6.0.version_number-1 \ dse-libgraph-6.0.version_number-1 \ dse-libcassandra-6.0.version_number-1 \ dse-libhadoop2-client-6.0.version_number-1 \ dse-libsolr-6.0.version_number-1 \ dse-libtomcat-6.0.version_number-1 \ dse-liblog4j-6.0.version_number-1 \ dse-libspark-6.0.version_number-1
For example:sudo yum install dse-6.0.x-1 \ dse-full-6.0.x-1 \ dse-libgraph-6.0.x-1 \ dse-libcassandra-6.0.x-1 \ dse-libhadoop2-client-6.0.x-1 \ dse-libsolr-6.0.x-1 \ dse-libtomcat-6.0.x-1 \ dse-liblog4j-6.0.x-1 \ dse-libspark-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 yum 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: Configure systemd units: RedHat systemd configuration.
- 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.