Installing DataStax Enterprise Binary Tarball Distribution¶

Prerequisites¶

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

• Oracle Java SE Runtime Environment (JRE) 6. 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¶

To install DataStax Enterprise and OpsCenter:

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

   # java -version
   

   DataStax recommends using the most recently released version of Oracle Java SE Runtime Environment (JRE) 6 on all DSE nodes. Versions earlier than 1.6.0_19 should not be used. 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.
• Initializing a DataStax Enterprise Cluster - Setting the configuration properties on each node in the cluster before starting the cluster.
• Starting DataStax Enterprise as a Stand-Alone Process - Starting DataStax Enterprise as a stand-alone process.