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.

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

   java -version

   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.
   • 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://DSA_profile_name:downloads_key@debian.datastax.com/enterprise stable main" | sudo tee -a /etc/apt/sources.list.d/datastax.sources.list

   where DSA_profile_name and downloads_key are your DataStax Academy Profile Name and My Downloads Key. 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 \|.

   For backward compatibility, you can use your DataStax Academy email address and password instead of your Profile Name and Downloads Key.

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.11-1 \
       dse-full=5.1.11-1 \
       dse-libcassandra=5.1.11-1 \
       dse-libgraph=5.1.11-1 \
       dse-libhadoop2-client-native=5.1.11-1 \
       dse-libhadoop2-client=5.1.11-1 \
       dse-liblog4j=5.1.11-1 \
       dse-libsolr=5.1.11-1 \
       dse-libspark=5.1.11-1 \
       dse-libtomcat=5.1.11-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