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+
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
- Open the Internet Services Manager in Microsoft IIS.
- Under the host name in Nodes (above Application Pools), select Server Certificates
and click Create a self-signed certificate in the Actions pane.
- Select the Website to make the site Binding, and then click
Add to add a new binding.
- Select HTTPS and select the SSL Certificate from the list.
- Select SSL Settings in Website and check Require SSL and Accept for client
- 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.
- Click Continue to this Web Site (not recommended).
- 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
- Open the Microsoft IIS Server Manager.
- Browse to Roles/Web Server.
- Verify ISAPI extensions and ISAPI filters are installed under Role Services.
If these role services are not installed, then you must install them.
- 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.
- Enable 32–bit application pool support for 64–bit IIS.
- Right-click Application Pool and choose DefaultAppPool.
- Choose Advanced Settings.
- Set the Enable 32–bit Application option to True.
- Enable the ISAPI-dll Execute option.
- Choose Open Handler Mappings.
- Right-click Select ISAPI-dll, and then choose Edit Feature Permissions.
- Enable the Execute option.
- Add a new ISAPI filter.
- Open the ISAPI Filters tab.
- Click Add.
- In the Filter Name field, enter GF LB
- In the Executable field, type C:\Inetpub\wwwroot\sun-passthrough\sun-passthrough.dll.
- Set ISAPI and CGI restrictions.
- Open ISAPI and CGI Restriction.
- Click Add.
- For ISAPI and CGI path, browse to C:\inetpub\wwwroot\sun-passthrough\sun-passthrough.dll.
- For Description, enter GF LB
- Select the Allow extension path to execute checkbox.
- Create and configure a new virtual directory.
- Right-click on Web site, choose New, and then choose Virtual Directory.
- In the Alias field, type sun-passthrough .
- In the Physical Path field, type C:\Inetpub\wwwroot\sun-passthrough.
- Create a new lb.log file.
- Exit the Internet Services Manager and browse to the C:\Inetpub\wwwroot\sun-passthrough directory.
- Create a text document named lb.log.
- Grant write permissions on the file to all users.
- 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.
- Restart the IIS server machine to allow the new PATH setting to take
- Verify that the web server, Loadbalancer Plug-In, and GlassFish Server are operating correctly.
- Start the Default Web Site that is managed by IIS.
- Launch a web browser and open the Default Web Site.
The IIS Welcome page should display.
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.
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. See Auto Apply
for more information about this feature.