Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide

Modifications to 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.

ProcedureTo 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 sun-passthrough.dll file and application_server_install_dir /bin to the system’s PATH environment variable.

  7. Restart the machine.

  8. Stop and start the web server for the new settings to take effect.

    To stop the web server, right click on the web site and select Stop . To start the web server, right click on the web site and select Start.

  9. 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://webserver_name/web_application, where webserver_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.

Automatically configured Sun-passthrough properties

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

Property 

Definition 

Default Value 

lb-config-file 

Path to the load balancer configuration file 

IIS_www_root\sun-passthrough\loadbalancer.xml

log-file 

Path to the load balancer log file 

IIS_www_root\sun-passthrough\lb.log

log-level 

Log level for the web server 

INFO