This topic describes the rebalance command in gfsh, the VMware Tanzu GemFire command-line interface.

Use this command to 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
check-circle-line exclamation-circle-line close-line
Scroll to top icon