KnownKeysTest (GemFire XD Java API Documentation)

java.lang.Object
- getInitialImage.InitImageTest
- - parReg.KnownKeysTest

Direct Known Subclasses:

ColocatedRecoveryTest, EventsDuringRecoveryTest, ExecutionAndColocationTest, KillDuringRecoveryTest, KnownKeysTestStreamingValidator, SBKnownKeysTest
```
public class KnownKeysTest
extends InitImageTest
```

Field Summary

Fields
Modifier and Type	Field and Description
`protected static String`	`DataStoreVmStr`
`protected static boolean`	`diskFilesRecorded`
`protected com.gemstone.gemfire.distributed.DistributedLockService`	`distLockService`
`protected boolean`	`highAvailability`
`protected static boolean`	`isBridgeConfiguration`
`protected static boolean`	`isClientCache`
`protected static boolean`	`isGatewayConfiguration`
`protected static boolean`	`isGatewaySenderConfiguration`
`protected static String`	`LOCK_NAME`
`protected static String`	`LOCK_SERVICE_NAME`
`protected boolean`	`lockOperations`
`protected static Set`	`missingKeys`
`protected static Set`	`missingValues`
`protected static ParRegUtil`	`parRegUtilInstance`
`protected static boolean`	`verifyRegionContentsCompleted`
`protected static StringBuffer`	`verifyRegionContentsErrStr`
`protected static int`	`verifyRegionContentsIndex`
`protected static StringBuffer`	`verifyRegionContentsSizeStr`
`protected static boolean`	`verifyRegionSizeCompleted`
`protected static int`	`verifyRegionSizeIndex`

Fields inherited from class getInitialImage.InitImageTest
ADD_NEW_KEY, aRegion, createRegionDurationMS, DESTROY, FIRST_OP, GET, giiDurationMS, INVALIDATE, keyIntervals, LAST_OP, LOCAL_DESTROY, LOCAL_INVALIDATE, LOG_INTERVAL_MILLIS, numNewKeys, operations, PUTALL_NEW_KEY, randomValues, REGION_NAME, sc, sleepMSAfterOps, supportsConcurrentMap, testInstance, totalNumKeys, UPDATE_EXISTING_KEY

Constructor Summary

Constructors
Constructor and Description

KnownKeysTest()

