BizTalk 2013 Installation and Configuration – Installing BizTalk Adapter Pack (Part 12)

BizTalk Adapter Pack along with BizTalk AppFabric Connect, RFID features, UDDI services and ESB Toolkit are not automatically installed with the default installation process, instead, you have to additional install this features

The Microsoft BizTalk Adapter Pack contains adapters that enable enterprise applications and databases to interface with each other by implementing a common adapter framework. Similar to programming to Web services, adapters enable clients to program to different enterprise applications. Technically, adapters are a binding to Windows Communication Framework (WCF). The BizTalk Adapter Pack consists of the following adapters:

  • Microsoft BizTalk Adapter for Oracle Database (Oracle Database adapter).
  • Microsoft BizTalk Adapter for Oracle E-Business Suite (Oracle E-Business adapter).
  • Microsoft BizTalk Adapter for mySAP Business Suite (SAP adapter). This also includes the .NET Framework Data Provider for mySAP Business Suite (Data Provider for SAP).
  • Microsoft BizTalk Adapter for Siebel eBusiness Applications (Siebel adapter). This also includes the .NET Framework Data Provider for Siebel eBusiness Applications (Data Provider for Siebel).
  • Microsoft BizTalk Adapter for SQL Server (SQL adapter).

To install BizTalk Adapter Pack:

  • Close any programs you have open. Run the BizTalk Server 2013 installer as Administrator.
  • On the Start screen, click “Install Microsoft BizTalk Adapters

BTS-2013-Adapter-Pack-01-Install-Microsoft-BizTalk-Adapters

  • In the next Start screen, the first step is to install WCF LOB Adapter SDK, select the “Step 1. Install Microsoft WCF LOB Adapter SDK”. An installer of SDK is launched.

BTS-2013-Adapter-Pack-02-Step-1-Install-Microsoft-WCF-LOB-Adapter-SDK

    • The WCF LOB Adapter SDK is a collection of a run-time engine and tools that help adapter developers create service-oriented interfaces to existing LOB systems by using WCF. The goal of the SDK is to facilitate uniform development of reusable, metadata-oriented, WCF-based adapters that enable enterprise applications, databases, and messaging platforms to integrate with each other.
    • On the Welcome to the Windows Communication Foundation LOB adapter SDK Setup Wizard screen, click “Next”

BTS-2013-Adapter-Pack-03-Welcome-Windows-Communication-Foundation-LOB-adapter-SDK-Setup-Wizard-screen

    • On the End-User License Agreement screen, select “I accept the terms in the License Agreement” to accept the license agreement and click “Next”

BTS-2013-Adapter-Pack-04-End-User-License-Agreement-screen

    • In the Choose Setup Type screen, select the installation type “Complete”:
      • Typical: will install the common runtime and tools,
      • Custom: will allow you to select the features that you want to install and the installation location.
      • Complete: will install all the features.

BTS-2013-Adapter-Pack-05-Choose-Setup-Type-screen

    • On the Ready to install WCF LOB adapter SDK screen, click “Install”

BTS-2013-Adapter-Pack-06-Ready-install-WCF-LOB-adapter-SDK-screen

    • On the Completed the Windows Communication Foundation LOB Adapter SDK Setup Wizard screen, click “Finish”

BTS-2013-Adapter-Pack-07-Completed-screen

  • Back to the Start screen, the second step is the installation of the Adapter Pack (x86), select the “Step 2. Install Microsoft BizTalk Adapter Pack”. An installer of SDK is launched.

BTS-2013-Adapter-Pack-08-Step-2-Install-Microsoft-BizTalk-Adapter-Pack

    • On the Welcome to the Microsoft BizTalk Adapter Pack Setup Wizard screen, click “Next”

BTS-2013-Adapter-Pack-09-Welcome-Microsoft-BizTalk-Adapter-Pack-Setup-Wizard-screen

    • On the End-User License Agreement screen, select “I accept the terms in the License Agreement” to accept the license agreement and click “Next”

