Configure services via Tricentis Service Configuration

This chapter covers the configuration process for services that you perform via Tricentis Service Configuration. Tricentis Service Configuration enables you to configure the following services:

Only the services you have selected during the server installation appear in the Tricentis Server Configuration dialog.

Start Tricentis Service Configuration

Tricentis Service Configuration starts automatically after the Tricentis Tosca Server installation. To configure the services, you need admin access rights. You can enable admin mode as soon as Tricentis Service Configuration starts.

To enable admin mode, click Yes when the User Account Control (UAC) window pops up.

Start Tricentis Service Configuration manually

You can start Tricentis Service Configuration manually the following ways:

  • From the Windows Start menu

  • Double-click the file Tricentis.ServiceConfiguration.exe, which you can find at C:\Program Files (x86)\TRICENTIS\Tosca Server\Service Configuration

Configure services with Tricentis Service Configuration

To configure services that you selected during the Tricentis Tosca Server Installation, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the tab of the service that you want to configure.

  2. Populate the configuration property fields. For information on which properties you have to configure for which service, see the following sections:

  3. Repeat the steps above for all services that you want to configure. Tricentis Service Configuration marks all updated service tabs with an asterisk.

You cannot save if you have entered an invalid property value for any service. In this case, Tricentis Service Configuration displays an orange exclamation mark on the service tab with the invalid property value.

  1. Click Save to save your changes. Tricentis Service Configuration restarts all services.

The default value for the secret key ClientSecret of each service is <to be generated>. After starting the Tricentis Service Configuration, the ClientSecret is automatically generated. It is associated with your ClientId. You can access it through the appsettings.json file. By default, this file is located at each services’ directory at C:\Program Files (x86)\TRICENTIS\Tosca Server\.

Each service uses the same ClientSecret in each appsettings.json file of all services. Tricentis recommends that you do not change the generated ClientSecret.

Configure Tricentis Service Discovery

The Tricentis Service Discovery stores information about where the endpoints for the different services are located.

To configure Tricentis Service Discovery, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the Service Discovery tab.

  2. Populate the following fields:

Property

Description

Port

Enter the port used to address Tricentis Service Discovery.

Certificate Thumbprint

Enter the thumbprint for the SSL certificate. For detailed information on security requirements, see chapter "Security requirements".

Certificate Location

Select the location of the SSL certificate.

Certificate Store

Select the store in which the SSL certificate is located.

  1. Click Save to save your changes. Tricentis Service Configuration restarts all Tricentis Services.

Configure Service Discovery

Configure Tricentis Project Service

The Tricentis Project Service stores information about projects such as database connection string and project name in a central location.

To configure the Tricentis Project Service, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the Project Service tab.

  2. Populate the following fields:

Property

Description

Port

Enter the port used to address Tricentis Project Service.

Certificate Thumbprint

Enter the thumbprint for the SSL certificate. For detailed information on security requirements, see chapter "Security requirements".

Certificate Location

Select the location of the SSL certificate.

Certificate Store

Select the store in which the SSL certificate is located.

  1. Click Save to save your changes. Tricentis Service Configuration restarts all Tricentis Services.

Configure Project Service

Configure Tricentis Authentication Service

To use the server-based Tricentis User Administration, you must configure Tricentis Authentication Service and Mail Configuration.

To do so, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the Authentication Service tab.

  2. Populate the following fields:

Property

Description

Port

Enter the port used to address Tricentis Authentication Service. The default port is 5000.

Hostname

Enter the name of the host to which the service is connected. The default host name is localhost.

If you specify a token signing certificate, the host name is automatically updated to the common name (CN). The common name is specified in the certificate's subject name property, located in the certificate store on your computer. If necessary, you can still change the host name. To do so, click into the Hostname property field and enter the name of the host.

Certificate Thumbprint (Https service)

Enter the thumbprint for the SSL certificate. For detailed information on security requirements, see chapter "Security requirements".

