rebalance

Class RebalanceUtil

java.lang.Object

rebalance.RebalanceUtil

public class RebalanceUtil
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
protected static ParRegUtil	parRegUtilInstance

Constructor Summary

Constructors

Constructor and Description
RebalanceUtil()

Method Summary

Modifier and Type	Method and Description
static void	checkRebalancingActivity(com.gemstone.gemfire.cache.control.RebalanceResults results) Check that rebalancing actually caused some movement of data.
static void	checkResultsWithRegion(Set<com.gemstone.gemfire.cache.partition.PartitionRebalanceInfo> detailSet) Check that the details of the rebalance agrees with the current state of the region(s) that were rebalanced.
static void	checkSimulateAgainstRebalance(com.gemstone.gemfire.cache.control.RebalanceResults simulateResults, com.gemstone.gemfire.cache.control.RebalanceResults rebalanceResults) Check that rebalance did what simualte proposed.
static void	createLocatorTask() Creates a (disconnected) locator.
static double	getAverageBucketCount(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)
static double	getAverageHeapUtilization(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)
static double	getAveragePrimaryCount(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)
static double	getHeapUtilizationStdDev(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmdSet)
static double	getNumMemLRUEvictions() Return the number of MemLRU evictions that have occurred.
static double	getPrimaryCountStdDev(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmdSet)
protected static long	getPRLocalSize(String regionName)
static String	getRegionName(com.gemstone.gemfire.cache.partition.PartitionRebalanceInfo prd)
static String	getRegionName(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)
static void	HydraTask_displayStats() Return the number of PR entries in this VM
static void	HydraTask_logLocalSize() Log the local size of the PR data store
static void	HydraTask_verifyBucketCopiesBatched() Hydra task to verify bucket copies.
static void	HydraTask_verifyEviction() Hydra CLOSETASK to verify that eviction occurred in rebalancing eviction tests.
static void	HydraTask_verifyPrimaries() Hydra task to verify primaries
static void	HydraTask_verifyPRMetaData() Hydra task to verify metadata versions of parReg/KnownKeysTest validation methods which verify all partitionedRegions in the VM.
static void	isBalanceImproved(com.gemstone.gemfire.cache.control.RebalanceResults results) Check that rebalancing improved the state of things.
static void	isBalanceImproved(com.gemstone.gemfire.cache.control.RebalanceResults results, boolean stableSystem) Check that rebalancing improved the state of things.
static void	isBalanceImproved(String regionName, Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> before, Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> after)
static boolean	isLocalMaxMemoryHonored(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)
static boolean	isRedundancySatisfied(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)
static String	partitionedRegionDetailsToString(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)
static String	partitionMemberDetailsToString(com.gemstone.gemfire.cache.partition.PartitionMemberInfo pmd)
static String	partitionRebalanceDetailsToString(com.gemstone.gemfire.cache.partition.PartitionRebalanceInfo details)
static void	primariesBalanced()
protected static String	primariesBalanced(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)
static String	RebalanceResultsToString(com.gemstone.gemfire.cache.control.RebalanceResults results, String title)
static void	startAndConnectLocatorTask() Connects a locator to its distributed system.
static void	stopLocatorTask() Stops a locator.
static void	waitForRecovery()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

parRegUtilInstance

protected static ParRegUtil parRegUtilInstance

Constructor Detail

RebalanceUtil

public RebalanceUtil()

Method Detail

primariesBalanced

public static void primariesBalanced()

waitForRecovery

public static void waitForRecovery()

primariesBalanced

protected static String primariesBalanced(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)

isBalanceImproved

public static void isBalanceImproved(com.gemstone.gemfire.cache.control.RebalanceResults results,
                                     boolean stableSystem)

Check that rebalancing improved the state of things.

Parameters:

results - The results of a rebalance

stableSystem - True if the system is stable, meaning it is not doing ops, cycling vms or allowing buckets to move. In this case this method will verify with test hooks that assume the buckets are stable. False if system is not stable and could be doing ops, cycling vms, or allowing buckets to move. In this case the method will not use test hooks for verification.

isBalanceImproved

public static void isBalanceImproved(com.gemstone.gemfire.cache.control.RebalanceResults results)

