Upgrading DSE OpsCenter package installations

Steps to upgrade to OpsCenter 6.7 for Debian or RHEL environments.

These steps provide information on upgrading to OpsCenter 6.7.0 for package installs and restarting the opscenterd daemon.

Important: Upgrading from OpsCenter 6.1 to 6.7.0 requires an interim upgrade to OpsCenter 6.5. Upgrade from OpsCenter 6.1 to the most current release of OpsCenter 6.5 before upgrading to OpsCenter 6.7.0.


The location of the cluster_name.conf file depends on the type of installation:
  • Package installations: /etc/opscenter/clusters/cluster_name.conf
  • Tarball installations: install_location/conf/clusters/cluster_name.conf


Review Upgrade considerations for changes in configuration files, metrics, and APIs that affect upgrades to OpsCenter 6.7.0.

Important: Before upgrading, back up your OpsCenter keyspace if you anticipate, plan, or need to downgrade to an earlier version of OpsCenter. Downgrading OpsCenter is a very manual and case-specific process. If you require a downgrade, contact DataStax Support for assistance before proceeding.
Additionally, ensure that OpsCenter is compatible with your version of DataStax Enterprise.
OpsCenter version DSE version
6.7 6.7, 6.0, 5.1
6.5 6.0, 5.1, 5.0
6.1 5.1, 5.0
6.0 5.0


  1. If you previously configured the api_port under the [cassandra] or [cassandra_storage] headers in cluster_name.conf, delete the entries and insert them under the [agents] header.

    If this entry still exists under the [cassandra] or [cassandra_storage] headers, OpsCenter will not start.

  2. On the OpsCenter daemon host, run the appropriate command to update the packages:
    • Debian or Ubuntu
      apt-get update
    • RHEL or CentOS
      Note: Yum automatically updates package lists when necessary.
  3. Install the upgraded OpsCenter package:

    Replace version_number shown in the example below with the version to which you are upgrading.

    • Debian or Ubuntu:
      apt-get install opscenter=version_number
    • RHEL or CentOS:
      yum install opscenter-version_number
  4. If the package manager prompts you for options regarding opscenterd.conf, keep your currently installed version.
  5. Restart the OpsCenter daemon.
    service opscenterd restart