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.20.
  • 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

Hardware requirements

See Recommended production settings.

Important: End User License Agreement (EULA). By downloading this DataStax product, you agree to the terms of the EULA.

In a terminal window:

  1. 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.

  2. 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
  3. If you have enabled signature verification (gpgcheck=1), import the DataStax Enterprise repository key: 
    sudo rpm --import https://rpm.datastax.com/rpm/repo_key
  4. 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.20-1 \
    dse-full-5.1.20-1 \
    dse-libgraph-5.1.20-1 \
    dse-libcassandra-5.1.20-1 \
    dse-libhadoop2-client-5.1.20-1 \
    dse-libsolr-5.1.201 \
    dse-libtomcat-5.1.20-1 \
    dse-liblog4j-5.1.20-1 \
    dse-libspark-5.1.20-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.
  5. Optional: Configure systemd units: RedHat systemd configuration.
  6. Optional: Single-node cluster installations only:
    1. If DataStax Enterprise is not already running: 
      sudo service dse start

      For more start options, see Starting DataStax Enterprise as a service.

    2. Verify that DataStax Enterprise is running: 
      nodetool status
      Results using vnodes:
      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
  7. If your OpsCenter version is not compatible with DSE 5.1, upgrade OpsCenter to a compatible version.

What's next