Skip to content

Quick start: set up a Test Node and its phones

This page takes you from a new computer to a first test that runs on a connected phone. Each step links to the page with the details.

What you need

  • A computer for the Test Node:
    • a Mac or Mac mini (Apple silicon or Intel, at least 8 GB RAM), for Android phones and iPhones; or
    • a Linux PC such as a Mini-PC (64-bit Intel/AMD, Debian or Ubuntu based), for Android phones and MCM modems.
  • Administrator rights on that computer (the installer asks for the sudo password) and internet access.
  • An Admin user in the TEO Web UI, to create the Test Node.
  • Phones of a supported model and OS version, each with an active SIM card.
  • A USB hub with its own power supply (6 or 8 ports) and data-capable USB cables. Up to 24 devices can be connected to one Test Node.

1. Create the Test Node

In the TEO Web UI, open Test Nodes, click +, enter a name (5 to 50 characters) and click Save. See Create a new Test Node.

2. Install the agent

Select the new Test Node, open the ⋮ menu and click Agent Installer. Copy the command and run it in a terminal on the computer. The command works once and expires after 30 minutes; Regenerate gives a new one.

The installer sets the agent up as a service that starts with the computer, so you do not need to keep a terminal open.

3. Check that the Test Node is online

On the dashboard map the Test Node appears as online, and on the Test Nodes page its status icon shows ✓. See Agent service.

4. Prepare each phone

  1. Before you connect, open the page for your brand (Samsung · Xiaomi · Pixel) and do the Before Prepare items of its checklist: Developer options, USB debugging, Stay awake and the ADB authorization timeout.
  2. Connect the phone to the Test Node by USB. When Allow USB debugging appears, select Always allow from this computer and tap OK.
  3. Wait for the Mobile ID: the phone appears on the Mobile ID's page as NewDevice_<number> (Automatic Device Discovery).
  4. Complete the Mobile ID: edit it and enter a descriptive name and the real MSISDN, National Format, IMSI and IMEI. IMSI and IMEI start with random placeholder values, and tests fail until they are replaced. See Edit a Mobile ID.
  5. Run Prepare: ⋮ menu → Prepare → Prepare Device. You receive an email with the result of each step. See Phone Preparation.
  6. After Prepare, do the After Prepare items of the brand checklist, and any step the email lists as failed.

iPhones are supported on Mac Test Nodes. Prepare is not available for iPhones.

  1. Connect the iPhone to the Mac by USB, unlock it and tap Trust in the Trust This Computer? alert.
  2. Turn on Developer Mode and make the settings on the iOS page, following its checklist.
  3. Wait for the Mobile ID on the Mobile ID's page (Automatic Device Discovery).
  4. Complete the Mobile ID: edit it and enter a descriptive name and the real MSISDN, National Format, IMSI and IMEI. See Edit a Mobile ID.

MCM modems (Quectel EG25-G) work on Linux Test Nodes only and are not discovered automatically.

  1. Insert an active SIM card and connect the modem to the Linux Test Node by USB.
  2. Create its Mobile ID by hand on the Mobile ID's page, as described in MCM modem setup.

The brand checklists are also available as a printable PDF.

5. Check the setup

  1. See the phone: on the Mobile ID's page, open the phone in Remote Mobile Access; its screen is shown. An MCM opens in MCM Remote Access instead.
  2. Run a first test: create a test case with one Is Attached step for the phone. Set RAN_TYPE to LTE Auto, because the step editor pre-selects 2G only. Start it with Run (Direct Run) and follow it on the Executions page. The step only reads the network state and changes nothing on the phone.

When the step passes, the Test Node and the phone are ready. You can now build your test cases and test suites.

If something does not work

See Setup troubleshooting.