The BizTalk Adapters for Enterprise Applications adapter that you use in the BizTalk application may fail at run time when you use a domain group to configure BizTalk Server 2006


Important This article contains information about how to modify the registry. Make sure to back up the registry before you modify it. Make sure that you know how to restore the registry if a problem occurs. For more information about how to back up, restore, and modify the registry, click the following article number to view the article in the Microsoft Knowledge Base:
256986 Description of the Microsoft Windows registry

Symptoms


Consider the following scenario. You use a domain group to configure Microsoft BizTalk Server 2006. A domain user account that is a member of the domain group is configured as the BizTalk host instance. The domain user account is not a member of any group on the local computer. In a BizTalk application, you use one of the adapters that is included in Microsoft BizTalk Adapters for Enterprise Applications.

Note BizTalk Adapters for Enterprise Applications includes the adapters that are listed in the "Applies to" section.

In this scenario, the adapter that you use in the BizTalk application may fail at run time. When you run the BizTalk application, an Error event that resembles one of the following may be logged in the Application log:
Event 1
Event 2
Event 3

Cause


This issue occurs if the domain user account that is configured as the BizTalk host instance cannot read the following registry key:
HKEY_LOCAL_MACHINE\Software\Microsoft\BizTalkAdapters\Config

Resolution


Warning Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require that you reinstall your operating system. Microsoft cannot guarantee that these problems can be solved. Modify the registry at your own risk.

To resolve this issue, grant the Read permission on the following registry key to the domain group or to the domain user account that is configured as the BizTalk host instance:
HKEY_LOCAL_MACHINE\Software\Microsoft\BizTalkAdapters\Config
To do this, follow these steps:
  1. Click Start, click Run, type Regedit, and then click OK.
  2. Locate the following registry key:
    HKEY_LOCAL_MACHINE\Software\Microsoft\BizTalkAdapters\Config
  3. Right-click the registry key that you located in step 2, and then click Permissions.
  4. On the Security tab, click Add.
  5. Type the domain group or the domain user account that is configured as the BizTalk host instance, and then click OK.
  6. On the Security tab, click the domain group or the domain user account that you added in step 5, click to select the Read check box, and then click OK.
  7. Exit Registry Editor.

More Information


The adapters that are included in BizTalk Adapters for Enterprise Applications access the local registry at run time. If the domain user account that is configured as the BizTalk host instance does not have access to the local registry, the adapters fail. When BizTalk Server 2006 is configured to use a domain group for the BizTalk Application Users group, the domain group is not automatically granted access to the local registry.

References


For more information about BizTalk Adapters for Enterprise Applications, visit the following Microsoft Web site: