Share via

Install the ESB Exception Management Samples from the Solution Project

  • Article
Retired Content

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This section describes how to install the ESB Exception Management samples from the solution project included with the Microsoft ESB Guidance.

To install the ESB Exception Management samples from the GlobalBank.ESB.Samples.ExceptionHandling.sln solution

  1. Load the solution named GlobalBank.ESB.Samples.ExceptionHandling.sln from the \Source\Samples\Exception Handling folder where you installed the distribution files into Visual Studio 2005.

  2. Open the** **Property Pages for each of the four projects in the solution, select the Deployment entry in the Configuration Settings section of the tree in the right-side pane, and then click All Configurations in the drop-down list at the top of the dialog box. Ensure that the Server and Configuration Database settings point to the appropriate SQL Server and BizTalkMgmtDb database and that all references are correct.

  3. Save and close the solution.

  4. In Windows Explorer, open the \Source\Samples\Exception Handling\Install\Scripts folder, and then open the script file named PreProcessingCORE.vbs in a text editor. You can edit the variables declared at the start of this file before you execute the script if required. The topic Settings in the PreProcessingCORE Script for the Exception Management Samples shows these variables and their default values. Then double-click the script to execute it. The script performs the following tasks:

    • It creates a new user account for the BizTalk Isolated Host Users group.
    • It adds the user account to the following local and domain groups:

      Local and domain groups

      [local machine]\IIS_WPG

      [local machine]\STS_WPG

      [domain]\BizTalk Isolated Host Users
    • It grants permission for the new user account and the BizTalk Application Users local group to the following folders:

      Folders

      Windows Temp folder

      The ESB Guidance installation folder
    • It creates an IIS application pool named ESBHttpAppPool using the new account as its identity.
    • It creates an IIS virtual directory named HwsMessages for the BizTalk HTTP ISAPI filter, specifying that it should run in the new application pool with Script and Execute permissions.

    Note

    If you are installing the Microsoft ESB Guidance into a BizTalk Server Group, exceptions may occur when the script attempts to set permissions. You must set these permissions and manually assign the user account to the BizTalk Isolated Host Users domain group after the script completes.

  5. Open the \Source\Samples\Exception Handling\Install\Scripts folder in Windows Explorer, and then double-click the script file named 1.CreateBizTalkApplication.cmd to create the GlobalBank.ESB application within BizTalk and deploy the ESB Exception Management Sample assemblies. The script performs the following tasks:

    • It rebuilds and deploys the GlobalBank.ESB.Samples.ExceptionHandling.sln from the \Source\Samples\Exception Handling folder where you installed the distribution files, which creates the GlobalBank.ESB application within BizTalk.
    • It imports the GlobalBank.ESB.ExceptionHandling_Bindings.xml BizTalk binding file.

  6. To confirm successful installation of the samples, or if you are encountering issues when you run them, you can use the list in the topic Assemblies and Artifacts Installed by the Exception Management Samples to check for the presence of the required assemblies and other artifacts.