DataStax OpsCenter Documentation

Installing OpsCenter from Debian or Ubuntu packages

DataStax provides OpsCenter packages for Debian and Ubuntu distributions. For a complete list of supported platforms, see OpsCenter – Supported Platforms. There are different package repositories for OpsCenter Community Edition and OpsCenter Enterprise Edition.

The OpsCenter Debian and Ubuntu packaged releases runs as a service from root. The service initialization script is located in /etc/init.d. If the machine reboots, OpsCenter restarts automatically.

Prerequisites

Before installing OpsCenter make sure you meet 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).
  • APT Package Manager.
  • 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+
  • OpenSSL: 0.9.8. SSL is enabled by default.

To check for the software versions:

$ java -version
$ python -V
$ openssl version

Use the exact version listed in Prerequisites. For example, the default OpenSSL on Ubuntu 11.10 1.0.0. If running openssl version shows that 1.0.0 is installed, you must install OpenSSL 0.9.8:

$ sudo apt-get install libssl0.9.8

After installing OpenSSL 0.9.8, Ubuntu 11.10 will still show 1.0.0.

Installing the OpsCenter package

To install OpsCenter on a Debian or Ubuntu system:

  1. Ensure that a DSE or Cassandra cluster is installed, configured, and running. You can determine this by using the nodetool ring command.

  2. Open the aptitude repository source list file (/etc/apt/sources.list) for editing. For example:

    # vi /etc/apt/sources.list
    
  3. In this file, add the repository for the edition you want to install. OpsCenter Enterprise Edition installations require the DataStax <username> and <password> you received in your registration confirmation email.

    • OpsCenter Community (free) Edition:

      deb http://debian.datastax.com/community stable main
      
    • OpsCenter Enterprise (paid) Edition:

      deb http://<username>:<password>@debian.datastax.com/enterprise stable main
      
  4. Add the DataStax repository key to your aptitude trusted keys:

    # curl -L http://debian.datastax.com/debian/repo_key | apt-key add -
    
  5. Install the OpsCenter package using the APT Package Manager:

    • OpsCenter Community (free) Edition:

      # apt-get update
      # apt-get install opscenter-free
      
    • OpsCenter Enterprise (paid) Edition:

      # apt-get update
      # apt-get 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 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.