RecoveryTest (GemFire XD Java API Documentation)

java.lang.Object
- diskRecovery.RecoveryTest

Direct Known Subclasses:: WANQueryClient

public class RecoveryTest
extends Object

Field Summary

Fields
Modifier and Type	Field and Description
`protected List<com.gemstone.gemfire.cache.Region>`	`allRegions`
`protected static int`	`CACHE_OPERATIONS`
`protected static int`	`CLEAR_REGION`
`protected static String`	`createCallbackPrefix`
`protected static String`	`destroyCallbackPrefix`
`protected static int`	`ENTRY_ADD_OPERATION`
`protected static int`	`ENTRY_DESTROY_OPERATION`
`protected static int`	`ENTRY_GET_NEW_OPERATION`
`protected static int`	`ENTRY_GET_OPERATION`
`protected static int`	`ENTRY_INVALIDATE_OPERATION`
`protected static int`	`ENTRY_LOCAL_DESTROY_OPERATION`
`protected static int`	`ENTRY_LOCAL_INVALIDATE_OPERATION`
`protected static int`	`ENTRY_PUTALL_OPERATION`
`protected static int`	`ENTRY_UPDATE_OPERATION`
`protected static String`	`getCallbackPrefix`
`protected static String`	`invalidateCallbackPrefix`
`static String`	`newVersionXmlKey`
`static String`	`oldVersionXmlKey`
`protected static int`	`PUTS_FOR_KEY_ORDER_POLICY`
`protected AtomicInteger`	`readyForSnapshot`
`protected static String`	`regionDestroyCallbackPrefix`
`protected static String`	`regionInvalidateCallbackPrefix`
`static RecoveryTest`	`testInstance` instance of this test class
`protected static HydraThreadLocal`	`threadIsPaused`
`protected static String`	`updateCallbackPrefix`

Constructor Summary

Constructors
Constructor and Description

RecoveryTest()