BTS-2013-Adapter-Pack-10-End-User-License-Agreement-screen

    • In the Choose Setup Type screen, select the installation type “Complete”:
      • Typical: will install the common runtime and tools,
      • Custom: will allow you to select the features that you want to install and the installation location.
      • Complete: will install all the features.

BTS-2013-Adapter-Pack-11-Choose-Setup-Type-screen

    • On the Ready to install Microsoft BizTalk Adapter Pack screen, click “Install”

BTS-2013-Adapter-Pack-12-Ready-install-Microsoft-BizTalk-Adapter-Pack-screen

    • On the Customer Experience Improvement Program screen, select if you want to join the customer experience improvement program or not and click “OK”

BTS-2013-Adapter-Pack-13-Customer-Experience-Improvement-Program-screen

    • On the Completed the Microsoft BizTalk Adapter Pack Setup Wizard screen, click “Finish”

BTS-2013-Adapter-Pack-14-Completed-Microsoft-BizTalk-Adapter-Pack-Setup-Wizard-screen

  • Back to the Start screen, the next step is installing the Microsoft BizTalk Adapter Pack (x64) – note that before you install this pack you have to install x86 first – select the “Step 3. Install Microsoft BizTalk Adapter Pack(x64)”. An installer of SDK is launched.

BTS-2013-Adapter-Pack-15-Step-3-Install-Microsoft-BizTalk-Adapter-Pack(x64)

    • On the Welcome to the Microsoft BizTalk Adapter Pack(x64) Setup Wizard screen, click “Next”

BTS-2013-Adapter-Pack-16-Welcome-Microsoft-BizTalk-Adapter-Pack(x64)-Setup-Wizard-screen

    • On the End-User License Agreement screen, select “I accept the terms in the License Agreement” to accept the license agreement and click “Next”

BTS-2013-Adapter-Pack-17-End-User-License-Agreement-screen

    • In the Choose Setup Type screen, select the installation type “Complete”:
      • Typical: will install the common runtime and tools,
      • Custom: will allow you to select the features that you want to install and the installation location.
      • Complete: will install all the features.

BTS-2013-Adapter-Pack-18-Choose-Setup-Type-screen

    • On the Ready to install Microsoft BizTalk Adapter Pack(x64), click “Install”

BTS-2013-Adapter-Pack-19-Ready-install-Microsoft-BizTalk-Adapter-Pack(x64)

    • On the Customer Experience Improvement Program screen, select if you want to join the customer experience improvement program or not and click “OK”

BTS-2013-Adapter-Pack-20-Customer-Experience-Improvement-Program-screen

    • On the Completed the Microsoft BizTalk Adapter Pack(x64) Setup Wizard screen, click “Finish”

BTS-2013-Adapter-Pack-21-Completed-Microsoft-BizTalk-Adapter-Pack(x64)-Setup-Wizard-screen

  • Back to the Start screen, the final step is installing the Microsoft BizTalk Adapters for Enterprise Applications, select the “Step 4. Install Microsoft BizTalk Adapters for Enterprise Applications”. An installer of SDK is launched.

BTS-2013-Adapter-Pack-22-Step-4-Install-Microsoft-BizTalk-Adapters-for-Enterprise-Applications

    • On the Welcome to the Microsoft BizTalk Adapters for Enterprise Applications Setup Wizard screen, click “Next”

BTS-2013-Adapter-Pack-23-Welcome-Microsoft-BizTalk-Adapters-for-Enterprise-Applications-Setup-Wizard-screen

    • On the End-User License Agreement screen, select “I accept the terms in the License Agreement” to accept the license agreement and click “Next”

BTS-2013-Adapter-Pack-24-End-User-License-Agreement-screen

    • In the Customer Information screen, type your User Name and Organization and click “Next” to continue.

