Sun GlassFish Enterprise Server 2.1 High Availability Administration Guide

ProcedureTo Configure Microsoft IIS to use the HTTP Load Balancer Plug-in

  1. Open the Internet Services Manager.

  2. Select the web site for which you want to enable the plug-in.

    This web site is typically named the Default Web Site.

  3. Right click on the web site and select Properties to open the Properties notebook.

  4. Add a new ISAPI filter, following these steps:

    1. Open the ISAPI Filters tab.

    2. Click Add.

    3. In the Filter Name field, enter Enterprise Server

    4. In the Executable field, type C:\Inetpub\wwwroot\sun-passthrough\sun-passthrough.dll.

    5. Click OK, and close the Properties notebook.

  5. Create and configure a new virtual directory:

    1. Right click on the default web site, select New, and then Virtual Directory.

      The Virtual Directory Creation Wizard opens.

    2. In the Alias field, type sun-passthrough .

    3. In the Directory field, type C:\Inetpub\wwwroot\sun-passthrough.

    4. Check the Execute Permission checkbox.

      Leave all other permission-related check boxes are left unchecked.

    5. Click Finish.

  6. Add the path of the sun-passthrough.dll file, the Enterprise Server as-install/bin and the Enterprise Server as-install/lib to the system’s PATH environment variable.

  7. For IIS 6.0 users, configure the Load Balancer Web Service Extension to run in IIS 6 using the following steps:

    1. In the IIS manager, expand the local computer, and click Web Service Extensions.

    2. In the Tasks pane, select Add a new Web Service Extension.

    3. Enter the name of the Extension as Sun-Passthrough and click Add.

    4. Type the path to sun-passthrough.dll, C:\Inetpub\wwwroot\sun-passthrough.

    5. Click OK.

    6. Select Set extension status to Allowed.

  8. For IIS 6.0 users, create the file C:\inetput\wwwroot\sun-passthrough\lb.log and give NTFS write and modify permissions to the group IIS_WPG on the file.

    Because IIS 6.0 runs in Worker Process Isolation Mode, it runs the IIS server with the security privileges of the group IIS_WPG.

  9. For all IIS users, restart the machine.

  10. Verify that the web server, load balancer plug-in, and Enterprise Server are operating correctly.

    Type the following in a web browser to access the web application context root: http://web-server-name/web-application, where web-server-name is the host name or IP address of the web server and web-application is the context root that you listed in the C:\Inetpub\wwwroot\sun-passthrough\ file.

    Tip –

    The ISAPI filter status should be green. To check the filter status, access the web site's Properties notebook and click the ISAPI Filters tab. If the status is not green, try sending any HTTP request to the IIS HTTP port. It is OK if the request fails. Recheck the ISAPI filter status.