Upgrading DSE OpsCenter tarball installations

Steps for upgrading OpsCenter using the 6.7 tarball.

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

Important: Upgrading from OpsCenter 6.1 to 6.7 or 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.7 or 6.8.


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
OpsCenter version DSE version
6.8 6.8, 6.7, 6.0, 5.1
6.7 6.7, 6.0, 5.1
6.5 6.0, 5.1, 5.0 (EOL)
6.1 5.1, 5.0 (EOL), 4.8 (EOSL)
6.0 5.0 (EOL), 4.8 (EOSL), 4.7 (EOSL)


Review Product Compatibility for information on OpsCenter compatibility with DSE.
Important: Before upgrading, backup your OpsCenter keyspace, 6.7 | 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 compatibility table to ensure that OpsCenter is compatible with your version of DataStax Enterprise.


  1. If you previously configured the api_port (6.7) | api_port (6.8) under the [cassandra] or [storage_cassandra] headers in cluster_name.conf, delete the entries.
    CAUTION: If this entry still exists under the [cassandra] or [storage_cassandra] headers, OpsCenter will not start.
  2. Download and extract the new tarball: 6.7 | 6.8.
  3. 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:

    scp -r old_tarball_directory/conf/clusters/* new_tarball_directory/conf/clusters/*
  4. If SSL is enabled, copy the contents of the SSL configuration directory: install_location/ssl/*.
  5. If opscenterd is running, stop the instance, 6.7 | 6.8, and start it from the new tarball installation directory.

What's next

Upgrade DataStax Agents manually from tarballs.