Installing DataStax Enterprise 5.1 on Debian-based systems using APT

Instructions for installing DataStax Enterprise 5.1 using APT repositories on Debian-based systems. Root permissions are required.

Use these instructions for installing DataStax Enterprise (DSE) 5.1.16 on Debian-based systems using APT.

Some things to know about installing DSE

  • The latest version of DataStax Enterprise 5.1 is 5.1.16.
  • When installed with 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 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 OpCenter 6.0, override the default DataStax Agent. See compatibility of OpsCenter with DSE. After installation:
    sudo apt-get install datastax-agent-6.0.supported_version-1
    Note: You can also install the agent during installation by adding datastax-agent-6.0.supported_version-1 to the installation command in 5.
  • After installing, you must configure and start DataStax Enterprise.
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.

Prerequisites

  • Root or sudo access.
  • A supported platform.
  • Aptitude Package Management (APT) application.
  • Latest build of a Technology Compatibility Kit (TCK) Certified OpenJDK version 8 or Oracle Java SE Runtime Environment 8 (JRE or JDK). Earlier or later versions are not supported.
    Attention: Although Oracle JRE/JDK 8 is supported, DataStax does more extensive testing on OpenJDK 8. This change is due to the end of public updates for Oracle JRE/JDK 8. Java 9 is not supported.
  • Python 2.7.x

Hardware requirements

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

Procedure

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 not OpenJDK 8 or Oracle Java 8, see Installing supporting software.

    Important:
    • Although Oracle JRE/JDK 8 is supported, DataStax does more extensive testing on OpenJDK 8 starting with DSE 5.1.11. This change is due to the end of public updates for Oracle JRE/JDK 8. Java 9 is not supported.
    • Package management tools do not install OpenJDK 8 or Oracle Java.
  2. Add a DataStax repository file called /etc/apt/sources.list.d/datastax.sources.list:
    echo "deb https://debian.datastax.com/enterprise stable main" | sudo tee -a /etc/apt/sources.list.d/datastax.sources.list
  3. Add the DataStax repository key:
    curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add -
  4. Update apt-get:
    sudo apt-get update
  5. Install the DataStax Enterprise package:
    Attention: Specify all packages; otherwise, the installation fails.
    • Install the latest 5.1.x version:
      sudo apt-get install dse=5.1.16-1 \
        dse-full=5.1.16-1 \
        dse-libcassandra=5.1.16-1 \
        dse-libgraph=5.1.16-1 \
        dse-libhadoop2-client-native=5.1.16-1 \
        dse-libhadoop2-client=5.1.16-1 \
        dse-liblog4j=5.1.16-1 \
        dse-libsolr=5.1.16-1 \
        dse-libspark=5.1.16-1 \
        dse-libtomcat=5.1.16-1
    • Install an earlier 5.1.x version:
      Note: To view the available versions, see the Release notes.
      sudo apt-get install 
        dse=version_number-1\
        dse-full=version_number-1 \
        dse-libcassandra=version_number-1 \
        dse-libgraph=version_number-1 \
        dse-libhadoop2-client-native=version_number-1 \
        dse-libhadoop2-client=version_number-1 \
        dse-liblog4j=version_number-1 \
        dse-libsolr=version_number-1 \
        dse-libspark=version_number -1 \
        dse-libtomcat=version_number-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 apt-get install dse-demos

    DataStax Enterprise is ready for additional configuration.

  6. Optional: Single-node cluster installations only:
    1. Start DataStax Enterprise:
      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

What's next