Using Microsoft IIS

To configure Microsoft Internet Information Services (IIS) to use the load balancer plug-in, modify certain properties in Windows Internet Services Manager. The Internet Services Manager is located in the Administrative Tools folder in the Control Panel folder.

Make these modifications after installing the Sun Java System Application Server.

To Configure Microsoft IIS to use the 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 Application 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 Application Server install-dir/bin and the Application Server install-dir/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 Application 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\sun-passthrough.properties 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 sun-passthrough.properties. You can change the default values.