Installing the DataStax Enterprise package on RHEL-based distributions¶

Prerequisites¶

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

• The Yum Package Management application installed.
• Root or sudo access to the install machine.
• 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.
• 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.
• If you are installing DataStax Enterprise on a 64-bit Oracle Linux, first install 32-bit versions of glibc libraries.

Also, see Recommended Settings for Production Installations.

DataStax Enterprise and OpsCenter installation steps¶

DataStax provides Yum repositories for CentOS, Oracle Linux, and RHEL systems.

java -version (Use the latest version of Java 6.)
(For CentOS 5.x or RHEL 5.x, see step 2.)
Edit /etc/yum.repos.d/datastax.repo
Add:
[datastax]
name= DataStax Repo for Apache Cassandra
baseurl=http://<username>:<password>@rpm.datastax.com/enterprise
enabled=1
gpgcheck=0

yum install dse-full opscenter

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 the JRE on RHEL or CentOS Systems.

2. (CentOS 5.x/RHEL 5.x only) Make sure you have EPEL (Extra Packages for Enterprise Linux) installed. EPEL contains dependent packages required by OpsCenter. To install for both 32- and 64-bit systems:

   # rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm
   

3. Add a yum repository file for DataStax in /etc/yum.repos.d. For example:

   # /etc/yum.repos.d/datastax.repo
   

4. In this file add the following lines:

   [datastax]
   name= DataStax Repo for Apache Cassandra
   baseurl=http://<username>:<password>@rpm.datastax.com/enterprise
   enabled=1
   gpgcheck=0
   

5. Install DataStax Enterprise and OpsCenter using Yum:

   # yum install dse-full opscenter
   

The packaged releases create a user cassandra. When starting DataStax Enterprise as a service, the Cassandra and Hadoop tracker services run as this user. A service initialization script is located in /etc/init.d/dse. Run levels are not set by the package.

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 Packaged 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 service - Starting DataStax Enterprise as a Service.