Hybrid Deployment Agent Error: ldp.orchestrator.fivetran.com Is Not Reachable

Issue

The Hybrid Deployment Agent fails to install due to a curl timeout during connectivity checks, with the following error:

ldp.orchestrator.fivetran.com is not reachable.

The installation script runs curl --max-time 5 to check connectivity but times out before completing.

Environment

• Deployment model: Hybrid Deployment
• All container platforms

Resolution

To troubleshoot this issue, take the following steps:

1. Run the installer with the -s flag to skip validation checks:

   ./hdagent.sh -s start
   

   Skipping validation may bypass important checks, including disk space and time synchronization.
2. Run the following command to check DNS lookup latency and network timing:

   curl -w "dns:%{time_namelookup} tcp:%{time_connect} tls:%{time_appconnect} total:%{time_total}\n" -o /dev/null -s https://ldp.orchestrator.fivetran.com
   

   If DNS latency is high, work with your network team to improve latency.
3. If you re-run install.sh, be aware that it stops the existing container, may replace configuration files such as config.json, and starts a new container. The connection restarts, but no data is lost because configurations are managed in the Fivetran control plane.

For more information, see the set up guide for the relevant container platform:

• Docker Setup Guide
• Podman Setup Guide
• Kubernetes Setup Guide

Cause

This issue occurs when network latency exceeds the hard-coded 5-second timeout in the installation script, causing the curl-based connectivity check to fail.