Using DNS Resolution Instead of the IP Reported by the Host Agent

Description

Beginning with Parallels RAS 21.1, the default behavior is to use the IP address reported by the Host Agent when connecting to a host. This change helps prevent connection issues that occur when a host’s IP address cannot be resolved by the Connection Broker.

If your environment requires explicit DNS resolution instead of using the IP provided by the Host Agent, you can modify the UseRASAgentIP registry value on all Connection Broker servers in the farm.

Registry Path

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Parallels\2XController

How to Enable DNS Resolution

Follow the steps below to adjust the registry value:

1. Open Registry Editor (regedit.exe).
2. Navigate to:
   HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Parallels\2XController
3. Locate the UseRASAgentIP DWORD value.
4. Change the value:
   • 1 (default): Use IP reported by the Host Agent
   • 0: Use DNS resolution
5. Close Registry Editor.

Result

Setting UseRASAgentIP to 0 forces the Connection Broker to resolve host IP addresses via DNS instead of relying on the Host Agent’s reported IP.