Skip to content

Test node setup on Linux

Use this guide when a Linux PC (for example a Mini-PC) will be used as a QuadTEO Test Node. The installation uses the same Agent Installer command as on a Mac.

Requirements

  • A 64-bit Intel/AMD PC (x86_64). ARM computers are not supported.
  • A Debian or Ubuntu based Linux: the installer uses apt-get to add the Python venv package when it is missing.
  • A user with sudo rights (the installer asks for the password).
  • Internet access, and free disk space for the agent runtime (the download alone is about 600 MB).
  • A USB hub with its own power supply (6 or 8 ports) when phones or modems will be attached; up to 24 devices per Test Node (see Test Node hardware).

A Linux Test Node runs Android phones and MCM modems. MCM modems work only on Linux Test Nodes.

1. Create the Test Node and get the command

  1. In the TEO Web UI, open Test Nodes and click + (Admin users only). Enter a name and save.
  2. Select the new Test Node, open the ⋮ menu and click Agent Installer.
  3. Copy the command. It works once and expires after 30 minutes; Regenerate gives a new one.

2. Run the installer

Log in to the Linux PC as the user that will run the agent, go to the home directory (cd ~) and run the command:

curl -fsSL https://<customer-domain>.quadified.com/api/custom/node-setup/<installer-token> | bash

The installer runs eight steps:

  1. Downloads the agent runtime and updater packages.
  2. Asks for your sudo password.
  3. Checks the prerequisites and installs the Python venv package with apt-get when needed.
  4. Installs the runtime environment.
  5. Installs the TEO agent and writes the node's own credential.
  6. Installs the AWS SSM agent, which lets Quadified support reach the node.
  7. Installs and starts the agent as the systemd service tmsagent.service.
  8. Installs the CloudWatch agent (log and metric shipping).

The agent is installed in a QuadATFAgent folder in the directory you ran the command from. Re-running the installer works as on a Mac, and the same warning applies to the -c option; see Running the installer again.

Warning

Run a node's command only on the PC that belongs to that Test Node. The command gives the node a new credential, so running it on another machine disconnects the original one.

3. Manage the agent service

The service starts at boot and restarts the agent if it stops.

systemctl status tmsagent          # is the agent running?
sudo systemctl restart tmsagent    # restart it
journalctl -u tmsagent -f          # follow the service output

The agent also writes its log files (quadatflog-*.log) in the QuadATFAgent folder. Do not start the agent a second time by hand: only one agent can run on a machine.

4. Verify the Test Node

Open the dashboard: the Test Node should appear as online on the map, and its status icon on the Test Nodes page should show ✓. Then connect the phones and modems; see Phone preparation and MCM modem setup.