A short troubleshooting guide to OpsCenter

By Erin Moy -  September 13, 2013 | 1 Comment

Hi my name is Erin and I’m a QA engineer. I’ve been on the OpsCenter team for the last 6 months or so and these are some problems I’ve encountered and their possible solutions.

General Checks

The following are things to check if you are not able to load OpsCenter in your browser, are not able to connect to your cluster, or notice other problems in OpsCenter.

  1. Make sure the opscenterd process is up and running. To check, run the following on the command line. ps -ef | grep opscenter
  2. Which browser are you using? Our supported browsers are Chrome, Firefox, and Safari.
  3. Are OpsCenter and the agents running? You might need to restart the agents after your cluster or OpsCenter was upgraded. Here are directions for restarting the agents.
  4. Is your firewall up? I’m guilty of this one. I sometimes forget to run “sudo service iptables stop” on my cluster that uses Red Hat. And remember to restart after disabling the firewall. Which port numbers are opened? This gave me problems when I was setting up my Amazon EC2 account. The solution was to make the ports as open as possible. In EC2, this would be your security groups. Important ports for OpsCenter can be found here.
  5. Is SSL mismatched? For example, your agents has SSL enabled and OpsCenter does not or vice versa. OpsCenter SSL documentation

What functionality is limited to the enterprise edition?

  1. You can provision DataStax Enterprise clusters.
  2. You can manage multiple clusters.
  3. Alerts
  4. Data backups
  5. Cluster report
  6. Diagnostics tarball
  7. Email notifications

Permissions and Backups

This is pertinent to people using OpsCenter and their DSE/Cassandra cluster was installed from a tarball. If you have this setup and try to run a backup, you will see something like below.


You will need to make sure the user running the agent has read/write permissions on the Cassandra data directory. Choose one of the following solutions:

  1. Add the user to the group that owns the directory.
  2. Run the opscenter-agent as root. Once opscenterd, Cassandra, and the agent are installed and running (but before trying to backup / restore anything), edit /etc/init.d/opscenter-agent on your cluster, replacing the USER= line with USER="root". Then sudo service opscenter-agent restart.

You should be able to run a backup and restore successfully now.

Resources and Documentation

Good online resources and documentation sure come in handy, especially when you have forgotten something. Here’s a list of some of most useful resources I know of.

Official DataStax Documentation

Getting Started with Apache Cassandra

DataStax Enterprise questions on StackOverflow

OpsCenter 3.2 Troubleshooting

When in doubt, do not be afraid to ask questions.

DataStax has many ways for you to advance in your career and knowledge.

You can take free classes, get certified, or read one of our many white papers.

register for classes

get certified

DBA's Guide to NoSQL


  1. Josh says:

    I got the OpsCenter installed along with agents (I see no errors in OpsCenter) . However the Service menu is disabled. Is there anything which needs to be done to get it enabled ?
    I am attaching you a photo of the OpsCenter installed.

    Here is our version of Cassandra

    cqlsh> select peer, release_version from system.peers;

    peer | release_version
    ————–+—————– | 2.0.8 | 2.0.8

    (2 rows)

    cqlsh> select release_version from system.local;



Your email address will not be published. Required fields are marked *

Subscribe for newsletter:

Tel. +1 (408) 933-3120 sales@datastax.com Offices France GermanyJapan

DataStax Enterprise is powered by the best distribution of Apache Cassandra™.

© 2017 DataStax, All Rights Reserved. DataStax, Titan, and TitanDB are registered trademark of DataStax, Inc. and its subsidiaries in the United States and/or other countries.
Apache Cassandra, Apache, Tomcat, Lucene, Solr, Hadoop, Spark, TinkerPop, and Cassandra are trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries.