How to install the BizTalk Accelerator for RosettaNet 3.0 RNIFSend.aspx and RNIFReceive.aspx Web pages on a Windows 2000-based Web server or a Windows XP Professional-based Web server (898633)



The information in this article applies to:

  • Microsoft BizTalk Accelerator for RosettaNet 3.0 Standard Edition
  • Microsoft BizTalk Accelerator for RosettaNet 3.0 Enterprise Edition

Important This article contains information about how to modify the registry. Make sure to back up the registry before you modify it. Make sure that you know how to restore the registry if a problem occurs. For more information about how to back up, restore, and modify the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows registry

INTRODUCTION

The following Microsoft ASP.NET Web pages are included with the Microsoft BizTalk Accelerator for RosettaNet (BTARN) 3.0:
  • RNIFReceive.aspx
  • RNIFSend.aspx
This article discusses how to install and configure these Web pages on either a Microsoft Windows 2000-based computer or on a Microsoft Windows XP Professional-based computer.

MORE INFORMATION

When you install BTARN 3.0 on a Microsoft Windows Server 2003-based computer, the Setup program installs the RNIFReceive.aspx and RNIFSend.aspx Web pages. This behavior does not occur on either a Windows 2000-based computer or a Windows XP Professional-based computer because the Setup program requires Microsoft Internet Information Services (IIS) 6.0 application pools.

To install and configure the BTARN 3.0 RNIFReceive.aspx and RNIFSend.aspx Web pages on either a Windows 2000-based Web server or on a Windows XP Professional-based Web server, you must manually perform the installation. The following steps let you manually install the BizTalk Accelerator for RosettaNet 3.0 on an existing IIS 5.0 Web server. To perform the installation, follow these steps:

Warning Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require that you reinstall your operating system. Microsoft cannot guarantee that these problems can be solved. Modify the registry at your own risk.
  1. Make sure that you have installed the Microsoft .NET Framework 1.1 on your new Web server.
  2. Copy the contents of the RNApp folder from the installation folder that is on the Windows Server 2003-based server to a folder on the hard disk drive of your new Web server. For example, copy the contents of the folder to the C:\RNApp folder. Typically, these contents are located in the following folder:

    C:\Program Files\Microsoft BizTalk Accelerator for RosettaNet 3.0

    Note You can also copy the contents of the RNApp folder from the original BizTalk Accelerator for RosettaNet 3.0 installation CD.
  3. Under the new folder, change the <identity/> element in the Web.config file to the following element:
    <identity impersonate="true"/>
    Note This change enables the use of the IUSR_MACHINE account that is used to access the performance counters.
  4. On the new Web server, start Internet Information Services Manager.
  5. In Internet Information Services Manager, create a new virtual directory that is named BTARNApp, and then point the new BTARNApp virtual directory to the folder that you created in step 2 (C:\RNApp).
  6. Paste the following registry entries in Notepad:
    Windows Registry Editor Version 5.00
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalk Accelerator for RosettaNet\3.0\Configuration]
    "HttpReceiverSiteId"=dword:00000001
    "AsyncReceivePortURI"="http://myBizTalkServer:80/BTARNHttpReceive/BTSHTTPReceive.dll?xRNResponseType=async"
    "SyncReceivePortURI"="http://myBizTalkServer:80/BTARNHttpReceive/BTSHTTPReceive.dll?xRNResponseType=sync"
    "SiteId"=dword:00000001
     
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Eventlog\Application\BizTalk Accelerator for RosettaNet]
    "EventMessageFile"="C:\\WINDOWS\\Microsoft.NET\\Framework\\v1.1.4322\\EventLogMessages.dll" 

    Note Replace myBizTalkServer with the name of your new Web server, and make sure that the path name of the .NET Framework 1.1 is correct.
  7. Save the file as BTARN.reg.
  8. In Windows Explorer, double-click the BTARN.reg file to enter the keys in the registry on the new Web server. Click Yes.
  9. On the Microsoft BizTalk Server host computer, you must change a registry entry to point to the new Web server. Locate and then change the following registry entry to point to the new Web server:
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalk Accelerator for RosettaNet\3.0\Configuration] 
    "RNIFSenderURI"="http://myBizTalkWebServer:80/BTARNApp/RNIFSend.aspx"
    Note Replace myBizTalkWebServer with the name of your new Web server.
  10. Locate the Microsoft.Solutions.BTARN.Shared.dll file on the Windows Server 2003-based server. This file is in the Bin subfolder of the BTARN 3.0 installation folder. Typically, this file is located in the following folder:

    C:\Program Files\Microsoft BizTalk Accelerator for RosettaNet 3.0\Bin

    Copy this file to a folder that is under the Program Files folder on your new Web server. For example, copy the Microsoft.Solutions.BTARN.Shared.dll file to the C:\Program Files\BTARN\ folder.

    Note You can also copy the file from the original BizTalk Accelerator for RosettaNet 3.0 installation CD.
  11. Register the Microsoft.Solutions.BTARN.Shared.dll file in the global assembly cache on the new Web server. To do this, use one of the following methods:
    • Copy the file to the C:\Windows\Assembly folder.
    • At the Microsoft Visual Studio .NET Command Prompt, run the following commands:

      GACUtil /if Microsoft.Solutions.BTARN.Shared.dll

      regasm Microsoft.Solutions.BTARN.Shared.dll

  12. Install performance counters for the ASP.NET Web page by running the following Microsoft Visual Basic Script (.vbs) file on the new Web server:
    'install.vbs
    set pci = createobject("Microsoft.Solutions.BTARN.Shared.PerformanceCountersInstaller")
    pci.Install()
    

REFERENCES

For more information about the BizTalk Accelerator for RosettaNet 3.0, visit the following Microsoft Web site:

Modification Type:MajorLast Reviewed:9/30/2005
Keywords:kbhowto kbBTSAccelerators kbinfo KB898633 kbAudDeveloper kbAudITPRO