Configuring Microsoft IIS

There are several Microsoft Internet Information Services (IIS) configuration steps you need to perform before and after installing the Loadbalancer Plug-In for GlassFish Server 3.1. The Loadbalancer Plug-In supports Microsoft IIS 7.5+ (32–bit). IIS 64–bit is supported if 32–bit application support is enabled in IIS.

The following topics are addressed here:

• To Configure SSL for IIS 7.5+

• Microsoft IIS 7.5+ Post-Install Configuration Steps

• Automatically Configured sun-passthrough Properties

To Configure SSL for IIS 7.5+

This procedure explains how to configure SSL on a Microsoft IIS 7.5+ server so it can work with the Loadbalancer Plug-In. Note that the load balancer Auto Apply feature is not supported in IIS, so this procedure is only required if you want to use IIS with SSL support for other reasons.

1. Open the Internet Services Manager in Microsoft IIS.
2. Under the host name in Nodes (above Application Pools), select Server Certificates and click Create a self-signed certificate in the Actions pane.
3. Select the Website to make the site Binding, and then click Add to add a new binding.
4. Select HTTPS and select the SSL Certificate from the list.
5. Select SSL Settings in Website and check Require SSL and Accept for client certificate.
6. Launch Browse HTTPS from Website and verify that the Welcome page launches.

   Internet Explorer (IE) 7 will display an error page because the self-signed certificate was issued by your computer, not by a trusted Certificate Authority (CA). IE 7 will trust the certificate if you add it to the list of Trusted Root Certification Authorities in the certificates store on the local computer or in Group Policy for the domain.

7. Click Continue to this Web Site (not recommended).
8. Proceed with the instructions in Installing the Loadbalancer Plug-In.

Microsoft IIS 7.5+ Post-Install Configuration Steps

This section explains the Microsoft IIS 7.5+ configuration steps that must be performed after installing the Loadbalancer Plug-In for GlassFish Server 3.1.

To Configure Microsoft IIS 7.5+ After Installing the GlassFish Loadbalancer Plug-In

1. Open the Microsoft IIS Server Manager.
2. Browse to Roles/Web Server.
3. Verify ISAPI extensions and ISAPI filters are installed under Role Services.

   If these role services are not installed, then you must install them.

4. Select the web site for which you want to enable the Loadbalancer Plug-In, and make the following changes.

   These changes can be made at the root level, affecting all web sites, or can be made for individual web sites.

   1. Enable 32–bit application pool support for 64–bit IIS.
      1. Right-click Application Pool and choose DefaultAppPool.
      2. Choose Advanced Settings.
      3. Set the Enable 32–bit Application option to True.
   2. Enable the ISAPI-dll Execute option.
      1. Choose Open Handler Mappings.
      2. Right-click Select ISAPI-dll, and then choose Edit Feature Permissions.
      3. Enable the Execute option.
   3. Add a new ISAPI filter.
      1. Open the ISAPI Filters tab.
      2. Click Add.
      3. In the Filter Name field, enter GF LB
      4. In the Executable field, type C:\Inetpub\wwwroot\sun-passthrough\sun-passthrough.dll.
   4. Set ISAPI and CGI restrictions.
      1. Open ISAPI and CGI Restriction.
      2. Click Add.
      3. For ISAPI and CGI path, browse to C:\inetpub\wwwroot\sun-passthrough\sun-passthrough.dll.
      4. For Description, enter GF LB
      5. Select the Allow extension path to execute checkbox.
   5. Create and configure a new virtual directory.
      1. Right-click on Web site, choose New, and then choose Virtual Directory.
      2. In the Alias field, type sun-passthrough .
      3. In the Physical Path field, type C:\Inetpub\wwwroot\sun-passthrough.
5. Create a new lb.log file.
   1. Exit the Internet Services Manager and browse to the C:\Inetpub\wwwroot\sun-passthrough directory.
   2. Create a text document named lb.log.
   3. Grant write permissions on the file to all users.
6. Add the absolute paths for the sun-passthrough.dll file and the C:\inetpub\glassfish-lbplugin\lib directory to the IIS server machine's PATH environment variable.
7. Restart the IIS server machine to allow the new PATH setting to take effect.
8. Verify that the web server, Loadbalancer Plug-In, and GlassFish Server are operating correctly.
   1. Start the Default Web Site that is managed by IIS.
   2. Launch a web browser and open the Default Web Site.

      The IIS Welcome page should display.

See Also

See Automatically Configured sun-passthrough Properties for a list of the properties that are automatically configured when you install the Loadbalancer Plug-In.

Automatically Configured sun-passthrough Properties

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