Tetra LabX Agent Frequently Asked Questions

Why does a LabX server error display when I try to connect the Tetra LabX Agent?


Server Error

To troubleshoot the error:

  1. Log in to the LabX app server and run the installation checker app (same folder as the actual LabX app).
  2. From the installation checker app, click Run to initiate a system check (this may take a few minutes).
  3. When the check completes, search for the SystemIntegrationService and review the following:
    • Does the endpoint URL match the one entered in LabX Agent?
    • Is the port open on the server?

Error Review

After installing the Tetra LabX Agent, why doesn't it start when I double-click and instead indicates that "Tetrascience.Agent.LabX.WinApp has stopped working"?

The v1.0.0 Tetra LabX Agent does not include the Admin role requirement in its manifest file. You may need to manually launch the application "as administrator".
Please always run the app 'as administrator' until the next version is released to avoid permission issues

What is the LabX endpoint address that the Tetra LabX Agent communicates with?

The Tetra LabX Agent uses this LabX endpoint address:
http://<address of server>:51155/LabX/BasicSystemIntegrationService

Which tasks are selected by the Tetra LabX Agent?

The task selection is based on two criteria:

  • Task Creation Date is later than the Task Creation Date which you specify on the Management Console.
  • Task State. The Tetra LabX Agent excludes all tasks which are still processing. The Task State selection includes these states:
    • Completed
    • Aborted

How to export the method parameters?

The parameters of a method can be selected or implemented depending on the application (LabX Operational Manual, Page 190, Section ). A user might change the value of a method parameter during the experiment. The changed value can be exported to the result file if the "include results in exports" checkbox is checked. (see the screenshot below)


How to fix the folder security right error?

After a user clicks on the "Start" button, the service start can be failed with this error message "User XXX has no access to this folder: YYYY". It can be fixed by changing the windows folder security settings.

  1. Open that folder in the Windows Explorer, right click on the folder and select the "Properties"

Folder Properties

  1. Select the "Security" Tab and click on "Advanced"

Security Advanced

  1. Select "Add", then "Select a principal", input user name, click on the "Check Name", click on "OK", then select "Modify" and "Write" access right.

Add user