Installing DataStax Enterprise 6.8 on RHEL-based systems using Yum

Instructions for installing DataStax Enterprise 6.8 using Yum repositories on RHEL-based systems.

Instructions for installing DataStax Enterprise (DSE) 6.8 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.8 is 6.8.0.
  • 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.8 and the DataStax Agent. It does not install OpsCenter, DataStax Studio, or DataStax Bulk Loader.
  • When connecting to DSE 6.8 from OpsCenter, use version OpsCenter 6.8; 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 Adding a superuser login.

Prerequisites

Note: For more information about managing Java, see Managing Java installs. For more information about choosing a Java vendor, see Choosing a Java vendor in Lifecycle Manager.

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_242"
    OpenJDK Runtime Environment (build 1.8.0_242-b09)
    OpenJDK 64-Bit Server VM (build 25.242-b09, mixed mode)
    If Oracle Java, the results should look like:
    java version "1.8.0_241"
    Java(TM) SE Runtime Environment (build 1.8.0_241-b13)
    Java HotSpot(TM) 64-Bit Server VM (build 25.241-b13, mixed mode)

    If not OpenJDK 8 or Oracle Java 8, see Installing the JDK.

  2. Install the libaio package. For example:
    sudo yum install libaio
  3. 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
  4. If you have enabled signature verification (gpgcheck=1), import the DataStax Enterprise repository key:
    sudo rpm --import https://rpm.datastax.com/rpm/repo_key 
  5. Install the DataStax Enterprise packages:
    • Install the latest version (6.8.0):
      sudo yum install dse-full
    • 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

    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 Adding a superuser login.
    • 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.
  6. Optional: Single-node cluster installations only:
    1. Start DataStax Enterprise:
      sudo service dse start
    2. Verify that DataStax Enterprise is running:
      nodetool status
      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

What's next