JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server 3.1-3.1.1 High Availability Administration Guide
search filter icon
search icon

Document Information


1.  High Availability in GlassFish Server

2.  Setting Up SSH for Centralized Administration

3.  Administering GlassFish Server Nodes

4.  Administering GlassFish Server Clusters

5.  Administering GlassFish Server Instances

6.  Administering Named Configurations

7.  Configuring Web Servers for HTTP Load Balancing

Supported Operating Systems and Web Servers

Configuring Oracle iPlanet Web Server

To Set up the HTTP Load Balancer in SSL Mode for Oracle iPlanet Web Server 7

Configuring Apache HTTP Server

Configuring Apache Before Installing the GlassFish Loadbalancer Plug-In

To Build and Install Apache With SSL Support

To Create a Security Certificate for Apache

Configuring Apache After Installing the GlassFish Loadbalancer Plug-In

Configuring Security Files to Work With the Load Balancer

Providing Access Permissions to Apache User

Loadbalancer Plug-In Initialization

Modifying Directory Access Permissions to Enable Auto Apply

Starting Apache on Solaris and Linux

Configuring Microsoft IIS

To Configure SSL for IIS 7.5+

Microsoft IIS 7.5+ Post-Install Configuration Steps

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

Automatically Configured sun-passthrough Properties

Configuring Oracle HTTP Server

To Configure Oracle HTTP Server to Use the Loadbalancer Plug-In

To Enable the Load Balancer Auto Apply Feature

Installing the Loadbalancer Plug-In

To Install the Loadbalancer Plug-In

Verifying Loadbalancer Plug-In Configuration

To Verify the Loadbalancer Plug-In Configuration

8.  Configuring HTTP Load Balancing

9.  Upgrading Applications Without Loss of Availability

10.  Configuring High Availability Session Persistence and Failover

11.  Configuring Java Message Service High Availability

12.  RMI-IIOP Load Balancing and Failover


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 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 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. See Auto Apply for more information about this feature.