Installing DataStax Enterprise 6.0 on Debian-based systems using APT

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

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

Some things to know about installing DSE

  • The latest version of DataStax Enterprise 6.0 is 6.0.9.
  • 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.0 and the DataStax Agent. It does not install OpsCenter, DataStax Studio, Graph Loader, or DataStax Bulk Loader.
  • When connecting to DSE 6.0 from OpsCenter, use version OpsCenter 6.5; 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

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 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 supporting software on DataStax Enterprise 6.0.

  2. Install the libaio package. For example:
    sudo apt-get install libaio1
  3. 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
  4. Add the DataStax repository key:
    curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add -
  5. Update apt-get:
    sudo apt-get update
  6. Install the DataStax Enterprise package:
    • Install the latest version (6.0.9):
      sudo apt-get install dse-full=6.0.9-1
    • Install an earlier 6.0.x version:
      Note: To view the available 6.0.x 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
      For example:
      Attention: Specify all packages; otherwise, the installation fails.
      sudo apt-get install \
        dse=6.0.0-1 \
        dse-full=6.0.0-1 \
        dse-libcassandra=6.0.0-1 \
        dse-libgraph=6.0.0-1 \
        dse-libhadoop2-client-native=6.0.0-1 \
        dse-libhadoop2-client=6.0.0-1 \
        dse-liblog4j=6.0.0-1 \
        dse-libsolr=6.0.0-1 \
        dse-libspark=6.0.0-1 \
        dse-libtomcat=6.0.0-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=6.0.9-1
    DataStax Enterprise is ready for additional configuration. See What's next.
  7. Optional: Single-node cluster installations only:
    1. Start DataStax Enterprise:
      sudo service dse start
    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

What's next