Skip to content

Agent service

The Agent Installer installs the TEO agent as a system service. The service starts when the machine boots and restarts the agent automatically if it stops, so you do not need to start the agent by hand or keep a terminal open. Starting a second copy manually does not work: only one agent can run on a machine.

Check the agent

Open the customer dashboard:

https://<customer-domain>.quadified.com/dashboard

The Test Node should appear as online on the map, and its status icon on the Test Nodes page should show ✓ after you click it.

On the machine itself:

  • Mac: pgrep -fl TMSAgent shows the running agent process.
  • Linux Mini-PC: systemctl status tmsagent shows the service state.

The agent writes its log files (quadatflog-*.log) in the QuadATFAgent folder.

If the node is not online

  1. Check that the machine is awake and connected to the internet.
  2. An Admin user can restart the agent from the Web UI: Test Nodes → select the node → ⋮ → Restart Agent.
  3. On a Linux Mini-PC you can also restart the service: sudo systemctl restart tmsagent. On a Mac, restarting the machine restarts the agent.
  4. If the node still does not come online, see Setup troubleshooting or contact support@quadified.com.