Install Tosca Server in unattended mode

You can install the Tosca Server in one of the following ways:

This chapter explains how to install the Tosca Server in unattended mode. For information on how to upgrade the Tosca Server, see the upgrade manual.

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

Prerequisites

Before you start the installation, ensure that you meet all requirements listed in chapter Install Tosca Server.

Perform unattended installation

To perform an unattended installation, follow the steps below:

  1. Unzip the installation package.

  2. Go to the destination folder and enter the following command at the command line:

    "Tricentis Tosca Server 13.4.exe" /s <MSI commands> /clone_wait /V" /qn".

    • /s specifies silent mode. Elements that require user interaction are not displayed.

    • Replace <MSI commands> with one or more of the commands in the list below.

    • /clone_wait prevents the setup process from ending before the installation is finished.

    • /V" specifies that all parameters entered between quotation marks after this parameter are directly passed on to the Windows Installer Service MSIEXEC.

    • /qn " specifies that Windows Installer dialogs are not displayed during the installation.

MSI commands

The table below contains a list of MSI commands. 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.

For the MSI commands in the list below, please note the following:

  • If a path contains spaces, you have to enclose it with quotation marks: "<Path>". For instance: "C:\Temp\My directory\".

  • All MSI commands except ADDLOCAL are parameters used to configure the features. If you want to use the default configurations for these features, you do not have to specify them.

MSI command

Description

ADDLOCAL

Specifies which features you want to install.

Enter ADDLOCAL=<feature name> and replace <feature name> with one of the feature names listed below.

You can enter multiple features, separated by comma: ADDLOCAL=<feature1 name>,<feature2 name>.

If you want to install all features, use ADDLOCAL=ALL or don't enter the ADDLOCAL command at all.

B_DIAGNOSTICS

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.

DIAGNOSTICS

Enables or disables Tosca Diagnostics.

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

The default parameter is DIAGNOSTICS=1

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 Tosca Server.

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

LANDINGPAGE_PORT

Specifies the port of the Tosca Server website for a HTTP binding.

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 Tosca Server features.

The default value is 0. In order to specify HTTPS endpoints in the Web.config files of the Tricentis Tosca Server features, 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.

Feature names

Feature name

Description

_LandingPage

Installs the Tricentis Tosca Server website.

If you do not install all features, this parameter is mandatory (see example 2 below).

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

Examples

Example 1

The following command installs all Tosca Server features with their default configurations.

"Tricentis Tosca Server 13.4.exe" /s /clone_wait /V" /qn"

Example 2

The following command installs the features Tosca Distribution Server and Tosca Administration Console with default configurations:

"Tricentis Tosca Server 13.4.exe" /i /s /clone_wait /V"ADDLOCAL=_LandingPage,_4DEXServer,_10AdministrationConsole /qn".

Example 3

The following command installs the feature Tosca REST API Service with a custom directory to store the workspaces:

"Tricentis Tosca Server 13.4.exe" /i /s /clone_wait /V" ADDLOCAL=_LandingPage,_2RESTApi RESTAPI_WSPATH=C:\TOSCARESTAPI_Workspaces /qn".

Example 4

The following command installs all Tosca Server features:

  • Data and log files are saved to C:\ProgramData\TRICENTIS\Tosca Server\Data_Logs.

  • The activation key for the Exploratory Testing Server is 1234-1234-1234-1234.

  • The port of the Tosca Server website is port 90.

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

Uninstall in unattended mode

You can also uninstall Tosca Server without user interaction.

To uninstall in unattended mode, enter the following command at the command line: "Tricentis Tosca Server 13.4.exe" /s /x /V"/qn".

  • /s specifies silent mode.

  • /x triggers the deinstallation.

  • /V" specifies that all parameters entered between quotation marks after this parameter are directly passed on to the Windows Installer Service MSIEXEC.

  • /qn" specifies that Windows Installer dialogs are not displayed during the installation.

What's next

Depending on which Tosca Server features you selected during the installation, you may need to configure their services. For information on how to do so, Configure services via Tricentis Service Configuration.

Please note that you cannot start Service Configuration automatically after the installation in unattended mode.