Share via

Azure EAI and EDI Labs - Installation (Part 2/2 - SB Runtime Tools) - Step-by-Step

  • Article

Introduction

Service Bus Connect is organized in two big modules:

  • Developer SDK
    • Azure Service Bus EAI and EDI Labs (EAI): Previously installed, which means that installing the Azure Service Bus EAI and EDI Labs we can install the whole bundle needed to start working.
    • Microsoft WCF LOB Adapter SDK 2010: It is a requirement to use the Microsoft BizTalk Adapter Pack 2010.
    • Microsoft BizTalk Adapter Pack 2010: Needed if our app will send messages to LOB on-premises systems like SAP, SQL Server, Oracle e Siebel.
  • Runtime & Tools
    • Azure Service Bus EAI and EDI Labs (EAI): Previously installed, which means that by installing the Azure Service Bus EAI and EDI Labs we can install the whole bundle needed to start working.
    • Microsoft WCF LOB Adapter SDK 2010: Its a requirement to use the Microsoft BizTalk Adapter Pack 2010.
    • Microsoft BizTalk Adapter Pack 2010: Needed if our app will send messages to LOB on-premises systems like SAP, SQL Server, Oracle e Siebel.
    • Runtime Service: Runs on-premise to manage all communications between local LOB systems and the EAI apps running in Service Bus.
    • PowerShell: Extensions to manage Service Bus Connect Runtime components.

As we can check some components are common in Developer SDK and Runtime&Tools, this is because in a normal business environment we assume that is going to exist a machine to develop the applications and another to have them running.

System requirements

  • Windows Server 2008 R2 or Windows 7 (Professional or +)
  • .NET Framework 4 or superior.
  • Microsoft Visual Studio 2010.
  • Microsoft Visual C# .NET
  • SQL Server
  • LOB Server client libraries (To establish the communications with the LOB target that we want. Net framework 4 install the SQL Server library automatically.
  • Windows Server AppFabric 1.0 ou 1.1
  • AppFabric needs:
    • Installing the KB980423 hotfix for windows in order to fix some AppFabric and IIS bugs. This must be done after the installation of appfabric
    • Uninstall any previous appfabric version
    • IIS 7.0 or superior
      • After installing go to : “Turn windows features on or off” (use windows search text box to do it faster) and activate:
        • IIS Metabase and IIS 6 configuration compatibility
        • Windows Authentication
    • Insure the following:
      • We are local network administrators
      • We have permission to create SQL server databases using dbo schema.
      • We have administration roles in IIS manager

Install Service Bus Runtime Environment

  • Initialize installation (.exe file)
  • Accept user licence terms

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_1.jpg

  • Select only runtime & tools

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_2.jpg

  • Service Bus Connect installation is initialized

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_3.jpg

  • Select installation type (Recommend Complete)

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_4.jpg

  • Define the SQL Server sysadmin credentials just as they are defined in Management Service Application Pool of IIS 7.0+

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_5.jpg

  • Define a path to the SQL Server instance that the Service Bus is going to. It will be something like: <ServerName>\InstanceName>

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_6.png

  • Define a master key that will be used to encrypt the SQL Server database in use by the Service (Random value - with significance)

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_7.jpg

  • Select the security certificate to use in Service Bus connections.

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_8.jpg

Selecting the “Use SSL to secure the management service” checkbox is in order to allow service bus to encrypt hhtp requests with SSL. Must be selected. We can use an existing certificate in IIS personal storage. I advise you to use this option in production data, while for testing we should create a new one. In this last option we just need to provide a certificate name. By default the connection port is 8080, we must check if the firewall has this port opened.

  • Click install

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_8.jpg

  • Service bus is installed

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_9.png

  • Select finish and it is done.

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_ServiceBus_Runtime/1_10.jpg

With this last step the process is finished and now we are ready to use Visual Studio to create our Service Bus EAI and EDI projects.

Creating a Visual Studio Project

To create a new project you just need to:

  • Start Visual Studio

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_VS_EAIproject/1.jpg

  • Go to File->New-> Project

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_VS_EAIproject/2.jpg

  • In New Project, expand the C# option, go to Service Bus and select the option that best fits your demands, EDI project or EAI.

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_VS_EAIproject/3.jpg

  • That's it .

http://dl.dropbox.com/u/9893747/__NOT%20MOVE__/WA_Labs_VS_EAIproject/4.jpg

The EAI environment to work on Visual Studio project is very similar to BizTalk 2010, however some functions won't be available in Windows Azure eai and edi labs, functionalities like generating a schema instance or validating a schema, so useful in BizTalk to test our maps.

My suggestion is that if you have it, use BizTalk in parallel with your eai and edi project and with this have all functionalities by your side, this because testing bridges deployed in the azure cloud can be quite complicated because errors returned by the debug console are insufficient. To insure that errors are not in our schemas or maps we should use BizTalk server.

This lack of functionalities is because Azure EAI and EDI labs is still in a development stage, so I hope, this April version is much better than the first release so lets hope some other release brings us the full package.

Thanks,
Rui Pedro Machado

I was recruited by Sandro Pereira!

See Also

Another important place to find a huge amount of Windows Azure BizTalk Services related articles is the TechNet Wiki itself. The best entry point is Windows Azure BizTalk Services resources on the TechNet Wiki.

If you are also looking for BizTalk Server related articles, the best entry point is BizTalk Server Resources on the TechNet Wiki.