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.5 for package installs and restarting the opscenterd daemon.

Important: Upgrading from OpsCenter 6.1 to 6.7.5 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.5.

cluster_name.conf

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

Prerequisites

Review Upgrade considerations for changes in configuration files, metrics, and APIs that affect upgrades to OpsCenter 6.7.5.
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, view the compatibility table to ensure that OpsCenter is compatible with your version of DataStax Enterprise.

Procedure

  1. If you previously configured the api_port 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. On the OpsCenter daemon host, run the appropriate command to update the packages:
    • Debian or Ubuntu
      sudo 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:
      sudo apt-get install opscenter=version_number
    • RHEL or CentOS:
      sudo 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.
    sudo service opscenterd restart

What's next

Upgrade DataStax Agents from the OpsCenter interface.