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
