How to Configure IIS for an HTTP Receive Location

Depending on which version of Microsoft Windows you are using, you will have to configure Microsoft Internet Information Services (IIS) differently to work with the HTTP adapter receive location.

If your operating system is Microsoft Windows Server 2003, IIS 6.0 provides two different application isolation modes to protect Web applications. Worker process isolation mode is the default mode, but IIS 5.0 is also provided for backward compatibility. You can configure the HTTP adapter receive location to work with either mode, but worker process isolation mode is recommended for its improved security functionality.

Aa559072.note(en-us,BTS.20).gifNote
If your operating system is the x64 edition of Microsoft Windows Server 2003, the 64-bit version of the HTTP receive adapter is installed to the <drive> \Program Files (x86)\Microsoft BizTalk Server 2006\HttpReceive64 directory of your BizTalk server by default. To run the 64-bit version of the HTTP receive adapter in 64-bit native mode you must execute the following script from a command line:

cscript %SystemDrive%\inetpub\AdminScripts\adsutil.vbs set w3svc/AppPools/Enable32bitAppOnWin64 0

C:\WINDOWS\Microsoft.NET\Framework64\vX.X.XXXXX>aspnet_regiis.exe -i

Aa559072.note(en-us,BTS.20).gifNote
All editions of BizTalk Server 2000, BizTalk Server 2002, and BizTalk Server 2004 can be installed on an x64 operating system but only the BizTalk Server 2006 Enterprise and BizTalk Server 2006 Developer editions support running a BizTalk Server 2006 host instance using native 64-bit execution.

If your operating system is Windows 2000 Server, you must use IIS 5.0 isolation mode, and configure your HTTP receive location accordingly.

For more information about isolation modes, see http://go.microsoft.com/FWLink/?LinkID=16726.

Aa559072.note(en-us,BTS.20).gifNote
Any IIS configuration that leads to SOAP and HTTP sharing the same process is not valid. You can have only one isolated receiver per process.

To configure the IIS 6.0 worker process isolation mode to work with the HTTP adapter receive location

  1. Click Start, point to Settings, and then click Control Panel.

  2. In Control Panel, double-click Administrative Tools.

  3. In Administrative Tools, double-click Internet Information Services.

  4. In Internet Information Services (IIS) Manager, right-click Web Service Extensions, and then click Add a new Web service extension.

  5. In the New Web Service Extension dialog box, do the following.

    Use this To do this

    Extension Name

    Type the name of the new Web service extension.

    Required files

    Click Add, and then click Browse. Browse to the <drive>:\Program Files\Microsoft BizTalk Server 2006\HttpReceive directory (or <drive>:\Program Files (x86)\Microsoft BizTalk Server 2006\HttpReceive64 directory on 64 bit machines), select BTSHTTPReceive.dll, click Open, and then click OK.

    Aa559072.note(en-us,BTS.20).gifNote
    If you receive an error stating that the file is already required by HWSMessages HTTPReceive, you can cancel this operation because the HTTP receive adapter already exists and was created for Human Workflow Services.

    Set extension status to Allowed

    Select this check box.

  6. Click OK.

  7. Right-click Application Pools, point to New, and then click Application pool.

  8. In the Add New Application Pool dialog box, in the Application pool ID box, type a name for the application pool, and then click OK.

    The new application pool appears in the list of Application Pools.

  9. Right-click the new application pool, and then click Properties.

  10. In the <Application Pool name> Properties dialog box, on the Identity tab, do the following.

    Use this To do this

    Configurable

    Select this property.

    User name

    Type a user name for the BizTalk Isolated Hosts group and the IIS_WPG group.

    This user account must have access to the BizTalk Management database, so do not create the application pool to run under the IWAM_<servername> user account, which is the default.

    Aa559072.note(en-us,BTS.20).gifNote
    The BizTalk Management database is also referred to as the BizTalk Configuration database.

    Password

    Type the password for the user.

  11. Click OK.

  12. Expand the Web Sites node, right-click the Default Web Site node, point to New, and then click Virtual Directory.

  13. In the Virtual Directory Creation Wizard, on the Welcome page, click Next.

  14. On the Virtual Directory Alias page, in the Alias box, type the alias to associate with the virtual directory, and then click Next.

  15. On the Web Site Content Directory page, click Browse.

  16. In the Browse For Folder dialog box, navigate to the <drive>:\Program Files\Microsoft BizTalk Server 2006\HttpReceive directory, click OK, and then click Next.

  17. On the Access Permissions page, select Read and Execute, clear all other check boxes, and then click Next.

  18. On the Completion page, click Finish to close and complete the wizard.

    The new virtual directory appears under the list of Default Web Sites in Internet Information Services (IIS) Manager.

  19. Right-click the virtual directory, and then click Properties.

  20. In the <Virtual Directory> Properties dialog box, on the Virtual Directory tab, do the following.

    Use this To do this

    Execute Permissions

    Ensure that the property is set to Scripts and Executables.

    Application Pool

    Select the new application pool created earlier in this procedure.

  21. Click OK.

  22. On the File menu, click Exit.

