Share via


Install the Exception Management Framework from the Windows Installer File

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 the process for installing the Microsoft ESB Guidance Exception Management Framework using the Windows Installer provided with the Microsoft ESB Guidance.

To install the ESB Exception Management Framework from a pre-packaged .msi file

  1. Click Run on the Start menu to open a command prompt and execute the following command, replacing the <path> parameter with the full path to the .msi file you want to install (the default path and name in this release is C:\Program Files\Microsoft patterns & practices\ESB Guidance\Microsoft.Practices.ESB.ExceptionHandling.msi).

    BTSTask.exe ImportApp -Package:
        "<path>\Microsoft.Practices.ESB.ExceptionHandling.msi" 
        /Environment:DEV_EXC /ApplicationName:Microsoft.Practices.ESB
    
  2. Execute the following command to add the necessary assemblies to the global assembly cache, copy the pipeline components, and create the IIS virtual directories. If you are installing from the Microsoft.Practices.ESB.ExceptionHandling.msi Windows Installer, it copies all Web services to the folder C:\Inetpub\wwwroot\ESB.Services.

    msiexec.exe /q /i "<path>\Microsoft.Practices.ESB.ExceptionHandling.msi"
    
  3. Open SQL Server Management Studio (or an equivalent SQL Server management tool) and connect to the SQL Server that will host the exception database. Load the SQL script EsbExceptionDb_CREATE.sql from the <path>\SQL folder into a new Query window and execute it to create the EsbExceptionDb database.

  4. In Windows Explorer, open the folder where you installed the Microsoft ESB Guidance Exception Management Framework and execute the script file named InstallPostProcessing.cmd to deploy the ESB Guidance Event Log Source and the BAM Observation Models.

  5. Execute the script file named InstallWebServiceConfig.vbs to configure the virtual directories created in step 2.

Now continue to the next task: Install the ESB JMS/WMQ Components.