Image File Share

Some Tosca Test Case Script statements, such as "TBox Take Screenshot", require a Directory specification for Tosca to store the image file. In a multiuser, distributed Tosca environment, this directory must be a file share that all Tosca machines can reach. When setup correctly, an image captured during a run that executes on one machine, can be seen in a report generated by another machine.

Create a common file share that all machines can reach and that all script developers know to use.

For example, set the 'Directory' parameter in the 'TBox Take Screenshot' step to "\\ToscaImageServer\images".

IMPORTANT: Application security must be set correctly to access UNC paths to remote machines

If the File Share is set to be hosted by a remote machine (not on the Tosca Server machine), the user identity under which the Tosca Rest Api service runs must be set to a Windows Service Account that has access to the remote UNC path. If the user does not have proper security permissions, the integration will not be able to access images on the File Share and reports will contain blank boxes where images should occur.  Logon to Tosca Commander on the Tosca Server with the service account to establish the license permissions.

Tosca 14 and earlier:

To change the account that runs the ToscaRestApi Application Pool, perform the following steps:

  • On the Tosca Server, open Computer Management Snap-in. (Usually, right-click the start icon and select Computer Management).
  • Expand 'Services and Applications'
  • Select 'Internet Information Services'
  • In the "Connections" pane, expand the current server and select 'Application Pools'
  • In the "Application Pools" pane, right-click 'ToscaRestApi'
  • In the "Connections" pane, expand the current server and select 'Application Pools', and select 'Advanced Settings…'
  • In the Advanced Settings dialog, in the 'Process Model' section, select 'Identity', and click the ellipsis on the right.
  • Click the "Custom account:" radio button, then the "Set…" button.
  • Add credentials for a Windows account that will have access to the File Share
  • Click OK to get back to the Application Pool window.

Restart the ToscaRestApi application pool.

Tosca 15+

Define a logon Service Account for the "Tricentis.Tosca.RestApiService" service and restart. 

  • On the Tosca Server, open Services.  
  • Locate Tricentis.Tosca.RestApiService in the list of services.
  • Select this service and right-click to bring up the context menu.  Select Properties.
  • In the tab: Log-On, select the radio button for This account, which allows the user to specify an account.
  • Provide service account credentials, browsing if needed, then click OK.
  • Stop and restart service.
  • Ensure Service Account is listed under Log On As column in services.