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

Prerequisites¶

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

• 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.

  Note

  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.

• Your DataStax username and password (provided in your DataStax registration confirmation email). If you do not have a DataStax username and password, register before attempting to download the software.

DataStax Enterprise and OpsCenter installation steps¶

sudo java -version (Use the latest version of Java 6.)
curl -OL http://<username>:<password>@downloads.datastax.com/enterprise/
     dse.tar.gz
curl -OL http://<username>:<password>@downloads.datastax.com/enterprise/
     opscenter.tar.gz
tar -xzvf dse.tar.gz
tar -xzvf opscenter.tar.gz
rm *.tar.gz
(If you do not have root access to the default directories, see step 4.)
(If you do not want to use the default directories, see step 5.)

Detailed installation instructions:

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 distribution to a location on your machine:

   $ curl -OL http://<username>:<password>@downloads.datastax.com/enterprise/dse.tar.gz
   $ curl -OL http://<username>:<password>@downloads.datastax.com/enterprise/opscenter.tar.gz
   

   where <username> and <password> are the DataStax account credentials from your registration confirmation email.

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¶

• Configuring OpsCenter - Configuring the browser-based user interface for monitoring, administering, and configuring multiple clusters from a single centralized management console.
• Taking a look at Binary tarball install locations - Information about where DataStax Enterprise files are installed.
• Deployment - Setting the configuration properties on each node in the cluster before starting the cluster.
• Configuring the heap dump directory - Configuring a directory for troubleshooting and to avoid server crashes.
• Starting DataStax Enterprise as a stand-alone process - Starting DataStax Enterprise as a stand-alone process.