Files and directories

This chapter provides an overview of the most important Tricentis Tosca files and directories. All paths refer to a standard installation on the C: drive with the default paths suggested by Tricentis.

To work with Tricentis Tosca, every Windows user needs unlimited write access to the directories %TRICENTIS_PROJECTS% and %TRICENTIS_ALLUSERS_APPDATA%. The Tosca_Projects folder must be placed on a directory that is persistent on the machine.

Environment variables

During installation, Tricentis Tosca creates environment variables by default. The path may vary depending on the operating system you use.

You can modify all default environment variables.

Enter SET into the command line to view the paths to the environment variables listed in the table below.

Environment variables

Environment variable

Examples for Windows 7 (64-bit)

%TRICENTIS_HOME%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\Classic

%COMMANDER_HOME%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\ToscaCommander

%TRICENTIS_DEX_AGENT_HOME%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution\

%TBOX_HOME%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox\

%TRICENTIS_LICENSING_HOME%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\Licensing

%TRICENTIS_PROJECTS%

C:\Tosca_Projects\

%TRICENTIS_SEARCH%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\dll;C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\dll\GuptaEngine;...

%TRICENTIS_ALLUSERS_APPDATA%

C:\ProgramData\TRICENTIS\Tosca Testsuite\7.0.0

Tricentis Tosca saves specific information, such as user settings or temporary files under the following path: %APPDATA%\TRICENTIS. If necessary, an administrator can modify this path.

%TRICENTIS_HOME%

This is the default directory for Classic Engines. It contains files, such as

  • .dll files, applications and configuration files for Tricentis Tosca.

The most important sub-directories are described below in greater detail. The specified paths can be copied to the Windows dialog Start->Run to identify the respective paths.

%TRICENTIS_HOME%\dll

This is the main directory for all classic Tosca Engines.

%TRICENTIS_HOME%\dll\Dat

This directory contains the following configuration files for Tosca Engines:

ObjectMappings.dat

WinClassMappings.dat

WizardMappings.dat

Comments can be added to the .dat files, provided that they are specified between quotation marks.

%TRICENTIS_HOME%\dll\Help

This directory contains the Tosca Engine Object model description.

%TRICENTIS_HOME%\dll\Settings\XML

Directory for all default settings.

%TRICENTIS_HOME%\ocr

This directory contains files required for Optical Character Recognition (OCR) in Tosca TBox and Classic Engines.

%COMMANDER_HOME%

This is the default directory for Tosca Commander. It contains all files required for Tosca Commander.

The most important subdirectories are described below in greater detail. The specified paths can be copied to the Windows dialog Start->Run to identify the respective paths.

%COMMANDER_HOME%\MiniSat

This directory contains files required for verifying the validity and consistency of TestCase-Design relations.

%COMMANDER_HOME%\Reporting

This directory contains files required for the Tosca Commander Reporting function.

%COMMANDER_HOME%\smus

This directory contains files required for verifying the validity and consistency of TestCase-Design relations.

%COMMANDER_HOME%\SQL

This directory contains SQL scripts for Azure SQL Server, DB2, MS SQL Server and Oracle in order to create databases for Tosca Commander.

The migration of common repositories is described in detail in the respective upgrade manual.

%COMMANDER_HOME%\ToscaCI

This directory contains files required for Tosca Continuous Integration.

%COMMANDER_HOME%\x64

This directory contains files required for general access to Tricentis Tosca workspaces and for Solution Documentation synchronization in 64-bit systems.

%COMMANDER_HOME%\x86

This directory contains files required for general access to Tricentis Tosca workspaces and for Solution Documentation synchronization in 32-bit systems.

%TRICENTIS_DEX_AGENT_HOME%

This is the default directory for the Tosca Distribution Agent.

The most important subdirectories are described below in greater detail. The specified paths can be copied to the Windows dialog Start->Run to identify the respective paths.

%TRICENTIS_DEX_AGENT_HOME%\Settings

Directory for all default settings.

%TBOX_HOME%

This is the default directory for Tosca TBox. It contains all files required for Tosca TBox.

The most important subdirectories are described below in greater detail. The specified paths can be copied to the Windows dialog Start->Run to identify the respective paths.

%TBOX_HOME%\DistributedExecution

This directory includes the Agent folder.

%TBOX_HOME%\java

This directory contains files required for Tosca TBox Java components.

