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.

Prerequisites

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 folowing compatibility table to ensure that OpsCenter is compatible with your version of DataStax Enterprise.

OpsCenter version	DSE version
6.8	6.8, 6.7, 6.0, 5.1
6.7	DSE 6.0
6.5	6.0, 5.1, 5.0 (EOL)
6.1	5.1, 5.0, 5.0 (EOL)
6.0	5.0 (EOL), 4.8 (EOSL), 4.7 (EOSL)

Procedure

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
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.
Download and extract the new tarball: 6.8.
Copy the following files and directories from the old tarball installation directory to the new one:
```
conf/clusters/*
conf/event-plugins/*
conf/install_id
conf/logback.xml
conf/opscenterd.conf
./passwd.db
./lcm.db
./keys/lcm.key
```
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/*
```
If SSL is enabled, copy the contents of the SSL configuration directory: install_location/ssl/*.
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.