Check that rebalancing improved the state of things. This method should only be called when the test is silent (no ops) as it compares the rebalance results to the current state of the existing PRs in this vm.

isBalanceImproved

public static void isBalanceImproved(String regionName,
                                     Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> before,
                                     Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> after)

isLocalMaxMemoryHonored

public static boolean isLocalMaxMemoryHonored(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)

isRedundancySatisfied

public static boolean isRedundancySatisfied(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)

getAverageHeapUtilization

public static double getAverageHeapUtilization(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)

getAverageBucketCount

public static double getAverageBucketCount(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)

getAveragePrimaryCount

public static double getAveragePrimaryCount(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmd)

getHeapUtilizationStdDev

public static double getHeapUtilizationStdDev(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmdSet)

getPrimaryCountStdDev

public static double getPrimaryCountStdDev(Set<com.gemstone.gemfire.cache.partition.PartitionMemberInfo> pmdSet)

HydraTask_displayStats

public static void HydraTask_displayStats()

Return the number of PR entries in this VM

getPRLocalSize

protected static long getPRLocalSize(String regionName)

HydraTask_logLocalSize

public static void HydraTask_logLocalSize()

Log the local size of the PR data store

HydraTask_verifyPRMetaData

public static void HydraTask_verifyPRMetaData()

Hydra task to verify metadata versions of parReg/KnownKeysTest validation methods which verify all partitionedRegions in the VM.

HydraTask_verifyPrimaries

public static void HydraTask_verifyPrimaries()

Hydra task to verify primaries

HydraTask_verifyBucketCopiesBatched

public static void HydraTask_verifyBucketCopiesBatched()

Hydra task to verify bucket copies. This must be called repeatedly by the same thread until StopSchedulingTaskOnClientOrder is thrown.

RebalanceResultsToString

public static String RebalanceResultsToString(com.gemstone.gemfire.cache.control.RebalanceResults results,
                                              String title)

partitionRebalanceDetailsToString

public static String partitionRebalanceDetailsToString(com.gemstone.gemfire.cache.partition.PartitionRebalanceInfo details)

partitionedRegionDetailsToString

public static String partitionedRegionDetailsToString(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)

partitionMemberDetailsToString

public static String partitionMemberDetailsToString(com.gemstone.gemfire.cache.partition.PartitionMemberInfo pmd)

getRegionName

public static String getRegionName(com.gemstone.gemfire.cache.partition.PartitionRegionInfo prd)

getRegionName

public static String getRegionName(com.gemstone.gemfire.cache.partition.PartitionRebalanceInfo prd)

checkSimulateAgainstRebalance

public static void checkSimulateAgainstRebalance(com.gemstone.gemfire.cache.control.RebalanceResults simulateResults,
                                                 com.gemstone.gemfire.cache.control.RebalanceResults rebalanceResults)

Check that rebalance did what simualte proposed.

Parameters:

simulateResults - The details of the simulate step.

rebalanceResults - The details of the rebalance step.

checkRebalancingActivity

public static void checkRebalancingActivity(com.gemstone.gemfire.cache.control.RebalanceResults results)

Check that rebalancing actually caused some movement of data. If not, find out why not (e.g. was there no more space)?

Parameters:

result - The RebalanceResults

checkResultsWithRegion

public static void checkResultsWithRegion(Set<com.gemstone.gemfire.cache.partition.PartitionRebalanceInfo> detailSet)

Check that the details of the rebalance agrees with the current state of the region(s) that were rebalanced.

Parameters:

detailSet - The details of the rebalance. Each element of this set is the details of rebalancing one PR.

HydraTask_verifyEviction

public static void HydraTask_verifyEviction()

Hydra CLOSETASK to verify that eviction occurred in rebalancing eviction tests.

getNumMemLRUEvictions

public static double getNumMemLRUEvictions()

Return the number of MemLRU evictions that have occurred. Note: util.TestHelper() searches all bridgeServer archives

Returns:

The number of MemLRU evictions, obtained from stats.

createLocatorTask

public static void createLocatorTask()

Creates a (disconnected) locator.

startAndConnectLocatorTask

public static void startAndConnectLocatorTask()

Connects a locator to its distributed system.

stopLocatorTask

public static void stopLocatorTask()

Stops a locator.