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 following compatibility table to ensure that OpsCenter is compatible with your version of DataStax Enterprise.
OpsCenter version | DSE version |
---|---|
6.8 |
6.8, 6.7 [EOSL], 6.0 [EOSL], 5.1 |
6.7 |
DSE 6.0 [EOSL] |
6.5 |
6.0 [EOSL], 5.1, 5.0 [EOSL] |
6.1 |
5.1, 5.0 [EOSL], 5.0 [EOSL] |
6.0 |
5.0 [EOSL], 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 incluster_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.