Setting the dispatcher load balancing property to cluster compatible mode

If your IBM® Cognos® servers operate within a load balancing infrastructure, you can turn off the weighted round robin format of load balancing for the dispatcher.

If you don't set this parameter, load balancing may be duplicated by the cluster and by IBM Cognos software, which can degrade performance.

You can set the dispatcher property named loadBalancingMode either to weightedRoundRobin or clusterCompatible.

In weightedRoundRobin mode, the dispatcher sprays requests in a weighted round fashion, according to the configuration settings for the dispatcher. For more information, see Balancing requests among dispatchers. This is the default mode.

In clusterCompatible mode, non-affinity requests are processed locally if possible. If there is no service on the local dispatcher, the request fails. This ensures that IBM Cognos software respects any load balancing performed by your own load balancing infrastructure.

You can set the loadBalancingMode property for single dispatchers or for a group of dispatchers in a configuration folder. For more information, see Grouping dispatchers in configuration folders. Because it is an inherited property, you can move dispatchers to a configuration folder and set the loadBalancingMode property for the folder to quickly set the property for a group of dispatchers.

You can also control dispatcher load balancing by setting the in-progress request factor, see Balance Dispatcher Load with In-Progress Request Factor, or by setting capacity processing, see Balancing requests among dispatchers .

Before you begin

You must have the required permissions to access IBM Cognos Administration functionality. See Secured Functions and Features.

Procedure

  1. In IBM Cognos Administration, on the Status tab, click System.
  2. Click the arrow for the Actions menu next to System and click Set properties.
    Tip: You can also change the load balancing setting at the dispatcher level.
  3. Click the Settings tab.
  4. Select Tuning from the Category list.
  5. In the Value column, select the value for the Load Balancing Mode, either Weighted Round Robin or Cluster Compatible, and then click OK.

    The new value takes effect immediately.