Runtime Components: BizTalk Adapter Service

 

Important

Microsoft Azure BizTalk Services (MABS) is being retired, and replaced with Azure Logic Apps. If you currently use MABS, then Move from BizTalk Services to Logic Appsprovides some guidance on moving your integration solutions to Logic Apps.

If you're brand new to Logic Apps, then we suggest getting started here:

When BizTalk Adapter Service runtime is installed, the following components are created:

  • BizTalk Adapter Service web site in IIS

  • Configuration store in Microsoft Azure

To install and setup the Runtime, refer to Install Azure BizTalk Services SDK.

BizTalk Adapter Service web site

The BizTalk Adapter Service web site and BizTalk Adapter AppPool are created in IIS. The BizTalk Adapter Service web site contains the following:

BAService

An application that hosts the Management API that runs in the ManagementService.svc WCF web service. This WCF web service runs continuously monitoring the LOB Relay.

The ManagementService.svc WCF web service uses a web.config file in the \Program Files\Microsoft BizTalk Adapter Service\BAService folder.

LOB Relay

When a LOB component is added, an application with the same name is also created. This application hosts the RuntimeService.svc WCF web service. A runtime service is created for every LOB component in the Bridge Configuration application. So if there are 15 LOB components in the Bridge Configuration application, there will be at least 15 RuntimeService.svc WCF web services IIS.

The RuntimeService.svc WCF web service uses a web.config file in the \Program Files\Microsoft BizTalk Adapter Service\BAServiceRuntime folder.

Windows Authentication is specified for the BizTalk Adapter Service web site and the BAService application hosted in this web site.

By default, the BizTalk Adapter Service web site binds to port 8080. This port is set during the BizTalk Adapter Service setup and can also be modified in the web site in IIS.

Reconnect Interval

By default, an IIS application pool is configured to recycle every 1740 seconds (29 minutes). When the BizTalk Adapter AppPool recycles, a LOB Relay may fail to start. If a LOB Relay fails to start, an attempt is made to restart the LOB Relay after a fixed interval. This is controlled by the ReConnectIntervalInSeconds property, which has a default value of 30 seconds.

To change or disable the reconnect interval:

  1. Open the Internet Information Services (IIS) Manager.

  2. Expand Sites and expand BizTalk Adapter Service.

  3. Click BAServiceRuntime. Under the ASP.NET group, click Application Settings and click Open Feature in the Actions pane.

  4. To modify the reconnect interval, click ReConnectIntervalInSeconds and click Edit in the Actions pane. Set this to any value in seconds. For example, to set the reconnect interval to 5 minutes, enter 300. To disable the reconnect interval, set ReConnectIntervalInSeconds to any negative number, like -1.

ReConnectIntervalInSeconds can also be modified in the web.config file (\Program Files\Microsoft BizTalk Adapter Service\BAServiceRuntime):

<appSettings>
    <add key="EnablePerfCounters" value="True" />
    <add key="ReConnectIntervalInSeconds" value="30" />
</appSettings>

Note

The Recycling Settings in IIS can be configured. See Configuring Recycling Settings for an Application Pool (IIS 7).

Administrators can make client requests to BizTalk Adapter Service web site

Users in the local Administrators group can make client requests to the BizTalk Adapter Service web site within IIS. The BAService application inherits the .NET Authorization Rules from the BizTalk Adapter Service web site and the web server-level.

To allow non-Administrators to make client requests to the BizTalk Adapter Service web site, use the .NET Authorization Rules feature within IIS:

  1. Open the Internet Information Services (IIS) Manager.

  2. Expand Sites and click BizTalk Adapter Service.

  3. Under the ASP.NET group, double-click .NET Authorization Rules. NET Authorization Rules Page explains the UI elements.

  4. In the Actions pane, click Add Allow Rule. Add or Edit Allow Authorization Rule and Add or Edit Deny Authorization Rule Dialog Boxes explains the UI options when Add Allow Rule or Add Deny Rule is used.

Note

When BizTalk Adapter Service Runtime is installed, the identity specified during the Setup can make client requests to the BizTalk Adapter Service web site. This identity also has permissions to access the BizTalk Adapter Service configuration store.

Configuration Store

The BizTalk Adapter Service configuration is stored in Microsoft Azure using your BizTalk Services URL you specify during the setup.

When an item is created in Server Explorer in Visual Studio on the development environment, the store is updated. Connect to LOB systems from a BizTalk Services Project provides details on Server Explorer and the development experience.

See Also

Development and Runtime Architecture: BizTalk Adapter Service
Connect to LOB systems from a BizTalk Services Project
PowerShell Cmdlets for the BizTalk Adapter Service
LOB Security in BizTalk Adapter Service
Troubleshoot the BizTalk Adapter Service
Using the BizTalk Adapter Service (BAS)