Click to Rate and Give Feedback
MSDN
MSDN Library
BizTalk Server
BizTalk Server 2009
Operations
Using Adapters
HTTP Adapter
 How to Configure IIS for an HTTP Re...

  Switch on low bandwidth view
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 Windows Server 2003 or Windows Server 2008, IIS 6.0 and IIS 7.0 provide two different application isolation modes to protect Web applications. Worker process isolation mode is the default mode, but IIS 5.1 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,MSDN.10).gifNote
If your operating system is the x64 edition of Microsoft Windows Server 2003 or Windows Server 2008, the 64-bit version of the HTTP receive adapter is installed to the <drive> \Program Files (x86)\Microsoft BizTalk Server 2009\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,MSDN.10).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,MSDN.10).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.

  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 2009\HttpReceive directory (or <drive>:\Program Files (x86)\Microsoft BizTalk Server 2009\HttpReceive64 directory on 64 bit machines), select BTSHTTPReceive.dll, click Open, and then click OK.

    Aa559072.note(en-us,MSDN.10).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,MSDN.10).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 2009\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.

  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, select the root Web server entry. In the Features View, double-click Handler Mappings, and then in the Actions pane, click Add Script Map.

    Aa559072.note(en-us,MSDN.10).gifNote
    Configuring the script mapping at the Web server level will cause this mapping to apply to all child Web sites. If you want to restrict the mapping to a specific Web site or virtual folder, select the target site or folder instead of the Web server.

  5. In the Add Script Map dialog box, in the Request path field, type BtsHttpReceive.dll.

  6. In the Executable field, click the ellipsis () button and browse to drive:\Program Files\Microsoft BizTalk Server 2009\HttpReceive. Select BtsHttpReceive.dll and then click OK.

  7. In the Name field, type BizTalk HTTP Receive, and then click Request Restrictions.

  8. In the Request Restrictions dialog box, click the Verbs tab and then select One of the following verbs. Enter POST as the verb.

  9. On the Access tab, select Script, and then click OK.

  10. When prompted to allow the ISAPI extension, click Yes.

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

  12. In the Add Application Pool dialog box, in the Name box, type a name for the application pool. Select NET Framework 2.0.50727 and then click OK.

    Aa559072.note(en-us,MSDN.10).gifNote
    The version number may vary depending on the version of .NET Framework 2.0 installed on the computer.

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

  13. In Application Pools, in the Features View, select the new application pool, and then click Advanced Settings in the Actions pane.

  14. In the Advanced Settings dialog box, in the Process Model section, in the Identity field, click the ellipsis () button.

  15. In the Application Pool Identity dialog box, select Custom account, and then click Set. Click OK to close the Advanced Settings dialog box.

  16. In IIS Manager, open the Sites folder. Right-click the Default Web Site and then click Add Application.

  17. In the Add Application dialog box, in Alias, enter an alias to associate with the application, and then click Select.

  18. In the Select Application Pool dialog box, select the new application pool you created earlier, and then click OK.

  19. Click the ellipsis () button and browse to drive:\Program Files\Microsoft BizTalk Server 2009\HttpReceive for the Physical path.

  20. Click Connect As and enter the User name and Password for a user account that is a member of the Administrators group, and then click OK.

  21. Click Test Settings and verify that no errors are displayed in the Test Connection dialog box. Click Close, and then click OK.

  22. The new application appears in the list of Default Web Sites in Internet Information Services (IIS) Manager.

Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker