1.4.1. Upgrading

1.4.1.1. Preface

Please completely read this section before attempting to upgrade your current version of the Axivion Suite.

If at any point you have got questions, please do not hesitate to contact us at axivion.support@qt.io in order to resolve open questions before issues arise.

1.4.1.2. Which version to upgrade to?

Usually we recommend upgrading to the latest version available.

Changing the major version (second digit in our version scheme) usually requires more migration work on your side and can cause more changes in analysis findings than changes in the minor version (third digit in our version scheme).

You thus may want to choose to stay on your current major version even though a newer major version is available until new features or performance improvements of the newer major version force you to do the bigger upgrade.

1.4.1.3. Planning your upgrade

Before performing an upgrade, you should read the relevant sections of the “Update and Migration” chapter.

If you are upgrading e.g. from version 7.2.1 to 7.3.0 you should read all the migration sections “between” 7.2.1 and 7.3.0. Some of these sections will not exist which means that either no such version was released or there are no migration hints for that version.

If you are using a distributed setup of multiple Axivion Suite installations you should consider the hints of the next section.

1.4.1.4. Order of upgrading / Version compatibility

If you are using a separate installation of the Axivion Suite for a centralized dashboard installation, you can upgrade that installation first and everything should continue to work unless otherwise noted in the respective sections of the “Update and Migration” chapter. The dashboard is designed to be backwards compatible and thus can display the analysis results produced by older installations of the Axivion Suite. It will not do any automatic migration of the analysis data either, so you can continue analyzing with an older version of the Axivion Suite and still display the results in a newer dashboard.

While running a later version of the Axivion Suite on the analysis side together with an earlier version on the dashboard side may work, we do not guarantee this combination of a version mismatch.

Users of the IDE plugins usually are not required to upgrade immediately. Once the dashboard they are working with is upgraded, they can download the updated version from the upgraded dashboard.

1.4.1.5. Upgrading the installation files

When upgrading the Axivion Suite you should never install a newer version on top of an older one. Either uninstall the old version first and then install the new version, or install the new version into a different location. (If you use the installer, it will offer to remove the old installation automatically starting from 7.12.0.)

Please shut down any running processes of the Axivion Suite. This includes running continuous integration builds, running dashboards, any running instances of gravis, etc. (When using the Windows installer, it takes care of shutting down the dashboard.)

For the installation itself, you can either use the guided installer (.exe on Windows, .run on GNU/Linux, .dmg on macOS) installer or extract the archive (.zip on Windows, .tar.gz on GNU/Linux and macOS) to a location of your preference.

On GNU/Linux and macOS, after unpacking the provided .tar.gz file (i.e., when not using the guided installer), you have to execute ./setup.sh once.

Refer to Basic Installation for more information.

1.4.1.6. Apply necessary configuration changes

Now is the time to adjust the configuration when necessary according to the sections of the “Update and Migration” chapter.

1.4.1.7. Using the new version

The new version of the Axivion Suite is now ready for use and processes such as the dashboard, continuous integration, or gravis can now be started again. (When using the Windows installer, it takes care of starting the Dashboard again.)

Upon launch of the new dashboard, it will automatically migrate the internal configuration database if necessary.

Project databases are automatically migrated on next continuous integration run.

Users of the IDE plugins can now upgrade their plugins by downloading them from the new dashboard.