Versions Compared

Old Version 1

changes.mady.by.user Inga A.

Saved on

compared with

New Version Current

changes.mady.by.user Jonė Š.

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Image Added Teamwork Cloud Software Upgrade Path Image Added

19.0


Database Migration 19.0

Image Added



19.0 SP3


Database Migration 2021x

Image Added



2021x


Cassandra Upgrade


Image Added



2021x Refresh2 HF5




Image Added

19.0 SP119.0 SP4

2021x Refresh12022x
19.0 SP2

2021x Refresh22022x Refresh1
2021x Refresh2 HF5

2022x Refresh2

2024x

2024x Refresh1

Cassandra 3

Cassandra 4

How to use the diagram:

  • 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 are upgrading vertically down a single column, you only need to upgrade the Teamwork Cloud software. Intermediate versions can be skipped as well.
Note
  • 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:
  • Teamwork Cloud 2021x Refresh 2 HF5 supports both Cassandra 3 and 4.

Upgrade guides

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

...

id1266628834

...

id1266628836

...

id1266628835

...

Warning
titleDatabase migration prerequisites

The steps below apply only when migrating the Teamwork Cloud database from versions 2021x, 2021x Refresh1, and 2021x Refresh2. If you want to migrate the database of an earlier version, first migrate it to 2021x series. When migrating skip the project migration step on the client-side (this step will be required only after the migration to the new version of Teamwork Cloud).

For more information about migrating the Teamwork Cloud database to 2021x series, see:

...

  2. Upgrade Apache Cassandra to version 4.x

...

  1. from 3.x (if needed).
  2. Upgrade Teamwork Cloud.

...

  2. Migrate Teamwork Cloud projects.
  3. Migrate Cameo Collaborator documents if there are any.

When migrating from

a pre-2022x Refresh1

the Teamwork Cloud server version earlier than 2022x Refresh1,

ensure that

you

delete duplicate

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.

Warning
Note
titleNote on usernames