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 hvr_config and hvr_tmp folders aren't created as expected.

Environment

All database connectors
Connection method: Proxy Agent
Operating system: Linux

Resolution

To resolve this issue, do the following:

Replace placeholder values, such as <your_user>, with the relevant values for your environment.

Optional: Recreate HVR_HOME. If you need to recreate your HVR_HOME directory:
i. Back up the existing HVR_HOME directory, if it exists: mv "$HVR_HOME" "$HVR_HOME.bk"
ii. Extract the .tar.gz file to HVR_HOME from the directory where the file is located, using elevated privileges:
```
mkdir -p "HVR_HOME"
sudo tar -xvf fivetran-proxy-agent-linux-x86_64.tar.gz -C "$HVR_HOME"
```
iii. Ensure the process completes without errors.
If you no longer have the .tar.gz file, you can download it from HVR download location. Use the version in $HVR_HOME/hvr.ver to select the same file you used originally, unless you intend to upgrade.
If the hvr_config and hvr_tmp folders aren't created automatically, create them by running:
```
mkdir -p "$HVR_CONFIG"
```
```
mkdir -p "$HVR_TMP"
```
Ensure the authenticating user can access and write to the folders. To adjust ownership and permissions, run:
```
sudo chown -R <your_user>:<your_group> "$HVR_CONFIG" "$HVR_TMP"
```
Ensure the configuration files or fivetran_proxy.service file used by the Proxy Agent point to the correct paths.
Restart the Proxy Agent to clear any potential error state caused by the previously missing directories.
Review the Proxy Agent logs for error messages that could explain why the folders were not created.

For more information, see our Install Proxy Agent documentation.

Cause

This issue occurs when the extraction process or the environment's configuration prevents the automatic creation of the hvr_config and hvr_tmp folders. This may happen for any of the following reasons:

The .tar.gz file extraction process didn't create the folders.
Insufficient permissions for the user running the extraction.
Paths referenced in the fivetran_proxy.service file don’t point to the correct location.