Troubleshooting non-WCF Line of Business Adapters
“Failed to retrieve” error
When using a non-WCF Line of Business (LOB) adapter, the following errors may occur:
Failed to retrieve system
Browsing agent: Error trapped in constructor. Target machine Actively refused connection.
Runtime agent: Error trapped in constructor. Target machine Actively refused connection.
Cause
The LOB adapters use .Net Remoting. If the .Net Remoting activation takes longer than expected, the adapter may return these errors.
Resolution
Create the StartAgentSleep registry key and increase the timeout value:
Open the registry and go to HKEY_LOCAL_MACHINE\software\Microsoft\BizTalkAdapters.
Create a new DWORD value with the following properties:
Name: StartAgentSleep
Base: Decimal
Value data: 1000
Value data is measured in milliseconds (ms). 1000ms equals 1 second.
In some systems, one second may not be enough. Increase the value and test to help determine the appropriate timeout needed.
Important
Adding the StartAgentSleep registry key impacts all the non-WCF LOB adapters.