View Source

Refer to the table below to determine your Teamwork Cloud upgrade path.

Teamwork Cloud Software Upgrade Path
19.0	Database Migration 19.0	19.0 SP3	Database Migration 2021x	2021x	Cassandra Upgrade	2021x Refresh2 HF5
19.0 SP1		19.0 SP4		2021x Refresh1		2022x
19.0 SP2				2021x Refresh2		2022x Refresh1
				2021x Refresh2 HF5		2022x Refresh2
						2024x
						2024x Refresh1
						2024x Refresh2
						2024x Refresh3
Cassandra 3						Cassandra 4

How to use the table:

Find the version of Teamwork Cloud you are currently running.
Find the target version you would like to upgrade to.
If you are upgrading from left to right, you need to migrate the database and/or upgrade Cassandra as well as the Teamwork Cloud software.
You cannot skip database migration and upgrade steps when upgrading from left to right.
You can upgrade directly between non-consecutive versions (for example, from 2021x to 2024x), but you may need to upgrade Cassandra.
If you upgrade vertically down a single column, you only need to upgrade the Teamwork Cloud software. Intermediate versions can be skipped as well.

The procedures of data migration for versions 19.0 & 2021x are completely different. See the following pages on migrating data and upgrading Teamwork Cloud for the relevant target version:
- 19.0 SP4
- 2021xR2
Teamwork Cloud 2021x Refresh 2 HF5 supports both Cassandra 3 and 4.

Upgrade guides

Back up your current data before any upgrade! Once you upgrade Teamwork Cloud, you cannot downgrade it. Major database changes occur with each Teamwork Cloud upgrade and data cannot be reverted.
Upgrade Apache Cassandra (if needed).
Upgrade Teamwork Cloud.
Migrate Teamwork Cloud projects.

When migrating from the Teamwork Cloud server version earlier than 2022x Refresh1, you must delete duplicate external LDAP users with usernames in different cases (e.g., JOHN and john) if such usernames exist. Leave just one user. Otherwise, authentication of these duplicate user entries might fail in 2022x Refresh1 or newer versions.