Server Processes

These Tosca services must be installed, configured, and running on the Tosca Server, for VERA's integration component:

  1. REST API
  2. Distributed Execution (aka DEXServer)
  3. Notification Service (Tosca 15)


Additionally, update the REST API's configuration file with required settings, noted below, and consider updating DEX Server's configuration file to update Agent status more frequently.

REST API configuration files:

      Tosca 14 and earlier - C:\Program File (x86)\TRICENTIS\Tosca Server\RESTApi\web.config

      Tosca 15 - C:\Program File (x86)\TRICENTIS\Tosca Server\RestApiService\TCAPIRestService.dll.config 

                        C:\Program File (x86)\TRICENTIS\Tosca Server\RestApiService\TCAPIRestServiceStandalone.exe.config

DexServer configuration files:

      Tosca 14 and earlier - C:\Program File (x86)\TRICENTIS\Tosca Server\DEXServer\web.config

      Tosca 15 - C:\Program File (x86)\TRICENTIS\Tosca Server\DexServer\Tricentis.DistributionServerService.exe.config 

Service Settings

Backup the REST API's configuration files before making edits. These four REST API settings are required:

SectionGroup:UserSettings
Under path <Configurations><ConfigSections> …
<sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
<section name="Tricentis.TCCore.Base.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
</sectionGroup> 


UserSetting:IndividualCheckInEnabled
Under path <Configurations><userSettings>
<userSettings>
<Tricentis.TCCore.Base.Properties.Settings>
<setting name="IndividualCheckInEnabled" serializeAs="String">
<value>True</value>
</setting>
</Tricentis.TCCore.Base.Properties.Settings>
</userSettings> 


Install and configure the REST API service by following Tosca installation instructions. Review the Tosca documentation for the REST API settings "ExceptionLogPath" and "AttachmentPath" for the location to store the REST API logs and the attachments.

Tosca 15: The location for the Tosca REST API exception logs and attachments must be created in the Tosca server installation directory.  The following REST API exception log and attachments sample location requires creation of a folder “TCAPIRestService”

                    and a subfolder “Attachments” in directory “C:\ProgramData\TRICENTIS\ToscaServer\Logs”.  


RestServiceSettings:LogExceptions & IndividualUpdateEnabled
Under path <Configurations>/<applicationSettings>/<TCAPIRestService.Properties.Settings>
<setting name="ExceptionLogPath" serializeAs="String">
<value>C:\ProgramData\TRICENTIS\ToscaServer\Logs\TCAPIRestService</value>
</setting>
<setting name="LogExceptions" serializeAs="String">
<value>True</value>
</setting>
…
<setting name="AttachmentPath" serializeAs="String">
<value>C:\ProgramData\TRICENTIS\ToscaServer\Logs\TCAPIRestService\Attachments</value>
</setting>
…
<setting name="IndividualUpdateEnabled" serializeAs="String">
<value>True</value>
</setting> 


The following Distributed Execution Server setting configures Tosca Agent machine status to update more quickly in Tosca Commander. The original value is "00:10:00". The new value is "00:00:10". Be sure to back up the original file before making changes.
Under <applicationSettings>

<setting name="AgentSynchronisationInterval" serializeAs="String">
<value>00:00:10</value>
</setting> 


Optionally, install and configure the Tosca Event Monitor service to observe Test Events Execution Status on Agent machines. This is recommended. See the Tosca documentation on the Tosca Event Monitor.

Tosca 14:  Tosca's Distributed Execution Server installs with Tosca Server as an Application Pool running on IIS called "DistributionServer". Make sure it is up and running. Stop and Start this Application Pool/Service in Windows Computer Management, in the IIS Manager section.

                  The Tosca REST API installs with Tosca Commander as an Application Pool running on IIS called "ToscaRestApi".  Stop and start this Application Pool/Service in Windows Computer Management, in the IIS Manager section.

If configuring an Image File Share on a remote machine, other than the Tosca Server, the ToscaRestApi Application Pool's security must be set up as a defined user, not the default "LocalSystem" account, to access a remote UNC.

Tosca 15: Tosca's Distributed Execution Server installs with Tosca Server as a Windows service called "Tricentis.DistributedExecutionService".  Stop and start this service in Task Manager.

                  The Tosca REST API installs with Tosca Commander as a Windows service called "Tricentis.Tosca.RestApiService".  Stop and start this service in Task Manager.

                  The Tosca Notification Service installs with Tosca Server as a Windows service called "Tricentis.Tosca.NotificationService" and is required to be started.  Stop and start the service on the Tosca Server from the landing page ("http:localhost") under Settings.

If configuring an Image File Share on a remote machine other than the Tosca Server, the ToscaRestApi service login information must be modified to that of a defined Service Account, not the default, "LocalSystem".