Skip to main content

rebalance

Rebalance partitioned regions.

The default is for all partitioned regions to be rebalanced.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

rebalance [--include-region=value(,value)*]
[--exclude-region=value(,value)*] [--time-out=value] [--simulate(=value)?]

NameDescriptionDefault Value
‑‑include-regionPartitioned Region paths to be included for rebalance operation. Includes take precedence over excludes. 
‑‑exclude-region Partitioned Region paths to be excluded for rebalance operation. 
‑‑time-outTime to wait (in seconds) before GFSH returns to a prompt while rebalancing continues in the background.-1 (wait for rebalancing to complete
‑‑simulateWhether to only simulate rebalancing. The --time-out parameter is not available when simulating.false
Table 1. Rebalance Parameters

Example Commands:

rebalance --include-region=/region3 --simulate=true

Sample Output:

Rebalanced Stats | Value
----------------------------------------------------------------------------------------------- | -----
Total bytes in all redundant bucket copies created during this rebalance | 0
Total time (in milliseconds) spent creating redundant bucket copies during this rebalance | 0
Total number of redundant copies created during this rebalance | 0
Total bytes in buckets moved during this rebalance | 0
Total time (in milliseconds) spent moving buckets during this rebalance | 0
Total number of buckets moved during this rebalance | 0
Total time (in milliseconds) spent switching the primary state of buckets during this rebalance | 0
Total primaries transferred during this rebalance | 0
Total time (in milliseconds) for this rebalance | 0
Total number of members in system on which rebalance is executed | 2