Configure Server

The Tosca Exploratory Testing Server is part of Tosca Server (see chapter "Install Tosca Server via setup dialog").

Configure the Exploratory Testing Server

After the installation, you must configure the Exploratory Testing Server port. To do so, follow the steps below:

1. Open the appsettings.json file located at C:\Program Files (x86)\TRICENTIS\Tosca Server\Exploratory Testing Server.

2. In the HttpServer section, change the default port 5013 to your port.

3. Save and close the file.

4. Open the ocelot.json file located at C:\Program Files (x86)\TRICENTIS\Tosca Server\Gateway.

5. In the "ServiceId": "ExploratoryTestingService" section, change the default port 5013 to your port. You have to make this change in the following two places:

   • Under "DownstreamPathTemplate": "/{everything}"

   • Under "DownstreamPathTemplate": "/xta-assets/{everything}"

"ServiceId": "ExploratoryTestingService"
    },
    {
      "DelegatingHandlers": [
        "ServiceIdentifierApplierDelegationHandler"
      ],
      "DownstreamPathTemplate": "/{everything}",
      "DownstreamScheme": "http",
      "DownstreamHostAndPorts": [
        {
          "Host": "localhost",
          "Port": 5013
        }
      ],
      "UpstreamPathTemplate": "/explore/{everything}",
      "UpstreamHttpMethod": [
        "POST",
        "PUT",
        "GET",
        "DELETE",
        "HEAD"
      ],
      "ServiceId": "ExploratoryTestingService"
    },
    {
      "DownstreamPathTemplate": "/xta-assets/{everything}",
      "DownstreamScheme": "http",
      "DownstreamHostAndPorts": [
        {
          "Host": "localhost",
          "Port": 5013
        }

6. Save and close the file.

7. Open the ExploratoryTesting.json file located at C:\Program Files (x86)\TRICENTIS\Tosca Server\Gateway\Consul\config.

8. Change the value of port to your port.

9. Save and close the file.

You must restart the service in the Windows Services app every time you change the appsettings.json file.

Define a directory for the data

The Exploratory Testing Server saves all session data to a directory. To configure the path to the required directory, follow the steps below:

1. Open the appsettings.json file located at C:\Program Files (x86)\TRICENTIS\Tosca Server\Exploratory Testing Server.

2. In the App section, enter the path to the directory as the value of DataDirectory.

   Example: "DataDirectory": "C:\ProgramData\TRICENTIS Exploratory Testing".

Enter the activation key

To invite exploratory testers to a session, you must enable the Exploratory Testing Server. This requires a valid activation key that you receive with the corresponding license.

To enter the activation key, follow the steps below:

1. Open the appsettings.json file located at C:\Program Files (x86)\TRICENTIS\Tosca Server\Exploratory Testing Server.

2. In the App section, enter the activation key as the value of ActivationKey.

   Example: "ActivationKey": "XXXX-XXXX-XXXX-XXXX".