Installation guide
Using the Load Balancing Plug-in: libresonate
60 iPlanet Web Server, Enterprise Edition Release Notes • June 20, 2001
Library configuration
In order to enable the plug-in, you need to modify obj.conf manually. This should look something
like this:
Init fn="load-modules" funcs="init-resonate"
shlib="server_root/bin/https/lib/libresonate.so"
Init fn="init-resonate" ThreadPool="sleep" EventExePath="/tools/ns/bin/perl5"
LateInit="yes" CmdLow="/usr/netscape/ent41/plugins/loadbal/CmdLow.pl"
CmdHigh="/usr/netscape/ent41/plugins/loadbal/CmdHigh.pl"
The init-resonate function can take the following parameters:
Setting
LogVerbose on in magnus.conf will cause the server to print a lot of information to the
error log on how the plug-in is configured and when it is invoked.
Table 6 init-resonate Parameters
Parameter Description
ThreadPool the name of the thread pool to monitor
Aggressive if set to TRUE this argument causes the plug-in use the pool thread count rather
than the queue thread count
PollTime how frequently to check the thread status, by default 2000 seconds
HighThreshold defines the queue size/# of threads where HighCmd is executed in order to
increase load on the server. The default is 4096.
LowThreshold defines the queue size/# of threads where the LowCmd is executed in order to
decrease load on the server. The default is 1.
EventExePath pointer to the script program you want to run (i.e. /usr/bin/perl or /bin/sh).
Defaults to perl or perl.exe depending on platform.
CmdLow pointer to the script to be run when the LowThreshold is met
ArgsLow arguments to send to CmdLow
CmdHigh pointer to the script to be run when the HighThreshold is met
ArgsHigh arguments to send to CmdHigh
NOTE You must specify LateInit="yes" when loading this module. This
is because the module creates a monitoring thread and this
monitoring thread needs to start after
ns-httpd has started.