Upgrade Tosca Server and its features

This chapter contains information on how to upgrade the Tricentis Tosca Server and its features from version 13.2 to version 13.3.

The Tricentis Tosca Server contains the following features: 

  • Tosca Distributed Execution Monitor

  • Tosca Distribution Server

  • Exploratory Testing Server

  • Tosca REST API Service

  • Tosca Test Data Management

  • Tosca Administration Console

  • Interactive Testing Server

  • Tricentis File Service

  • Tricentis Authentication Service

Since the release of Tricentis Tosca 12.0, the Tricentis License Server is released independently of Tosca Server and Tosca Commander. For information on Tricentis License Server versions and upgrading, see chapter "Upgrade the Tricentis License Server".

Preparatory steps

Before you upgrade the Tosca Server, you need to create backup files for the Tosca Server features that you use.

Once you start the upgrade, the installation removes all user defined settings. You can refer to your backup files to re-configure your settings during the installation.

Tosca Distributed Execution Monitor

If you use Tosca Distributed Execution Monitor, create a backup of the Tosca Distributed Execution Monitor Web.config file.

This file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer.

Tosca Distribution Server

If you use the Tosca Distribution Server, create a backup of the Tosca Distribution Server Web.config file.

This file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer.

Interactive Testing Server

If you use the Interactive Testing Server, create a backup of the Interactive Testing Server Web.config file and the appsettings.json file.

These files are located at C:\Program Files (x86)\TRICENTIS\Tosca Server\InteractiveTestingStandalone.

Exploratory Testing Server

If you use the Exploratory Testing Server, create a backup of the Exploratory Testing Server Web.config file.

This file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\ExploratoryTestingServer.

Tosca REST API Service

If you use the Tosca REST API Service, create a backup of the Tosca REST API Service Web.config file.

This file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\RESTApi.

Tosca Test Data Management

If you use Tosca Test Data Management, create a backup of the Tosca Test Data Management Web.config file.

This file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\TestDataManagement.

Tricentis File Service

If you use the Tricentis File Service, create a backup of the Tricentis File Service Web.config file.

The file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\FileService.

Tricentis Authentication Service

If you use the Authentication Service, create a backup of the Tricentis Authentication Service Web.config file.

The file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\AuthenticationService.

Upgrade the Tosca Server

To upgrade the Tosca Server, follow the steps below:

  1. Uninstall the old version of Tosca Server. This also removes user defined settings.

  2. Start the Tosca Server upgrade by executing the setup file ToscaServer13.3.exe.

  3. Follow the installation process described in chapter "Install Tricentis Tosca Server via InstallShield Wizard".

    You can refer to your backup files to configure your settings during the installation.

On systems using IIS 7.5, the operating system will be restarted during the installation.

If you encounter unexpected behavior in a Tricentis Tosca Server feature after the upgrade, compare the backed up Web.config file of the respective feature with the upgraded version.

Do not replace the version 13.3 Web.config files with your backup files.