Install the WCF LOB Adapter SDK

Install and configure the Microsoft Windows Communication Foundation (WCF) Line of Business (LOB) Adapter SDK.

Requirements

Install following components on the system where you install the WCF LOB Adapter SDK.

Windows x86 or x64

Required OS resources include:
  • Microsoft Distributed Transaction Coordinator (MSDTC) : Required to support OleTx transactions
  • Message Queuing (MSMQ) : Required to support reliable messaging
  • Internet Information Services (IIS) : Required if you want to host your application in IIS
  • Windows Process Activation Service (WAS) : Required if you want to host your application in WAS
Windows Communication Foundation
.NET Framework
Visual Studio Required if you are building custom adapters, or developing solutions that use the adapters built with the WCF LOB Adapter SDK.
BizTalk Server Required if you use the adapters with BizTalk Server.

Install

Important

  • Close all instances of Visual Studio
  • To do a Complete setup, confirm that BizTalk Server is installed on the computer.
  1. Run the BizTalk Server Setup.exe as Administrator.

  2. Select Install Microsoft BizTalk Adapters, and then select Install Microsoft WCF LOB Adapter SDK.

  3. On the Welcome screen, select Next.

  4. Accept the license agreement, and select Next.

  5. In Choose Setup Type, select the type of installation:

    • To install the common run time and tools, select Typical.

    • To select the features that you want to install and the installation location, select Custom, and then select the features you want to install.

    • To install all the features, select Complete.

  6. Select Install.

Update or remove

  1. Open Programs and Feature.

  2. In the list, select Windows Communication Foundation LOB Adapter SDK, and then select Change.

  3. On the Welcome screen, select Next.

  4. Do one of the following:

    • To select the components that you want to install, select Change.

    • To repair errors in the most recent installation, select Repair.

    • To remove the WCF LOB Adapter SDK from the computer, select Remove.

  5. If you choose to modify the installation:

    1. Select Next.

    2. Select Change, and then select Finish.

  6. If you choose to repair the installation, in the Ready to repair WCF LOB Adapter SDK dialog box, select Repair, and then select Finish.

  7. If you choose to remove the adapters, in the Ready to remove WCF LOB Adapter SDK dialog box, select Remove, and then select Finish.

Remove custom adapters after uninstalling the WCF LOB Adapter SDK

If you have developed any custom adapters using the WCF LOB Adapter SDK, and you have registered these adapters on your computer, you must also complete the following procedure.

  1. Remove the custom adapter from the global assembly cache (GAC).

    1. Open a Visual Studio command prompt.

    2. Remove the custom adapter .dll from the GAC using command gacutil /u.

  2. Remove the references to the custom adapter binding from machine.config

    1. Go to the machine.config file under <system drive>:\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG.

    2. Open the file by using a text editor.

    3. Search for the element bindingExtensions, client and bindingElementExtensions under system.serviceModel\extensions.

    4. Remove the WCF binding that pertains to your custom adapter.

Do a silent installation

A silent installation is ideal for test scenarios or as part of a large-scale enterprise deployment. WCF LOB Adapter SDK provides command line parameters that you can use with AdapterFramework.msi to perform a silent installation.

Note

To perform silent installation, you should be an Administrator on the computer.

  1. Open a command prompt as administrator.

  2. Type the following:

    AdapterFramework.msi /quiet MUOPTIN=”Yes”  
    

    Use the following command line options in conjunction with AdapterFramework.msi:

    • Use /quiet to install WCF LOB Adapter SDK silently.

    • Use MUOPTIN=”Yes”|”No” to indicate if the WCF LOB Adapter SDK should check for updates with Microsoft Update.

      When set to Yes, WCF LOB Adapter SDK checks for updates through Microsoft Update. When set to no WCF LOB Adapter SDK does not check for updates with Microsoft Update.

Note

To display additional options for command line installation, type AdapterFramework.msi /?at the command prompt.