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:
-
Unzip the contents of the ToscaServer_<version number>.zip file for the installation.
-
Open a command line, and browse to the folder containing ToscaServer_<version number>.zip.
-
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:
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:
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.
"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:
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" |