%TBOX_HOME%\nunit

This directory contains files required by Tosca TBox which are used to start Selenium scripts.

%TBOX_HOME%\opencv

This directory contains files required for image-based test automation.

%TBOX_HOME%\Resources

This directory contains Tosca TBox browser extensions and tools required for mobile automation.

%TRICENTIS_LICENSING_HOME%

This is the default directory for license administration.

The most important subdirectories are described below in greater detail. The specified paths can be copied to the Windows dialog Start->Run to identify the respective paths.

%TRICENTIS_LICENSING_HOME%\Settings

Directory for all default settings.

%TRICENTIS_PROJECTS%

This is the default directory where all project-related data is stored.

This directory contains temporary files, sample files and configuration files. The subdirectories will be described below.

The specified paths can be copied to the Windows dialog Start-> Run in order to identify the respective paths.

%TRICENTIS_PROJECTS%\Tosca_CommonRepositories

This is the default directory for Tosca Commander common repositories with data management in the file system. Please make sure that all users have access to this directory in multiuser environments.

%TRICENTIS_PROJECTS%\Tosca_Workspaces

This is the default directory for Tosca Commander workspaces with data management in the file system. Log files are saved to the workspace folder of your project.

This directory contains the following pre-defined workspaces: First Steps and Advanced Examples.

%TRICENTIS_PROJECTS%\ToscaCommander

This is the default project directory for Tosca Commander projects. It contains settings and templates for all Tosca Commander projects that refer to it, e.g. keywords, ObjectMaps, reports, templates, examples, etc.

%TRICENTIS_ALLUSERS_APPDATA%

This directory contains all user-specific files. This is the case when users add, for instance, definitions or modify settings (see chapter " Hierarchy of the Settings Files"). This directory is not removed when you uninstall Tosca Commander.

You can find a description for all %TRICENTIS_ALLUSERS_APPDATA% subdirectories below. You can copy the specified paths to the Windows dialog Start->Run to identify the respective paths.

You can install the %TRICENTIS_ALLUSERS_APPDATA% directory on a network drive. To do so, use the Windows Installer property NETDRIVE.

In this case, the Tricentis Tosca setup skips the access permission configuration for the chosen directory, so you need to set the necessary access permissions before you prompt the installation. Possible access permissions are Group EVERYONE, Full Access, or recursive inheritance.

In this example, the command below grants recursive inheritance.

icacls "<%TRICENTIS_ALLUSERS_APPDATA%>" /t /grant *S-1-1-0:(OI)(CI)F

By default, the NETDRIVE value is 0. In this case, the Tricentis Tosca installer sets permissions for user EveryOne on %TRICENTIS_ALLUSERS_APPDATA%.

If you want to use NETDRIVE, set the NETDRIVE value to 1. In this case, you have to set permissions for %TRICENTIS_ALLUSERS_APPDATA% yourself.

However, you need to ensure that Tricentis Tosca users have FullControl permissions for %TRICENTIS_ALLUSERS_APPDATA% during Tricentis Tosca runtime.

In this example, the command below starts an unattended installation with the following conditions:

  • It installs %TRICENTIS_ALLUSERS_APPDATA% in the directory \\example.domain.com\files\johndoe\toscasettings

  • Tricentis Tosca doesn't set permissions for %TRICENTIS_ALLUSERS_APPDATA%

"Tricentis Tosca<versionnumber>.exe" /s NETDRIVE=1 TRICENTIS_ALLUSERS_APPDATA=\\example.domain.com\files\johndoe\toscasettings /qn

In this example, the command below starts an attended installation and enables NETDRIVE.

"Tricentis Tosca<versionnumber>.exe" NETDRIVE=1

%TRICENTIS_ALLUSERS_APPDATA%\License

This directory contains the License.xml file including its current settings for the License Administration.

%TRICENTIS_ALLUSERS_APPDATA%\ManagedFilesArea

This is the default directory for managing file references externally (see chapter "Create file reference with central storage location").

%TRICENTIS_ALLUSERS_APPDATA%\Settings\Dat

This is the directory for user-specific configuration files for Tosca Engines.

ObjectMappings.dat

WinClassMappings.dat

WizardMappings.dat

%TRICENTIS_ALLUSERS_APPDATA%\Settings\XML

This is the directory for user-specific settings files.

Settings.xml

UserDefinition.xml