Windows Azure EAI and EDI Labs: Installation Step-By-Step

Windows Azure EAI and EDI Labs: Installation Step-By-Step

Introduction

Service Bus Connect is organized in two big modules:

  • Developer SDK
    • Windows 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: 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 & Tools
    • Windows 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: 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 installs the SQL Server library automatically.
  • Windows Server AppFabric 1.0 or 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 Developer SDK

  •     Initialize the process (.exe file)
  •     Accept the user licence terms

  • Select only the Developer SDK option

  • Click install

  • Finished

Install Service Bus Runtime Environment

  • Initialize installation (.exe file)
  • Accept user licence terms
  • Select only runtime & tools
  • Service Bus Connect installation is initialized
  • Select installation type (Recommend Complete)
  • Define the SQL Server  sysadmin credentials just as they are defined in Management Service Application Pool of IIS 7.0+
  • Define a path to the SQL Server instance that the Service Bus is going to. It will be something like: <ServerName>\<InstanceName>
  • Define a master key that will be used to encrypt the SQL Server database in use by the Service  (Random value - with significance)
  • Select the security certificate to use in Service Bus connections.
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
  • Service bus is installed
  • Select finish and it is done.

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
  • Go to File->New-> Project
  • In New Project, expand the C# option, go to Service Bus and select the option that best fits your demands, EDI project or EAI.
  • That's it.

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, functions like generating a schema instance or validating a schema, so usefull in BizTalk to test our maps.

My suggestion is that if you have it, use BizTalk in paralell 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 functions is because Azure EAI and EDI labs are still in a development stage, so I hope, this April version is much better than the first release so let's 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 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.
Leave a Comment
  • Please add 7 and 3 and type the answer here:
  • Post
Wiki - Revision Comment List(Revision Comment)
Sort by: Published Date | Most Recent | Most Useful
Comments
  • Naomi  N edited Revision 12. Comment: All articles look very much the same to me (and have the same typos)

  • Ed Price - MSFT edited Revision 10. Comment: Title casing, tag

Page 1 of 1 (2 items)
Wikis - Comment List
Sort by: Published Date | Most Recent | Most Useful
Posting comments is temporarily disabled until 10:00am PST on Saturday, December 14th. Thank you for your patience.
Comments
  • Ed Price - MSFT edited Revision 10. Comment: Title casing, tag

  • Naomi  N edited Revision 12. Comment: All articles look very much the same to me (and have the same typos)

Page 1 of 1 (2 items)