Skip to content

Mac Test Node Setup and Agent Installation

Follow this procedure when a new Mac or Mac mini will be used as a QuadTEO Test Node.

Note

Replace <customer-domain> with the customer environment domain, for example app-integration.

1. Configure Sleep Settings

If the Mac does not already have these settings applied, configure them first. This prevents the machine from going to sleep while the agent is running.

Disable sleep while plugged in:

sudo pmset -c sleep 0

Disable sleep while on battery:

sudo pmset -b sleep 0

Disable sleep for both power modes:

sudo pmset -a sleep 0

These settings keep the Mac awake so the agent can continue running without interruption.

2. Create a Test Node

Go to:

https://<customer-domain>.quadified.com/dashboard
  1. Open Test Nodes.
  2. Click the + button (Admin users only).
  3. Enter a name for the Test Node.
  4. Assign the required project if needed.
  5. Click Save.

The Test Node form with Name, ID and Projects

3. Open the Agent Installer

After the Test Node is created:

  1. Select the newly created Test Node.
  2. In the top-right corner of the Test Nodes page, click the three-dot menu.
  3. Click Agent Installer.

The Agent Installation modal shows a command that must be executed on the Mac mini terminal.

4. Run the Agent Installer Command

Open a terminal on the Mac, go to your home directory (cd ~), then copy the command from the Agent Installation modal and run it.

The command has the following format:

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

The command works once and expires 30 minutes after it was created (the modal shows the time left, for example Expires in 30:00). If the command expires, or you need to run the installer again, click Regenerate and run the newly generated command.

Warning

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

What the installer does

The installer shows its progress in nine steps:

  1. Downloads the agent runtime and updater packages.
  2. Asks for your sudo password.
  3. Checks the prerequisites.
  4. Installs the runtime environment (including the tools for Android phones and iPhones).
  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 the agent as a system service and starts it.
  8. Installs the CloudWatch agent (log and metric shipping).
  9. Enables automatic power-on for the Mac.

The agent is installed in a QuadATFAgent folder in the directory you ran the command from. To install it somewhere else, add -d <folder> to the command, for example curl -fsSL <installer-url> | bash -s -- -d /opt/QuadATFAgent. When the installation completes, the message "ATF Test Node installation complete." shows the folder.

Running the installer again

  • If QuadATFAgent already exists, the installer asks whether to rename it (default, kept as a backup), remove it, or stop.
  • If a previous run failed, it shows the step that failed and asks whether to start a fresh installation. The state is kept in a .atf-install-state file in the directory you ran the command from.
  • If only the CloudWatch step failed, run the whole installer again with a new command from Agent Installer.

Do not use -c on a connected Test Node

The installer's -c option repeats only the CloudWatch step. Every installer command gives the node a new credential when it runs, but -c does not install that credential, so the agent that is already running loses its connection. Run the whole installer again instead.

5. Check the Agent Service

The agent now runs as a service: it starts automatically when the Mac boots and restarts by itself if it stops. You do not need to start it or keep a terminal open. See Agent service.

6. Verify Agent Status on the UI

Go to:

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

On the dashboard map, the Test Node should appear as online.

Next, connect the phones and prepare them; see Phone preparation.