Apache Geode CHANGELOG

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)?]

Name Description Default Value
--include-region Partitioned 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-out Time to wait (in seconds) before GFSH returns to a prompt while rebalancing continues in the background. -1 (wait for rebalancing to complete
--simulate Whether 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