This section covers the steps to upgrade from Cassandra 3 to 4 for Teamwork Cloud 2021x Refresh 2 HF5 and newer releases. If you are trying to upgrade from v19.0, please refer to the data migration guide first.
|
To upgrade Cassandra
IMPORTANT! Flush memtables to the disk by executing the following command:
nodetool drain |
Shut down the 3.x node.
Make a note of the existing cluster name and token count with the following command:
grep -E 'num_tokens:|cluster_name:' cassandra.yaml |
Uninstall/remove Cassandra 3.x (example with yum package manager)
sudo yum remove -y cassandra |
Configure the 4.x node to point to the appropriate data files in the /etc/cassandra/default.conf/cassandra.yaml settings as shown in the example below.
data_file_directories: - /data/data commitlog_directory: /logs/commitlog hints_directory: /data/hints saved_caches_directory: /data/saved_caches |
Check the cluster name and token count in cassandra.yaml. If needed, replace the default values with the values set in 3.x. The example below shows the default values for a Cassandra 4.x installation.
cluster_name: 'Test Cluster' num_tokens: 16 |
The cluster name and token count must match those values set in Cassandra 3.x. |