Installing DataStax Enterprise on any Linux-based platform or Mac OS X

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

Use this install method for Mac OS X and platforms without package support, or if you do not have or want a root installation.

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

Prerequisites

Latest version of Oracle Java SE Runtime Environment (JRE) 6 or 7. See Installing the Oracle JRE.
Java Native Access (JNA) is required for production installations. See Installing the JNA.
If you are using Ubuntu 10.04 LTS, you must update to JNA 3.4, as described in Installing the JNA on Debian or Ubuntu systems.
If you using an older RHEL-based Linux distribution, such as CentOS-5, you may need to replace the Snappy compression/decompression library; see the Release Notes.

The binary tarball runs as a stand-alone process.

Procedure

These steps install DataStax Enterprise. After installing, you must configure and start DataStax Enterprise.

In a terminal window:

Check which version of Java is installed:
```
$ java -version
```
Use the latest version of Oracle Java 6 or 7 on all nodes.
Download the tarball from the Download DataStax Enterprise page.

You will need the DataStax account credentials from your registration.
Unpack the distribution:
```
$ tar -xzvf dse-3.2.x.tar.gz
```
When DataStax Enterprise is started, it installs files into the /var/lib/cassandra and /var/log/cassandra directories. If you do not have root access to the default directories, ensure that you have write access:
```
$ 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
```

(Optional) If you do not want to use the default data and logging directories, you can define your own directory locations:

Make the directories for data and logging directories:

$ mkdir install_location/dse-data
$ cd dse-data
$ mkdir commitlog
$ mkdir saved_caches

Go the directory containing the cassandra.yaml file:
```
$ cd install_location/resources/cassandra/conf
```

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

Comment out the following option from the /etc/dse/cassandra/cassandra-env.sh file:
```
JVM_OPTS="$JVM_OPTS -Denable-old-dse-state=true"
```

Results

DataStax Enterprise is ready for configuration.

What's next

Set the configuration properties on each node in the cluster for single or multiple data center deployment.
Configure the heap dump directory to avoid server crashes.
Start DataStax Enterprise.
Configuration file locations.