Sun GlassFish Enterprise Server v2.1.1 High Availability Administration Guide

Using Microsoft IIS

To use Microsoft Internet Information Services (IIS) with the load balancer plug-in, follow the steps provided in these sections.

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.

Automatically configured sun-passthrough properties

The installer automatically configures the following properties in You can change the default values.



Default Value 


Path to the load balancer configuration file 



Path to the load balancer log file 



Log level for the web server 


Note –

The Auto Apply feature is not currently supported with IIS.