BizTalk HOW TO: Configure ESB Toolkit For Starters

Since there are not any VMs that you can simply download and get up and running with quickly, I decided to put together a quick and dirty installation guide for installing the Toolkit on a single server in a 32-bit virtualized environment for evaluation purposes. What follows are the steps to get you from 0 to ESB with all of the sample applications.

1. Install the Pre-Requisite Components
   • Microsoft Windows Server 2008 or Windows Server 2003 (except Web Editions) operating system
   • Internet Information Services (IIS) 7.0 with IIS 6.0 extensions or IIS 6.0 (used for Web services and the ESB Management Portal)
   • Microsoft SQL Server 2008 or Microsoft SQL Server 2005
   • Microsoft BizTalk Server 2009 Enterprise Edition, including Business Activity Monitoring (BAM)
   • Microsoft Visual Studio 2008 SP1 (required on development computers)
   • Microsoft UDDI Services 3 (required by UDDI resolver and dependent samples)
   • .NET Framework 3.5 SP1
   • Microsoft Chart Controls for Microsoft .NET Framework 3.5
   • Enterprise Library 4.1
   • Microsoft Visual Studio 2008 Software Development Kit (SDK) 1.1 (required by the Itinerary Designer when installing from source code) [optional]
2. Install the main MSIs (Docs/Toolkit x86)
   • Currently available for download here.
3. Import/Install C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Microsoft.Practices.ESB.ExceptionHandling.msi
4. Import/Install C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Microsoft.Practices.ESB.CORE.msi
5. Give SQL Service account permissions to all of the BAM related databases
6. Using the bm.exe tool, deploy the BAM Activities located at C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Bam
   • bm deploy-all -DefinitionFile:"C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Bam\Microsoft.BizTalk.ESB.BAM.Exceptions.xml"
   • bm deploy-all -DefinitionFile:"C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Bam\Microsoft.BizTalk.ESB.BAM.Itinerary.xml"
7. Run C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Bin\ESBConfigurationTool.exe
   • You have to apply settings on each page before continuing to the next page
8. Run C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\Bin\Microsoft.Practices.ESB.UDDIPublisher.exe
   • If errors, uncheck Require SSL setting in UDDI3 MMC
9. Extract C:\Program Files\Microsoft BizTalk ESB Toolkit 2.0\ESBSource.zip to C:\Projects\Microsoft.Practices.ESB\
10. Create snk at C:\Projects\Microsoft.Practices.ESB\Keys\ [command below requires Visual Studio Command Prompt]
    • sn -k Microsoft.Practices.ESB.snk
11. Mark C:\Projects\Microsoft.Practices.ESB\ as NOT read-only
12. Run the command below
    • powershell Set-ExecutionPolicy unrestricted
13. Run the command below
    • C:\Projects\Microsoft.Practices.ESB\Source\Samples\DynamicResolution\Install\Scripts\Setup_bin.cmd
14. Run the command below
    • C:\Projects\Microsoft.Practices.ESB\Source\Samples\Itinerary\Install\Scripts\Setup_bin.cmd
15. Run the command below
    • C:\Projects\Microsoft.Practices.ESB\Source\Samples\MultipleWebServices\Install\Scripts\Setup_bin.cmd
16. Repeat for remaining samples (setup_bin.cmd or SampleName_Install.cmd for each)
17. Open the Visual Studio solution named ESB.Portal.sln from the C:\Projects\Microsoft.Practices.ESB\Source\Samples\Management Portal\ESB.Portal folder, and then make sure that the section of the Web.config file contains the correct connection strings for the ESBAdmin database.
18. Open C:\Projects\Microsoft.Practices.ESB\Source\Samples\Management Portal\ESB.AlertService\ESB.AlertService.sln, and change TargetPlatform property of the Setup project to x86.
19. Build C:\Projects\Microsoft.Practices.ESB\Source\Samples\Management Portal\ESB.AlertService\ESB.AlertService.sln
20. Build C:\Projects\Microsoft.Practices.ESB\Source\Samples\Management Portal\ESB.UDDI.PublisherService\ESB.UDDI.PublisherService.sln
21. Run C:\Projects\Microsoft.Practices.ESB\Source\Samples\Management Portal\ESB.AlertService.Install\Debug\setup.exe
22. Run C:\Projects\Microsoft.Practices.ESB\Source\Samples\Management Portal\ESB.UDDI.PublisherService.Install\Debug\setup.exe
23. Use the My Settings page in the portal to configure the main portal settings
    • Default URL: http://localhost/ESB.Portal/PortalSettings.aspx
24. Configure the settings on the Fault Settings page in the portal
    • Default URL: http://localhost/ESB.Portal/Admin/Configuration.aspx
25. Configure the settings on the Registry Settings page in the portal
• Default URL: http://localhost/ESB.Portal/Uddi/UDDIAdmin.aspx.

Once you have the BizTalk ESB Toolkit 2.0 installed, I would recommend you read the following documents (in order) in the official documentation to give you a tour of what all is there, and even get fairly deep into the inner-workings of the Toolkit, and extensibility opportunities:

• Overview of the BizTalk ESB Toolkit

• Architecture of the BizTalk ESB Toolkit

• Itinerary-Based Routing

• BizTalk ESB Toolkit Message Life Cycle

• The ESB Management Portal and Fault Message Viewer

• Prerequisites for the Development Activities

• Development Activities

• Running the Itinerary On-Ramp Sample

• Installing and Running the Scatter-Gather Sample

• Installing and Running the Multiple Web Services Sample

• The ESB Itinerary Selector Component

• The ESB Itinerary Forwarder Component

• The ESB Dispatcher Component [Most of the magic of ESB happens here]

• Implementing Design Patterns in Itineraries

• Creating a Custom Itinerary Service