Error while importing BizTalk binding files remotely

The post was orignally published here.

The solution to enable the import of binding files for remote execution. Some extra BizTalk software installation is required, when using the WCF adapter.

Today I’ve encountered an issue with remote BizTalk deployment.  Every night we run a TFS build and the result of that build is deployed to our BizTalk Test Server.  Because the build process runs on our TFS Build Server, we actually perform a remote deployment to the BizTalk Test Server.  Until last night, everything worked fine.

The error

This error occurred during the import of one of the binding files:

“Failed to create ‘WCF-Custom’ Transport Component.”

The cause

It was the first time we tried to remotely import a BizTalk binding file that contained the WCF-Custom adapter.

The troubleshooting

I used the Microsoft.BizTalk.Deployment.DeployerComponent to import the bindings.  I created a workaround for the issue, by executing BTSTASK.exe remotely via PSEXEC.exe.  This worked fine, but then I’ve got the same error while starting receive locations and send ports, that were configured with the WCF-Custom adapter.  As I didn’t have a good command line alternative for this functionality, the workaround was useless.

Afterwards, I’ve tried to install some extra BizTalk software on the TFS Build Server. And yes, this was the way to go!

The solution

The Windows Communication Foundation Adapter runtime should also be installed on the local machine (in our case TFS Build Server).  This is not documented somewhere and it’s not the behavior you would expect.  The BizTalk deployment libraries work fine for remote deployment, until you use the WCF adapter…

This is an overview of the BizTalk software installed on our TFS Build Server:

  • BizTalk Developer Tools and SDK  [needed to run Unit Tests]
  • BizTalk Project Build Component  [needed to build BizTalk Projects]
  • BizTalk 2010 Cumulative Update Pack 4.0 [contains this fix]
  • Windows Communication Foundation Adapter [apparently needed to remotely import bindings containing WCF adapters]

image     image

About me

Hi! I’m Toon Vanhoutte, a hands-on Azure architect – based in Belgium – with a big passion for teaching and helping people out. I’m happy to assist you during your Azure journey with high-quality advisory and I would love to teach you Azure’s possibilities via my tailored training courses.

Subscribe to the blog