Install Tosca Server in unattended mode

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

• Via setup dialog as described in chapter "Install Tosca Server via setup dialog".

• In unattended mode. In this case, the setup completes the installation without user interaction.

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.

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 one of the following commands at the command line.

   • For an installation with SSL certificate (HTTPS), enter:

     "Tricentis Tosca Server 16.0.0.exe" /s THUMBPRINT="<your certificate thumbprint>" LANDINGPAGE_PORT=443 HOSTNAME="<your host name>" STORENAME="<your certificate store name>" <optional arguments> /qn

   • For an installation without SSL certificate (HTTP), enter:

     "Tricentis Tosca Server 16.0.0.exe" /s USE_HTTPS=0 LANDINGPAGE_PORT=80 <optional arguments> /qn

The parameters from the command lines above specify the following actions:

• /s specifies silent mode. Elements that require user interaction aren't displayed.

• USE_HTTPS is enabled by default. To use HTTP instead of HTTPS, enter the following parameter: USE_HTTPS=0.

• THUMBPRINT is mandatory for HTTPS. The installation will fail without a valid certificate thumbprint. It must meet the following requirements:

  • The SSL certificate is valid.

  • The subject alternative name contains at least one valid DNS name.

    Note: you can't use wildcards. The certificate must contain the real DNS name.

  • The extended key usage extension includes the Server Authentication OID 1.3.6.1.5.5.7.3.1. This ensures that the certificate implements Transport Layer Security (TLS) on the internet as described in RFC-5280.

  • The certificate has a private key.

  • The key is exportable. You must enable Mark as exportable in the Windows certificate import dialog when you import the certificate. If you haven't done so, you must renew the certificate.

  • The certificate is only stored in a single certificate store location of the local machine certificate store. That's the certificate store which is local to the machine and global to all its users.

• LANDINGPAGE_PORT is mandatory and specifies the port of the Tosca Server Gateway through which all Tosca Server services are accessed. The commonly used port is 443 for HTTPS and 80 for HTTP.

• STORENAME is mandatory for HTTPS and specifies the X.509 certificate store name.

• HOSTNAME is mandatory for HTTPS and specifies the DNS name that the certificate contains as subject alternative name.

• Replace <optional arguments> with one or more optional parameters from the list below.

• /qn disables Windows Installer dialogs during the installation.

Optional parameters

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.

The table below contains a list of optional parameters. Please note the following:

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

• If you want to use the default configurations for a feature, you don't have to specify them.

Optional parameters	Description
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. The default path is C:\ProgramData\TRICENTIS\ToscaServer.
FILESERVICE_ROOTDIR	Specifies the path to the directory where Tricentis File Service stores files. The default path is C:\ProgramData\TRICENTIS\ToscaServer\FileService\Files.
INSTALLDIR	Specifies the installation directory for Tosca Server. The default directory is C:\Program Files (x86)\TRICENTIS\ToscaServer.

Examples

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: "Tosca Server 16.0.0.exe" /uninstall /quiet"

The parameters from the command line above specify the following actions:

• /uninstall starts uninstalling Tosca Server.

• /quiet performs the uninstall process in silent mode.

What's next

Otherwise, you can jump straight to the Tricentis Service Configuration, where you configure the Tosca Server services that you want to use.

Please note that Tricentis Service Configuration doesn't start automatically after the installation in unattended mode.