Common Issues
The connector shows a 'tunneling configuration' timeout or restarts repeatedly.
The connector shows a 'tunneling configuration' timeout or restarts repeatedly.
Symptom: The Connector container logs show If the TLS handshake completes and you receive any HTTP response (for example, a 404), host egress is healthy and the issue is container-level, not your corporate firewall.Step 2: Check IP forwardingIf the host can reach If this returns The Connector reconnects on its next retry. No rebuild or image re-pull is needed, and the local image and configuration are unaffected.
ConnectTimeoutException: connection timed out cloud.cdata.com:443 and the container restarts in a loop. The Connector never reaches Success status in Connect AI.Step 1: Test host egress (independent of Docker)Run the following on the host:cloud.cdata.com but the container cannot, verify IP forwarding on the host:0, the host cannot route the containerβs outbound traffic to the internet. Docker requires IP forwarding to be enabled. Enable it:Issues keeping the Connector connected across reboots, patches, and hardening.
Issues keeping the Connector connected across reboots, patches, and hardening.
net.ipv4.ip_forward is commonly reset to 0 by OS reboots, patch cycles, and security-hardening baselines. Apply the level of persistence your environment requires.Survives a reboot: Add a persistent sysctl setting:- Permit
net.ipv4.ip_forward=1on hosts running the Connector, on the basis that Docker requires IP forwarding for container connectivity. - If forwarding must remain globally disabled, apply a scoped forward/masquerade rule allowing only the Docker bridge subnet outbound to
cloud.cdata.comon port 443.
net.ipv4.ip_forward = 0 with a load order after 99-ip-forward.conf is the line the exception must override.The Connector connects then disconnects repeatedly / SSL handshake failure.
The Connector connects then disconnects repeatedly / SSL handshake failure.
Symptom: The Connector container logs show repeated entries like:The Connector might show Success in Connect AI intermittently, but connections fail with
HTTP [40005] Invalid HTTP response ... Action impossible while not connected.Cause: SSL/TLS inspection on your egress firewall or proxy is intercepting and terminating the Connectorβs outbound WebSocket connection to Azure Service Bus. The Connector expects to complete a TLS handshake directly with Microsoftβs Azure infrastructure; when an inspection appliance presents its own certificate instead, the handshake fails.Fix: Request a TLS inspection bypass from your network/security team for the following hostnames:*.servicebus.windows.netβAzure Service Bus (Connector relay tunnel)*.azurecr.ioβAzure Container Registry (Connector image pull)*.cdata.comβCData cloud infrastructure