Constructors
Constructor and Description
`RecoveryTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected Object`	`addEntry(com.gemstone.gemfire.cache.Region aRegion)` Add a new entry to the given region.
`protected void`	`addEntry(com.gemstone.gemfire.cache.Region aRegion, Object key)` Add a new entry to the given region.
`protected void`	`cacheRegionOperations()` Method to exercise Cache.rootRegions and Cache.getRegion(String).
`protected static void`	`checkForLastIteration()` Check if we have run for the desired length of time.
`protected void`	`clearAllRegions()`
`protected com.gemstone.gemfire.cache.Region`	`clearRegion()` Invoke region.clear() - only one region is cleared during any test run.
`protected void`	`concRecoverLatestResponder()` Do randon operations and wait for the controller to signal it's time to write a snapshot to the blackboard.
`protected static void`	`deleteDir(File aDir)` Recursively delete a directory and its contents
`protected static void`	`deleteExistingDiskDirs()` Delete existing disk directories if they contain disk files.
`protected void`	`destroyAllEntries()`
`protected void`	`destroyEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalDestroy)` Destroy an entry in the given region.
`protected void`	`destroyEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, boolean isLocalDestroy)` Destroy an entry in the given region.
`protected static void`	`doOfflineValAndCompaction()`
`protected void`	`doOperations(long msToRun)` Do random operations on the cache and any defined regions in this vm.
`protected void`	`getExistingKey(com.gemstone.gemfire.cache.Region aRegion)` Does a get operation on an existing key.
`protected void`	`getNewKey(com.gemstone.gemfire.cache.Region aRegion)` Get a new key int the given region.
`protected Object[]`	`getNonPartitionedRegionInfo()` Return an array of nonPartitionedRegionInfo where Object[0] = selected region (null if there are no non-partitioned regions in the test) Object[1] = total number of non-partitioned regions.
`protected int`	`getOperation(Long whichPrm)` Get a random operation using the given hydra parameter.
`protected int`	`getOperation(com.gemstone.gemfire.cache.Region aRegion)` Get an operation to perform on the region
`protected Map`	`getPutAllMap(com.gemstone.gemfire.cache.Region aRegion)` Get a map to use for putAll for the given region.
`protected static String`	`getRegionCreatedKey(int vmID, String regionName)` Return a key to be used in the blackboard to indicate that a member created a particular region.
`protected void`	`getThisNewKey(com.gemstone.gemfire.cache.Region aRegion, Object key)` Do a get on the given new key.
`protected Object`	`getUpdateObject(com.gemstone.gemfire.cache.Region r, String key)` Return an object to be used to update the given key.
`static String`	`getXmlFileName(int vmID)` Return the xml file name for the vm with the given ID.
`protected static boolean`	`hasDiskInitFile(String diskStoreName, File[] diskDirArr)`
`static void`	`HydraTask_addGatewayHub()` Create gateway hub
`static void`	`HydraTask_backupController()` Task to control the backupResponder vms.
`static void`	`HydraTask_backupResponder()` Task to do random operations and direct other vms to pause and create snapshots.
`static void`	`HydraTask_compactionController()` Hydra task to run the compaction controller thread.
`static void`	`HydraTask_compactionResponder()` Hydra task to run the responder threads for compaction tests.
`static void`	`HydraTask_concRecoverAllController()` For concurrent recovery tests that stop all vms concurrently.
`static void`	`HydraTask_concRecoverLatestController()` For concurrent recovery tests, control when vms are stopped and restarted and create blackboard information for verification.
`static void`	`HydraTask_concRecoverLatestResponder()` For concurrent recovery tests, respond to the concRecoverLatestController
`static void`	`HydraTask_convertPre65Controller()`
`static void`	`HydraTask_convertPre70Controller()`
`static void`	`HydraTask_convertVerifyFromSnapshot()` Verify all regions from the snapshot and wait for all threads to complete verify
`static void`	`HydraTask_convertVerifyFromSnapshotAndSync()` Verify all regions from the snapshot and wait for all threads to complete verify
`static void`	`HydraTask_convertWANTestController()` Run from a new version locator thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running.
`static void`	`HydraTask_convertWANTestResponder()` Run from a new version locator thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running.
`static void`	`HydraTask_createExtraRegions()` Create extra root regions.
`static void`	`HydraTask_createGatewayHub()` Create gateway hub
`static void`	`HydraTask_createLocator()`
`static void`	`HydraTask_createRegions()` Create a region for each region defined in hydra.RegionPrms-names
`static void`	`HydraTask_createRegionsConvertedFirst()` Create a region for each region defined in hydra.RegionPrms-names
`static void`	`HydraTask_createXmlFile()` Hydra task to create an xml file for all regions currently existing
`static void`	`HydraTask_disconnect()` Disconnect from the distributed system
`static void`	`HydraTask_diskConvOperationsController()` Task to control the operationsResponder vms.
`static void`	`HydraTask_diskConvOperationsResponder()` Task to do random operations and direct other vms to pause and create snapshots.
`static void`	`HydraTask_doOnlineBackup()`
`static void`	`HydraTask_doOperations()` Task to do random operations
`static void`	`HydraTask_doOperationsHA()` Task to do random operations that expect exceptions from shutDownAllMembers
`static void`	`HydraTask_doOperationsShutDownAll()` Task to do random operations that expect exceptions from shutDownAllMembers
`static void`	`HydraTask_doOperationsWithPause()` Task to do random operations and pause then the controller thread signals pausing by incrementing the pausing counter.
`static void`	`HydraTask_doRecovery()` Stop all members and restart to do disk recovery
`static void`	`HydraTask_doSingleConvert()` Convert disk files for this jvm.
`static void`	`HydraTask_importAndVerify()` Verify all regions from the snapshot after choosing 1 vm to import the snapshot
`static void`	`HydraTask_initialize()` Creates and initializes a server or peer.
`static void`	`HydraTask_initializeClient()` Creates and initializes an edge client.
`static void`	`HydraTask_initializeController()` Initialization for controller for compaction test.
`static void`	`HydraTask_latestRecoveryTest()` Hydra task to verify that the latest disk files are recovered.
`static void`	`HydraTask_load()` Hydra task to load the region(s) with keys/values.
`static void`	`HydraTask_logRegions()` Task to log the sizes of all regions.
`static void`	`HydraTask_markVmInBlackboard()` Hydra task to mark this vm in the blackboard with a string.
`static void`	`HydraTask_multiRegionInitialize()` Initialization for test that run with multi-regions and multi-diskStores
`static void`	`HydraTask_operationsController()` Task to control the operationsResponder vms.
`static void`	`HydraTask_operationsResponder()` Task to do random operations and direct other vms to pause and create snapshots.
`static void`	`HydraTask_prepareForNewVersionOps()` set each newVersion uniqueKey blackboard value to a value higher than was used in the oldVersion ops to ensure unique keys and that new keys obtained by newVersion vms have never been used by oldVersion vms
`static void`	`HydraTask_recordStartupState()` Record disk startup state to the blackboard for later validation
`static void`	`HydraTask_recoverAfterGiiTest()` Serial execution test that steps back and forth between two vms to verify that the disk files are updated when initialized from gii and can be used for recovery
`static void`	`HydraTask_resetUniqueKeyIndex()` Reset the uniqueKeyIndex to be higher than the current blackboard counter
`static void`	`HydraTask_restoreBackups()` Hydra task to restore each backup that occurred during the run.
`static void`	`HydraTask_rvvConvert()` Execute conversion from pre-7.0 to 7.0 (RVV), but only one thread in the test can do the conversion.
`static void`	`HydraTask_rvvConvertOperationsController()` Controller for rvv (7.0) conversion test.
`static void`	`HydraTask_rvvConvertOperationsResponder()` Task to do random operations and direct other vms to pause and create snapshots.
`static void`	`HydraTask_rvvConvertVerifyFromSnapshot()` Verify all regions from the snapshot and wait for all threads to complete verify
`static void`	`HydraTask_rvvConvertVerifyFromSnapshotAndSync()` Verify all regions from the snapshot and wait for all threads to complete verify
`static void`	`HydraTask_rvvConvertWANTestController()` Run from a new version locator thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running.
`static void`	`HydraTask_rvvConvertWANTestResponder()` Run from the oldVersionPublisher thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running.
`static void`	`HydraTask_snapshotController()` Task to control the snapshotResponder vms.
`static void`	`HydraTask_snapshotResponder()` Task to do random operations, writeSnapshot, export then import snapshot and verify
`static void`	`HydraTask_startGatewayHub()` Start gateway hub
`static void`	`HydraTask_startLocatorAndDS()`
`static void`	`HydraTask_stopGatewayHub()` Disconnect from the distributed system
`static void`	`HydraTask_tombstoneTestController()` This is run by one vm to control responder vms for reaping tomstone tests.
`static void`	`HydraTask_tombstoneTestResponder()` Responds to directives issued by the tombstone test controller
`static void`	`HydraTask_upgradeController()` Controller method to test uprade of disk files one release to another.
`static void`	`HydraTask_verifyDeltaGII()` Verify if initialized remotely (via gii) verify that we used deltaGII if expected.
`static void`	`HydraTask_verifyEmptyRegions()` Verify that all regions are empty
`static void`	`HydraTask_verifyFromLeaderSnapshot()` Verify all regions from the snapshot after choosing 1 vm to write its state to the blackboard.
`static void`	`HydraTask_verifyFromSnapshot()` Verify all regions from the snapshot
`static void`	`HydraTask_verifyFromSnapshotAndSync()` Verify all regions from the snapshot and wait for all threads to complete verify
`static void`	`HydraTask_verifyPRs()` Verify regions that are PRs
`static void`	`HydraTask_verifyRegions()` Verify the expected sizes of all regions
`static void`	`HydraTask_verifyStartupState()` Verify that each vm got it's data from disk or gii as appropriate
`static void`	`HydraTask_waitForMyStartupRecovery()` For all PRs, wait for startup recovery in this VM.
`static void`	`HydraTask_writeSnapshot()`
`static void`	`HydraTask_writeToBB()` Write a snapshot to the blackboard for all regions except any extra regions.
`protected void`	`invalidateEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalInvalidate)` Invalidate an entry in the given region.
`protected void`	`invalidateEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, boolean isLocalInvalidate)` Invalidate an entry in the given region.
`protected boolean`	`isClearedRegion(com.gemstone.gemfire.cache.Region aRegion)` Whether or not the given Region was the target of a Region.clear().
`protected static long`	`logExecutionNumber()` Log the execution number of this serial task.
`protected Object`	`obtainExistingKey(com.gemstone.gemfire.cache.Region aRegion)` Return a random key from aRegion
`protected List<String>`	`obtainExistingKeys(com.gemstone.gemfire.cache.Region aRegion, int numToObtain)` Return a random key from aRegion
`protected Object`	`obtainNewKey()` Return a new key, never before used in the test.
`protected void`	`putAll(com.gemstone.gemfire.cache.Region aRegion)` putall a map to the given region.
`static void`	`putsForKeyOrderPolicy(com.gemstone.gemfire.cache.Region aRegion)` Puts ValueHolders with sequentially increasing modVal into the cache Does 1000 sequential updates on a single entry in the given region.
`protected static void`	`recoverLatestController()`
`protected static String`	`regionHierarchyToString()` Return a string representation of the region hierarchy for this test.
`protected static void`	`registerInterest()` Register interest with ALL_KEYS, and InterestPolicyResult = KEYS_VALUES which is equivalent to a full GII.
`protected static void`	`runRestoreScript(File backupDir, boolean expectSuccess)` Find restore scripts for any online backups that were done during the run and execute the scripts.
`static void`	`rvvConvert()` Run the 7.0 conversion method.
`static void`	`rvvConvert(List<String> oldXmlFiles, List<String> newXmlFiles)`
`protected static void`	`rvvConvert(String diskStoreName, File[] diskDirArr)` Given a diskStoreName and an array of disk directories: 1) run the offline validator 2) run the offline conversion utility (7.0 RVV) 3) run the offline validator again then check that the validator returns the same results before and after the conversion.
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region aRegion)` Update an existing entry in the given region.
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region aRegion, Object key)` Update an existing entry in the given region.
`protected void`	`validateAfterRestore(long backupNum)` After a restore from a backup, validate all region data.
`protected void`	`verifyAllRegionsEmpty()`
`protected void`	`verifyFromSnapshot()` For each region written to the blackboard, verify its state against the region in this vm.
`void`	`verifyFromSnapshot(com.gemstone.gemfire.cache.Region aRegion, Map regionSnapshot)` Verify that the given region is consistent with the given snapshot.

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

