4.6 Dispatcher scripts

4.6 Dispatcher scripts

+
Search Tips | Advanced Search

Dispatcher scripts are command-based scripts that are automatically run whenever a certain event is triggered. They are mostly used in high availability environments.
The following is a list of some of the scripts that Dispatcher uses:

goActive Run every time a Load Balancer server switches into active state.
goStandby Run every time a Load Balancer server goes into standby state.
goInOp Run when the Load Balancer Executor component is stopped or when it is started.
goIdle Not used in high availability environments. It is run when the Load Balancer server goes into idle state (when the machine is a stand-alone dispatcher, or when the high availability features have not yet been added). Do not use this script if you are configuring high availability.
serverDown Run when the Manager identifies that a balanced server is down. Using this script is not mandatory, but use it to send an e-mail message to the administrator or log the information to a file.
serverUp Run when the Manager identifies that a balanced server is back up. This script is also not mandatory, use it to send an e-mail message to the administrator or log the information to a file.
highavailChange Run when the state of a Load Balancer server changes or when the Executor is started. It is not mandatory, but use it to send an e-mail message to the administrator or log the information to a file.

These scripts must be placed in...
<product_install_path>/servers/bin

In UNIX systems, add execution permission to these files.
You will find a set of examples in...
<product_install_path>/servers/samples

You can start building your own scripts based on these examples. If you want to use the samples, copy them to the bin subdirectory, rename them and edit them there.
There are two sets of samples for the high availability scripts (goActive, goStandby and goInOp): one for regular high availability and one for mutual high availability.
Next

goActive	Run every time a Load Balancer server switches into active state.
goStandby	Run every time a Load Balancer server goes into standby state.
goInOp	Run when the Load Balancer Executor component is stopped or when it is started.
goIdle	Not used in high availability environments. It is run when the Load Balancer server goes into idle state (when the machine is a stand-alone dispatcher, or when the high availability features have not yet been added). Do not use this script if you are configuring high availability.
serverDown	Run when the Manager identifies that a balanced server is down. Using this script is not mandatory, but use it to send an e-mail message to the administrator or log the information to a file.
serverUp	Run when the Manager identifies that a balanced server is back up. This script is also not mandatory, use it to send an e-mail message to the administrator or log the information to a file.
highavailChange	Run when the state of a Load Balancer server changes or when the Executor is started. It is not mandatory, but use it to send an e-mail message to the administrator or log the information to a file.