Engine Balancer Configuration
To configure Engine Balancing on the Director, go to Admin > System Admin > Manager Configuration > Engines and Clients, and change the following properties:
|
Setting |
Description |
|
Engine Balancer |
The Engine balancer to use: Weight-Based or Home/Shared. |
|
Rebalance Interval |
The amount of time, in seconds, between balancing episodes. (Previously called the Poll Period.) |
|
Logoff Timeout |
The amount of time in seconds that an Engine waits to finish a task before logging off. |
|
Broker Query Timeout |
The maximum time to wait for Broker’s reply for balancer data queries. The value is in milliseconds. |
|
Soft Logoff |
If true, Engine logoffs do not restart the JVM unless needed by a home Broker. This enables them to retain state and log in faster. |
|
Engine Fraction |
The fraction of extra Engines that moves to another Broker on a balance. This can be set to less than 1 to dampen Engine movement. For example, if the fraction is 0.5 and the balancer determines that a Broker has eight extra Engines, it moves four on the first balance. Assuming those Engines move, on the next balance it determines that there are four extra and moves two, and so on. |
|
Engine Balance Maximum |
The maximum number of Engines that can move to another Broker on a rebalance. The maximum applies over the entire grid. For example, if this property is set to 100 and the balancer determines to rebalance 200 Engines (after taking Engine Balance Fraction into account), then only 100 Engines are actually rebalanced. |
|
Max Service Discriminators |
The maximum number of service discriminators to consider when reporting balance data from each Broker. |
|
Allow Routing When Sharing |
If Broker Routing properties are used when the Sharing balancer is enabled. Under most circumstances, when using the Sharing balancer, it is best not to also use routing. |
|
Treat Pinned Engines as Busy |
If pinned, Engines are reported as busy from a sharing point of view. In some use cases, treating pinned Engine as busy Engines can reduce Engine fluctuation and improve overall grid performance. Note that this setting affects Engine sharing only. For information about Engine Pinning, see the TIBCO GridServer® Developer's Guide. |
These settings must be identical on all Directors.