Installing ESB Toolkit 2.0 on Win 2003 64 bit OS

For installing ESB Toolkit 2.0 in a single machine 32 bit environment you should look at this link Quick Learn.

I recently installed and configured ESB Toolkit 2.0 on Windows 2003 SP2 64 bit OS. I am sharing my install notes with you so you can benefit from my experience. Use these instructions to install and configure ESB Toolkit in development environment only. Before installing the ESB Toolkit I had already installed and configured BizTalk 2009

  1. Set the trust level of BizTalkServerApplication and BizTalkServerIsolatedHost to “untrusted”. This is needed because all the bindings for ESB Sample expect these hosts to be untrusted.
  2. Run BizTalk ESB Toolkit 2.0-x64.msi
  3. The installer will extract all the files to C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0
  4. Read the Readme file from C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0Readme.htm
  5. Also read Get Started C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0GettingStarted.htm
  6. Read know issues document from  C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0KnownIssues.htm
  7. In addition to this you should read the known issues from
  8. Use the section “Installing the BizTalk ESB Toolkit” section from Microsoft BizTalkESBToolkit.chm file.
  9. Install all the Prerequisites.
  10. Import the C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0Microsoft.Practices.ESB.CORE64.msi in BizTalk Server 2009 Administration Console.
  11. Run c:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0Microsoft.Practices.ESB.CORE64.msi  and accept all defaults
  12. Run C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0BinESBConfigurationTool.exe
  13. Follow the directions in section “Configuring Services and Components” to configure all the databases and services.
  14. This configuration is performed in steps. First you configure the database and then you can configure the corresponding service.
  15. Create c:projects
  16. Create c:projectsmicrosoft.practices.ESB folder
  17. Uncheck the read-only attribute on c:projectsmicrosoft.practices.ESB
  18. Extract C:Program Files (x86)Microsoft BizTalk ESB Toolkit to c:projectsmicrosoft.practices.ESB
  19. The previous setup will create keys and source folders. Run Visual Studio Tool Command prompt and change directory to c:projectskeys. Run the command sn -k Microsoft.Practices.ESB.snk.
  20. Install Management Portal.
    1. Open Windows PowerShell(32) command prompt
    2. Run the command Get-ExecutionPolicy. If the response to this command is not “RemoteSigned” you will need to run Set-ExecutionPolicy RemoteSigned This will allow you install scripts to run.
    3. Navigate to C:ProjectsMicrosoft.Practices.ESBSourceSamplesManagement PortalInstallScripts
    4. Run the command .Management_Install.ps1 1
    5. Open the solution C:ProjectsMicrosoft.Practices.ESBSourceSamplesManagement PortalESB.AlertServiceESB.AlertService.sln in Visual Studio.
    6. Change the configuration type to Release and build the solution.
    7. Run C:ProjectsMicrosoft.Practices.ESBSourceSamplesManagement PortalESB.AlertService.InstallReleaseSetup.exe
    8. When you are prompted for user name you should enter it in format domainusername  format. Even if you are doing a single computer install you should enter computernameusername.
    9. Run UDDI Services Management Console. Right click on UDDI and select Properties. Select Security tab. Uncheck “Require SSL for publication to this site”.
    10. Open the solution C:ProjectsMicrosoft.Practices.ESBSourceSamplesManagement PortalESB.UDDI.PublisherService ESB.UDDI.PublisherService.sln
    11. Change the build configuration to “Release” and build.
    12. Run C:ProjectsMicrosoft.Practices.ESBSourceSamplesManagement PortalESB.UDDI.PublisherService.InstallReleaseSetup.exe
    13. Follow the instruction  in section Configuring Exception Management InfoPath Form Template Shares of section “Installing the BizTalk ESB Toolkit” of MicrosoftBizTalkESBToolkit.chm
    14. Follow the Security Considerations section of section “Installing the BizTalk ESB Toolkit” of MicrosoftBizTalkESBToolkit.chm
  21. Install Exception Management Samples
    1. Start the BizTalk Application Microsoft.Practices.ESB.
    2. Edit the file C:ProjectsMicrosoft.Practices.ESBSourceSamplesException HandlingInstallScriptsSetup_bin.cmd. Comment out the line that executes
      REM ./ExceptionHandling_Install.cmd
    3. Run C:ProjectsMicrosoft.Practices.ESBSourceSamplesException HandlingInstallScriptsSetup_bin.cmd
    4. Open Windows PowerShell(32) command prompt(You need this because the install relies on Explorer OM which does not support 64 bit)
    5. Navigate to C:ProjectsMicrosoft.Practices.ESBSourceSamplesException HandlingInstallScripts
    6. Run the command .ExceptionHandling_Install.ps1 1
    7. This will install the exception handling samples. Now you are all set to run the exception handling samples. You can use similar steps to install other samples.
  22. Create a 32 bit host and change and send and receive handler for SQL Adapter. This is needed because the SQL Adapter cannot run in 64 bit mode.
  23. Enable the web service extension for btshttpreceive.dll
  24. Configure IIS for both Kerberos and NTLM using the instructions
  25. Install SQLXML 4.0 SP1 from This is needed by the exception management components to write the expection the the database. Thanks to Saravana Kumar for discovering this issue and posting a fix for it.
  26. Install BAM definitions by executing these commands:

cd C:Program Files (x86)Microsoft BizTalk Server 2009Tracking
Bm.exe deploy-all -DefinitionFile:”C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0BamMicrosoft.BizTalk.ESB.BAM.Itinerary.xml”
Bm.exe deploy-all -DefinitionFile:”C:Program Files (x86)Microsoft BizTalk ESB Toolkit 2.0BamMicrosoft.BizTalk.ESB.BAM.Exceptions.xml”

This entry was posted in BizTalk, ESB. Bookmark the permalink.