CapacityTest (GemFire XD Java API Documentation)

java.lang.Object
- rebalance.CapacityTest

public class CapacityTest
extends Object

Test class for PR capacity and rebalancing.

Field Summary

Fields
Modifier and Type	Field and Description
`protected com.gemstone.gemfire.cache.Region`	`aRegion`
`protected static String`	`bucketMapKey`
`protected static String`	`primaryMapKey`
`static CapacityTest`	`testInstance`

Constructor Summary

Constructors
Constructor and Description

CapacityTest()

Constructors
Constructor and Description
`CapacityTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`addCapacity()` Bring a new vm into the ds and rebalance to create new capacity.
`protected Map<Integer,Integer>`	`getIdealLocalSizeMap()` Return a Map containing the ideal number of entries for a given vm's local max memory and the total number of keys currently in aRegion.
`protected static int`	`getLocalMaxMemory()` Return a value for localMaxMemory for this vm.
`protected Map<Integer,Integer>`	`getLocalMaxMemoryMap()` Return a Map where the key is a vmId, and the value is that vm's localMaxMemory setting
`protected Map<Integer,Long>`	`getLocalSizeMap()` Return a Map where the key is a vmId, and the value is that vm's number of entries (its local size).
`static void`	`HydraTask_addCapacity()` Add a new vm (adds capacity) to the ds and rebalance with verification.
`static void`	`HydraTask_initAccessor()` Creates and initializes the singleton instance of ParRegTest in this VM.
`static void`	`HydraTask_initBridge()` Creates and initializes the singleton instance of ParRegTest in this VM.
`static void`	`HydraTask_initDataStore()` Creates and initializes the singleton instance of ParRegTest in this VM.
`static void`	`HydraTask_initEdge()` Creates and initializes the singleton instance of ParRegTest in this VM.
`static void`	`HydraTask_loadUntilFull()` Put into the PR until all data store vms exceed local max memory.
`static void`	`HydraTask_loadUntilNumKeys()` Put into the PR until RebalancePrms-numKeys has been reached.
`static void`	`HydraTask_rebalance()` Rebalance the PR.
`static void`	`HydraTask_recordLocalSize()` Record the local size of this VM's PR (this is the number of entries in this vm's PR, not the number of entries in the entire pr).
`static void`	`HydraTask_replaceDataStore()` For replacement test, create the PR, rebalance and verify that this vm hosts the equivalent capacity that it held before being stopped.
`static void`	`HydraTask_stopStart()` Stop a vm, write the current PR state to the bb before stopping.
`static void`	`HydraTask_verifyRegionSize()` Verify all keys/values are present
`static void`	`HydraTask_verifyVariedLMM()` Verify that a vm with localMaxMemory N has half the data as a vm with localMaxMemory 2N.
`void`	`initializeInstance()` Initialize this test instance
`void`	`initializeRegion(String regDescriptName, int localMaxMemory)` Create a region with the given region description name.
`protected void`	`loadUntilFull()` Put into the PR until local max memory is exceeded in all vms.
`protected void`	`loadUntilNumKeys()` Put into the PR until RebalancePrm.numKeys has been reached.
`protected void`	`stopStart()` Write the current state of buckets to the blackboard, then do a stop/start.
`protected void`	`verifyLmmBasedOnIdealSize()` Verify the actual number of entries in each vm is close to the expected ideal number of entries.
`protected void`	`verifyLmmBasedOnRelativeSize()` Verify the relative sizes of the data and local max memory in each vm relative to every other vm.
`protected void`	`verifyRegionSize()` Verify the region size.
`protected void`	`verifyReplacedCapacity()` Verify that this restarted vm roughly replaced the capacity it had before.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - testInstance
```
public static CapacityTest testInstance
```
  - aRegion
```
protected com.gemstone.gemfire.cache.Region aRegion
```
  - primaryMapKey
```
protected static final String primaryMapKey
```
    See Also:
    
    Constant Field Values
  - bucketMapKey
```
protected static final String bucketMapKey
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - CapacityTest
```
public CapacityTest()
```
- Method Detail
  - HydraTask_initAccessor
```
public static void HydraTask_initAccessor()
```
    Creates and initializes the singleton instance of ParRegTest in this VM.
  - HydraTask_initDataStore
```
public static void HydraTask_initDataStore()
```
    Creates and initializes the singleton instance of ParRegTest in this VM.
  - HydraTask_initEdge
```
public static void HydraTask_initEdge()
```
    Creates and initializes the singleton instance of ParRegTest in this VM.
  - HydraTask_initBridge
```
public static void HydraTask_initBridge()
```
    Creates and initializes the singleton instance of ParRegTest in this VM.
  - HydraTask_replaceDataStore
```
public static void HydraTask_replaceDataStore()
```
    For replacement test, create the PR, rebalance and verify that this vm hosts the equivalent capacity that it held before being stopped.
  - initializeRegion
