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