Description
Add two gfsh commands to allow redundancy to be restored and to check the current redundancy status:
restore redundancy [--include-region=value(,value)*] [--exclude-region=value(,value)*] [--reassign-primaries(=value)]
status redundancy [--include-region=value(,value)*] [--exclude-region=value(,value)*]
The first command will execute a function on members hosting the specified partitioned regions and trigger the restore redundancy operation for those regions, then report the final redundancy status of those regions.
The command will return success status if:
- Redundancy is fully satisfied for all regions that were included, either explicitly or implicitly.
- No partitioned regions were found and none were explicitly included.
The command will return error status if:
- At least one bucket in a region has zero redundant copies, and that region has redundancy configured.
At least one bucket in a region has fewer than the configured number of redundant copies. - At least one of the explicitly included partitioned regions is not found.
- There is a member in the system with a version of Geode older than 1.13.0 (assuming that is the version in which this feature is implemented).
- The restore redundancy function encounters an exception.
The second command will determine the current redundancy status for the specified regions and report it to the user.
Both commands will take optional --include-region and --exclude-region arguments, similar to the existing rebalance command. If neither argument is specified, all regions will be included. Included regions will take precedence over excluded regions when both are specified. The restore redundancy command will also take an optional --reassign-primaries argument to determine if primaries should be reassigned or not during the operation. The default behaviour will be to reassign primaries.
Both commands will output a list of regions with zero redundant copies first (unless they are configured to have zero redundancy), then regions with less than their configured redundancy, then regions with full redundancy. The restore redundancy command will also output information about how many primaries were reassigned and how long that process took, similar to the existing rebalance command.
As described here: https://cwiki.apache.org/confluence/display/GEODE/Redundancy+Gfsh+Commands
Attachments
Issue Links
- blocks
-
GEODE-7955 Documentation for restore redundancy internal API and gfsh commands
-
- Closed
-
- is blocked by
-
GEODE-7953 Create Restore Redundancy Internal API
-
- Closed
-
- links to