Skip to content

Further Information on Version Upgrades

Upgrade from version 3.0 to version 4.0

Warning

With Squash TM 4.0, version of Java and the drivers for connection to PostgreSQL and MariaDB databases are updated.
As a result of choices imposed by these tools, Squash TM 4.0.0 is not be compatible with: - MySQL, no matter its version
- MariaDB 10.1
- PostgreSQL 9 (as a reminder, PostgreSQL 10 is also not supported)
- Java versions before Java 11, including Java 8 (Java installed on the server hosting Squash TM)

If you are using Squash with one of these versions, we recommend you to upgrade your tools - or to migrate in the case of MySQL - before considering an upgrade to Squash TM version 4.0. More information on this post

To upgrade Squash TM from version 3.0 to version 4.0, you must run an upgrade script on the database: <database>-upgrade-to-4.0.0.sql.
It is necessary to follow the usual upgrade procedure.

Plugins Compatibility

Because of the upgrade of internal components, when upgrading to Squash TM 4.0, it is necessary to also upgrade all the plugins. All the plugins compatible with Squash TM 4.0 are in version 4.0.0.

Transition from Mantis SOAP Bugtracker to Mantis REST Bugtracker

With Squash TM 4.0, Mantis REST Bugtracker replaces Mantis SOAP Bugtracker that is not available anymore. Unlike Mantis SOAP Bugtracker which was included in Squash TM core, it is necessary to install Mantis REST Bugtracker connector to access its functionalities. By default, it is included in Squash TM distribution (in the 'plugins' directory).

Transition from Mantis SOAP Bugtracker to Mantis REST Bugtracker does not cause data loss. Known issues linked to executions are still visible in Squash TM. It is also not necessary to create a new bugtracker in Squash TM.
Only the authentication protocol changes, it is now a token authentication. To use this new connector and visualize known issues reported with the former connector, users must authenticate again to Mantis from Squash TM with their token generated in Mantis beforehand.

Compatibility with Squash AUTOM/DEVOPS

Squash TM 4.0 is compatible with Squash AUTOM/DEVOPS 2022-05 and later deliveries. Thus, for Squash AUTOM/DEVOPS users, Squash Orchestrator and the associated services must be updated.

Moreover, with Squash TM 4.0, it is now possible to configure the URL to retrieve information from Squash Orchestrator for a Squash AUTOM test automation server. For existing configuration, it is necessary to configure this URL. For more information, visit the documentation.

Upgrade from Version 2.1+ to Version 3.0

To upgrade Squash TM from version 2.1 to version 3.0, you must run an upgrade script on the database: <database>-upgrade-to-3.0.0.sql.
It is necessary to follow the usual upgrade procedure.

Plugins Compatibility

With the upgrade to Squash TM 3.0, it is necessary to also upgrade some plugins. All the plugins compatible with Squash TM 3.0 are in version 3.0.0.
For the plugins that don't have a 3.0 version, the version 2.X is compatible with Squash TM 3.0.

Upgrade from Version 2.1 to Version 2.2

To upgrade Squash TM from version 2.1 to version 2.2, it is not necessary to upgrade the database. You must only upgrade the app.

Plugins Compatibility

Plugins compatible with Squash TM 2.1 are also compatible with Squash TM 2.2 except the following plugins that have a 2.2 version:

  • Result Publisher Plugin
  • Squash AUTOM Plugin

Warning, plugins in version 2.2 are not compatible with Squash TM 2.1. To have the latest features, it is necessary to upgrade Squash TM and the plugins in version 2.2.

Upgrade from Version 2.0 to Version 2.1

To upgrade Squash TM from version 2.0 to version 2.1, you must run an upgrade script on the database: <database>-upgrade-to-2.1.0.sql.
It is necessary to follow the usual upgrade procedure.

Plugins Compatibility

Squash TM 2.1 is compatible with plugins in version 2.1. For the plugins that don't have a 2.1 version, the version 2.0 is compatible with Squash TM 2.1.
Warning, plugins in version 2.1 are not compatible with Squash TM 2.0. To have the latest features, it is necessary to upgrade Squash TM and the plugins in version 2.1.

Upgrade from Version 1.22.5+ to Version 2.0

