Upgrade Tosca Server

For upgrades from version 2025.1 or newer, we've made the process easier. The account used to run your service is now saved accordingly for Tosca Server component services, so upgrades work even if you use a custom service account.

The new upgrade process transfers your configurations and settings to the new version automatically. The only exception is Interactive Testing. Tosca Server upgrades it, but you still need to manually back up and update its configuration files.

We strongly recommend that you always try the simplified upgrade and don't uninstall and reinstall Tosca Server. If you do uninstall, you'll need to manually back up your configuration files and then populate the new version's configuration files.

Preparatory steps for Interactive Testing

If you use Interactive Testing, back up the configuration files listed in "Tosca Server configuration files" before the upgrade. Keep these things in mind:

• You only need to back up the files that are listed for Interactive Testing.

• You only need to back up the Interactive Testing configuration files.

Upgrade process

Since Tosca Server supports implicit upgrades, you don't need to uninstall the old version first. Instead, just install the new version:

1. Make sure you meet the installation requirements in "Before you start".

2. Trigger the upgrade:

   • For attended installation, run the executable file.

   • For unattended installation, run the command "Tricentis Tosca Server 2026.1 LTS.exe" /s /qn.

   Depending on your system environment, you may need to run as an administrator.

3. If you use Interactive Testing, re-populate the settings. Use your backups as references.

   Only use your backup files as a reference.

   • Don't replace any new version files with your backup files.

   • Don't paste the entire content from your backup files without checking for differences between settings in the new and the old version.

4. Open TricentisService Configuration and verify your settings. Then, select Save in any tab. This is an important step to finalize your upgrade.

Troubleshooting

Tosca Server upgrades component by component: it backs up the configuration files of the first component, upgrades the component, and populates the new configuration files. Then it repeats the process for the next component, and so on.

The backups of your configuration files are in a sub-folder of the data storage path: <your data storage path>/Installer/Backup.

• In GUI installations, Tosca Server uses the data storage path in Set common application data path.

• In unattended mode, Tosca Server uses the data storage path you defined with the DATADIR parameter when you installed the previous version.

If Tosca Server encounters an issue during the upgrade—or you cancel the upgrade manually—Tosca Server uninstalls all new components. You can then fix whatever prevents the upgrade and start another one by triggering the installation of 2026.1 LTS. Please note that this isn't a rollback. Tosca Server simply removes the new components, but doesn't restore the old.

We offer a simplified Tosca Server, implicit upgrade process that preserves previous configurations. With this process, Tosca Server automatically transfers your configurations and settings to the new version.

The only exceptions are Exploratory Testing and Interactive Testing. Tosca Server does upgrade them automatically with everything else, but you still need to manually back up and update their configuration files.

We strongly recommend that you always try the simplified upgrade and don't uninstall and reinstall Tosca Server. If you uninstall/reinstall, you have to manually back up your configuration files and then populate the new version's configuration files.

Preparatory steps for Exploratory Testing Server and Interactive Testing

If you use Exploratory Testing and/or Interactive Testing, perform these steps before the upgrade:

1. Back up the configuration files listed in "Tosca Server configuration files". Keep these things in mind:

   • You only need to back up the files that are listed for Exploratory Testing and Interactive Testing.

   • You only need to back up the files for the features you use. For example, if you only use Interactive Testing, you only need to back up the Interactive Testing configuration files.

2. If you use Exploratory Testing, perform these additional actions:

   • Finish ongoing sessions and import the results into Tosca Commander. Tosca Server doesn't persist the files and data of ongoing sessions during the upgrade. Importing ensures that you have access to them independently of Tosca Server.

   • Remove the existing server.db file located at C:\ProgramData\TRICENTIS\Exploratory Testing. This file isn't compatible with the latest version of Tosca Server and might prevent it from starting up.

Upgrade process

Since Tosca Server supports implicit upgrades, you don't need to uninstall the old version first. Instead, just install the new version:

1. Make sure you meet the installation requirements in "Before you start".

2. Trigger the upgrade:

   • For attended installation, run the executable file.

   • For unattended installation, run the command "Tricentis Tosca Server 2026.1 LTS.exe" /s /qn.

   Depending on your system environment, you may need to run as an administrator.

3. If you use Exploratory Testing and/or Interactive Testing, re-populate the settings. Use your backups as references.

   Only use your backup files as a reference.

   • Don't replace any new version files with your backup files.

   • Don't paste the entire content from your backup files without checking for differences between settings in the new and the old version.

4. Open Tricentis Service Configuration and verify your settings. Then, select Save in any tab. This is an important step to finalize your upgrade.

Troubleshooting

Tosca Server upgrades component by component: it backs up the configuration files of the first component, upgrades the component, and populates the new configuration files. Then it repeats the process for the next component, and so on.

The backups of your configuration files are in a sub-folder of the data storage path: <your data storage path>/Installer/Backup.

• In GUI installations, Tosca Server uses the data storage path in Set common application data path.

• In unattended mode, Tosca Server uses the data storage path you defined with the DATADIR parameter when you installed the previous version.

If Tosca Server encounters an issue during the upgrade—or you cancel the upgrade manually—Tosca Server uninstalls all new components. You can then fix whatever prevents the upgrade and start another one by triggering the installation of 2026.1 LTS. Please note that this isn't a rollback. Tosca Server simply removes the new components, but doesn't restore the old.