To configure the IIS 5.0 isolation mode to work with the HTTP adapter receive location

  1. Click Start, and then click Control Panel.

  2. In Control Panel, double-click Administrative Tools.

  3. In Administrative Tools, double-click Internet Information Services.

  4. In Internet Information Services, expand <computer name> (local computer), and Web Sites.

  5. Right-click Default Web Site, point to New, and then click Virtual Directory.

  6. In the Virtual Directory Creation Wizard, on the Welcome page, click Next.

  7. On the Virtual Directory Alias page, in the Alias box, type the alias to associate with the virtual directory, and then click Next.

  8. On the Web Site Content Directory page, click Browse.

  9. In the Browse For Folder dialog box, browse to the <drive>:\Program Files\Microsoft BizTalk Server 2006\HttpReceive directory, click OK, and then click Next.

  10. On the Access Permissions page, select Read and Execute, clear all other check boxes, and then click Next.

  11. On the Completion page, click Finish to close and complete the wizard.

    The new virtual directory appears under the list of Default Web Sites in Internet Information Services.

  12. Right-click the virtual directory, and then click Properties.

  13. In the <Virtual Directory> Properties dialog box, on the Virtual Directory tab, do the following.

    Use this To do this

    Execute Permissions

    Ensure that the property is set to Scripts and Executables.

    Application Protection

    Change the value of the property to High (Isolated) or Medium (Pooled).

    Medium is not recommended because it imposes a security risk by opening BizTalk databases to all the IIS applications that run with that protection level.

    Setting this property to High creates a separate COM+ application to host the virtual directory. Setting this property to Medium means that the virtual directory is hosted by the IIS Out-Of-Process Pooled Applications.

  14. Click OK.

  15. On the File menu, click Exit.

  16. Change to the Administrative Tools window, and double-click Component Services.

  17. In the Component Services window, expand Component Services, expand Computers, expand My Computer, and then expand COM+ Applications.

  18. If the Application Protection property is set to Medium, right-click IIS Out-of-Process Pooled Applications, and then click Properties.

    –Or–

    If the Application Protection property is set to High, right-click IIS_{Default Web Site//root/virtual directory name}, and then click Properties.

  19. Right-click the virtual directory and then click Properties.

  20. On the Identity tab, configure the account properties for the user that belongs to the BizTalk Isolated Host Users group. This user account must have access to the BizTalk Management database, so do not create the application pool to run under the IWAM_<server name> user account, which is the default.

  21. Create an HTTP receive location using BizTalk Explorer. Specify the Virtual directory plus ISAPI extension property to be equal to /<virtual directory>/BTSHTTPReceive.dll<query string>. For instructions about configuring the HTTP receive location, see How to Configure an HTTP Receive Location.

See Also

Tasks

How to Configure an HTTP Receive Location

Tags :


Page view tracker