Table of Contents

Recently there was a chance to install and configure the ESB Tool Kit and ESB Management portal in multi-server environment.


Below are the steps to successfully configure and deploy the ESB Management portal.

  1. Install Enterprise Library 5 from
  2. Install Chart Control from Microsoft Chart Controls for .NET Framework 4 & Framework 3.5.
  3. Install Microsoft Report Viewer Redistributable 2008 from
  4. Copy the ESB portal source code from the development server in C:\Projects folder and Remove the read-only attribute of this folder.
  5. Update database server name in the web config file of ESB portal (located in “C:\Projects\Microsoft.Practices.ESB\ESBSource\Source\Samples\Management Portal\ESB.Portal\Web.Config”).
  6. Update Database server name in web config of ESB Exception Service (Located in “C:\Projects\Microsoft.Practices.ESB\ESBSource\Source\Samples\Management Portal\ESB.Exceptions.Service\ESB.Exceptions.Service\Web.config”).
  7. To turn on unrestricted access for PowerShell, execute the following command using the PowerShell 32-bit and 64-bit consoles: set-executionpolicy unrestricted. To verify, run the following command get-executionpolicy.
    1. Note: If you face any issue with above script, use “Set-ExecutionPolicy Unrestricted -Scope CurrentUser”.
  8. Go to the C:\Projects\Microsoft.Practices.ESB\ESBSource\Source\Samples\Management Portal\Install\Scripts location and edit Management_Install.ps1 script.
  9. Comment the [BuildManagementSolution] function of PowerShell script. (This is required because there is no need to build the solution again).
  10. Update the [RunDatabaseScript $relativePath”\SQL\ESB.Administration Database.sql” “Database server Name“] command. (This is required because it will try to create the database in local server).
  11. Step 10 is only required for first server configuration. Later comment out this line of the script for the other server (This is because SQL Server will be the same for both BizTalk instances).
  12. Open a command prompt using “Run as administrator”.
  13. Execute the Management_Install.cmd  command located in “C:\Projects\Microsoft.Practices.ESB\Source\Samples\ManagementPortal\Install\Scripts”.
  14. Open the IIS manager, select the ESB portal and check the authorization. If all is fine, browse the ESB portal directly from here.
  15. If an error occurred, change the authorization and app pool setting by checking user access.

Repeat the same step to the other server.

Note: Multi-Server Environment – (Two BizTalk Server and one SQL Server)

See Also

Another important place to find a huge amount of BizTalk related articles is the TechNet Wiki itself. The best entry point is BizTalk Server Resources on the TechNet Wiki.