Create configuration parameters on the server

A configuration is a collection of configuration parameters that define which Tosca Distribution Agents should execute which TestEvents.

To change or add parameters on the Tosca Distribution Server, modify the ConfigurationParameters.xml file, located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer\bin. The system creates the file once the Tosca Distribution Server is started for the first time.

For more information on custom configurations and how to proceed once you have changed or added parameters on the server, see chapter "Customize execution behavior".

Change existing parameters

By default, the following parameters are available: OperatingSystem, Memory, OperatingSystemType, IPAddress and HostName.

If an existing parameter value does not apply to your Tosca Distribution Agents, you can change it. For instance, if your agents have 2 GB, 4 GB, 8 GB, 16 GB and 100 GB of memory, change the default value from 32 GB to 64 GB.

To do so, follow the steps below:

  1. Access the ConfigurationParameters.xml file.

  2. Enter a new Value for the respective parameter.

<TestConfigurationParameter>
	<Name>Memory</Name>
	<Comment></Comment>
	<TestConfigurationParameterValues>
		<TestConfigurationParameterValue>
			<Key>1</Key>
			<Value>2 GB</Value>
		</TestConfigurationParameterValue>
		<TestConfigurationParameterValue>
			<Key>2</Key>
			<Value>4 GB</Value>
		</TestConfigurationParameterValue>
		<TestConfigurationParameterValue>
			<Key>3</Key>
			<Value>8 GB</Value>
		</TestConfigurationParameterValue>
		<TestConfigurationParameterValue>
			<Key>4</Key>
			<Value>16 GB</Value>
		</TestConfigurationParameterValue>
		<TestConfigurationParameterValue>
			<Key>5</Key>
			<Value>64 GB</Value>
		</TestConfigurationParameterValue>
	</TestConfigurationParameterValues>
</TestConfigurationParameter>

Add a new parameter

If you want to define entirely new criteria by which to assign TestEvents, add custom parameters. To do so, follow the steps below:

  1. Access the ConfigurationParameters.xml file.

  2. Add the new parameter. Generally, it is easiest to copy and paste an existing parameter and then adapt it to your needs.

    The example below shows a parameter used to create a configuration exclusively for agents with Firefox installed: 

<TestConfigurationParameter>
	<Name>FirefoxInstalled</Name>
	<Comment></Comment>
	<TestConfigurationParameterValues>
		<TestConfigurationParameterValue>
			<Key>1</Key>
			<Value>Yes</Value>
		</TestConfigurationParameterValue>
		<TestConfigurationParameterValue>
			<Key>2</Key>
			<Value>No</Value>
		</TestConfigurationParameterValue>
	</TestConfigurationParameterValues>
</TestConfigurationParameter>