Installing DataStax Enterprise 4.8 using APT repositories

Install DataStax Enterprise, DataStax Agent, and OpsCenter using APT repositories on Debian-based systems.

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

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

Prerequisites

  • Be sure your platform is supported.
  • DataStax Academy registration email address and password.
  • Aptitude Package Management (APT) 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.
  • 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. Add a DataStax repository file called /etc/apt/sources.list.d/datastax.sources.list: 
    $ echo "deb https://dsa_email_address:password@debian.datastax.com/enterprise stable main" | sudo tee -a /etc/apt/sources.list.d/datastax.sources.list
    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 \|.
  3. Add the DataStax repository key: 
    curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add -
  4. Install the package:
    1. $ sudo apt-get update
    2. Install the package:(Use for all product levels.): 
      sudo apt-get install dse-full=4.8.X-1 dse=4.8.X-1 dse-hive=4.8.X-1 dse-pig=4.8.X-1 dse-demos=4.8.X-1 dse-libsolr=4.8.X-1 dse-libtomcat=4.8.X-1 dse-libsqoop=4.8.X-1 dse-liblog4j=4.8.X-1 dse-libmahout=4.8.X-1 dse-libhadoop-native=4.8.X-1 dse-libcassandra=4.8.X-1 dse-libhive=4.8.X-1 dse-libpig=4.8.X-1 dse-libhadoop=4.8.X-1 dse-libspark=4.8.X
      To install the DataStax agent for your OpsCenter version, add the agent version to the install command. For example:
      sudo apt-get install dse-full=4.8.16-1 dse=4.8.16-1 . . . datastax-agent-6.1.6-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.

Results

DataStax Enterprise is ready for configuration.

What's next