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

Posted: January 16, 2015 in BizTalk
Tags: , , , ,

This next posts will focus on installing and configuring BizTalk Server 2013 R2 and additional components

Make sure that you have installed all the latest critical Windows updates from Microsoft and all the prerequisites before you install BizTalk Server 2013 R2.

BizTalk Adapter Pack

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).
Microsoft BizTalk Adapter Pack and Microsoft BizTalk Adapter Pack (x64)

We are preparing a x64 environment machine so 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 run time 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.

Steps to install BizTalk Adapter Pack

To install BizTalk Adapter Pack:

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

81-BizTalk-Server-2013-R2-install-microsoft-biztalk-adapters-pack

  • In the next Start page, 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.
    • 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.~

82-BizTalk-Server-2013-R2-Adapter-pack-step-1-install-microsoft-wcf-lob-adapter-sdk

    • On the Welcome to the Windows Communication Foundation LOB adapter SDK Setup Wizard page, click “Next”

83-BizTalk-Server-2013-R2-Adapter-pack-welcome-windows-communication-foundation-lob-adapter-sdk-setup-wizard

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

84-BizTalk-Server-2013-R2-Adapter-pack-end-user-license-agreement-screen

    • In the Choose Setup Type page, select the installation type “Complete”:
      • Typical: will install the common run time 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.

85-BizTalk-Server-2013-R2-Adapter-pack-choose-setup-type

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

86-BizTalk-Server-2013-R2-Adapter-pack-ready-install-wcf-lob-adapter-sdk-screen

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

87-BizTalk-Server-2013-R2-Adapter-pack-completed

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

88-BizTalk-Server-2013-R2-Adapter-pack-step-2-install-microsoft-biztalk-adapter-pack

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

89-BizTalk-Server-2013-R2-Adapter-pack-welcome-microsoft-biztalk-adapter-pack-setup-wizard

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

90-BizTalk-Server-2013-R2-Adapter-pack-end-user-license-agreement

    • In the Choose Setup Type page, select the installation type “Complete”:
      • Typical: will install the common run time 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.

91-BizTalk-Server-2013-R2-Adapter-pack-choose-setup-type

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

92-BizTalk-Server-2013-R2-Adapter-pack-ready-install-microsoft-biztalk-adapter-pack

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

93-BizTalk-Server-2013-R2-Adapter-pack-customer-experience-improvement-program

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

94-BizTalk-Server-2013-R2-Adapter-pack-completed-microsoft-biztalk-adapter-pack-setup-wizard

  • Back to the Start page, 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.

95-BizTalk-Server-2013-R2-Adapter-pack-step-3-install-microsoft-biztalk-adapter-packx64

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

96-BizTalk-Server-2013-R2-Adapter-pack-welcome-microsoft-biztalk-adapter-packx64-setup-wizard

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

97-BizTalk-Server-2013-R2-Adapter-pack-end-user-license-agreement-screen

    • In the Choose Setup Type page, select the installation type “Complete”:
      • Typical: will install the common run time 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.

98-BizTalk-Server-2013-R2-Adapter-pack-choose-setup-type

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

99-BizTalk-Server-2013-R2-Adapter-pack-ready-install-microsoft-biztalk-adapter-packx64

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

100-BizTalk-Server-2013-R2-Adapter-pack-customer-experience-improvement-program

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

101-BizTalk-Server-2013-R2-Adapter-pack-completed-microsoft-biztalk-adapter-packx64-setup-wizard

  • Back to the Start page, 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.

102-BizTalk-Server-2013-R2-Adapter-pack-step-4-install-microsoft-biztalk-adapters-for-enterprise-applications

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

103-BizTalk-Server-2013-R2-Adapter-pack-welcome-microsoft-biztalk-adapters-for-enterprise-applications-setup-wizard

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

104-BizTalk-Server-2013-R2-Adapter-pack-end-user-license-agreement

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

105-BizTalk-Server-2013-R2-Adapter-pack-customer-information

    • In the Choose Setup Type page, 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.

106-BizTalk-Server-2013-R2-Adapter-pack-choose-setup-type

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

107-BizTalk-Server-2013-R2-Adapter-pack-choose-destination-location

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

108-BizTalk-Server-2013-R2-Adapter-pack-ready-install

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

109-BizTalk-Server-2013-R2-Adapter-pack-completed-microsoft-biztalk-adapters-for-enterprise-applications

  • Close the Start page, click “Exit”.

110-BizTalk-Server-2013-R2-Adapter-pack-success

Add adapters to BizTalk Administration Console

As it happens with all adapters that we installed on our BizTalk Servers environment, before we can begin to use them we need to register or add the adapters. So in the next step it will be describing how can we add the enterprise adapters, or any other custom adapter, on the BizTalk Administration Console. To accomplish that we need to:

  • Open BizTalk Administration Console by pressing the “Windows key” to switch to the Start screen, type “BizTalk Server Administration” or “BizTalk”, click “BizTalk Server Administration” option from the Search 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”

111-BizTalk-Server-2013-R2-Register-New-Adapter

  • In the “Adapter Properties” window
    • In the Name box, type a descriptive name for this adapter.
      • WC-SQL
    • In the Adapter combo box, select the adapter from the drop-down that you want to add.
      • WCF-SQL
    • In the Description box, type a description for the adapter (this is optional).
      • The WCF SQL Adapter provides access to SQL Database table, views, stored procedures and functions. Polling is also provided, allowing applications to periodically look for data in databases.
    • Click “OK” to complete the process of adding the adapter.

112-BizTalk-Server-2013-R2-Register-New-Adapter

  • Repeat steps to add the other adapters.

112-BizTalk-Server-2013-R2-Register-New-Adapter-2

Note: This configurations requires that you restart the host instance associated with the adapters.

Related links
Comments

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s