Installing DataStax Enterprise 4.8 using Yum repositories

Install DataStax Enterprise, DataStax Agent, and OpsCenter using Yum repositories on RHEL-based systems.

When installed from Yum, DataStax Enterprise runs as a service.

Important: DataStax Enterprise 4.8 uses Cassandra 2.1 and CQL3.1.

To install on SUSE, use the GUI installer or the binary tarball installation.

Prerequisites

  • Be sure your platform is supported.
  • DataStax Academy registration email address and password.
  • Yum Package Management application.
  • Root or sudo access to the install machine.
  • Latest version of Oracle Java SE Runtime Environment 7 or 8 or OpenJDK 7 is recommended.
    Note: If using Oracle Java 7, you must use at least 1.7.0_25. If using Oracle Java 8, you must use at least 1.8.0_40. In some cases, using JDK 1.8 causes minor performance degradation compared to JDK 1.7.
  • RedHat-compatible distributions require EPEL (Extra Packages for Enterprise Linux). For RHEL 5.x, see Installing EPEL on RHEL OS 5.x.
  • If installing on a 64-bit Oracle Linux distribution, first install the 32-bit versions of glibc libraries.
  • Python 2.6 (minimum); 2.7 (recommended).
Hardware requirements
Requirement Minimum Production
CPUs 2 16
Memory 8 GB 24 GB
Data directory 20 GB 200 GB
Commit log directory 20 GB 200 GB
Saved caches directory 20 GB 200 GB
Logs directory 20 GB 200 GB
Production requirements depend on the volume of data and workload.

Also see Recommended production settings and the DataStax Enterprise Reference Architecture white paper.

The packaged releases create a cassandra user. When starting DataStax Enterprise as a service, the Cassandra and Hadoop tracker services run as this user. The service initialization script is located in /etc/init.d/dse. Run levels are not set by the package.

Procedure

These steps install DataStax Enterprise, the DataStax Agent, and OpsCenter (optional). After installing, you must configure and start DataStax Enterprise.

In a terminal window:

  1. Verify that a required version of Java is installed:
    java -version

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

    Important: Package management tools do not install Oracle Java.
  2. Make sure that the EPEL is installed. See Installing EPEL on RHEL OS 5.x.
  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://dsa_email_address:password@rpm.datastax.com/enterprise
    enabled=1
    gpgcheck=0
    where dsa_email_address and password are the DataStax Academy account credentials you created on the registration page.
    Attention: Depending on your environment, you might need to replace @ in your email address with %40 and escape any character in your password that is used in your operating system's command line. Examples: \! and \|.
  4. If you have enabled signature verification (gpgcheck=1), import the DataStax Enterprise repository key:
    rpm --import https://rpm.datastax.com/rpm/repo_key 
  5. Install the package (Use for all product levels.):
    sudo yum install dse-full-4.8.X-1
    Note: Be sure to change X to an actual version number. To view the available versions, see the Release notes. The latest version of DataStax Enterprise 4.8 is 4.8.16.
    To install the DataStax agent for your OpsCenter version, add the agent version to the install command. For example:
    sudo yum install dse-full-4.8.16-1 datastax-agent-6.1.6-1

    For production installations, DataStax recommends installing the OpsCenter separate from the cluster. See the OpsCenter documentation.

    Note: Removing the datastax-agent package also removes the DataStax Enterprise package.

Results

DataStax Enterprise is ready for configuration.

What's next