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\Settings
%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_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.

%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%\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 upgrade manual.

%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.

%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%\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 are 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 multi-user 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"/s NETDRIVE=1 /qn

%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 references").

%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