This procedure describes how to configure dynamic rebalancing on an existing entry balancing configuration.

  1. To configure entry rebalancing, you may create an entry counter placement algorithm, if the current placement algorithm does not support rebalancing. You can either do this using dsconfig in interactive mode, or using the dsconfig command line as follows:
    $ 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. You can throttle how many entries are being moved by the proxy, so that the backend servers do not have too heavy a load. To do this, set the rebalancing-queue-maximum-size property of the request processor created in the previous step. By default, it is set to 1000. If the load is too high, reduce this value as follows:
    $ 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. So, 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. You can configure the access log to display entry rebalancing processing information as follows:
    $ dsconfig set-log-publisher-prop \
      --publisher-name "File-Based Access Logger" \
      --set log-entry-rebalancing-requests:true