Certificate Location (Https Service

Select the location of the SSL certificate.

Certificate Store (Https Service

Select the store in which the SSL certificate is located.

Certificate Thumbprint (Token Signatures)

Enter the thumbprint for the token signing certificate. For more information, see chapter "Token Sign Certificate".

Certificate Location (Token Signatures)

Select the location of the certificate.

Certificate Store

Select the store in which the certificate is located.

User Storage Database

The default SQLite database path is %PROGRAMDATA%\TRICENTIS\IdentityManagement\UserStore.db.

To use a different database, enter another SQLite database path, or use the drop-down menu to select an MSSQL database and enter the corresponding path.

If you change the database, your data is not migrated automatically. You need to perform the migration manually.

Configuration Database

The default SQLite database path is %PROGRAMDATA%\TRICENTIS\IdentityManagement\ConfigurationStore.db.

To use a different database, enter another SQLite database path, or use the drop-down menu to select an MSSQL database and enter the corresponding path.

If you change the database, your data is not migrated automatically. You need to perform the migration manually.

Operational Database

The default SQLite database path is %PROGRAMDATA%\TRICENTIS\IdentityManagement\OperationalStore.db.

To use a different database, enter another SQLite database path, or use the drop-down menu to select an MSSQL database and enter the corresponding path.

If you change the database, your data is not migrated automatically. You need to perform the migration manually.

Regex for custom password policy

Define a custom password policy for locally created users with a regular expression.

The default value for the regular expression is .{8,}. This means that the password must contain at least 8 characters.

If you want to use your own regular expression, you can change the default value.

Maximum number of failed login attempts before account is locked

Define the number of failed login attempts before an account is locked. The default value is 5.

Account lockout duration in hours

Define the number of hours a locked-out account remains locked out before it is unlocked. The default value is 0.

Number of unique passwords before re-use

Specify the number of unique passwords a user must use before reusing an old password. The default value is 10.

  1. Click Save to save your changes. Tricentis Service Configuration restarts all Tricentis Services.

Configure Authentication Service

Configure Tricentis File Service

Tricentis File Service stores execution logs and common repository attachments as files.

To configure Tricentis File Service, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the File Service tab.

  2. Populate the following fields:

Property

Description

Storage Directory Path

Specify the path to the directory where you want to store the files.

Port

Enter the port used to address Tricentis File Service.

Log Path

Specify the path to the directory where you want to save the log files.

Log Level

Specify the level of logging to write in the log files: Error messages, File modifications, All file service communication.

Certificate Thumbprint

Enter the thumbprint for the SSL certificate. For detailed information on security requirements, see chapter "Security requirements".

Certificate Location

Select the location of the SSL certificate.

Certificate Store

Select the store in which the SSL certificate is located.

Enable Security

Select the Enable Security check box to activate authentication for File Service via Tricentis User Administration. Note that this works only for workspaces that you create with a Tricentis Server Repository.

  1. Click Save to save your changes. Tricentis Service Configuration restarts all Tricentis Services.

Configure Tricentis File Service

Configure Tricentis Automation Object Service

The Automation Object Service (AOS) is a central element of the distribution architecture if you install Distributed Execution with AOS.

To configure the Automation Object Service, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the Automation Object Service tab.

  2. Populate the following fields:

    Property

    Description

    Distribution Server Address

    Specify the address of the Tosca Distribution Server. The default address is http://localhost.

    Workspace Folder

    Specify the folder where the workspace configured for the Automation Object Service is located. The default folder is %TRICENTIS_PROJECTS%Tosca_Workspaces.

    Workspace Name/ID

    Enter the name of the workspace.

    Username

    Enter the username to access the workspace.

    Password

    Enter the password to access the workspace.

    Log Level

    Select the log level.

    Logfile Location

    Specify the location of the logfile.

    Log Requests

    Select whether the log should include requests.

    Log Errors

    Select whether the log should include errors.

    Include Scope

    Select whether the log should include scope.

    Port

    Enter the port used to address Tricentis Automation Object Service. The default port is 5006.

    Certificate Thumbprint

    Enter the thumbprint for the SSL certificate.

    For more information on security requirements, see chapter "Security requirements".

    Certificate Location

    Select the location where the SSL certificate is found on the computer.

    Certificate Store

    Select the store where the SSL certificate is located on the computer.

    Maximum Parallel Workspaces

    Specify the maximum number of workspaces that the Automation Object Service can work with in parallel.

    Distribution Server Call Timeout (ms)

    Specify the timeout of retrieving the test results from the Tosca Distribution Server. The default timeout is 30,000 ms.

    If this timeout expires and there is no response from the Tosca Distribution Server, the Automation Object Service abandons the request and logs an error.

  1. Click Save to save your changes. As soon as you have saved your changes, Tricentis Service Configuration restarts all Tricentis Services.

Configure Automation Object Service

Configure Test Data Service

To configure the Test Data Service, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the Test Data Service tab.

  2. Select Enable Security, to activate authentication for the Test Data Service via Tricentis User Administration.

  3. Select Enable Diagnostics, to send anonymous usage data to Tricentis.

Configure Test Data Service

Configure Mail Configuration

Once you have configured Tricentis Authentication Service, configure the SMTP (Simple Mail Transfer Protocol) server to send emails from the Tricentis User Administration.

To do so, follow the steps below:

  1. In the tab menu of the Tricentis Service Configuration, click the Mail Configuration tab.

  2. In respective fields, enter the following data:

Property

Description

SMTP Mail Server Address

Specify your SMTP mail server address.

Port

Enter the associated SMTP Host Port.

Username

Specify the username of the SMTP server.

Password

Specify the password.

Sender Name

Specify the name of the sender.

Sender Email

Specify the email address to send emails from.

Send test email to

Specify the email address that you want to send a test email to and click Test.

  1. Click Save to save your changes. Tricentis Service Configuration restarts all Tricentis Services.

Configure Mail Configuration