Early access: Define results import workspaces

For Tosca Distributed Execution with Automation Object Service (AOS), you need to set up at least one AOS workspace. To speed up time to execution, you can set up multiple AOS workspaces.

By default, if you have multiple AOS workspaces for one repository, Tosca uses only one of these workspaces to import results. This might not be enough for complex test sets where you run ExecutionLists in parallel. To speed up your time to results, define multiple AOS workspaces to import results in parallel.

Parallel results import is an early access feature and still under development. We can't guarantee full functionality in this or future versions.

Before you start

Before you define a number of results import workspaces, make sure you have these things in place:

You've gone through "AOS workspaces: considerations", and you've decided how many AOS workspaces you need in total.
You've created all these AOS workspaces.

Define the number of results import workspaces

To set up parallel results import, follow these steps:

Open the appsettings.json file for AOS. After a default installation, this file is at C:\Program Files (x86)\TRICENTIS\Tosca Server\AutomationObjectService.
Scroll to the Repositories tag in the AutomationObjectServiceConfig section.
- If you use one repository with Tosca Distributed Execution, the Repositories tag contains one child property, which shows all AOS workspaces connected to this repository.
- If you use multiple repositories, the Repositories tag contains multiple child properties, one for each repository.
The repository child property has the setting NumberOfImportWorkspaces with the default value 1. To change the number of workspaces that should import results, change the default value to the desired number.

If you use multiple repositories, repeat this for all repositories where you want to have parallel results import.
Save and close your file.

Examples

These code examples show how to define parallel results import in different scenarios: with one repository and with multiple repositories connected to Tosca Distributed Execution with AOS.

Code example 1: one repository

This is your scenario:

You have one repository called MyProject.
You've created six AOS workspaces for this repository.
You want to use three of these workspaces to import results.

{
  "AutomationObjectServiceConfig": {
    "DexBaseUrl": "http://localhost:5007",
    "DexCallTimeout": 30000,
    "HeartBeatTimeout": 1000,
    "MaxWorkspaceConnections": 10,
    "SendRequestRetryAttempts": 1,
    "SendRequestRetryInterval": 5000,
    "TaskCallTimeout": 3600000,
    "TcApiWorkspaceFolder": "%TRICENTIS_PROJECTS%\\Tosca_Workspaces",
    "Repositories": {
      "MyProject": {
        "NumberOfImportWorkspaces": 3,
        "CommonRepositoryConnectionString": "Server=test.server.com;Database=TestDatabase;Uid=testuser;Pwd=11111!;",
        "Workspaces": [
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspace_1",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspace_2",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspace_3",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspace_4",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspace_5",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspace_6",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          }
        ]
      }
    }
  },
  .....
}
                                                            

Code example 2: three repositories

This is your scenario:

You have three repositories called MyProject1, MyProject2, and MyProject3.
For MyProject1, you've created six AOS workspaces. You want to use three of these workspaces to import results.
For MyProject2, you've created four AOS workspaces. You want to use two of these workspaces to import results.
For MyProject3, you've created three AOS workspaces. Since this project's tests are small and simple, you've decided that the default number of import workspaces—one—is enough. So you leave the setting as is.

{
  "AutomationObjectServiceConfig": {
    "DexBaseUrl": "http://localhost:5007",
    "DexCallTimeout": 30000,
    "HeartBeatTimeout": 1000,
    "MaxWorkspaceConnections": 10,
    "SendRequestRetryAttempts": 1,
    "SendRequestRetryInterval": 5000,
    "TaskCallTimeout": 3600000,
    "TcApiWorkspaceFolder": "%TRICENTIS_PROJECTS%\\Tosca_Workspaces",
    "Repositories": {
      "MyProject1": {
        "NumberOfImportWorkspaces": 3,
        "CommonRepositoryConnectionString": "Server=test.server1.com;Database=TestDatabase1;Uid=testuser1;Pwd=11111!;",
        "Workspaces": [
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject1_1",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject1_2",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject1_3",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject1_4",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject1_5",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject1_6",
            "WorkspacePassword": "111",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          }
        ]
      },
      "MyProject2": {
        "NumberOfImportWorkspaces": 2,
        "CommonRepositoryConnectionString": "test.server2.com;Database=TestDatabase2;Uid=testuser2;Pwd=22222!;",
        "Workspaces": [
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject2_1",
            "WorkspacePassword": "222",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject2_2",
            "WorkspacePassword": "222",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject2_3",
            "WorkspacePassword": "222",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject2_4",
            "WorkspacePassword": "222",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          }
        ]
      },
      "MyProject3": {
        "NumberOfImportWorkspaces": 1,
        "CommonRepositoryConnectionString": "test.server3.com;Database=TestDatabase3;Uid=testuser3;Pwd=33333!;",
        "Workspaces": [
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject3_1",
            "WorkspacePassword": "333",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject3_2",
            "WorkspacePassword": "333",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          },
          {
            "RepositoryType": "MS SQL Server",
            "WorkspaceName": "MyAOSWorkspaceForProject3_3",
            "WorkspacePassword": "333",
            "WorkspaceUsername": "admin",
            "CredentialsSource": "Local"
          }
        ]
      }
    }
  },
  .....
}
                                                            

What's next

Finish your Tosca Distributed Execution with AOS setup:

With HTTPS.
With HTTP.