- Field Detail
  - testInstance
```
public static RecoveryTest testInstance
```
    instance of this test class
  - allRegions
```
protected List<com.gemstone.gemfire.cache.Region> allRegions
```
  - readyForSnapshot
```
protected AtomicInteger readyForSnapshot
```
  - threadIsPaused
```
protected static HydraThreadLocal threadIsPaused
```
  - oldVersionXmlKey
```
public static final String oldVersionXmlKey
```
    See Also:
    
    Constant Field Values
  - newVersionXmlKey
```
public static final String newVersionXmlKey
```
    See Also:
    
    Constant Field Values
  - ENTRY_ADD_OPERATION
```
protected static final int ENTRY_ADD_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_DESTROY_OPERATION
```
protected static final int ENTRY_DESTROY_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_INVALIDATE_OPERATION
```
protected static final int ENTRY_INVALIDATE_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_LOCAL_DESTROY_OPERATION
```
protected static final int ENTRY_LOCAL_DESTROY_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_LOCAL_INVALIDATE_OPERATION
```
protected static final int ENTRY_LOCAL_INVALIDATE_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_UPDATE_OPERATION
```
protected static final int ENTRY_UPDATE_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_GET_OPERATION
```
protected static final int ENTRY_GET_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_GET_NEW_OPERATION
```
protected static final int ENTRY_GET_NEW_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_PUTALL_OPERATION
```
protected static final int ENTRY_PUTALL_OPERATION
```
    See Also:
    
    Constant Field Values
  - CACHE_OPERATIONS
```
protected static final int CACHE_OPERATIONS
```
    See Also:
    
    Constant Field Values
  - PUTS_FOR_KEY_ORDER_POLICY
```
protected static final int PUTS_FOR_KEY_ORDER_POLICY
```
    See Also:
    
    Constant Field Values
  - CLEAR_REGION
