Installing DataStax Enterprise 4.6 using APT repositories

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

For a complete list of supported platforms, see DataStax Enterprise Supported Platforms.

Important: DataStax Enterprise 4.6 uses Cassandra 2.0.

Prerequisites

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

Note: JNA (Java Native Access) is automatically installed.

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:

Note: In the following commands, 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.6 is 4.6.13.

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

    If not Oracle Java 7 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 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 -
    Note: If you have trouble adding the key, use http instead of https.
  4. Install the packages:
    1. $ sudo apt-get update
    2. Install th package: 
      • $ sudo apt-get install dse-full=4.6.X-1 dse=4.6.X-1 dse-hive=4.6.X-1 dse-pig=4.6.X-1 dse-demos=4.6.X-1 dse-libsolr=4.6.X-1 dse-libtomcat=4.6.X-1 dse-libsqoop=4.6.X-1 dse-liblog4j=4.6.X-1 dse-libmahout=4.6.X-1 dse-libhadoop-native=4.6.X-1 dse-libcassandra=4.6.X-1 dse-libhive=4.6.X-1 dse-libpig=4.6.X-1 dse-libhadoop=4.6.X-1 dse-libspark=4.6.X-1
        (Use for all product levels.)
      • $ sudo apt-get install dse-full=4.6.X-1 dse=4.6.X-1 dse-hive=4.6.X-1 dse-pig=4.6.X-1 dse-demos=4.6.X-1 dse-libsolr=4.6.X-1 dse-libtomcat=4.6.X-1 dse-libsqoop=4.6.X-1 dse-liblog4j=4.6.X-1 dse-libmahout=4.6.X-1 dse-libhadoop-native=4.6.X-1 dse-libcassandra=4.6.X-1 dse-libhive=4.6.X-1 dse-libpig=4.6.X-1 dse-libhadoop=4.6.X-1 dse-libspark=4.6.X-1 opscenter
        (Also installs OpsCenter.)
    Note:

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

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

  5. Review the installation logs to verify the installation.
    Directories Description
    /usr/share/dse/backups/log_file_dir/copied_config_files.log Show Config File Overwrites
    /usr/share/dse/backups/log_file_dir/bitrock_installer.log View Installation Log
    /usr/share/dse/backups/log_file_dir/install_dependencies.log View Dependency Installation Log
    /usr/share/dse/backups/pfc_results.txt View Configuration Recommendations and Warnings ( Preflight Check Results)
    /usr/share/dse View README
    /usr/share/dse Uninstall DataStax Enterprise

Results

DataStax Enterprise is ready for configuration.

What's next