Installing DataStax Enterprise 5.1 on RHEL-based systems using Yum
Instructions for installing DataStax Enterprise 5.1 using Yum repositories on RHEL-based systems.
Use these instructions for installing DataStax Enterprise (DSE) 5.1 on RHEL-based systems using Yum.
To install on SUSE, use the GUI installer or the binary tarball installation.
Some things to know about installing DSE
- The latest version of DataStax Enterprise 5.1 is 5.1.22.
- When installed with Yum, 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 OpsCenter 6.0, override the default DataStax Agent. See compatibility of OpsCenter with
DSE.
sudo yum install dse-full datastax-agent-6.0.supported_version-1 #during installation
sudo yum install datastax-agent-6.0.supported_version-1 #after installation
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.
- 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_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)
- 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.)
Hardware requirements
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 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 5.1.x version:Note: To view the available versions, see the Release notes.
sudo yum install dse-5.1.version_number-1 \ dse-full-5.1.version_number-1 \ dse-libgraph-5.1.version_number-1 \ dse-libcassandra-5.1.version_number-1 \ dse-libhadoop2-client-5.1.version_number-1 \ dse-libsolr-5.1.version_number-1 \ dse-libtomcat-5.1.version_number-1 \ dse-liblog4j-5.1.version_number-1 \ dse-libspark-5.1.version_number-1
For example:sudo yum install dse-5.1.22-1 \ dse-full-5.1.22-1 \ dse-libgraph-5.1.22-1 \ dse-libcassandra-5.1.22-1 \ dse-libhadoop2-client-5.1.22-1 \ dse-libsolr-5.1.221 \ dse-libtomcat-5.1.22-1 \ dse-liblog4j-5.1.22-1 \ dse-libspark-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 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 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: Configure systemd units: RedHat systemd configuration.
- Optional:
Single-node cluster installations only:
- If your OpsCenter version is not compatible with DSE 5.1, upgrade OpsCenter to a compatible version.
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.