Configuring GlassFish load-balancer plugin in IIS

IIS is supported web-server for installing load-balancer plugin for a long time. Sun GlassFish Enterprise Server comes with a installer which takes care of configuring load-balancer plugin on IIS. There are still some manual steps, but they are minimal.

In this blog, user will be provided with complete set of manual steps to configure load-balancer plugin on IIS.

Platform supported

  • Windows 2003 Enterprise Edition

Currently the load-balancer plugin is well tested on above mentioned platform. It may work on other windows platform, even though it is not tested on those platform.


IIS Version supported

  • IIS 6.0
  • IIS 5.0

These are tested version of IIS with load-balancer plugin


Download Location

The load-balancer plugin library can be downloaded from http://download.java.net/javaee5/external/WINNT/aslb/jars

The latest version of load-balancer plugin available is aslb-9.1.1-b7.jar. User can download any other latest version compared to above version, if available.


Steps to configure load-balancer plugin on IIS

Let me first put down steps which is automatically taken care of by installer when using Sun GlassFish Enterprise Server :

  1. User has already installed IIS and directory C:\\Inetpub\\wwwroot(or equivalent) exists. Now create a directory sun-passthrough under C:\\Inetpub\\wwwroot. From now on directory C:\\Inetpub\\wwwroot\\sun-passthrough will be referred to as <sun-passthrough-dir>.
  2. Download load-balancer plugin and unjar it. Then unzip SUNWaspx.zip and SUNWaslb.zip. This directory will be referred to as <lbplugin-unzip-dir>.
  3. Create directory
    1. <sun-passthrough-dir>\\errorpages
    2. <sun-passthrough-dir>\\resource
    3. <sun-passthrough-dir>\\sec_db_files
  4. Copy file - <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\sun-passthrough.dll to <sun-passthrough-dir>. Also change permission of the file to executable for IIS run-as user(IIS_WPG).
  5. Copy file - <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\sun-passthrough.properties to <sun-passthrough-dir>. Append following entries to the file :
    1. lb-config-file=<sun-passthrough-dir>\\loadbalancer.xml
    2. log-file=<sun-passthrough-dir>\\lb.log
    3. log-level=INFO
  6. Copy files - <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\errorpages\\default-error.html and <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\errorpages\\sun-http-lberror.html to <sun-passthrough-dir>\\errorpages directory.
  7. Copy files - <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\LBPluginDefault_root.res and <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\LBPlugin_root.res to <sun-passthrough-dir>\\resource directory.
  8. Copy files - <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\secmod.db, <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\cert8.db and <lbplugin-unzip-dir>\\lib\\webserver-plugin\\windows\\iis\\key3.db to <sun-passthrough-dir>\\sec_db_files directory.
  9. Copy file <lbplugin-unzip-dir>\\lib\\install\\templates\\loadbalancer.xml.example to <sun-passthrough-dir>\\loadbalancer.xml directory.
  10. Copy files - <lbplugin-unzip-dir>\\lib\\dtds\\sun-loadbalancer_1_1.dtd and <lbplugin-unzip-dir>\\lib\\dtds\\sun-loadbalancer_1_2.dtd to <sun-passthrough-dir> directory.

Manual steps that are needed even when using installer are well documented and are available at http://docs.sun.com/app/docs/doc/819-4740/abdhq?a=view
Note: In step 6, use <lbplugin-unzip-dir>\\lib instead of <application-server-install-dir\\bin and <application-server-install-dir\\lib as suggested in linked documentation.

User need to edit load-balancer xml(<sun-passthrough-dir>\\loadbalancer.xml) to reflect their cluster configuration. User can export load-balancer xml in DAS and then copy it to above mentioned location using following instructions.


Comments:

Kshitiz - any chance this works with IIS7 yet?

Posted by Jason Grey on April 07, 2009 at 05:20 AM PDT #

As of now IIS 7 is not supported as it is not tested with IIS7 till now.

Thanks,
Kshitiz

Posted by KSHITIZ SAXENA on April 07, 2009 at 04:33 PM PDT #

Hi...
Some success was reported with IIS7?
I will try tomorrow!!

Posted by AriGarcia on June 03, 2009 at 02:14 PM PDT #

Post a Comment:
  • HTML Syntax: NOT allowed
About

kshitiz

Search

Categories
Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today