Host agent configuration reference

The host agent reads its configuration from /etc/edb/acp-host-agent/acp-host-agent.conf. Set variables using KEY=value syntax, one per line. Lines beginning with # are comments. See Installing the host agent for setup instructions.

# =============================================================================
# WEM Connection (REQUIRED)
# =============================================================================
# host:port of WEM's relay to its internal job-execution engine. This address
# is WEM's listen port plus 1 (for example, WEM on 8080 -> wem-host:8081).
WEM_CONNECT_ADDRESS=localhost:8081

# Task queue(s) this agent polls for activities (REQUIRED).
# Comma-separate multiple queues. Supported queue names:
#   coordinator-tasks  - WHPG coordinator-node operations
#   standby-tasks      - WHPG standby-node operations
#   dr-standby-tasks   - WHPG DR-standby operations
WEM_TASK_QUEUES=

# =============================================================================
# Agent Identity (optional)
# =============================================================================
# Stable per-host identifier sent as this agent's worker identity.
# Leave unset to auto-derive from the DMI product UUID or NIC MAC address.
# AGENT_ID=

# Directory where the agent's enrollment keypair is stored. Must be writable
# by the acp-host-agent OS user.
# AGENT_STATE_DIR=/var/lib/edb/acp-host-agent

# =============================================================================
# WEM Database (optional)
# =============================================================================
# WHPG database the agent's psql invocations connect to for WEM data.
# WEM_DATABASE=wem

# =============================================================================
# WarehousePG Hub (optional - WHPG coordinator hosts only)
# =============================================================================
# WarehousePG data directory (for example, /data/whpg/gpseg-1). If unset,
# the agent derives it by querying the local cluster itself
# (psql -U gpadmin -d postgres -c "SHOW data_directory;"). Set this variable
# explicitly only if that derivation is unreliable in your environment.
# WHPG_DATA_DIR=

# =============================================================================
# Logging
# =============================================================================
# Log level: error|warn|info|debug|trace, or per-target directives.
AGENT_LOG_LEVEL=info

WEM connection

Variable	Required	Default	Description
`WEM_CONNECT_ADDRESS`	Yes	`localhost:8081`	Host:port of WEM's relay to its internal job-execution engine. Set this parameter to WEM's listen port plus 1. The shipped default assumes the host agent runs on the same host as WEM. If it doesn't, set this parameter to WEM's hostname or IP address, for example `WEM_CONNECT_ADDRESS=wem-host:8081`.
`WEM_TASK_QUEUES`	Yes	—	Task queue or queues this agent polls for activities. Comma-separate multiple queues. Valid values are `coordinator-tasks` for WHPG coordinator-node operations, `standby-tasks` for WHPG standby-node operations, and `dr-standby-tasks` for WHPG DR-standby operations. Ships empty. You must set this variable before starting the service.

WEM database

Variable	Required	Default	Description
`WEM_DATABASE`	No	`wem`	WHPG database the agent's `psql` invocations connect to for WEM data, such as log-scan results. Set this to the same value as `WHPG_DATABASE`. The agent's passwordless `sudo` permissions are scoped to that exact database name, so changing this parameter causes privileged operations to fail with `sudo: a password is required`. WEM creates this database automatically if it doesn't already exist.

WarehousePG Hub

Variable	Required	Default	Description
`WHPG_DATA_DIR`	No	Derived from the local cluster	WarehousePG data directory, for example `/data/whpg/gpseg-1`. WEM derives this value by running `psql -U gpadmin -d postgres -c "SHOW data_directory;"` against the local cluster. Set this parameter explicitly only if that derivation is unreliable in your environment.

Agent identity

By default, the host agent derives its unique identifier from the host's DMI product UUID or NIC MAC address. Set AGENT_ID only if the default derivation produces inconsistent results across restarts.

Variable	Default	Description
`AGENT_ID`	Derived from DMI product UUID or NIC MAC address	Stable per-host identifier sent as this agent's worker identity. Override only if the default derivation produces inconsistent results.
`AGENT_STATE_DIR`	`/var/lib/edb/acp-host-agent`	Directory where the agent's enrollment keypair is stored. Must be writable by the `acp-host-agent` OS user.

Logging

Control the verbosity of host agent logs. Use debug or trace for troubleshooting, and error or warn in production to reduce noise.

Variable	Default	Description
`AGENT_LOG_LEVEL`	`info`	Log level filter. Valid values: `error`, `warn`, `info`, `debug`, `trace`.