BTS-2013-Adapter-Pack-25-Customer-Information-screen

    • In the Choose Setup Type screen, select the installation type “Complete”:
      • Custom: will allow you to select the features that you want to install and the installation location.
      • Complete: will install all the features.

BTS-2013-Adapter-Pack-26-Choose-Setup-Type-screen

    • On the Choose Destination Location screen, choose the folder location that to want to install this features and click “Next”

BTS-2013-Adapter-Pack-27-Choose-Destination-Location-screen

    • On the Ready to install screen, click “Install”

BTS-2013-Adapter-Pack-28-Ready-install-screen

    • On the Completed the Microsoft BizTalk Adapters for Enterprise Applications Setup Wizard screen, click “Finish”

BTS-2013-Adapter-Pack-29-Completed-Microsoft-BizTalk-Adapters-for-Enterprise-Applications-Setup-Wizard-screen

  • Close the Start screen, click “Exit”.

BTS-2013-Adapter-Pack-30-Success

Microsoft BizTalk Adapter Pack and Microsoft BizTalk Adapter Pack (x64)

If I’m preparing an x64 environment machine why do I need to install both x86 and x64 Microsoft BizTalk Adapter Pack and not only x64 pack?

On any computer where you want to perform design-time tasks using either Visual Studio or BizTalk MMC, you must install the 32-bit adapter because:

  • BizTalk Server Administration console runs as a 32-bit Microsoft Management Console (MMC) application.
  • Visual Studio is also a 32-bit application (and there isn’t any 64-bit version of Visual Studio)

However, for BizTalk runtime perspective:

  • If you want to run the adapters under a 32-bit BizTalk process (Host Instance): you need to install Microsoft BizTalk Adapter Pack.
  • If you want to run the adapters under a 64-bit BizTalk process (Host Instance): you need to install Microsoft BizTalk Adapter Pack (x64).

So you always have to install Microsoft BizTalk Adapter Pack, or in other cases, you always need to install the 32-bit adapter if you want to perform any operation at design-time, especially, configuring the adapters in the administrative console.

Add adapters to BizTalk Administration Console

As it happens with all adapters that we installed on our BizTalk Servers before we can begin to use it we need to register or add the adapter. So the next step is adding the appropriate adapters in BizTalk Administration Console. To accomplish that we need to:

· Open BizTalk Administration Console by pressing the “Windows key” to switch to Metro UI and type “BizTalk Server Administration” or “BizTalk”, right-click “BizTalk Server Administration” option on Apps menu

  • In the console left tree, expand “BizTalk Server Administration –> BizTalk Group –> Platform Settings” and then “Adapters”
  • Right-click on “Adapters” and add a new adapter by selecting the option “New –> Adapter”

BTS-2013-Adapter-Pack-31-Add-adapters-BizTalk-Administration-Console

  • In the “Adapter Properties” window
    • In the Name box, type a descriptive name for this adapter.
    • In the Adapter combo box, select the adapter from the drop-down that you want to add.
    • In the Description box, type a description for the adapter (this is optional).

BTS-2013-Adapter-Pack-32-WCF-OracleDB-Adapter-Properties

  • Click “OK” to complete the process of adding the adapter.
  • Repeat steps to add the other adapters.

Note: These configurations requires that you restart the host instance associated with the adapter.

Related links

Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc. He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community.

One Platform Operations, Monitoring and Analytics Software
BizTalk360

microsoft biztalk

Learn more

Over 500 customers across 30+ countries depend on BizTalk360

ServiceBus360

Azure service bus

Learn more

Start managing your Azure Service Bus namespaces in minutes

One Platform - Operations, Monitoring and Analytics Software
BizTalk360

microsoft biztalk

Learn more

Over 500 customers across 30+ countries depend on BizTalk360

One Platform - Operations, Monitoring and Analytics Software
ServiceBus360

Azure service bus

Learn more

Start managing your Azure Service Bus namespaces in minutes

Back to Top