```
protected static final int CLEAR_REGION
```
    See Also:
    
    Constant Field Values
  - getCallbackPrefix
```
protected static final String getCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - createCallbackPrefix
```
protected static final String createCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - updateCallbackPrefix
```
protected static final String updateCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - invalidateCallbackPrefix
```
protected static final String invalidateCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - destroyCallbackPrefix
```
protected static final String destroyCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - regionInvalidateCallbackPrefix
```
protected static final String regionInvalidateCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - regionDestroyCallbackPrefix
```
protected static final String regionDestroyCallbackPrefix
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - RecoveryTest
```
public RecoveryTest()
```
- Method Detail
  - HydraTask_createLocator
```
public static void HydraTask_createLocator()
                                    throws Throwable
```
    Throws:
    
    Throwable
  - HydraTask_startLocatorAndDS
```
public static void HydraTask_startLocatorAndDS()
                                        throws Throwable
```
    Throws:
    
    Throwable
  - HydraTask_initializeClient
```
public static void HydraTask_initializeClient()
                                       throws Throwable
```
    Creates and initializes an edge client.
    
    Throws:
    
    Throwable
  - HydraTask_initialize
```
public static void HydraTask_initialize()
                                 throws Throwable
```
    Creates and initializes a server or peer.
    
    Throws:
    
    Throwable
  - HydraTask_initializeController
```
public static void HydraTask_initializeController()
```
    Initialization for controller for compaction test.
  - HydraTask_multiRegionInitialize
```
public static void HydraTask_multiRegionInitialize()
                                            throws Throwable
```
    Initialization for test that run with multi-regions and multi-diskStores
    
    Throws:
    
    Throwable
  - HydraTask_createXmlFile
```
public static void HydraTask_createXmlFile()
```
    Hydra task to create an xml file for all regions currently existing
  - HydraTask_load
```
public static void HydraTask_load()
```
    Hydra task to load the region(s) with keys/values. This is a batched task. Load the region hierarchy with RecoveryPrms.maxNumEntries across all regions.
  - HydraTask_compactionController
```
public static void HydraTask_compactionController()
```
    Hydra task to run the compaction controller thread. This method controls what the responder vms do.
  - HydraTask_compactionResponder
```
public static void HydraTask_compactionResponder()
```
    Hydra task to run the responder threads for compaction tests. This method responds to directives from the compaction controller.
  - HydraTask_latestRecoveryTest
```
public static void HydraTask_latestRecoveryTest()
                                         throws ClientVmNotFoundException,
                                                InterruptedException
```
    Hydra task to verify that the latest disk files are recovered.
    
    Throws:
    
    ClientVmNotFoundException
    
    InterruptedException
  - HydraTask_recordStartupState
```
public static void HydraTask_recordStartupState()
```
    Record disk startup state to the blackboard for later validation
  - HydraTask_verifyRegions
```
public static void HydraTask_verifyRegions()
```
    Verify the expected sizes of all regions
  - HydraTask_verifyStartupState
```
public static void HydraTask_verifyStartupState()
```
    Verify that each vm got it's data from disk or gii as appropriate
  - HydraTask_markVmInBlackboard
```
public static void HydraTask_markVmInBlackboard()
```
    Hydra task to mark this vm in the blackboard with a string.
  - HydraTask_verifyEmptyRegions
```
public static void HydraTask_verifyEmptyRegions()
```
    Verify that all regions are empty
  - HydraTask_concRecoverLatestController
```
public static void HydraTask_concRecoverLatestController()
```
    For concurrent recovery tests, control when vms are stopped and restarted and create blackboard information for verification.
  - HydraTask_concRecoverLatestResponder
```
public static void HydraTask_concRecoverLatestResponder()
```
    For concurrent recovery tests, respond to the concRecoverLatestController
  - HydraTask_verifyFromSnapshot
```
public static void HydraTask_verifyFromSnapshot()
```
    Verify all regions from the snapshot
  - HydraTask_writeSnapshot
```
public static void HydraTask_writeSnapshot()
```
  - HydraTask_verifyFromSnapshotAndSync
```
public static void HydraTask_verifyFromSnapshotAndSync()
```
    Verify all regions from the snapshot and wait for all threads to complete verify
  - HydraTask_convertVerifyFromSnapshotAndSync
```
public static void HydraTask_convertVerifyFromSnapshotAndSync()
```
    Verify all regions from the snapshot and wait for all threads to complete verify
  - HydraTask_convertVerifyFromSnapshot
```
public static void HydraTask_convertVerifyFromSnapshot()
```
    Verify all regions from the snapshot and wait for all threads to complete verify
  - HydraTask_concRecoverAllController
```
public static void HydraTask_concRecoverAllController()
```
    For concurrent recovery tests that stop all vms concurrently.
  - HydraTask_verifyFromLeaderSnapshot
```
public static void HydraTask_verifyFromLeaderSnapshot()
```
    Verify all regions from the snapshot after choosing 1 vm to write its state to the blackboard.
  - HydraTask_doOperations
```
public static void HydraTask_doOperations()
                                   throws Exception
```
    Task to do random operations
    
    Throws:
    
    Exception
  - HydraTask_doOperationsWithPause
```
public static void HydraTask_doOperationsWithPause()
                                            throws Exception
```
    Task to do random operations and pause then the controller thread signals pausing by incrementing the pausing counter.
    
    Throws:
    
    Exception
  - HydraTask_doOperationsShutDownAll
```
public static void HydraTask_doOperationsShutDownAll()
                                              throws Exception
