Advanced node settings¶
The Agent Installer configures a Test Node completely; most nodes never need these settings. Change them only when Quadified support asks you to, or when your site needs a proxy.
The .env file¶
The agent reads optional settings from a file named .env in the QuadATFAgent folder, next to the TMSAgent program. Each line is NAME=value. Restart the agent after changing it (see Agent service).
| Setting | What it does |
|---|---|
ATF_HTTP_PROXY |
The HTTP(S) proxy the agent uses, for sites where the node can reach the internet only through a proxy. For example ATF_HTTP_PROXY=http://proxy.example.com:3128. |
ATF_IOS_MODE |
iPhone support: auto (default: on when the iPhone tools are present), on (required; the agent does not start without them) or off. |
LOG_LEVEL |
How much the agent logs. Default info; set forcedebug when support asks for debug logs. |
NO_FILE_LOG |
Set to any value to stop writing log files. |
LOG_FMT_JSON |
Set to any value to write log files as JSON lines. |
METRICS_PORT |
Port of the agent's local metrics endpoint (default 29100). |
ATF_CLIENT_RESERVE_TIMEOUT_SEC |
How long, in seconds, a test step waits for a running device health check to finish before it fails (default 30). |
Files not to touch¶
node-identity.json: the node's own credential. Do not delete, copy or edit it. A node without it cannot connect; to replace it, run a new Agent Installer command for the node.- Log files
quadatflog-*.login theQuadATFAgentfolder: send them to support when asked.