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 GridServer Developer’s Guide.

These settings must be identical on all Directors.