The BizTalk Accelerator for RosettaNet provides orchestrations, schemas, tools and related helper assemblies that allow you to exchange RosettaNet Implementation Framework (RNIF) documents with your trade partners. However, installing the accelerator can be difficult if you do not plan correctly for it.

Network topology considerations

The BizTalk Accelerator for RosettaNet sends and receives RNIF messages using intermediary ASP.NET pages that can be hosted on a separate server from your BizTalk installation. This allows you to host the send and receive pages in your DMZ, which communicate with the BizTalk server within your secured domain. If you run the accelerator installation on a machine that has IIS installed but does not have BizTalk installed, it will default to installing only the ASP.NET pages.

During this web page installation, you will be asked to enter the name of the BizTalk installation that these pages will be communicating with. This information is stored in the registry at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalk Accelerator for RosettaNet\<version number>\Configuration in the AsyncReceivePortURI and SyncReceivePortURI keys.  These point to the BTSHttpReceive.dlll hosted on the BizTalk Server installation. When receiving incoming documents, the RNIFReceive.aspx page will repost the message to the URL contained in these keys.

When installing the accelerator on the BizTalk machine, you will be asked to provide the name of the IIS server that the ASP.NET pages reside on. This information is stored in the registry at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalk Accelerator for RosettaNet\<version number>\Configuration in the RNIFSenderURI key.  Note that only the URL of the send page is stored here, as this is the only page that BizTalk Server will send outgoing documents to.

Platform considerations

If you are installing the accelerator on an x64 platform, see How to configure the BizTalk Accelerator for RosettaNet in x64 environments.

BizTalk considerations

If you are installing the Accelerator for RosettaNet on multiple machines, all of which are participating in a BizTalk Server group, you may need to create a new domain user.  This is because the accelerator has some specific host setting requirements that are incompatible with the "default" host settings that your existing BizTalk hosts may be using.  Specifically, the in-process and out of process hosts that the accelerator assemblies will run in must be marked as "Authentication Trusted".  This setting is off by default when you create a new host, and BizTalk will not allow you to use the same user account for both trusted and untrusted hosts.  So it is often easier/more desirable to create a new user account than switch all your existing hosts to trusted.

When installing the accelerator, it will install all the assemblies into the default BizTalk Application and will attempt to configure all orchestrations and ports to run in the first host it finds that is marked as "Authentication Trusted".  To ensure everything is installed to the host instances, temporarily make the trusted host instance as the default instance. If you want the assemblies to be in a different application than the default, create a new application in the BizTalk administration console and set it as the default during the installation.

 


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.