DataStax OpsCenter Documentation

Installing OpsCenter tarball distributions on Linux and Mac OSX

DataStax provides a binary tarball for installing OpsCenter Community Edition and OpsCenter Enterprise Edition. The tarball installs OpsCenter in a single directory. This type of installation does not require root permissions.

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 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).
  • Oracle Java SE Runtime Environment (JRE) 6 - Install the most recently released version of the JRE 6. Versions earlier than 1.6.0_19 should not be used. Java 7 is not recommended.
  • Python 2.6+
  • (Linux only) SYSSTAT Utilities (for collection of I/O system metrics). When agents are installed from packaged installations, these utilities are installed automatically.
  • The correct version of OpenSSL for your operating system.

To check for the software versions:

$ java -version
$ python -V
$ openssl version
$ iostat -V

Installing the OpsCenter binary

To install on a Linux or Mac OSX 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. Download the tarball distribution of OpsCenter.

    For the Community (free) and Enterprise (paid) editions, you can either download the packages from the DataStax website or use the wget command. For example:

    • OpsCenter Community (free) Edition:

      $ curl -OL http://downloads.datastax.com/community/opscenter.tar.gz
      
    • OpsCenter Enterprise (paid) Edition:

      $ curl -OL http://<username>:<password>@downloads.datastax.com/enterprise/opscenter.tar.gz
      
  3. Unpack the distribution.

    $ tar -xzvf opscenter.tar.gz
    

    Files for OpsCenter and a single OpsCenter agent are now in place.

  4. Set the [webserver] interface (hostname or IP address of the OpsCenter machine) and any other required configuration properties for your environment in the opscenterd.conf file as described in OpsCenter configuration properties.

  5. Start OpsCenter.

    After a few moments, the OpsCenter connects to its agent. A tarball for deploying agents to other nodes appears in the OpsCenter installation directory. See Manually deploying agents - Tarball installations to deploy agents to other nodes. You cannot deploy multiple agents to other nodes automatically (by clicking Fix in the OpsCenter console).

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