Page History

On this page

Preparing to upgrade Cassandra

To prepare for Cassandra upgrade

1. Ensure that all Cassandra nodes are ready. Run the following command and verify that all nodes are Up and Normal:
   

   Code Block
   language bash theme DJango linenumbers true
   nodetool status

2. Leave the Cassandra service running but stop all Teamwork Cloud services.
3. Back up your current database before upgrading.
4. Upgrade all Cassandra data tables to current version by running the following command:
   

   Code Block
   language bash theme DJango linenumbers true
   nodetool upgradesstables

   Note
   This process can take a long time for large databases. To run the upgrade process in the background, you can use the Linux nohup command: Code Block language bash theme DJango linenumbers true nohup nodetool upgradesstables & Make sure this process is completed before proceeding!

Upgrading Cassandra

Teamwork Cloud no longer supports Apache Cassandra 3.x, therefore before upgrading Teamwork Cloud, you need to upgrade Casandra to version 4.1.

To upgrade Cassandra

1. IMPORTANT! Flush memtables to the disk by executing the following command:

   Code Block
   language bash theme DJango linenumbers true
   nodetool drain

2. Shut down Stop the Cassandra nodeservice.

3. Backup the Cassandra configuration file at: /etc/cassandra/default.conf/cassandra.yaml

4. Make a note of the existing cluster name and token count with the following command:

   Code Block
   language bash theme DJango linenumbers true
   grep -E 'num_tokens:|cluster_name:' cassandra.yaml

5. Uninstall/remove Cassandra 3.x (example with yum package manager)

   Code Block
   language bash theme DJango linenumbers true
   sudo yum remove -y cassandra

6. Install Cassandra 4.x. new version of Cassandra (for installation instructions, see see Installing Cassandra on Linux or Installing Cassandra on Windows.

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

   Code Block
   language bash title Example
   data_file_directories: - /data/data commitlog_directory: /logs/commitlog hints_directory: /data/hints saved_caches_directory: /data/saved_caches

8. ).

9. Check the cluster name and token count in in cassandra.yaml. If needed, replace the default values with the values set in 3.xthe previous version. The example below shows the default values for a Cassandra 4.x installation. 

10. Code Block
    language bash title Example
    cluster_name: 'Test Cluster' num_tokens: 16

    Note
    title Cassandra 4 Configuration
    The cluster name and token count must match those values set in the previous version of Cassandra 3.x.

11. Start the Cassandra 4.x node.service.

12. Check if the service is running smoothly:

    • Check the log

    files

    • file for

    errors.After the upgrade is complete, perform the required post-installation configuration changes. For more information, see Post-installation steps on Linux or Post-installation steps on Windows.

    • startup errors.

    • Verify that all nodes have a status of Up and Normal with this command:

      Code Block
      language bash theme DJango linenumbers true
      nodetool status

Additional resources

For more information about upgrading Apache Cassandra, see https://www.datastax.com/learn/whats-new-for-cassandra-4/migrating-cassandra-4x.