```
    Task to do random operations that expect exceptions from shutDownAllMembers
    
    Throws:
    
    Exception
  - HydraTask_doOperationsHA
```
public static void HydraTask_doOperationsHA()
                                     throws Exception
```
    Task to do random operations that expect exceptions from shutDownAllMembers
    
    Throws:
    
    Exception
  - HydraTask_backupController
```
public static void HydraTask_backupController()
```
    Task to control the backupResponder vms.
  - HydraTask_backupResponder
```
public static void HydraTask_backupResponder()
                                      throws Exception
```
    Task to do random operations and direct other vms to pause and create snapshots.
    
    Throws:
    
    Exception
  - HydraTask_doRecovery
```
public static void HydraTask_doRecovery()
```
    Stop all members and restart to do disk recovery
  - HydraTask_operationsController
```
public static void HydraTask_operationsController()
```
    Task to control the operationsResponder vms.
  - HydraTask_operationsResponder
```
public static void HydraTask_operationsResponder()
                                          throws Exception
```
    Task to do random operations and direct other vms to pause and create snapshots.
    
    Throws:
    
    Exception
  - HydraTask_snapshotController
```
public static void HydraTask_snapshotController()
```
    Task to control the snapshotResponder vms.
  - HydraTask_snapshotResponder
```
public static void HydraTask_snapshotResponder()
                                        throws Exception
```
    Task to do random operations, writeSnapshot, export then import snapshot and verify
    
    Throws:
    
    Exception
  - HydraTask_diskConvOperationsController
```
public static void HydraTask_diskConvOperationsController()
```
    Task to control the operationsResponder vms.
  - HydraTask_diskConvOperationsResponder
```
public static void HydraTask_diskConvOperationsResponder()
                                                  throws Exception
```
    Task to do random operations and direct other vms to pause and create snapshots.
    
    Throws:
    
    Exception
  - HydraTask_recoverAfterGiiTest
```
public static void HydraTask_recoverAfterGiiTest()
                                          throws Exception
```
    Serial execution test that steps back and forth between two vms to verify that the disk files are updated when initialized from gii and can be used for recovery
    
    Throws:
    
    Exception
  - HydraTask_logRegions
```
public static void HydraTask_logRegions()
```
    Task to log the sizes of all regions.
  - HydraTask_createExtraRegions
```
public static void HydraTask_createExtraRegions()
```
    Create extra root regions.
  - HydraTask_createRegions
```
public static void HydraTask_createRegions()
```
    Create a region for each region defined in hydra.RegionPrms-names
  - HydraTask_createGatewayHub
```
public static void HydraTask_createGatewayHub()
```
    Create gateway hub
  - HydraTask_addGatewayHub
```
public static void HydraTask_addGatewayHub()
```
    Create gateway hub
  - HydraTask_startGatewayHub
```
public static void HydraTask_startGatewayHub()
```
    Start gateway hub
  - HydraTask_createRegionsConvertedFirst
```
public static void HydraTask_createRegionsConvertedFirst()
```
    Create a region for each region defined in hydra.RegionPrms-names
  - HydraTask_writeToBB
```
public static void HydraTask_writeToBB()
```
    Write a snapshot to the blackboard for all regions except any extra regions.
  - HydraTask_disconnect
```
public static void HydraTask_disconnect()
```
    Disconnect from the distributed system
  - HydraTask_stopGatewayHub
```
public static void HydraTask_stopGatewayHub()
```
    Disconnect from the distributed system
  - HydraTask_doSingleConvert
```
public static void HydraTask_doSingleConvert()
```
    Convert disk files for this jvm.
  - HydraTask_verifyPRs
```
public static void HydraTask_verifyPRs()
```
    Verify regions that are PRs
  - HydraTask_waitForMyStartupRecovery
```
public static void HydraTask_waitForMyStartupRecovery()
```
    For all PRs, wait for startup recovery in this VM.
  - HydraTask_convertPre65Controller
```
public static void HydraTask_convertPre65Controller()
```
  - HydraTask_upgradeController
```
public static void HydraTask_upgradeController()
```
    Controller method to test uprade of disk files one release to another. For example, for 6.6 this will test creation of 6.5 disk files to be recovered by 6.6 jvms.
  - HydraTask_resetUniqueKeyIndex
```
public static void HydraTask_resetUniqueKeyIndex()
```
    Reset the uniqueKeyIndex to be higher than the current blackboard counter
  - HydraTask_prepareForNewVersionOps
```
public static void HydraTask_prepareForNewVersionOps()
```
    set each newVersion uniqueKey blackboard value to a value higher than was used in the oldVersion ops to ensure unique keys and that new keys obtained by newVersion vms have never been used by oldVersion vms
  - HydraTask_convertWANTestController
```
public static void HydraTask_convertWANTestController()
```
    Run from a new version locator thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running. This could be changed later.
  - HydraTask_convertWANTestResponder
```
public static void HydraTask_convertWANTestResponder()
                                              throws Exception
```
    Run from a new version locator thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running. This could be changed later.
    
    Throws:
    
    Exception
  - HydraTask_restoreBackups
```
public static void HydraTask_restoreBackups()
                                     throws Exception
```
    Hydra task to restore each backup that occurred during the run.
    
    Throws:
    
    Exception
  - validateAfterRestore
```
protected void validateAfterRestore(long backupNum)
                             throws Exception
