How to Update Teamscale

This section describes how to migrate user- and project-specific data from an existing installation to newer versions of Teamscale. The steps needed to update Teamscale depend on whether you are applying a patch version update or a feature version update.

Patch version updates are updates where the first two parts of the version number stay the same. For example, an update from version 8.4.2 to the newer version 8.4.4 would be considered a patch version update.

Feature version updates are updates where one of the first two parts of the version number changed. For example, an update from version 8.4.3 to 8.5.0 would be considered a feature version update.

Avoid Downtimes with a Shadow Instance

For large instances, we recommend you use a shadow instance to perform feature version updates. This avoids unnecessary downtimes during the update process.

Updating from very old versions

Teamscale supports migration of backups from older version, but only for a few years into the past. If a backup is too old to be processed by the current version of Teamscale, you get a corresponding error message during the backup import. In this case, use an older version to import and re-export the backup, to get the backup to a newer version and repeat the update with this migrated backup.