Install Tricentis Tosca Server via command line

You can perform an unattended installation of Tricentis Tosca Server, i.e. an installation without any user interaction.

You can install either all or specific Tricentis Tosca Server features via the command line.

Tosca Commander and the Tricentis Tosca Server must have the same version to enable communication. Install Tricentis Tosca first.

On systems running IIS 7.5, you have to install the Application Initialization Module for IIS 7.5.

Download the appwarmup_x64.msi file from https://www.iis.net/downloads/microsoft/application-initialization and run the installation as administrator. The operating system restarts during the installation.

To install Tricentis Tosca Server via command line, follow the steps below:

  1. Unzip the contents of the ToscaServer_<version number>.zip file for the installation.

  2. Open a command line, and browse to the folder containing ToscaServer_<version number>.zip.

  3. Enter the following command:

    ToscaServer<versionnumber>.exe /s /clone_wait /V"<MSI commands>/qn"

    You can use the parameters described below to configure your unattended installation.

    For information on how to install all Tricentis Tosca Server features via command line, see chapter "Install all features " below.

    For information on how to install specific Tricentis Tosca Server features via command line, see chapter "Install specific features" below.

Parameters to configure the installation

You can use the following parameters to configure the installation of Tricentis Tosca Server:

Parameter

Description

/s

The installation is done in silent mode. Elements that require user interaction are not displayed.

/clone_wait

This command prevents the setup process from ending before the installation is finished.

/V

All parameters entered between quotation marks after this parameter are directly passed on to the Windows Installer Service MSIEXEC.

ADDLOCAL

Specifies which features you want to install.

Use the following syntax to install one feature: ADDLOCAL=<feature name>

Use the following syntax to install multiple features: ADDLOCAL=<feature1 name>,<feature2 name>

Use the following syntax to install all features: ADDLOCAL=ALL

/qn

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

You can find further MSIEXEC parameters in the Windows Installer Service documentation or by running the MSIEXEC.exe file in the command line.

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

Parameters to define which features to install

Define the features you want to install as values of the MSIEXEC parameter ADDLOCAL.

You can use the following values:

Parameters - feature names

Value

Description

_LandingPage

Installs the Tricentis Tosca Server website.

This parameter is mandatory.

_2RESTApi

Installs the Tosca REST API Service (see the Tricentis Tosca Support Portal).

_4DEXServer

Installs the Tosca Distribution Server.

_5TestEventMonitor

Installs the Tosca Distributed Execution Monitor.

_6XTA_Server

Installs the Exploratory Testing Server.

_8LicenseAdministration

Installs Tosca License Administration.

_9TestDataService

Installs the Tosca Test Data Service.

_10AdministrationConsole

Installs the Tosca Administration Console.

_11InteractiveTesting

Installs the Interactive Testing Server.

_12FileService

Installs the Tricentis File Service.

Parameters to configure features

To configure the features you want to install, use the following configuration parameters:

Parameters - feature configurations

Parameter

Description

B_DIAGNOSTICS

This enables or disables Tosca Diagnostics.

Use the B_DIAGNOSTICS=true parameter to enable Tosca Diagnostics, and B_DIAGNOSTICS=false to disable it.

The default value is true.

DATADIR

Specifies where to save data and log files of the features to be installed.

The default path of the data directory is C:\ProgramData\TRICENTIS\ToscaServer.

EVENTMONITOR_DISTSERVER

Specify the endpoint address to the Tosca Distribution Server if you want to install Tosca Distributed Execution Monitor, .

The default address is http://localhost:80/DistributionServerService/MonitorService.svc.

INSTALLDIR

Specifies the installation directory for Tricentis Tosca Server.

The default directory is C:\Program Files (x86)\TRICENTIS/ToscaServer.

LANDINGPAGE_PORT

Specifies the port of the Tricentis Tosca Server website for a HTTP binding in the IIS Manager.

The default port is 80.

RESTAPI_WSPATH

Specifies the path to the directory where all workspaces are stored for the Tosca REST API Service.

The default path is %TRICENTIS_PROJECTS%\Tosca_Workspaces.

USE_HTTPS

Specifies whether to use an HTTPS binding for the Tricentis Tosca Server features.

The default value is 0. In order to specify HTTPS endpoints in the Web.config files of the features Tosca Distribution Server and Tosca Distributed Execution Monitor, use the parameter USE_HTTPS=1.

XTA_KEY

Specifies the activation key in the Web.config file of the Exploratory Testing Server.

You can find your activation key in your License Agreement.

Install all features

If you want to install and configure all Tricentis Tosca Server features, enter the following command into the command line:

Syntax:

ToscaServer<version number>.exe /s /clone_wait /V"<configuration parameter>=<value> /qn"

  • replace <configuration parameter> with the required parameter as described above

  • replace <value> with the required value

The following example installs all Tricentis Tosca Server features.

  • The installation file ToscaServer<version number>.exe is located in the directory C:\Tosca Server.

  • The parameter DATADIR specifies that data and log files are saved to C:\ProgramData\TRICENTIS\ToscaServer\Logs.

  • The parameter XTA_KEY specifies the activation key 1234-1234-1234-1234 for the Exploratory Testing Server.

"C:\Tosca Server\ToscaServer<version number>.exe" /i /s /clone_wait /V"ADDLOCAL=ALL DATADIR=\"C:\ProgramData\TRICENTIS\Tosca Server\Logs\" XTA_KEY=1234-1234-1234-1234 LANDINGPAGE_PORT=81 /qn"

Install specific features

If you don't want to install all features, use the MSIEXEC parameter ADDLOCAL to specify which features to install (see chapter "Parameters to define which features to install ").

You can also configure these features via command line (see chapter "Parameters to configure features").

This example performs the following tasks:

  • It installs the feature Tosca REST API Service

C:\ToscaServer.exe /i /s /clone_wait /V"ADDLOCAL=_LandingPage,_2RESTApi LANDINGPAGE_PORT=9010 RESTAPI_WSPATH=C:\TOSCARESTAPI_Workspaces /qn"

Uninstall Tricentis Tosca Server

You can also uninstall Tricentis Tosca Server without user interaction.

To perform an unattended uninstallation, enter the following command:

Syntax:

ToscaServer<version number>.exe /s /x /V"/qn"

The command line uses the following parameter:

Parameter

Description

/s

The uninstallation is done in silent mode. Elements that require user interaction are not displayed.

/V

All parameters entered between quotation marks after this parameter are directly passed on to the Windows Installer Service msiexec.

/x

Specifies that an uninstallation is performed.

/qn

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

In this example, the file ToscaServer<version number>.exe is located in the directory C:\Tosca Server. To uninstall, use the following command line:

"C:\Tosca Server\ToscaServer<version number>.exe" /s /x /V"/qn"