Constructors
Constructor and Description
`KnownKeysTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`doOps(BitSet availableOps)` Do operations on the REGION_NAME's keys using keyIntervals to specify which keys get which operations.
`protected List`	`getDataStoreVms()` Return a list of the ClientVmInfo for all data store VMs.
`static void`	`HydraTask_accessorInitialize()` Initialize the single instance of this test class and an accessor partitioned region.
`static void`	`HydraTask_createGatewaySenderIds()` Creates GatewaySender ids based on the `ConfigPrms.gatewaySenderConfig` for new wan senders.
`static void`	`HydraTask_dataStoreInitialize()` Initialize the single instance of this test class and a dataStore partitioned region.
`static void`	`HydraTask_disconnect()` Disconnect from the ds, in preparation of calling offline disk validation and compaction
`static void`	`HydraTask_doOps()` Hydra task to execution ops, then stop scheduling.
`static void`	`HydraTask_doPrTxOps()` Hydra task to execution PR TX ops, then stop scheduling.
`static void`	`HydraTask_HA_accessorInitialize()`
`static void`	`HydraTask_HA_dataStoreInitialize()`
`static void`	`HydraTask_initialize()` Initialize the single instance of this test class but not a region.
`static void`	`HydraTask_loadRegion()` Hydra task to initialize a region and load it according to hydra param settings.
`static void`	`HydraTask_logLocalSize()` Log the local size of the PR data store
`static void`	`HydraTask_startGatewayHub()` Using the Gateway endpoints stored on the hydra BB via GatewayHubHelper.createGatewayHub, start the Gateway in the Servers.
`static void`	`HydraTask_startNewWanComponents()` Hydra task to start new WAN senders which are created earlier via GatewaySenderHelper.createGatewaySenders.
`static void`	`HydraTask_stopStartVms()` Hydra task to stop/start numVmsToStop at a time.
`static void`	`HydraTask_validatePR()`
`static void`	`HydraTask_verifyBucketCopiesBatched()` Hydra task to verify bucket copies.
`static void`	`HydraTask_verifyHDFSRegionContents()`
`static void`	`HydraTask_verifyHDFSRegionSize()` Verify that test counters and region size are in agreement after the load.
`static void`	`HydraTask_verifyPrimaries()` Hydra task to verify primaries
`static void`	`HydraTask_verifyPRMetaData()` Hydra task to verify metadata
`static void`	`HydraTask_verifyRegionContents()` Hydra task to verify the contents of the region after all ops.
`static void`	`HydraTask_verifyRegionSize()` Hydra task to verify the size of the region after the load.
`static void`	`HydraTask_verifyUniqueHosts()` Hydra task to verify buckets on on unique hosts
`static void`	`HydraTask_waitForMyStartupRecovery()` Waits for this vm to complete redundancy recovery.
`static void`	`HydraTask_waitForSilence()` Hydra task to wait for a period of silence (30 seconds) to allow the server queues to drain to the clients.
`static void`	`HydraTask_waitForStartupRecovery()` If this vm has a startup delay, wait for it.
`static void`	`HydraTask_writeDiskDirsToBB()` Hydra task to write the existing diskDirs to the blackboard, if any are set.
`void`	`initInstance(String regDescriptName)` Initialize this test instance
`protected void`	`recordFailedOps(String sharedMapKey)` Use TxHelper.getClientTXOperations() to get the List of TransactionalOperations which failed due to TransactionDataNodeHasDeparted and TransactionDataRebalancedExceptions (HA tests).
`static void`	`StartTask_initialize()` Initialize the known keys for this test
`protected void`	`stopStartVms()` Stop and start ParRegPrms.numVMsToStop.
`void`	`verifyHDFSRegionContents()` HDFS regions are recovered lazily from disk ...
`protected void`	`verifyHDFSRegionSize()`
`void`	`verifyRegionContents()` Verify the contents of the region, taking into account the keys that were destroyed, invalidated, etc (as specified in keyIntervals) Throw an error of any problems are detected.
`protected void`	`verifyRegionSize()` Verify that test counters and region size are in agreement after the load.

Methods inherited from class getInitialImage.InitImageTest
addNewKey, blockedGetRegion, checkContainsKey, checkContainsValueForKey, checkUpdatedValue, checkValue, createObject, createObject, destroy, doGetInitImage, doNewKeyGets, doOpsPlusPuts, get, getCacheLoader, getCacheWriter, getOp, getRegionKeySet, getValueToAdd, hasLocalGiiCompleted, HydraTask_blockedGetRegion, HydraTask_doCacheWriterTest, HydraTask_doGetInitImage, HydraTask_doGetInitImageWithoutMonitor, HydraTask_doNewKeyGets, HydraTask_doPutAllNewKey, HydraTask_initCache, HydraTask_loadRegionWithGets, HydraTask_verifyCacheWriterTest, HydraTask_verifyEventCounters, HydraTask_verifyGII, HydraTask_verifyNonBlocking, initializeInstance, initializeRegion, initInstance, initRegion, invalidate, isAnyGiiInProgress, isLocalGiiInProgress, isLocalGiiInProgress, loadRegion, loadRegionWithGets, localDestroy, localInvalidate, putAllNewKey, updateExistingKey, verifyCacheWriterTest, verifyEventCounters, verifyNonBlocking, waitForAllGiiToComplete, waitForAnyGiiToBegin, waitForLocalGiiCompleted, waitForLocalGiiToBegin

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

- Field Detail
  - DataStoreVmStr
```
protected static String DataStoreVmStr
```
  - isBridgeConfiguration
```
protected static boolean isBridgeConfiguration
```
  - isGatewayConfiguration
```
protected static boolean isGatewayConfiguration
```
  - isClientCache
```
protected static boolean isClientCache
```
  - isGatewaySenderConfiguration
```
protected static boolean isGatewaySenderConfiguration
```
  - missingKeys
```
protected static Set missingKeys
```
  - missingValues
```
protected static Set missingValues
```
  - verifyRegionSizeIndex
```
protected static int verifyRegionSizeIndex
```
  - verifyRegionSizeCompleted
```
protected static boolean verifyRegionSizeCompleted
```
  - verifyRegionContentsIndex
```
protected static int verifyRegionContentsIndex
```
  - verifyRegionContentsErrStr
```
protected static StringBuffer verifyRegionContentsErrStr
```
  - verifyRegionContentsSizeStr
```
protected static StringBuffer verifyRegionContentsSizeStr
```
  - verifyRegionContentsCompleted
```
protected static boolean verifyRegionContentsCompleted
```
  - parRegUtilInstance
```
protected static ParRegUtil parRegUtilInstance
```
  - lockOperations
```
protected boolean lockOperations
```
  - distLockService
```
protected com.gemstone.gemfire.distributed.DistributedLockService distLockService
```
  - LOCK_SERVICE_NAME
```
protected static String LOCK_SERVICE_NAME
```
  - LOCK_NAME
```
protected static String LOCK_NAME
```
  - highAvailability
```
protected boolean highAvailability
```
  - diskFilesRecorded
```
protected static boolean diskFilesRecorded
```
- Constructor Detail
  - KnownKeysTest
```
public KnownKeysTest()
```
- Method Detail
  - StartTask_initialize
```
public static void StartTask_initialize()
```
    Initialize the known keys for this test
  - HydraTask_initialize
```
public static void HydraTask_initialize()
```
    Initialize the single instance of this test class but not a region. If this VM has already initialized its instance, then skip reinitializing.
  - initInstance
```
public void initInstance(String regDescriptName)
```
    Initialize this test instance
  - HydraTask_accessorInitialize
```
public static void HydraTask_accessorInitialize()
```
    Initialize the single instance of this test class and an accessor partitioned region.
  - HydraTask_HA_accessorInitialize
```
public static void HydraTask_HA_accessorInitialize()
```
  - HydraTask_dataStoreInitialize
```
public static void HydraTask_dataStoreInitialize()
```
    Initialize the single instance of this test class and a dataStore partitioned region.
  - HydraTask_startGatewayHub
```
public static void HydraTask_startGatewayHub()
```
    Using the Gateway endpoints stored on the hydra BB via GatewayHubHelper.createGatewayHub, start the Gateway in the Servers. Note that all participating Gateways must write their endpoints to the blackboard prior to any gateway making this call.
  - HydraTask_createGatewaySenderIds
```
public static void HydraTask_createGatewaySenderIds()
```
    Creates GatewaySender ids based on the ConfigPrms.gatewaySenderConfig for new wan senders. This has to be created before creating regions.
  - HydraTask_startNewWanComponents
```
public static void HydraTask_startNewWanComponents()
```
    Hydra task to start new WAN senders which are created earlier via GatewaySenderHelper.createGatewaySenders. It also start and creates receivers as given in hydra.ConfigPrms#gatewayReceiverConfig
  - HydraTask_writeDiskDirsToBB
```
public static void HydraTask_writeDiskDirsToBB()
```
    Hydra task to write the existing diskDirs to the blackboard, if any are set.
  - HydraTask_HA_dataStoreInitialize
```
public static void HydraTask_HA_dataStoreInitialize()
```
  - HydraTask_waitForStartupRecovery
```
public static void HydraTask_waitForStartupRecovery()
```
    If this vm has a startup delay, wait for it.
  - HydraTask_waitForMyStartupRecovery
```
public static void HydraTask_waitForMyStartupRecovery()
```
    Waits for this vm to complete redundancy recovery.
  - HydraTask_validatePR
```
public static void HydraTask_validatePR()
```
  - HydraTask_disconnect
```
public static void HydraTask_disconnect()
```
    Disconnect from the ds, in preparation of calling offline disk validation and compaction
  - HydraTask_logLocalSize
```
public static void HydraTask_logLocalSize()
```
    Log the local size of the PR data store
  - HydraTask_loadRegion
```
public static void HydraTask_loadRegion()
```
    Hydra task to initialize a region and load it according to hydra param settings.
  - HydraTask_doOps
```
public static void HydraTask_doOps()
```
    Hydra task to execution ops, then stop scheduling.
  - HydraTask_doPrTxOps
```
public static void HydraTask_doPrTxOps()
```
    Hydra task to execution PR TX ops, then stop scheduling.
  - HydraTask_waitForSilence
```
public static void HydraTask_waitForSilence()
```
    Hydra task to wait for a period of silence (30 seconds) to allow the server queues to drain to the clients.
  - HydraTask_verifyPRMetaData
```
public static void HydraTask_verifyPRMetaData()
```
    Hydra task to verify metadata
  - HydraTask_verifyUniqueHosts
```
public static void HydraTask_verifyUniqueHosts()
```
    Hydra task to verify buckets on on unique hosts
  - 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.
  - HydraTask_stopStartVms
```
public static void HydraTask_stopStartVms()
```
    Hydra task to stop/start numVmsToStop at a time.
  - HydraTask_verifyRegionContents
```
public static void HydraTask_verifyRegionContents()
```
    Hydra task to verify the contents of the region after all ops. This MUST be called as a batched task, and will throw StopSchedulingTaskOnClientOrder when completed. It is necessary to reinitialize the verify state variables if this is called a second time in this VM, however an error is thrown if a second attempt it made without resetting the state variables.
  - HydraTask_verifyHDFSRegionContents
```
public static void HydraTask_verifyHDFSRegionContents()
```
  - HydraTask_verifyRegionSize
```
public static void HydraTask_verifyRegionSize()
```
    Hydra task to verify the size of the region after the load. This MUST be called as a batched task, and will throw StopSchedulingTaskOnClientOrder when completed. It is necessary to reinitialize the verify state variables if this is called a second time in this VM, however an error is thrown if a second attempt it made without resetting the state variables.
  - verifyRegionSize
```
protected void verifyRegionSize()
```
    Verify that test counters and region size are in agreement after the load. This must be called repeatedly by the same thread until StopSchedulingTaskOnClientOrder is thrown.
  - verifyRegionContents
```
public void verifyRegionContents()
```
    Verify the contents of the region, taking into account the keys that were destroyed, invalidated, etc (as specified in keyIntervals) Throw an error of any problems are detected. This must be called repeatedly by the same thread until StopSchedulingTaskOnClientOrder is thrown.
    
    Overrides:
    
    verifyRegionContents in class InitImageTest
  - HydraTask_verifyHDFSRegionSize
```
public static void HydraTask_verifyHDFSRegionSize()
```
    Verify that test counters and region size are in agreement after the load. This must be called repeatedly by the same thread until StopSchedulingTaskOnClientOrder is thrown. For HDFS regions (with eviction) we cannot rely on region.size(), containsKey(), containsValueForKey()
  - verifyHDFSRegionSize
```
protected void verifyHDFSRegionSize()
```
  - verifyHDFSRegionContents
```
public void verifyHDFSRegionContents()
```
    HDFS regions are recovered lazily from disk ... only operations (like get()) which invoke the cacheLoader will retrieve data from HDFS. So, we cannot rely on region.size(), containsKey, containsValueForKey, etc.
  - stopStartVms
```
protected void stopStartVms()
```
    Stop and start ParRegPrms.numVMsToStop. Do not return until the VMs have restarted and reinitialized
  - getDataStoreVms
```
protected List getDataStoreVms()
```
    Return a list of the ClientVmInfo for all data store VMs. These are obtained from the blackboard map.
  - doOps
```
public void doOps(BitSet availableOps)
```
    Do operations on the REGION_NAME's keys using keyIntervals to specify which keys get which operations. This will return when all operations in all intervals have completed.
    
    Overrides:
    
    doOps in class InitImageTest
    
    Parameters:
    
    availableOps - - Bits which are true correspond to the operations that should be executed.
  - recordFailedOps
```
protected void recordFailedOps(String sharedMapKey)
```
    Use TxHelper.getClientTXOperations() to get the List of TransactionalOperations which failed due to TransactionDataNodeHasDeparted and TransactionDataRebalancedExceptions (HA tests). Add the keys for these operations to the given set (either failedTxOps or inDoubtTxOps)

Class KnownKeysTest

Field Summary

Fields inherited from class getInitialImage.InitImageTest

Constructor Summary

Method Summary

Methods inherited from class getInitialImage.InitImageTest

Methods inherited from class java.lang.Object

Field Detail

DataStoreVmStr

isBridgeConfiguration

isGatewayConfiguration

isClientCache

isGatewaySenderConfiguration

missingKeys

missingValues

verifyRegionSizeIndex

verifyRegionSizeCompleted

verifyRegionContentsIndex

verifyRegionContentsErrStr

verifyRegionContentsSizeStr

verifyRegionContentsCompleted

parRegUtilInstance

lockOperations

distLockService

LOCK_SERVICE_NAME

LOCK_NAME

highAvailability

diskFilesRecorded

Constructor Detail

KnownKeysTest

Method Detail

StartTask_initialize

HydraTask_initialize

initInstance

HydraTask_accessorInitialize

HydraTask_HA_accessorInitialize

HydraTask_dataStoreInitialize

HydraTask_startGatewayHub

HydraTask_createGatewaySenderIds

HydraTask_startNewWanComponents

HydraTask_writeDiskDirsToBB

HydraTask_HA_dataStoreInitialize

HydraTask_waitForStartupRecovery

HydraTask_waitForMyStartupRecovery

HydraTask_validatePR

HydraTask_disconnect

HydraTask_logLocalSize

HydraTask_loadRegion

HydraTask_doOps

HydraTask_doPrTxOps

HydraTask_waitForSilence

HydraTask_verifyPRMetaData

HydraTask_verifyUniqueHosts

HydraTask_verifyPrimaries

HydraTask_verifyBucketCopiesBatched

HydraTask_stopStartVms

HydraTask_verifyRegionContents

HydraTask_verifyHDFSRegionContents

HydraTask_verifyRegionSize

verifyRegionSize

verifyRegionContents

HydraTask_verifyHDFSRegionSize

verifyHDFSRegionSize

verifyHDFSRegionContents

stopStartVms

getDataStoreVms

doOps

recordFailedOps