DataStax OpsCenter Documentation

Installing OpsCenter from CentOS, OEL, and RHEL packages

DataStax provides yum repositories for CentOS, Oracle Enterprise Linux (OEL), and RedHat Enterprise Linux (RHEL) distributions. For a complete list of supported platforms, see OpsCenter – Supported Platforms. There are different package repositories for the Community and Enterprise versions of OpsCenter.

The CentOS, OEL, and RHEL OpsCenter packaged releases create an opscenter user. OpsCenter runs as a service and runs as this user. The service initialization script is located in /etc/init.d. If the OpsCenter machine reboots, OpsCenter restarts automatically.

Note

By downloading OpsCenter from DataStax you agree to the terms of the DataStax Enterprise EULA or the DataStax Community EULA (End User License Agreements) posted on the DataStax website.

Prerequisites

Before installing OpsCenter make sure you have met the following prerequisites:

  • OpsCenter hardware requirements: computer with 2 cores and 2 GB RAM.
  • Your Cassandra or DataStax Enterprise cluster is up and running.
  • IP address or hostname of the machine where you are installing OpsCenter.
  • IP address or hostnames of two or three of your nodes.
  • Port number used by JMX (default is 7199).
  • YUM package management utility.
  • Root or sudo access on the machine where you are installing OpsCenter.
  • Oracle Java SE Runtime Environment (JRE) 6 - Install the JRE. Versions earlier than 1.6.0_19 should not be used. Java 7 is not recommended.
  • Python 2.6+
  • The correct version of OpenSSL for your operating system.

To check for the software versions:

$ java -version
$ python -V
$ openssl version

Installing the OpsCenter package

To install OpsCenter on CentOS, Oracle Linux, or RHEL:

  1. (CentOS 5.x/RHEL 5.x only) Make sure you have EPEL (Extra Packages for Enterprise Linux) installed. EPEL contains dependent packages, such as Python 2.6+, 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

  2. Open the yum repository specification /etc/yum.repos.d for editing. For example:

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

  3. In this file, add the repository for the edition you are installing. OpsCenter Enterprise Edition installations require the DataStax <username> and <password> you received in your registration confirmation email.

    • OpsCenter Community (free) Edition:

      [opscenter]
name= DataStax Repository
baseurl=http://rpm.datastax.com/community
enabled=1
gpgcheck=0

    • OpsCenter Enterprise (paid) Edition:

      [opscenter]
name= DataStax Repository
baseurl=http://<username>:<password>@rpm.datastax.com/enterprise
enabled=1
gpgcheck=0

  4. Install the OpsCenter package using yum:

    • OpsCenter Community (free) Edition:

      # yum install opscenter-free

    • OpsCenter Enterprise (paid) Edition:

      # yum install opscenter

  5. Set the [webserver] interface to the hostname or IP address of the OpsCenter machine in the /etc/opscenter/opscenterd.conf file. For example:

    [webserver]
port = 8888
interface = 10.183.170.161

  6. Start the OpsCenter:

    sudo service opscenterd start

  7. Install the agents:

  8. To start using OpsCenter, open a browser window and go to the OpsCenter URL at http://<opscenter_host>:8888 where <opscenter_host> is the IP or hostname of the OpsCenter machine.