```
    After a restore from a backup, validate all region data.
    
    Parameters:
    
    backupNum - The backup number we restored from (backups are created in directories called backup_
    
    Throws:
    
    Exception
  - regionHierarchyToString
```
protected static String regionHierarchyToString()
```
    Return a string representation of the region hierarchy for this test.
  - recoverLatestController
```
protected static void recoverLatestController()
```
  - concRecoverLatestResponder
```
protected void concRecoverLatestResponder()
```
    Do randon operations and wait for the controller to signal it's time to write a snapshot to the blackboard.
  - verifyFromSnapshot
```
protected void verifyFromSnapshot()
```
    For each region written to the blackboard, verify its state against the region in this vm.
  - verifyFromSnapshot
```
public void verifyFromSnapshot(com.gemstone.gemfire.cache.Region aRegion,
                               Map regionSnapshot)
```
    Verify that the given region is consistent with the given snapshot.
    
    Parameters:
    
    aRegion - The region to verify
    
    snapshot - The expected contents of aRegion.
  - HydraTask_importAndVerify
```
public static void HydraTask_importAndVerify()
```
    Verify all regions from the snapshot after choosing 1 vm to import the snapshot
  - doOperations
```
protected void doOperations(long msToRun)
                     throws Exception
```
    Do random operations on the cache and any defined regions in this vm.
    
    Parameters:
    
    msToRun - The number of milliseconds to run operations before returning.
    
    Throws:
    
    Exception
  - getOperation
```
protected int getOperation(com.gemstone.gemfire.cache.Region aRegion)
```
    Get an operation to perform on the region
    
    Parameters:
    
    reg - The region to get an operation for.
  - getOperation
```
protected int getOperation(Long whichPrm)
```
    Get a random operation using the given hydra parameter.
    
    Parameters:
    
    whichPrm - A hydra parameter which specifies random operations.
  - getExistingKey
```
protected void getExistingKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Does a get operation on an existing key.
    
    Parameters:
    
    aRegion - The region to perform the get on.
  - addEntry
```
protected Object addEntry(com.gemstone.gemfire.cache.Region aRegion)
```
    Add a new entry to the given region.
    
    Parameters:
    
    aRegion - The region to use for adding a new entry.
  - addEntry
```
protected void addEntry(com.gemstone.gemfire.cache.Region aRegion,
                        Object key)
```
    Add a new entry to the given region.
    
    Parameters:
    
    aRegion - The region to use for adding a new entry.
    
    key - The key to add.
  - putAll
```
protected void putAll(com.gemstone.gemfire.cache.Region aRegion)
```
    putall a map to the given region.
    
    Parameters:
    
    aRegion - The region to use for putall a map.
  - getPutAllMap
```
protected Map getPutAllMap(com.gemstone.gemfire.cache.Region aRegion)
```
    Get a map to use for putAll for the given region. Make sure the values in the map honor unique keys.
    
    Parameters:
    
    aRegion - The region to consider for the putAll.
    
    Returns:
    
    Map The map to use for the argument to putAll
  - invalidateEntry
```
protected void invalidateEntry(com.gemstone.gemfire.cache.Region aRegion,
                               boolean isLocalInvalidate)
```
    Invalidate an entry in the given region.
    
    Parameters:
    
    aRegion - The region to use for invalidating an entry.
    
    isLocalInvalidate - True if the invalidate should be local, false otherwise.
  - invalidateEntry
```
protected void invalidateEntry(com.gemstone.gemfire.cache.Region aRegion,
                               Object key,
                               boolean isLocalInvalidate)
```
    Invalidate an entry in the given region.
    
    Parameters:
    
    aRegion - The region to use for invalidating an entry.
    
    key - The key to invalidate.
    
    isLocalInvalidate - True if the invalidate should be local, false otherwise.
  - destroyEntry
```
protected void destroyEntry(com.gemstone.gemfire.cache.Region aRegion,
                            boolean isLocalDestroy)
```
    Destroy an entry in the given region.
    
    Parameters:
    
    aRegion - The region to use for destroying an entry.
    
    isLocalDestroy - True if the destroy should be local, false otherwise.
  - destroyEntry
```
protected void destroyEntry(com.gemstone.gemfire.cache.Region aRegion,
                            Object key,
                            boolean isLocalDestroy)
```
    Destroy an entry in the given region.
    
    Parameters:
    
    aRegion - The region to use for destroying an entry.
    
    key - The key to destroy.
    
    isLocalDestroy - True if the destroy should be local, false otherwise.
  - updateEntry
```
protected void updateEntry(com.gemstone.gemfire.cache.Region aRegion)
```
    Update an existing entry in the given region. If there are no available keys in the region, then this is a noop.
    
    Parameters:
    
    aRegion - The region to use for updating an entry.
  - updateEntry
```
protected void updateEntry(com.gemstone.gemfire.cache.Region aRegion,
                           Object key)
```
    Update an existing entry in the given region. If there are no available keys in the region, then this is a noop.
    
    Parameters:
    
    aRegion - The region to use for updating an entry.
    
    key - The key to update.
  - getNewKey
```
protected void getNewKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Get a new key int the given region.
    
    Parameters:
    
    aRegion - The region to use for getting an entry.
  - getThisNewKey
```
protected void getThisNewKey(com.gemstone.gemfire.cache.Region aRegion,
                             Object key)
```
    Do a get on the given new key.
    
    Parameters:
    
    aRegion - The region to use for getting an entry.
    
    key - A new key never used before.
  - obtainExistingKey
```
protected Object obtainExistingKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Return a random key from aRegion
    
    Parameters:
    
    aRegion - The region to get the existing key from.
    
    Returns:
    
    A random key from aRegion.
  - obtainExistingKeys