To upgrade from Squash TM 1.22.5 to Squash TM 2.0, you must follow the usual procedure:

  • Download the configuration files and the database
  • Download version 2.0
  • Run the upgrade script <database>-upgrade-to-2.0.0.sql in the database
  • Update the app

Warning

From version 2.0 onwards, packages Debian and Red Hat are no longer supported.
Please visit the page for more details on the procedure to follow.

Focus

Squash TM 2.0 offers a brand new interface based on the Angular technology. This change of technology entails that you must be watchful about a few things, which are listed down below.

Plugins Compatibility

Squash TM plugins that are compatible with versions 1.X are no longer compatible with version 2.0. Therefore, you must download the new version of these plugins to enjoy their features in Squash TM 2.0.

To avoid inconsistencies, all the plugins compatible with Squash TM 2.0 are in version 2.0.0.RELEASE.

Learn More

To see the list of plugins compatible with Squash TM 2.0, please visit the page Squash TM Plugins

Some plugins compatible with versions 1.X of Squash TM were already in version 2.X. To ensure a version number consistency between Squash TM and its plugins, these plugins were renamed.

Here is the table of correspondences for these plugins:

Plugin Name in Squash TM 1.X Name in Squash TM 2.0
Test Cases Report Books PDF report.books.testcases-1.x report.books.testcases.pdf
Editable Test Cases Report Books
(included in Squash TM)
report.books.testcases-2.x report.books.testcases.editable
Requirements Report Books PDF report.books.requirements-1.x report.books.requirements.pdf
Editable Requirements Report Books
(included in Squash TM)
report.books.requirements-2.x report.books.requirements.editable
Campaign & Iteration Report report.campaignassessment report.campaign.execution

Changes in Language Files

In Squash TM 2.0, the outsourcing of language files is evolving. The new interface being based on Angular, the messages visible in the HCI are now stored in new files in .json format. Custom (empty) files for every supported language (French, English, Spanish, German) are available in the Squash TM server directory conf/lang.

If the language files were modified in version 1.X to custom messages visible in the HCI, you must copy these changes in the .json files compatible with Squash TM 2.0.

However, you must keep the language files that were modified in version 1.X because they are still being used in version 2.X, especially for some backend and report messages.

Learn more

To learn more about these files, please read this part Outsource language files

Custom Plugins

This change of technology also has consequences on plugins. Thus, if custom plugins were created for Squash TM, and if they add graphic elements (buttons, fields) or new screens to Squash TM, they will no longer work with Squash TM 2.0. You must make the necessary changes to these custom plugins before you can use them in the new version.

Upgrade from Version 1.21.X to Version 1.22.4

To upgrade to version 1.22, you must follow the usual procedure: replace the binary code and run the required SQL scripts.

Warning

To upgrade to version 1.22.2+, you must run all the upgrade scripts between the database's original version to the targeted version of Squash TM. To upgrade to version 1.22.4 from version 1.21.X, you must run the following scripts in order:

  • <databse>-upgrade-to-1.22.0.sql
  • <databse>-upgrade-to-1.22.2.sql
  • <databse>-upgrade-to-1.22.3.sql

When you are running the script to upgrade to version 1.22, warnings and triggers can appear. These warnings are only for information purposes and have no impact whatsoever on the app.

Following the upgrade to Squash TM 1.22, login information to the automated execution servers will be lost because they are stored differently in the database. You will have to re-enter them on the automated execution server's consultation page in the block "Authentication policy":

Authentification à Jenkins

A new option added to the Squash TM administration allows you to automatically connect to bugtrackers when you are using an AD or LDAP.

Three new API come with version 1.22: Admin API, Xsquash4Jira API, and Actions Library API.

Learn more

To learn more about Squash TM APIs, please visit this page Squash TM APIs

Focus

In Squash TM 1.22, the install process of the systemd service in Debian has also evolved. Read more.

Upgrading from Version 1.20.X to Version 1.21.X

Upgrading from Squash TM 1.20.X to Squash TM 1.21.X must be done by following the usual version upgrade procedure.

It must be noted that running the script to upgrade to version 1.21 can take longer than usual when there is a high number of executions in Squash TM's database.