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.

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 properly configured 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. Ensure that a DSE or Cassandra cluster is installed, configured, and running. You can determine this by using the nodetool ring command.

  2. (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
    
  3. Open the yum repository specification /etc/yum.repos.d for editing. For example:

    # vi /etc/yum.repos.d/datastax.repo
    
  4. 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
      
  5. Install the OpsCenter package using yum:

    • OpsCenter Community (free) Edition:

      # yum install opscenter-free
      
    • OpsCenter Enterprise (paid) Edition:

      # yum install opscenter
      
  6. 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
    
  7. Start the OpsCenter:

    sudo service opscenterd start
    
  8. Install the agents:

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