Follow the steps described below to upgrade Magic Collaboration Studio to a new version and migrate its database.
Database migration prerequisites
The steps below apply only when migrating the Magic Collaboration Studio 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 Magic Collaboration Studio).
For more information about migrating the Magic Collaboration Studio database to 2021x series, see:
To upgrade Magic Collaboration Studio and migrate the database
Upgrade Apache Cassandra to version 4.x (we recommend using Apache Cassandra 4.0.3).
Upgrade Magic Collaboration Studio. After upgrading, the database schema will be updated automatically on the first Magic Collaboration Studio start-up.
Note on usernames
When migrating from a pre-2022x Refresh1 Magic Collaboration Studio server, ensure that you 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.