DataStax Enterprise 3.1 Documentation

Installing the DataStax Enterprise tarball on Mac OSX or other Linux OS

This documentation corresponds to an earlier product version. Make sure this document corresponds to your version.

Latest DSE documentation | Earlier DSE documentation

DataStax provides a binary tarball distribution for installing on platforms that do not have package support, such as Mac, or if you do not have or want to do a root installation. For a complete list of supported platforms, see DataStax Enterprise Supported Platforms.


Before installing DataStax Enterprise make sure you have met the following prerequisites:

  • Before you can install, you must register with DataStax to get a username and password.
  • Install the latest version of Oracle Java SE Runtime Environment (JRE) 6 or 7.
  • Java Native Access (JNA) is required for production installations. See Installing the JRE and the JNA.


If you are using Ubuntu 10.04 LTS, you need to update to JNA 3.4. See the steps describing this procedure in Installing the JNA on Debian or Ubuntu Systems.

Also see Recommended production settings.

Installation steps

From a terminal window:

  1. Check which version of Java is installed:

    # java -version

    Use the latest version of Oracle Java 6 or 7 on all nodes. If you need help installing Java, see Installing the Oracle JRE and JNA.

  2. Download the distributions. Installing OpsCenter is optional.

    $ curl -OL http://<username>:<password>
    $ curl -OL http://<username>:<password>
  3. Unpack the distributions:

    $ tar -xzvf dse.tar.gz
    $ tar -xzvf opscenter.tar.gz
    $ rm *.tar.gz
  4. By default, DataStax Enterprise is configured to use /var/lib/cassandra and /var/log/cassandra directories.

    If you do not have root access to the default directories, ensure you have write access as follows:

    $ 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
  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. For example:

      $ mkdir <install_location>/dse-data
      $ cd dse-data
      $ mkdir commitlog
      $ mkdir saved_caches
    2. Go the directory containing the cassandra.yaml file. For example:

      $ cd <install_location>/resources/cassandra/conf
    3. Edit the following lines in the cassandra.yaml file. For example:

      data_file_directories: <install_location>/dse-data
      commitlog_directory: <install_location>/dse-data/commitlog
      saved_caches_directory: <install_location>/dse-data/saved_caches

Next steps