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 :
- 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>.
- Download load-balancer plugin and unjar it. Then unzip SUNWaspx.zip and SUNWaslb.zip. This directory will be referred to as <lbplugin-unzip-dir>.
- Create directory
- <sun-passthrough-dir>\errorpages
- <sun-passthrough-dir>\resource
- <sun-passthrough-dir>\sec_db_files
- 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).
- Copy file -
<lbplugin-unzip-dir>\lib\webserver-plugin\windows\iis\sun-passthrough.properties
to <sun-passthrough-dir>. Append following entries to the file :
- lb-config-file=<sun-passthrough-dir>\loadbalancer.xml
- log-file=<sun-passthrough-dir>\lb.log
- log-level=INFO
- 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.
- 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.
- 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.
- Copy
file
<lbplugin-unzip-dir>\lib\install\templates\loadbalancer.xml.example
to <sun-passthrough-dir>\loadbalancer.xml directory.
- 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.
