Proxy Agent Setup Tests Fail and Required Folders Are Missing
Issue
While setting up a connection using the Proxy Agent connection method, setup tests fail, and the config and logs folders in the Proxy Agent installation directory (PROXY_HOME) are missing.
Environment
- All database connectors
- Connection method: Proxy Agent
- Operating system: Linux
Resolution
To resolve this issue, do the following:
The commands below use the fivetran user from our setup guide. If a different user owns your PROXY_HOME directory, replace fivetran with that user and group.
Optional: Reinstall the Proxy Agent files. If the
jredirectory or theproxyagent.jarfile is also missing fromPROXY_HOME:i. Back up the existing
PROXY_HOMEdirectory, if it exists:mv "$PROXY_HOME" "$PROXY_HOME.bk"ii. Download the Proxy Agent ZIP file for Linux and extract it to
PROXY_HOMEby following the Install Proxy Agent on Linux instructions.iii. Ensure the process completes without errors.
To keep the same version, check
$PROXY_HOME.bk/proxyagent.verand download that version, unless you intend to upgrade.If the
configandlogsfolders are missing, create them by running:mkdir -p "$PROXY_HOME/config" "$PROXY_HOME/logs"If you backed up
PROXY_HOMEin step 1, copy yourproxyagent.conffile back into$PROXY_HOME/config.Set the ownership of the folders to the user that owns
PROXY_HOME(thefivetranuser in our setup guide), so that they match the rest of the installation. The Proxy Agent service runs asroot, so it can access the folders regardless of their owner. Run:sudo chown -R fivetran:fivetran "$PROXY_HOME/config" "$PROXY_HOME/logs"Ensure the paths in the
fivetran_proxy.servicefile point to thejre/bin/javaexecutable, theproxyagent.jarfile, and theconfig/proxyagent.conffile inPROXY_HOME.Restart the Proxy Agent to clear any potential error state caused by the previously missing directories.
Review the Proxy Agent logs in
$PROXY_HOME/logs/agent-out.log, or runjournalctl -u fivetran_proxy.service, for error messages that could explain why the folders were missing.
If your Proxy Agent was installed with the High-Volume Agent installer (in the hvr_home and hvr_config directories), migrate it to the binary distribution.
For more information, see our Proxy Agent Binary Distribution Setup Guide.
Cause
This issue occurs when the config and logs folders weren't created during installation, or the Proxy Agent can't access them. This may happen for any of the following reasons:
- The folders weren't created before the Proxy Agent was started.
- Insufficient permissions for the user that runs the Proxy Agent service.
- Paths referenced in the
fivetran_proxy.servicefile don’t point to the correct location.