PingDirectory

Configuring dynamic rebalancing

Configure dynamic rebalancing on an existing entry balancing configuration.

Steps

  1. If the current placement algorithm does not support rebalancing, create an entry counter placement algorithm.

    Example:

    You can either do this using dsconfig in interactive mode or using the dsconfig command line as in this example.

    $ dsconfig create-placement-algorithm \
  --processor-name dc_example_dc_com-eb-req-processor \
  --algorithm-name rebalancing --type entry-counter \
  --set enabled:true --set rebalancing-enabled:true

  2. Remove any placement algorithm previously configured on this entry-balancing request processor.

  3. Throttle how many entries are being moved by the proxy so that the backend servers do not have too heavy a load by setting therebalancing-queue-maximum-size property of the request processor created in the previous step.

    Example:

    By default, the value is 1000. If the load is too high, reduce this value

    $ dsconfig set-request-processor-prop \
  --processor-name dc_example_dc_com-eb-req-processor \
  --set rebalancing-queue-maximum-size:50

  4. Verify that the access logs are configured to display the subtrees being moved by dynamic rebalancing.

    The access logs provide a good way to monitor progress. If the write load on the backend servers is high and you see lots of rebalancing activity in the access log, lower the queue size to lower the rebalancing activity.

    Example:

    This example configures the access log to display entry rebalancing processing information.

    $ dsconfig set-log-publisher-prop \
  --publisher-name "File-Based Access Logger" \
  --set log-entry-rebalancing-requests:true