BizTalk Magic Act: Disappearing Applications in the Management Console and “Out of Date” Group Configuration
Here’s a nice one. I re-deployed an updated BizTalk assembly to my local workstation. When refreshing the Admin console, the following message appeared:
Schema referenced by Map ‘YOUR_MAP’ has been deleted. The local, cached version of the BizTalk Server group configuration is out of date. You must refresh the BizTalk Server group configuration before making further changes.
A simple refresh of the Server Group did nothing but show the same exception. At the same time, the Application list would no longer show in the console. It was as if all the BizTalk applications had just disappeared! Further, I was not able to deploy anything else to BTS via Visual Studio or any other method. What a mess!
Turns out there’s a bug in BizTalk 2010 that makes it so that the Admin console doesn’t correctly handle exceptions regarding schema deployment mismatches. I had accidentally attempted to deploy a map without first deploying an updated version of one of the schemas. Normally, we can’t get away with such a deployment, but for whatever reason it happened. The Admin Console at this point becomes unusable.
There is a hotfix. Check out the article at http://support.microsoft.com/kb/2516201 .
The unfortunate part here is that it may not fix the entire problem. After installing the hotfix, I was able to once again see applications on my system, but it was still impossible to uninstall the broken application. For this, I had to open up the BizTalk Management Database and look into the bt_MapSpec table. I located the offending map in the table, deleted the record and BizTalk started humming along once again.
After taking such a drastic action, however, there was need to do a bit of clean-up. I uninstalled the assembly containing the map and, after doing some fixes, re-deployed it. Things seem to be working fine now.