```
protected List<String> obtainExistingKeys(com.gemstone.gemfire.cache.Region aRegion,
                                          int numToObtain)
```
    Return a random key from aRegion
    
    Parameters:
    
    aRegion - The region to get the existing key from.
    
    Returns:
    
    A List of existing keys.
  - cacheRegionOperations
```
protected void cacheRegionOperations()
```
    Method to exercise Cache.rootRegions and Cache.getRegion(String).
  - putsForKeyOrderPolicy
```
public static void putsForKeyOrderPolicy(com.gemstone.gemfire.cache.Region aRegion)
```
    Puts ValueHolders with sequentially increasing modVal into the cache Does 1000 sequential updates on a single entry in the given region. These values continually increase (each threads posts its current opNum in the BB with a key based on vmId and threadId) for an entry unique to this thread (every invocation of this method by a single thread works on the same unique entry).
  - clearRegion
```
protected com.gemstone.gemfire.cache.Region clearRegion()
```
    Invoke region.clear() - only one region is cleared during any test run. Note that Partitioned Regions do not support clear
  - getNonPartitionedRegionInfo
```
protected Object[] getNonPartitionedRegionInfo()
```
    Return an array of nonPartitionedRegionInfo where Object[0] = selected region (null if there are no non-partitioned regions in the test) Object[1] = total number of non-partitioned regions. (Used by clearRegion since clear is unsupported by PartitionedRegions).
  - isClearedRegion
```
protected boolean isClearedRegion(com.gemstone.gemfire.cache.Region aRegion)
```
    Whether or not the given Region was the target of a Region.clear().
  - runRestoreScript
```
protected static void runRestoreScript(File backupDir,
                                       boolean expectSuccess)
```
    Find restore scripts for any online backups that were done during the run and execute the scripts.
    
    Parameters:
    
    backupDir - The directory containing a backup.
    
    expectSuccess - If true then the restore scripts should work successfully, if false then they should fail because there are already disk files present.
  - deleteDir
```
protected static void deleteDir(File aDir)
```
    Recursively delete a directory and its contents
    
    Parameters:
    
    aDir - The directory to delete.
  - deleteExistingDiskDirs
```
protected static void deleteExistingDiskDirs()
```
    Delete existing disk directories if they contain disk files.
  - registerInterest
```
protected static void registerInterest()
```
    Register interest with ALL_KEYS, and InterestPolicyResult = KEYS_VALUES which is equivalent to a full GII.
  - logExecutionNumber
```
protected static long logExecutionNumber()
```
    Log the execution number of this serial task.
  - checkForLastIteration
```
protected static void checkForLastIteration()
```
    Check if we have run for the desired length of time. We cannot use hydra's taskTimeSec parameter because of a small window of opportunity for the test to hang due to the test's "concurrent round robin" type of strategy. Here we set a blackboard counter if time is up and this is the last concurrent round.
  - obtainNewKey
```
protected Object obtainNewKey()
```
    Return a new key, never before used in the test.
  - getUpdateObject
```
protected Object getUpdateObject(com.gemstone.gemfire.cache.Region r,
                                 String key)
```
    Return an object to be used to update the given key. If the value for the key is a ValueHolder, then get an alternate value which is similar to it's previous value (see ValueHolder.getAlternateValueHolder()).
    
    Parameters:
    
    aRegion - The region which possible contains key.
    
    key - The key to get a new value for.
  - getRegionCreatedKey
```
protected static String getRegionCreatedKey(int vmID,
                                            String regionName)
```
    Return a key to be used in the blackboard to indicate that a member created a particular region.
    
    Parameters:
    
    vmID - The vmID that created the region.
    
    regionName - The name of the region created.
  - getXmlFileName
```
public static String getXmlFileName(int vmID)
```
    Return the xml file name for the vm with the given ID.
  - HydraTask_rvvConvertOperationsController
```
public static void HydraTask_rvvConvertOperationsController()
```
    Controller for rvv (7.0) conversion test. This is a variant of operationsController. There are 2 distributed systems, one for an old version and one for a new version. This task is run by a thread that does not have a cache or region for either distributed system, but it is able to stop/start jvms in either distributed system. 1 - Kill the jvms in the new version distributed system. These jvms will be running the rvvConvertersionOperationsResponder task, and will be sleeping waiting to be killed. Once they are gone, they will not get any more tasks until they are started, so now only the old version jvms are running the rvvConvertersionOperationsController task and are populating the region with data. 2 - Signal to the old jvms to pause; once paused, one is randomly chosen to write a snapshot to the blackboard. 3 - Stop all the old jvms. 4 - Convert the disk files from the old version to the new version. 6 - Start up the new version jvms with the converted disk files. Dynamic init tasks compare the entries recovered from disk against the blackboard. 7 - From this point, the test only uses the new version vms. It will pause, one jvm will write to the blackboard, restart and verify against the blackboard in an init task.
  - HydraTask_rvvConvertOperationsResponder
```
public static void HydraTask_rvvConvertOperationsResponder()
                                                    throws Exception
```
    Task to do random operations and direct other vms to pause and create snapshots. Also coordinates an onlineBackup in the oldVersionAdmin
    
    Throws:
    
    Exception
  - HydraTask_convertPre70Controller
```
public static void HydraTask_convertPre70Controller()
```
  - HydraTask_rvvConvertVerifyFromSnapshotAndSync
```
public static void HydraTask_rvvConvertVerifyFromSnapshotAndSync()
```
    Verify all regions from the snapshot and wait for all threads to complete verify
  - HydraTask_rvvConvertVerifyFromSnapshot
