Install Tricentis Tosca in unattended mode

You can install Tricentis Tosca in unattended mode. In this case, the setup completes the installation without user interaction.

An unattended installation is necessary in environments that use software for automated and centralized software distribution. These environments need setups that support unattended installation.

To perform an unattended installation, you have to invoke the installer from the command line.

The setup provides command parameters that you can use to select the components for installation and to adapt some settings.

Perform an unattended installation

To perform an unattended installation, use the following general syntax: "Tricentis Tosca<version number>.exe" /s <MSI commands> /qn.

Use installation parameters

You can use the following parameters to control the installer:

MSI parameters

Command

Description

/s

Specifies that the installation or deinstallation is done in silent mode. Elements that require user interaction are not displayed.

/qn

Specifies that Windows Installer dialogs are not displayed during the installation.

Configure the setup

Use MSI installer commands to configure the installation process. Some of these commands allow you to set paths.

If a path contains spaces, you have to specify it with a backslash followed by quotation marks: "<Path>".

You can use the following MSI installer commands:

MSI installation commands

Command

Description

ADDLOCAL

Specifies which optional features to install.

For more information, see "Select features for installation".

DIAGNOSTICS

Enables or disables Tosca Diagnostics.

Use the parameter DIAGNOSTICS=1 to enable Tosca Diagnostics, and DIAGNOSTICS=0 to disable it.

Default: DIAGNOSTICS=1

ENABLE_TOSCA_BI

Enables or disables Tosca BI.

Use the parameter ENABLE_TOSCA_BI=1 to enable Tosca BI, and ENABLE_TOSCA_BI=0 to disable it.

Default: ENABLE_TOSCA_BI=0

To use Tosca BI, you need Tosca BI licenses.

EXAMPLE_WORKSPACES

Installs example workspaces with tutorials which helps you to get familiar with workspaces.

Use the parameter EXAMPLE_WORKSPACES=1 to enable the installation of the example workspaces, and EXAMPLE_WORKSPACES=0 to disable it.

Default: EXAMPLE_WORKSPACES=1

INSTALLDIR

Specifies the installation path of Tricentis Tosca.
Default: C:\Program Files\TRICENTIS\Tosca Testsuite (32bit) or Windows: C:\Program Files (x86)\TRICENTIS\Tosca Testsuite (64bit)

MOBILE_TESTING

Installs Appium and AndroidSDK which are necessary for mobile automation.

You must install Tricentis TBox for MOBILE_TESTING to work.

Use the parameter MOBILE_TESTING=1 to enable the installation of the mobile automation components, and MOBILE_TESTING=0 to disable it.

Default: MOBILE_TESTING=1

NETDRIVE

Installs the %TRICENTIS_ALLUSERS_APPDATA% directory on a network drive.

NETDRIVE sets the permissions for the folder %TRICENTIS_ALLUSERS_APPDATA%.

If you don't want to set any permissions on the %TRICENTIS_ALLUSERS_APPDATA% folder, set the NETDRIVE value to 1, i.e. NETDRIVE=1 .

Default: NETDRIVE=0

For more information, see chapter "%TRICENTIS_ALLUSERS_APPDATA%".

OCRDB

Installs an OCR Font Database that the Classic Powerbuilder/Win32 Engine uses.

You must install Tricentis Classic for OCRDB to work.

Use the parameter OCRDB=1 to enable the installation of the OCR Font Database, and OCRDB=0 to disable it.

Default: OCRDB=0

START_SERVICES

Starts TOSCAAutomationService by default when the Windows system service is installed.

If the security settings on your work station prevent services from starting, you can circumvent this by using START_SERVICES=0.

Default: START_SERVICES=1

TOSCA_PROJECTS

Specifies the path where projects are saved.

Default: C:\Tosca_Projects

TRICENTIS_ALLUSERS_APPDATA

Specifies the directory of user defined settings.

Default path: C:\ProgramData\TRICENTIS\Tosca Testsuite\7.0.0

You can find more MSIEXEC commands in the Windows Installer Service documentation or display them by running the MSIEXEC.exe file in the command line.

Required components

Tricentis Tosca includes required components which are installed automatically with all installation types:

  • Tricentis Tosca Product Info which contains information about all components that can be installed with Tricentis Tosca

  • Tosca Commander

  • Tricentis Licensing

If you upgrade from a version earlier than Tricentis Tosca 13.0, Tricentis Classic is also installed automatically.

Select features for installation

Use the ADDLOCAL command to specify which optional features you want to install. If you don't use the ADDLOCAL command, all features are installed.

To select a feature for installation, provide the internal feature name, as described in the table below, after ADDLOCAL.

To install multiple features, separate the feature names by comma without white space.

Feature names for installation with ADDLOCAL

Internal Feature name

Display feature name

TricentisTBox

Tricentis TBox

TricentisClassic

Tricentis Classic

DexAgent

Distributed Execution Agent

If you don't specify any features after the ADDLOCAL command, none of the optional features are installed.

View logs

Once installation is complete, you can view the installation logs in the %TEMP% folder.

Examples

The following command installs all required and optional features. This setup is similar to the Tosca Commander standard installation via the installer:

"Tricentis Tosca<version number>.exe" /s /qn

The following command installs all required features, the Tosca example workspaces, and the optional features Tricentis TBox and Appium. This setup is similar to the Distributed Execution Agent install via the installer:

"Tricentis Tosca<version number>.exe" /s MOBILE_TESTING=1 EXAMPLE_WORKSPACES=1 ADDLOCAL=TricentisTBox,DexAgent /qn

The following command installs only required features and no optional features, i.e. Tosca Commander with the Tosca example workspaces and Tricentis Licensing:

"Tricentis Tosca<version number>.exe" /s ADDLOCAL /qn

The following command installs all required features and Tricentis Classic with OCRDB as an optional feature:

"Tricentis Tosca<version number>.exe" /s OCRDB=1 ADDLOCAL=TricentisClassic /qn

The following command installs all required and optional features to a defined directory:

"Tricentis Tosca<version number>.exe" /s INSTALLDIR="D:\Tricentis Tosca" /qn

For more examples of installing components, refer to the Tricentis Knowledge Base.

Manage settings

To adjust specific settings for individual work stations after the installation, Tricentis recommends to perform a prototype installation on one computer.

By default, Tricentis Tosca stores settings files at C:\Program Files(x86)\TRICENTIS\Tosca Testsuite\. This directory contains the following sub-directories:

  • Classic\dll\Settings\XML\ for Classic Engines

  • DistributedExecution\Settings for Tosca Distributed Executions

  • Licensing\Settings\ for Licensing

  • TBox\Settings\ for Engines 3.0

For information on related Settings.xml files, see chapter " Hierarchy of the Settings Files".

You can copy the settings files into the corresponding directory on the target computers. This allows you to configure settings which you cannot configure during the installation process. These are managed directly by the central software administration.

Uninstall in unattended mode

Similarly to the unattended installation procedure, you can uninstall Tricentis Tosca without user interaction.

To uninstall in unattended mode, enter the following command at the command line: "Tricentis Tosca<version number>.exe" /uninstall /quiet.

Command

Description

/uninstall

Starts uninstalling Tricentis Tosca.

/quiet

Performs the uninstall process in silent mode.