Tricentis Tosca installation overview

This chapter gives an overview of the Tricentis Tosca installation.

To ensure full functionality, make sure that you have installed the latest Windows updates of the category Critical (Windows 7, 8) or Quality (Windows 10). For further information on software versions and hardware requirements, refer to the System Requirements.

To install Tricentis Tosca, you need local administrator rights. To use Tricentis Tosca, you need write permission for the directory %TRICENTIS_PROJECTS%.

Default paths of Tricentis Tosca


Default path



The installation file Tosca TestSuite.<version number>.exe contains all components of Tricentis Tosca. To access the installation file, refer to the Tricentis Support Portal.

For step-by-step instructions of the installation process, see chapter "Perform the installation".

You can modify or uninstall an installed Tricentis Tosca when you start the installation file Tosca TestSuite.<version number>.exe of the same version.

Tosca Commander AddIns

Tricentis Tosca installs the following AddIns automatically during default installation:

  • Tosca TestCase-Design

  • Tosca Reporting

  • Tosca Requirements Management

In Tosca Commander, you can view objects of AddIns that require a separate license but you cannot edit them. For detailed information on Tricentis Tosca AddIns, refer to the corresponding documentation.

Tosca Commander API

Tricentis Tosca contains a programming interface that allows you to open workspaces and retrieve data from Tosca Commander, both manipulated and newly created. The documentation is a .chm file that you can find in the directory %COMMANDER_HOME%\TCAPI.chm .

Additionally, you can extend the functionality, such as additional menu entries, drag and drop operations, etc. The documentation is in the same directory, in the TCAddOns.chm file.

To use the Tosca Commander API, you have to request its separate license. Contact your Tricentis Tosca sales agent for further information.

Tosca Commander versions 32-bit and 64-bit - differences

Tosca Commander runs in 32 or 64-bit mode, depending on whether you have a 64-bit or 32-bit operating system.

The directory %COMMANDER_HOME% includes the following processor-independent executable files:

  • TOSCACommander.exe

  • TCShell.exe

  • DbRepositorySchemaMigrator.exe

You need executable program files with the extension *X86.exe if you run the application in 32-bit mode on a 64-bit system.

For a more detailed list of supported operating systems, refer to the System Requirements.

64-bit support for DB2 repositories

Tosca Commander in 32-bit supports DB2 repositories by default. For 64-bit installations, you need to add an entry to the corresponding configuration file.

  • ToscaCommander.exe.config

  • TCShell.exe.config

  • TOSCARemoteCommander.exe.config

You must insert the following entry between the following tags: <runtime> and </runtime>, after the existing assemblyBinding nodes.

<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">


<assemblyIdentity name="IBM.Data.DB2" publicKeyToken="7c307b91aa13d208" culture="" />

<bindingRedirect oldVersion="" newVersion="" />



Create one configuration file for each of the following programs:

  • TDMObjectEditor.exe

  • DbRepositorySchemaMigrator.exe

  • TCAPI programs, e.g. TDMObjectEditor.exe.config

File content:

<?xml version="1.0"?>



<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">


<assemblyIdentity name="IBM.Data.DB2" publicKeyToken="7c307b91aa13d208" culture="" />

<bindingRedirect oldVersion="" newVersion="" />

<codeBase version="" href="C:\Program Files (x86)\IBM\DB2DSDriver\bin\netf20\IBM.Data.DB2.dll"/>





Restrictions in the 64-bit mode

The 64-bit compatibility applies exclusively to  Tosca Commander and the standard AddIns (Tosca Requirements, Tosca TestCase-Design, Tosca Reporting, and Tosca Structured Objects).

Restrictions concerning the Reporting AddIn

You cannot read out or modify reports that have been created with Crystal Reports.