```
public static void HydraTask_rvvConvertVerifyFromSnapshot()
```
    Verify all regions from the snapshot and wait for all threads to complete verify
  - HydraTask_rvvConvertWANTestController
```
public static void HydraTask_rvvConvertWANTestController()
```
    Run from a new version locator thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running. This could be changed later.
  - HydraTask_rvvConvertWANTestResponder
```
public static void HydraTask_rvvConvertWANTestResponder()
                                                 throws Exception
```
    Run from the oldVersionPublisher thread This code is hardcoded for 3 wan sites because of a time crunch to get the test running. This could be changed later.
    
    Throws:
    
    Exception
  - HydraTask_rvvConvert
```
public static void HydraTask_rvvConvert()
```
    Execute conversion from pre-7.0 to 7.0 (RVV), but only one thread in the test can do the conversion.
  - rvvConvert
```
public static void rvvConvert()
```
    Run the 7.0 conversion method.
  - rvvConvert
```
public static void rvvConvert(List<String> oldXmlFiles,
                              List<String> newXmlFiles)
```
  - hasDiskInitFile
```
protected static boolean hasDiskInitFile(String diskStoreName,
                                         File[] diskDirArr)
```
  - rvvConvert
```
protected static void rvvConvert(String diskStoreName,
                                 File[] diskDirArr)
```
    Given a diskStoreName and an array of disk directories: 1) run the offline validator 2) run the offline conversion utility (7.0 RVV) 3) run the offline validator again then check that the validator returns the same results before and after the conversion.
    
    Parameters:
    
    diskStoreName - The name of a diskStore.
    
    diskDirArr - An array of Files, each element being a disk directory.
  - HydraTask_doOnlineBackup
```
public static void HydraTask_doOnlineBackup()
```
  - doOfflineValAndCompaction
```
protected static void doOfflineValAndCompaction()
```
  - HydraTask_tombstoneTestController
```
public static void HydraTask_tombstoneTestController()
```
    This is run by one vm to control responder vms for reaping tomstone tests. This directs the responder vms to 1) initialize (create regions) 2) verify all regions are empty 3) load regions with configured number of entries 4) destroy all entries (via destroy, clear or expiration) 5) stop and restart all vms; one of the vms will initialize from disk regions and all others will do a gii from the one that did disk recovery This is repeated until numSecondsToRun is reached
  - HydraTask_tombstoneTestResponder
```
public static void HydraTask_tombstoneTestResponder()
```
    Responds to directives issued by the tombstone test controller
  - verifyAllRegionsEmpty
```
protected void verifyAllRegionsEmpty()
```
  - destroyAllEntries
```
protected void destroyAllEntries()
```
  - clearAllRegions
```
protected void clearAllRegions()
```
  - HydraTask_verifyDeltaGII
```
public static void HydraTask_verifyDeltaGII()
```
    Verify if initialized remotely (via gii) verify that we used deltaGII if expected.

Class RecoveryTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

allRegions

readyForSnapshot

threadIsPaused

oldVersionXmlKey

newVersionXmlKey

ENTRY_ADD_OPERATION

ENTRY_DESTROY_OPERATION

ENTRY_INVALIDATE_OPERATION

ENTRY_LOCAL_DESTROY_OPERATION

ENTRY_LOCAL_INVALIDATE_OPERATION

ENTRY_UPDATE_OPERATION

ENTRY_GET_OPERATION

ENTRY_GET_NEW_OPERATION

ENTRY_PUTALL_OPERATION

CACHE_OPERATIONS

PUTS_FOR_KEY_ORDER_POLICY

CLEAR_REGION

getCallbackPrefix

createCallbackPrefix

updateCallbackPrefix

invalidateCallbackPrefix

destroyCallbackPrefix

regionInvalidateCallbackPrefix

regionDestroyCallbackPrefix

Constructor Detail

RecoveryTest

Method Detail

HydraTask_createLocator

HydraTask_startLocatorAndDS

HydraTask_initializeClient

HydraTask_initialize

HydraTask_initializeController

HydraTask_multiRegionInitialize

HydraTask_createXmlFile

HydraTask_load

HydraTask_compactionController

HydraTask_compactionResponder

HydraTask_latestRecoveryTest

HydraTask_recordStartupState

HydraTask_verifyRegions

HydraTask_verifyStartupState

HydraTask_markVmInBlackboard

HydraTask_verifyEmptyRegions

HydraTask_concRecoverLatestController

HydraTask_concRecoverLatestResponder

HydraTask_verifyFromSnapshot

HydraTask_writeSnapshot

HydraTask_verifyFromSnapshotAndSync

HydraTask_convertVerifyFromSnapshotAndSync

HydraTask_convertVerifyFromSnapshot

HydraTask_concRecoverAllController

HydraTask_verifyFromLeaderSnapshot

HydraTask_doOperations

HydraTask_doOperationsWithPause

HydraTask_doOperationsShutDownAll

HydraTask_doOperationsHA

HydraTask_backupController

HydraTask_backupResponder

HydraTask_doRecovery

HydraTask_operationsController

HydraTask_operationsResponder

HydraTask_snapshotController

HydraTask_snapshotResponder

HydraTask_diskConvOperationsController

HydraTask_diskConvOperationsResponder

HydraTask_recoverAfterGiiTest

HydraTask_logRegions

HydraTask_createExtraRegions

HydraTask_createRegions

HydraTask_createGatewayHub

HydraTask_addGatewayHub

HydraTask_startGatewayHub

HydraTask_createRegionsConvertedFirst