Installing DataStax Enterprise 4.6 using the binary tarball

Install DataStax Enterprise on any Linux-based platform, including 32-bit platforms.

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.

The binary tarball runs as a stand-alone process.

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. Download the tarball from the download-previous-versions page.

    You will need the DataStax Academy credentials from your registration. Be sure to use your registration email address, not your username.

    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.

  3. Unpack the distribution:
    $ tar -xzvf dse-4.6.X.tar.gz

    The files are extracted into the dse-4.6.X directory.

  4. If you do not have root access to the default directories locations, you can define your own directory locations as described in the following steps or change the ownership of the directories:
    • /var/lib/cassandra
    • /var/log/cassandra
    • /var/lib/spark
    • /var/log/spark
    $ sudo mkdir -p /var/lib/cassandra; sudo chown -R  $USER:$GROUP /var/lib/cassandra
    $ sudo mkdir -p /var/log/cassandra; sudo chown -R  $USER:$GROUP /var/log/cassandra
    $ sudo mkdir -p /var/lib/spark; sudo chown -R  $USER:$GROUP /var/lib/spark
    $ sudo mkdir -p /var/log/spark; sudo chown -R  $USER:$GROUP /var/log/spark
  5. Optional: If you do not want to use the default data and logging directories, you can define your own directory locations:
    1. Make the directories for data and logging directories:
      $ mkdir install_location/dse-data
      $ cd dse-data
      $ mkdir commitlog
      $ mkdir saved_caches
    2. Go the directory containing the cassandra.yaml file:
      $ cd install_location/resources/cassandra/conf
    3. Edit the following lines in the cassandra.yaml file:
      data_file_directories: install_location/dse-data
      commitlog_directory: install_location/dse-data/commitlog
      saved_caches_directory: install_location/dse-data/saved_caches
    The location of the cassandra.yaml file depends on the type of installation:
    Package installations /etc/cassandra/cassandra.yaml
    Tarball installations install_location/resources/cassandra/conf/cassandra.yaml
  6. Optional: If you do not want to use the default Spark directories, you can define your own directory locations:
    1. Make the directories for the Spark lib and log directories.
    2. Go the directory containing the spark-env.sh file:
      • Installer-Services and Package installations: /etc/dse/spark/spark-env.sh
      • Installer-No Services and Tarball installations: install_location/resources/spark/conf/spark-env.sh
    3. Edit the spark-env.sh file to match the locations of your Spark lib and log directories, as described in Spark configuration.

Results

DataStax Enterprise is ready for configuration.

What's next