Optional server configurations

You can configure the Tosca Distribution Server for the following, optional tasks:

Specify the synchronization interval between the Tosca Distribution Server and Tosca Distribution Agents.
Whitelist specific domains so that the Tosca Distribution Server only accepts agents from these domains.
Change the path of the server log file.

To do so, modify the Web.config file, located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer.

Whenever you modify the Web.config file, you have to restart the Tricentis Tosca Server via the IIS Manager.

Do not modify the Web.config file while tests are running. If you do, all currently running and queued tests will be lost, and you will have to start them again after the Tricentis Tosca Server restarts.

Change the synchronization interval

The synchronization interval determines how often a Tosca Distribution Agent should ask the Tosca Distribution Server for ExecutionLists to run. If the synchronization interval is lower, agents spend less time in Idle mode, but there is more network traffic.

By default, the server and the agent synchronize once per minute.

To change the synchronization interval, follow the steps below:

Navigate to the applicationSettings section.
Set a different value for AgentSynchronisationInterval.

Example: a synchronization interval of 1 minute, 30 seconds:

<applicationSettings>
	<DistributionServer.Properties.Settings>
		...
		<setting name="AgentSynchronisationInterval" serializeAs="String">
			<value>00:01:30</value>
		</setting>
	</DistributionServer.Properties.Settings>
</applicationSettings>

Whitelist specific domains

If you whitelist domains, the Tosca Distribution Server will only accept Tosca Distribution Agents or Tosca CIClients from these specified domains. You can whitelist the following agents and clients:

Tosca Distribution Agents
Tosca CIClients from Windows operating systems
Tosca CIClients from operating systems other than Windows

Once an agent or client contacts the server, the server checks whether the domain of the user who started the agent or client matches the domain(s) on the list.

To whitelist domains, follow the steps below:

Navigate to the applicationSettings section.
Set the value for UseAgentLdapAuthorization to True. By default, it is set to False.
Enter your user domains as a value for AgentLdapValidDomains.
- You can enter multiple domains, separated by semicolons.
- You can also use wildcards with your domains, for instance tricentis.* or tri*.com.
If you set the value for UseAgentLdapAuthorization to True, but do not enter any domains, users will receive an error when trying to execute their TestCases.

Example: two whitelisted domains

<applicationSettings>
	<DistributionServer.Properties.Settings>
		...
		<setting name="UseAgentLdapAuthorization" serializeAs="String">
			<value>True</value>
		</setting>
		<setting name="AgentLdapValidDomains" serializeAs="String">
			<value>tricentis.com;google.*</value>
		</setting>
	</DistributionServer.Properties.Settings>
</applicationSettings>

Change the path of the server log file

The file ToscaDistributionServer.log logs all activities of the Tosca Distribution Server, such as when an agent registers with the server or when TestEvents are distributed. By default, the system saves the file to the log file directory C:\ProgramData\TRICENTIS\ToscaServer\DistributionServer\logs.

If you have write access to the log file directory, you can specify an alternate path. To do so, follow the steps below:

Navigate to the log4net section.
Set a different value for LogFileAppender.

Example: custom path to the log file

<log4net>
	[...]
	<appender name="LogFileAppender" type="log4net.Appender.RollingFileAppender">
		<param name="File" value="C:\ProgramData\CustomPath"></param>
		<param name="AppendToFile" value="true"></param>
		<rollingStyle value="Size"></rollingStyle>
		<maxSizeRollBackups value="10"></maxSizeRollBackups>
		<maximumFileSize value="10MB"></maximumFileSize>
		<staticLogFileName value="true"></staticLogFileName>
		<layout type="log4net.Layout.PatternLayout">
			<param name="ConversionPattern" value="%date [%thread] %-5level %logger - %message%newline"></param>
		</layout>
	</appender>
</log4net>