```
public void initializeRegion(String regDescriptName,
                             int localMaxMemory)
```
    Create a region with the given region description name.
    
    Parameters:
    
    regDescriptName - The name of a region description.
    
    localMaxMemory - The localMaxMemory to use for this region.
  - initializeInstance
```
public void initializeInstance()
```
    Initialize this test instance
  - getLocalMaxMemory
```
protected static int getLocalMaxMemory()
```
    Return a value for localMaxMemory for this vm.
  - HydraTask_loadUntilFull
```
public static void HydraTask_loadUntilFull()
```
    Put into the PR until all data store vms exceed local max memory.
  - HydraTask_loadUntilNumKeys
```
public static void HydraTask_loadUntilNumKeys()
```
    Put into the PR until RebalancePrms-numKeys has been reached.
  - HydraTask_addCapacity
```
public static void HydraTask_addCapacity()
```
    Add a new vm (adds capacity) to the ds and rebalance with verification.
  - HydraTask_verifyRegionSize
```
public static void HydraTask_verifyRegionSize()
```
    Verify all keys/values are present
  - HydraTask_stopStart
```
public static void HydraTask_stopStart()
```
    Stop a vm, write the current PR state to the bb before stopping.
  - HydraTask_rebalance
```
public static void HydraTask_rebalance()
```
    Rebalance the PR.
  - HydraTask_verifyVariedLMM
```
public static void HydraTask_verifyVariedLMM()
```
    Verify that a vm with localMaxMemory N has half the data as a vm with localMaxMemory 2N.
  - HydraTask_recordLocalSize
```
public static void HydraTask_recordLocalSize()
```
    Record the local size of this VM's PR (this is the number of entries in this vm's PR, not the number of entries in the entire pr).
  - loadUntilFull
```
protected void loadUntilFull()
```
    Put into the PR until local max memory is exceeded in all vms.
  - loadUntilNumKeys
```
protected void loadUntilNumKeys()
```
    Put into the PR until RebalancePrm.numKeys has been reached.
  - addCapacity
```
protected void addCapacity()
```
    Bring a new vm into the ds and rebalance to create new capacity.
  - verifyRegionSize
```
protected void verifyRegionSize()
```
    Verify the region size.
  - stopStart
```
protected void stopStart()
```
    Write the current state of buckets to the blackboard, then do a stop/start.
  - verifyReplacedCapacity
```
protected void verifyReplacedCapacity()
```
    Verify that this restarted vm roughly replaced the capacity it had before.
  - getLocalMaxMemoryMap
```
protected Map<Integer,Integer> getLocalMaxMemoryMap()
```
    Return a Map where the key is a vmId, and the value is that vm's localMaxMemory setting
  - getLocalSizeMap
```
protected Map<Integer,Long> getLocalSizeMap()
```
    Return a Map where the key is a vmId, and the value is that vm's number of entries (its local size).
  - verifyLmmBasedOnRelativeSize
```
protected void verifyLmmBasedOnRelativeSize()
```
    Verify the relative sizes of the data and local max memory in each vm relative to every other vm.
  - verifyLmmBasedOnIdealSize
```
protected void verifyLmmBasedOnIdealSize()
```
    Verify the actual number of entries in each vm is close to the expected ideal number of entries.
  - getIdealLocalSizeMap
```
protected Map<Integer,Integer> getIdealLocalSizeMap()
```
    Return a Map containing the ideal number of entries for a given vm's local max memory and the total number of keys currently in aRegion. This calculation is based on the following: Let x = the number of keys in vm with localMaxMemory baseLmm. Then the number of keys in all vms is represented by this equation (one term for each vmId present in the system): (lmmForVmId_1/baseLmm)*x + (lmmForVmId_2/baseLmm)*x + ... = numKeysInRegion + numKeysInRedundantCopies

Class CapacityTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

aRegion

primaryMapKey

bucketMapKey

Constructor Detail

CapacityTest

Method Detail

HydraTask_initAccessor

HydraTask_initDataStore

HydraTask_initEdge

HydraTask_initBridge

HydraTask_replaceDataStore

initializeRegion

initializeInstance

getLocalMaxMemory

HydraTask_loadUntilFull

HydraTask_loadUntilNumKeys

HydraTask_addCapacity

HydraTask_verifyRegionSize

HydraTask_stopStart

HydraTask_rebalance

HydraTask_verifyVariedLMM

HydraTask_recordLocalSize

loadUntilFull

loadUntilNumKeys

addCapacity

verifyRegionSize

stopStart

verifyReplacedCapacity

getLocalMaxMemoryMap

getLocalSizeMap

verifyLmmBasedOnRelativeSize

verifyLmmBasedOnIdealSize

getIdealLocalSizeMap