DataStax Enterprise 3.0 Documentation

Installing the DataStax Enterprise tarball on Mac OSX or Any 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.

To install the Opscenter, see Installing OpsCenter tarball distributions on Linux and Mac OSX.


  • Before you can install, you must register with DataStax to get a username and password.

  • The latest version of Oracle Java SE Runtime Environment (JRE) 6 is installed. Java 7 is not recommended.

  • Java Native Access (JNA) is required for production installations. See Installing JNA.


    If you are using Ubuntu 10.04 LTS, you need to update to JNA 3.4, as described in Install JNA on Ubuntu 10.04.

Also see Recommended production settings.

DataStax Enterprise and OpsCenter installation steps

  1. Check which version of Java is installed by running the following command in a terminal window:

    # java -version

    Use the latest version of Java 6 on all nodes. Java 7 is not recommended. If you need help installing Java, see Installing Oracle JRE.

  2. Download the tarball from the Previous Releases section of the Download DataStax Enterprise page.

  3. Unpack the distributions:

    $ tar -xzvf dse.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