Upgrading DSE OpsCenter tarball installations

About This Task

These steps provide information on upgrading to OpsCenter 6.8.0 using the OpsCenter tarball and restarting the opscenterd daemon.

Upgrading from OpsCenter 6.1 to 6.8 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.8.


Review Product Compatibility for information on OpsCenter compatibility with DSE.

Before upgrading, backup your OpsCenter keyspace (6.8) 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, view the following compatibility table to ensure that OpsCenter is compatible with your version of DataStax Enterprise.

OpsCenter version DSE version


6.8, 6.7 [EOSL], 6.0 [EOSL], 5.1


DSE 6.0 [EOSL]


6.0 [EOSL], 5.1, 5.0 [EOSL]


5.1, 5.0 [EOSL], 5.0 [EOSL]


5.0 [EOSL], 4.8 [EOSL], 4.7 [EOSL]


  1. Locate the cluster_name.conf file. The location of this file depends on the type of installation:

    • Package installations: /etc/opscenter/clusters/cluster_name.conf

    • Tarball installations: <install_location>/conf/clusters/cluster_name.conf

  2. If you previously configured the api_port (6.8) under the [cassandra] or [storage_cassandra] headers in cluster_name.conf, then delete the entries.

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

  3. Download and extract the new tarball: 6.8.

  4. Copy the following files and directories from the old tarball installation directory to the new one:


    For example, the following command copies the files in the /conf/clusters/* directory from the old tarball location to the new one, after substituting the location paths:

    scp -r <old_tarball_directory>/conf/clusters/* <new_tarball_directory>/conf/clusters/*
  5. If SSL is enabled, copy the contents of the SSL configuration directory: install_location/ssl/*.

  6. If opscenterd is running, stop the instance, 6.8, and start it from the new tarball installation directory.

What is Next

Upgrade DataStax Agents manually from tarballs.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000, info@datastax.com