Export (0) Print
Expand All

Installing the Exception Management Framework

This section describes the process for installing the Microsoft BizTalk ESB Toolkit Exception Management Framework.

Ee250099.note(en-US,BTS.10).gifNote:
If you have already installed the Microsoft.Practices.ESB.CORE.msi file, you do not have to install the Exception Management Framework components because they are included. If you need only the Exception Management Framework components, you can install the Microsoft.Practices.ESB.ExceptionHandling.msi file.

To install the Exception Management Framework

  1. Install the Microsoft BizTalk ESB Toolkit .msi file appropriate for your platform. This step unpacks the files needed to install the BizTalk ESB Toolkit and creates necessary registry entries. The Itinerary Designer can also be installed and registered with Microsoft Visual Studio 2008. To do this, click the Tools option in the installer.
  2. Import the appropriate Exception Management Framework .msi file as follows:
    • To import the Exception Management Framework with bindings:
      1. Use the Microsoft.Practices.ESB.ExceptionHandling .msi file and the BizTalk Server 2009 Administration Console. This step creates the Microsoft.Practices.ESB BizTalk Server application and register all required BizTalk Server artifacts in the BizTalk Server management database, such as pipelines and supporting assemblies.
      2. Install the Microsoft.Practices.ESB.ExceptionHandling .msi file from the BizTalk ESB Toolkit install folder. This step installs the supporting core and exception handling runtime assemblies to the global assembly cache and installs the pipeline components to the appropriate folder.
    • To import the Exception Management Framework without bindings:
      1. Install the Microsoft.Practices.ESB.ExceptionHandling _NOBINDING.msi file from the BizTalk ESB Toolkit install folder. This step installs the supporting core and exception handling runtime assemblies to the global assembly cache and installs the pipeline components to the appropriate folder.

Next, configure the Exception Management database and Web services.

To configure the Exception Mangement database and Web services

  1. Navigate to the installation path (the default path is C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\) of the BizTalk ESB Toolkit and launch the ESB Configuration Tool in the bin directory (ESBConfigurationTool.exe).
  2. Configure the Exception Management database. In the ESB Configuration Tool, as illustrated in Figure 1, select the Enable Exception Management Database check box. Provide the server and database name and credentials for your environment; the default database name is EsbExceptionDb. This step creates the exception handling database with the required permissions. Optionally, if choose to use an existing database to serve as the Exception Management database, you can make that selection here.

    Ee250099.a0cc0543-efad-4164-a45b-802d0f0af7c7(en-US,BTS.10).png

    Figure 1

    Enabling the Exception Management database using the ESB Configuration Tool
    Ee250099.note(en-US,BTS.10).gifNote:
    If you have already created exception management database as part of multi-server installation, select the Use Existing Database check box to connect to the existing database.

  3. After you finish configuring the Exception Management database, click Apply Configuration.
    Ee250099.note(en-US,BTS.10).gifNote:
    When using the ESB Configuration Tool during initial installation, you must apply configuration changes to each section before you can continue to configure the next section. This process also validates each configuration section before you continue. Configuration of these sections must be completed consecutively.

  4. Configure the exception Web services. In the ESB Configuration Tool, as illustrated in Figure 2, select the Enable Exception Services check box to configure the exception Web services. Provide the user credentials for your environment; the user must be a member of the Administrators group or the BizTalk Isolated Host Users group. This step creates the two exception handling Web services that can be used by applications outside the BizTalk ESB Toolkit.

    Ee250099.a0a573e6-af28-4f07-8bda-b47de578a5a8(en-US,BTS.10).png

    Figure 2

    Enabling the Exception Web Services using the ESB Configuration Tool
  5. Configure core Web services. Using the ESB Configuration Tool, configure the core Web services. This step creates a range of Web services, including the core on-ramps and general functionality of the core, such as transformations, resolution, and Microsoft BizTalk Server operational information. This will configure the BizTalk Operations Web service used by the Exception Management Framework.
  6. Place the Microsoft.Practices.ESB.BizTalkOperations.dll file in the global assembly cache. This is located in C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Bin. The BizTalk Operations Web service relies on the Microsoft.Practices.ESB.BizTalkOperations.dll file which is not registered to the global assembly cache during an Exception Management Framework installation, but is registered if you install the BizTalk ESB Toolkit Core.

To install BAM definitions

  • Install Exception Handling BAM tracking. The BAM definition file (Microsoft.BizTalk.ESB.BAM.Exceptions.xml) is located in the BAM folder in the installation directory and can be installed using the bm.exe tool. Use the following command as an example. For more information about the bm.exe tool, see BAM Management Utility on MSDN.
    Bm.exe deploy-all -DefinitionFile: "C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Bam\Microsoft.BizTalk.ESB.BAM.Exceptions.xml"
    

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft